Comfy Pilot

舒适飞行员

  

与您的ComfyUI工作流程交谈。Comfy Pilot为Claude Code提供了直接访问权限，可以查看、编辑和运行您的工作流——ComfyUI内部有一个嵌入式终端。

Comfy Pilot

为什么？

构建ComfyUI工作流意味着手动搜索节点、拖动连接和一次调整一个值。使用Comfy Pilot，您只需描述您想要的内容：

• *“使用ControlNet为我构建SDXL工作流”* --Claude创建所有节点，连接它们并设置参数
• *“查看输出并增加细节”* --Claude看到您生成的图像并调整工作流程
• *“下载FLUX schnell模型并为其设置工作流程”* --Claude下载模型并从头开始构建工作流

不复制粘贴节点名称。没有搜索菜单。你想说什么就说什么。

安装

CLI（推荐）：

comfy node install comfy-pilot

ComfyUI管理器：

1. 打开ComfyUI
2. 点击 经理 → 安装自定义节点
3. 搜索“舒适飞行员”
4. 点击 安装
5. 重新启动ComfyUI

Git克隆：

cd ~/Documents/ComfyUI/custom_nodes && git clone https://github.com/ConstantineB6/comfy-pilot.git

如果找不到Claude Code CLI，将自动安装。

需求

• Comfy用户界面
• Python 3.8+

特性

• MCP服务器 -允许Claude Code直接访问查看、编辑和运行您的ComfyUI工作流
• 嵌入式终端 -在ComfyUI中运行Claude Code的完整xterm.js终端
• 图像查看 -Claude可以看到预览图像和保存图像节点的输出
• 图形编辑 -以编程方式创建、删除、移动和连接节点

演示

https://github.com/user-attachments/assets/325b1194-2334-48a1-94c3-86effd1fef02

用法

1. 安装后重新启动ComfyUI
2. 浮动的Claude Code终端出现在右上角
3. MCP服务器自动配置为Claude Code
4. 请Claude帮助您完成工作流程：

- “我当前的工作流中有哪些节点？” - “添加一个连接到我的检查点加载器的KSampler节点” - “看看预览图像，告诉我你看到了什么” - “将工作流运行到节点5”

MCP工具

MCP服务器为Claude Code提供以下工具：

示例：创建节点

Create a KSampler and connect it to my checkpoint loader

克劳德将使用 edit_graph 致：

1. 创建KSampler节点
2. 将CheckpointLoader的MODEL输出连接到KSampler的模型输入
3. 将其适当地放置在图表中

示例：查看图像

Look at the preview image and describe what you see

克劳德将使用 view_image 以获取和分析图像输出。

示例：下载模型

Download the FLUX.1 schnell model for me

克劳德将使用 download_model 从Hugging Face下载到您的ComfyUI模型文件夹。支持：

• 拥抱脸（包括带令牌身份验证的门控模型）
• CivitAI
• 直接下载网址

终端控制

• 拖拽 要移动的标题栏
• 拖拽 右下角调整大小
• − 最小化
• × 关闭
• ↻ 重新连接会话

建筑

┌─────────────────────────────────────────────────────┐
│  Browser (ComfyUI)                                  │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  xterm.js       │  │  Workflow State          │  │
│  │  Terminal       │  │  (synced to backend)     │  │
│  └────────┬────────┘  └────────────┬─────────────┘  │
│           │ WebSocket              │ REST API       │
└───────────┼────────────────────────┼────────────────┘
            │                        │
            ▼                        ▼
┌─────────────────────────────────────────────────────┐
│  ComfyUI Server                                     │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  PTY Process    │  │  Plugin Endpoints        │  │
│  │  (claude CLI)   │  │  /claude-code/*          │  │
│  └─────────────────┘  └──────────────────────────┘  │
└─────────────────────────────────────────────────────┘
            │                        │
            │                        ▼
            │           ┌──────────────────────────┐
            └──────────▶│  MCP Server              │
                        │  (stdio transport)       │
                        └──────────────────────────┘

文件

• __init__.py -插件后端：WebSocket终端、REST端点
• js/claude-code.js -前端：xterm.js终端，工作流同步
• mcp_server.py -用于Claude Code集成的MCP服务器
• CLAUDE.md -Claude使用ComfyUI时的说明

故障排除

“未找到命令‘claude’”

安装Claude Code命令行界面：

macOS/Linux/WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

Windows（CMD）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

MCP服务器未连接

该插件在启动时自动配置MCP。检查ComfyUI控制台是否有错误，或手动添加到 ~/.claude.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "python3",
      "args": ["/path/to/comfy-pilot/mcp_server.py"]
    }
  }
}

终端已断开连接

点击↻ 按钮重新连接，或检查ComfyUI控制台是否有错误。

许可证

麻省理工学院