Claude Code 接入指南
🎯 Claude Code - 主要平台
Section titled “🎯 Claude Code - 主要平台”Claude Code 是 CLI-Anything 的首选和主要支持平台。通过内置的插件市场，可以一键安装并使用完整的 7 阶段 CLI 生成流水线。
📋 前提条件
Section titled “📋 前提条件”- Claude Code 已安装并登录账号
- Python 3.10+
- Git（Windows 用户需安装 Git for Windows 或使用 WSL）
- 目标软件已安装（如 GIMP、Blender、LibreOffice 等）
🚀 快速接入（3 步）
Section titled “🚀 快速接入（3 步）”Step 1：添加插件市场
Section titled “Step 1：添加插件市场”在 Claude Code 中输入：
/plugin marketplace add HKUDS/CLI-Anything这会添加 CLI-Anything 官方插件市场。
Step 2：安装 CLI-Anything 插件
Section titled “Step 2：安装 CLI-Anything 插件”/plugin install cli-anything安装完成后，Claude Code 就拥有了 CLI-Anything 的全部功能。
Step 3：一句话生成 CLI
Section titled “Step 3：一句话生成 CLI”/cli-anything gimpClaude Code 会自动执行完整的 7 阶段生成流程：
- Analyze - 分析 GIMP 软件结构和可用的操作
- Design - 设计 CLI 命令架构
- Implement - 实现核心代码
- Plan Tests - 规划测试用例
- Write Tests - 编写测试脚本
- Document - 生成使用文档
- Publish - 发布可用的 CLI
📖 7 阶段流水线详解
Section titled “📖 7 阶段流水线详解”Phase 1: Analyze（分析阶段）
Section titled “Phase 1: Analyze（分析阶段）”Claude Code 会：
- 分析目标软件的安装位置和文件结构
- 扫描可用的脚本接口（Python、DBus、AppleScript 等）
- 研究软件文档和社区资源
- 确定最佳自动化方案
Phase 2: Design（设计阶段）
Section titled “Phase 2: Design（设计阶段）”设计 CLI 命令架构：
# 示例：GIMP CLI 设计cli-anything-gimp image new|open|crop|rotate|flip|scalecli-anything-gimp layer add|merge|duplicatecli-anything-gimp filter apply|previewcli-anything-gimp export file|pdf|gifPhase 3: Implement（实现阶段）
Section titled “Phase 3: Implement（实现阶段）”生成实际的 CLI 代码：
- 核心命令行接口（Click/Typer）
- 与软件的实际通信层
- 错误处理和日志记录
Phase 4: Plan Tests（规划测试）
Section titled “Phase 4: Plan Tests（规划测试）”确定测试范围：
- 功能测试（各命令是否正常工作）
- 边界情况（无效参数、大文件处理）
- 集成测试（多命令组合工作流）
Phase 5: Write Tests（编写测试）
Section titled “Phase 5: Write Tests（编写测试）”生成自动化测试脚本：
- pytest 测试套件
- 冒烟测试
- 回归测试
Phase 6: Document（文档）
Section titled “Phase 6: Document（文档）”生成使用文档：
- 命令帮助信息
- 示例用法
- 常见问题解答
Phase 7: Publish（发布）
Section titled “Phase 7: Publish（发布）”最终产物：
- 可执行的 CLI 命令
- 完整的测试套件
- 使用文档
💬 使用示例
Section titled “💬 使用示例”基本图像操作
Section titled “基本图像操作”You: 请用 GIMP 创建一张 1920x1080 的蓝色背景图片
Claude: [自动执行]→ cli-anything-gimp image new --width 1920 --height 1080 --color "#0000FF"✅ 已创建蓝色背景图片，保存为 /tmp/blue-bg.xcfYou: 给这张照片应用模糊滤镜，半径 5 像素
Claude: [自动执行]→ cli-anything-gimp filter apply --input ./photo.jpg --name "gaussian-blur" --radius 5✅ 滤镜已应用，保存为 ./photo-blurred.jpgYou: 把 /photos 目录下所有 JPG 图片转换为 PNG，品质 95
Claude: [自动执行]→ for f in /photos/*.jpg; do cli-anything-gimp image convert --input "$f" --format PNG --quality 95 done✅ 转换完成！共处理 12 张图片You: 用 Blender 渲染场景，然后用 GIMP 添加水印，最后导出 PNG
Claude: [自动执行多个软件调用]→ cli-anything-blender scene render --input ./scene.blend --output ./render.png→ cli-anything-gimp image composite --base ./render.png --watermark ./logo.png --opacity 0.8→ cli-anything-gimp export file --input ./composite.png --output ./final.png --format PNG✅ 工作流完成！🔧 refine 命令 - 精修与迭代
Section titled “🔧 refine 命令 - 精修与迭代”当生成的 CLI 需要调整时，使用 refine 命令：
/cli-anything:refine ./gimp [focus]可选的 focus 参数：
[filters]- 只精修滤镜相关命令[layers]- 只精修图层相关命令[export]- 只精修导出相关命令
You: 当前 CLI 没有支持 GIF 导出，请添加这个功能
Claude: [读取现有代码]→ 精修导出模块，添加 GIF 格式支持✅ 已添加 GIF 导出功能！🛠️ 其他可用命令
Section titled “🛠️ 其他可用命令”测试生成的 CLI
Section titled “测试生成的 CLI”/cli-anything:test ./gimp运行 CLI 内置的测试套件。
验证 CLI 功能
Section titled “验证 CLI 功能”/cli-anything:validate ./gimp验证 CLI 的基本功能是否正常。
列出已生成的 CLI
Section titled “列出已生成的 CLI”/cli-anything:list列出所有已安装和生成的 CLI。
🐛 故障排除
Section titled “🐛 故障排除”问题：显示 “Unknown skill: cli-anything”
Section titled “问题：显示 “Unknown skill: cli-anything””原因：插件未正确加载
解决：
# 重新加载插件/plugin reload
# 或者手动安装/plugin install cli-anything --force问题：legacy 条目形式（旧版语法）
Section titled “问题：legacy 条目形式（旧版语法）”如果看到旧版的调用方式：
/agents cli-anything ./gimp解决：升级到最新版本，新版语法是：
/cli-anything ./gimpWindows 注意事项
Section titled “Windows 注意事项”Windows 用户必须安装以下之一：
- Git for Windows（推荐，最简单）
- WSL（Windows Subsystem for Linux）
安装 Git for Windows 时，确保勾选 “Git PATH” 选项。
macOS 注意事项
Section titled “macOS 注意事项”macOS 用户可能需要授予辅助功能权限：
- 系统设置 → 隐私与安全性 → 辅助功能
- 添加 Claude Code 到允许列表