舒适飞行员
  
与您的ComfyUI工作流程交谈。Comfy Pilot为Claude Code提供了直接访问权限，可以查看、编辑和运行您的工作流——ComfyUI内部有一个嵌入式终端。
为什么？
构建ComfyUI工作流意味着手动搜索节点、拖动连接和一次调整一个值。使用Comfy Pilot，您只需描述您想要的内容：
- *“使用ControlNet为我构建SDXL工作流”* --Claude创建所有节点，连接它们并设置参数
- *“查看输出并增加细节”* --Claude看到您生成的图像并调整工作流程
- *“下载FLUX schnell模型并为其设置工作流程”* --Claude下载模型并从头开始构建工作流
不复制粘贴节点名称。没有搜索菜单。你想说什么就说什么。
安装
CLI（推荐）：
comfy node install comfy-pilotComfyUI管理器：
- 打开ComfyUI
- 点击 经理 → 安装自定义节点
- 搜索“舒适飞行员”
- 点击 安装
- 重新启动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
用法
- 安装后重新启动ComfyUI
- 浮动的Claude Code终端出现在右上角
- MCP服务器自动配置为Claude Code
- 请Claude帮助您完成工作流程：
- “我当前的工作流中有哪些节点？” - “添加一个连接到我的检查点加载器的KSampler节点” - “看看预览图像，告诉我你看到了什么” - “将工作流运行到节点5”
MCP工具
MCP服务器为Claude Code提供以下工具：
| 工具 | 说明 |
|---|---|
get_workflow | 从浏览器获取当前工作流 |
summarize_workflow | 人类可读的工作流程摘要 |
get_node_types | 使用筛选搜索可用节点类型 |
get_node_info | 获取特定节点类型的详细信息 |
get_status | 队列状态、系统统计信息和执行历史记录 |
run | 运行工作流（可选择运行到特定节点）或中断 |
edit_graph | 批量创建、删除、移动、连接和配置节点 |
view_image | 从“预览图像”/“保存图像”节点查看图像 |
search_custom_nodes | 在ComfyUI管理器注册表中搜索自定义节点 |
install_custom_node | 从注册表安装自定义节点 |
uninstall_custom_node | 卸载自定义节点 |
update_custom_node | 将自定义节点更新到最新版本 |
download_model | 从Hugging Face、CivitAI或直接URL下载模型 |
示例：创建节点
Create a KSampler and connect it to my checkpoint loader克劳德将使用 edit_graph 致：
- 创建KSampler节点
- 将CheckpointLoader的MODEL输出连接到KSampler的模型输入
- 将其适当地放置在图表中
示例：查看图像
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 | bashWindows（PowerShell）：
irm https://claude.ai/install.ps1 | iexWindows（CMD）：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdMCP服务器未连接
该插件在启动时自动配置MCP。检查ComfyUI控制台是否有错误，或手动添加到 ~/.claude.json:
{
"mcpServers": {
"comfyui": {
"command": "python3",
"args": ["/path/to/comfy-pilot/mcp_server.py"]
}
}
}终端已断开连接
点击↻ 按钮重新连接，或检查ComfyUI控制台是否有错误。
许可证
麻省理工学院