VibeComfy：让 Claude Code 理解并编辑 ComfyUI 工作流的 CLI 工具集

VibeComfy 是一套专为 Claude Code（或其他 LLM 智能体）设计的命令行工具，用于解析、分析、修改 ComfyUI 工作流 JSON 文件。它的目标很明确：降低 AI 智能体与 ComfyUI 之间的交互门槛，让大模型真正成为你的工作流协作者。

GitHub：https://github.com/peteromallet/VibeComfy

为什么需要 VibeComfy？

ComfyUI 的强大源于其节点式工作流，但其底层 .json 文件对人类和 AI 都极不友好：

节点 ID 为随机数字，难以追踪连接关系
缺乏语义结构，LLM 容易误解节点功能
手动编辑易出错，调试成本高

VibeComfy 通过提供结构化 CLI 命令，将复杂 JSON 操作转化为自然语言可理解的原子动作，使 Claude Code 能安全、准确地：

理解工作流逻辑
修改节点配置
调试执行问题

核心能力

工作流分析

info：解析工作流，列出所有节点类型与连接
trace <node_id>：追踪从指定节点到输出的完整路径
find sampler：查找所有采样器节点及其参数

安全编辑

复制上采样链并重连输出
修改模型加载器路径
删除冗余节点并自动重连

日志集成

自动读取 comfyui.log
将错误信息反馈给 Claude，辅助定位问题
支持基于日志的自动修复建议

智能体协同

内置 CLAUDE.md 指令文件，指导 Claude 如何调用工具
所有操作通过 CLI 封装，避免直接操作原始 JSON
支持批处理脚本，实现复杂重构

快速开始

1. 配置环境

cp .env.example .env
# 编辑 .env，设置 COMFY_PATH=/your/ComfyUI/path

2. 启动带日志的 ComfyUI

cd /your/ComfyUI/path
python main.py 2>&1 | tee comfyui.log

3. 放置工作流

将 .json 文件放入 VibeComfy/workflows/ 目录。

4. 启动 Claude Code

cd VibeComfy
claude --dangerously-skip-permissions

5. 自然语言指令示例

“分析最近的工作流并解释它的功能”
“找到所有的采样器节点并显示它们的设置”
“复制上采样链并将其连接到第二个输出”
“追踪从视频加载器到最终输出的路径”

手动 CLI 使用（无需智能体）

# 查看工作流结构
python we_vibin.py info workflows/my_workflow.json

# 追踪节点 577 的输出路径
python we_vibin.py trace workflows/my_workflow.json 577

# 获取帮助
python we_vibin.py --help

项目结构

VibeComfy/
├── we_vibin.py        # CLI 入口
├── cli_tools/
│   ├── workflow.py    # JSON I/O 与基础工具
│   ├── analysis.py    # 路径追踪、节点分析
│   ├── editing.py     # 安全编辑操作（复制/连接/删除）
│   └── batch.py       # 批处理支持
└── workflows/         # 用户工作流存放目录

开发者自述

“我已经变得非常‘智能体思维’——如果没有 AI 中介，我甚至难以直接操作 ComfyUI。
VibeComfy 的目标不是取代用户，而是让智能体成为你与 Comfy 之间的翻译官。
当 Claude 能安全地调用 trace 或 edit 命令时，工作流开发就从‘调试地狱’变成了‘对话协作’。”