用途
Comfy Pilot 旨在让用户通过自然语言与 ComfyUI 工作流交互。它提供 MCP 服务器与嵌入式终端，使 Claude Code 能够直接访问、查看、编辑和运行 ComfyUI 工作流，从而减少手动搜索节点、拖拽连线和逐个调整参数的操作。
主要能力
- MCP 服务器：为 Claude Code 提供直接查看、编辑和运行 ComfyUI 工作流的访问能力。
- 嵌入式终端：在 ComfyUI 界面内运行完整的 xterm.js 终端，并启动 Claude Code。
- 图像查看：Claude 可查看“预览图像”（Preview Image）和“保存图像”（Save Image）节点的输出。
- 图编辑：可通过程序化方式创建、删除、移动和连接节点。
- 模型下载：通过 download_model 从 Hugging Face（包括需令牌认证的门控模型）或直接下载 URL 下载模型到 ComfyUI 模型文件夹。
使用方式
- 安装（推荐使用 CLI）：通过 ComfyUI Manager 安装——点击 Manager → Install Custom Nodes → 搜索 “Comfy Pilot” → 重启 ComfyUI。若未找到 Claude Code CLI，将自动安装。
- 重启 ComfyUI 后，右上角会出现浮动的 Claude Code 终端，MCP 服务器会自动为 Claude Code 配置。
- 向 Claude 提出工作流相关请求，例如：
- "What nodes are in my current workflow?"
- "Add a KSampler node connected to my checkpoint loader"
- "Look at the preview image and tell me what you see"
- "Run the workflow up to node 5"
- "Build me an SDXL workflow with ControlNet"
- "Look at the output and increase the detail"
- "Download the FLUX schnell model and set up a workflow for it"
终端控制
- 拖动标题栏移动终端
- 拖动右下角调整终端大小
- 点击 ↻ 按钮重新连接会话
主要文件
__init__.py：插件后端，包含 WebSocket 终端与 REST 端点js/claude-code.js：前端，包含 xterm.js 终端与工作流同步mcp_server.py：用于 Claude Code 集成的 MCP 服务器CLAUDE.md：Claude 处理 ComfyUI 时的操作说明
故障排除
- “Command 'claude' not found”：需安装 Claude Code CLI。macOS / Linux / WSL 与 Windows (PowerShell) 的安装命令在原文中未提供具体代码内容。
- MCP 服务器未连接：插件启动时会自动配置 MCP；可检查 ComfyUI 控制台错误，或手动添加至
~/.claude.json。 - 终端断开：点击 ↻ 按钮重新连接，或检查 ComfyUI 控制台错误。
适用场景与限制
适用于希望通过自然语言快速构建、调整和运行 ComfyUI 工作流的用户，尤其是使用 Claude Code 的场景。资料未提供关于收费、价格、平台支持范围、性能效果等更多细节，暂未提供。
