批量产品图
comfy-fragments为 ./skus.csv 里的每个 SKU 运行我们的产品图工作流，每个 4 个角度，路由到云端，全部下载到 ./shots。
为 ./skus.csv 里的每个 SKU 运行我们的产品图工作流，每个 4 个角度，路由到云端，全部下载到 ./shots。
快速开始
配置 Comfy CLI
一次安装，两种运行方式：Comfy Cloud 的 GPU，或你自己机器上的 ComfyUI。 把一条提示粘贴给你的编程智能体，或亲自运行这些命令。
云端运行消耗 Comfy 积分。添加积分，或使用现有的Comfy Cloud 订阅。浏览模板、模型和节点只需一个 Comfy 账户，完全免费。
安装 CLI
从 PyPI 安装（也支持 Homebrew），然后配置云端连接。它会打开浏览器完成登录。
pip install comfy-cli
想手动完成？在上面的安装之后运行：
comfy setup --where cloud
comfy skills install
让 Claude Code 为你配置
把这段粘贴进 Claude Code。它会安装 CLI、运行 setup、完成登录并添加自带技能。
帮我配置 Comfy CLI：pip install comfy-cli，然后 comfy setup --where cloud，再 comfy skills install。请按照 https://docs.comfy.org/agent-tools/cli.md 的指南操作，完成后告诉我。
comfy generate 处于测试阶段：参数名、模型别名和输出格式可能变化。底层合作伙伴端点是稳定的。
所有命令和参数详见命令参考。
一次真实会话，从头到尾。
面向 Comfy Cloud 一镜到底：一次合作伙伴模型生成、一次云端 GPU 工作流运行，以及自带技能。只剪掉了等待的秒数，输出原样保留。
视频文字稿：comfy setup 将 CLI 连接到 Comfy Cloud。comfy generate 用合作伙伴模型渲染提示词并保存 cat.png。comfy run 将工作流提交到云端 GPU，comfy jobs wait 跟踪任务，comfy download 将结果保存为 f5308bc5_000.png。comfy skills list 打印自带技能列表。会话最终保存两个文件：cat.png 和 f5308bc5_000.png。
智能体技能
你的智能体已经掌握的技能。
一条命令安装五个自带技能，让 Claude Code、Cursor 和任何支持 AGENTS.md 的工具掌握整个 CLI。下面是六个生产简报，每条提示都可以直接粘贴。
comfy skills install
自带技能
- comfy在终端中使用工作流、模型与生成
- comfy-fragments用类型化片段和 YAML 配方组装大型工作流
- comfy-debug从失败的运行快速定位到修复
- comfy-relay把每个工作流产物呈现在对话里
- comfy-director多镜头叙事视频导演
关键帧分镜
comfy-director根据 BRIEF.md 为一支 30 秒广告做分镜：8 张关键帧，主角保持一致，16:9，最后输出联览表。
根据 BRIEF.md 为一支 30 秒广告做分镜：8 张关键帧，主角保持一致，16:9，最后输出联览表。
角色设定表
comfy加载我们保存的角色工作流，为 ./characters 中的每个主角生成 4 视图转面。
加载我们保存的角色工作流，为 ./characters 中的每个主角生成 4 视图转面。
场景扩展
comfy把这张底板扩展到 21:9，接景绘制风格。保持地平线和光线方向。
把这张底板扩展到 21:9，接景绘制风格。保持地平线和光线方向。
3D 主道具
comfy根据 sketch.png 制作一个可直接用于游戏的 3D 主道具，输出 .glb 给我。
根据 sketch.png 制作一个可直接用于游戏的 3D 主道具，输出 .glb 给我。
营销主视觉
comfy匹配 frame_04.png 的配色，产出 1:1、4:5 和 16:9 三种比例的营销主视觉。
匹配 frame_04.png 的配色，产出 1:1、4:5 和 16:9 三种比例的营销主视觉。
更多智能体技能见Comfy Skills 仓库。
智能体契约
为智能体而造， 不是事后适配。
契约就写在 CLI 里。没有包装层，也不用猜。
--json
结构化输出
每条命令都接受 --json，并返回统一的信封结构：ok、data、error，以及智能体可以直接执行的 hint。任何能读 JSON 的工具都能接上。
comfy --json discover
自描述
一次调用输出完整的命令树、输出模式和错误码。智能体读取契约，而不是靠猜参数。
comfy run --workflow
真实工作流图
不是一次性端点。一次运行就是一份工作流 JSON，智能体可以编辑、校验、重跑、交给队友。同一张图也能在 ComfyUI 画布上打开。
为什么选择 Comfy CLI？
Comfy MCP 的终端搭档：同一个引擎、同一个账户，脚本化。
端到端 开源。
comfy-cli 是开源的，它驱动的引擎也是。从 PyPI 安装，需要时直接读源码，永远不必建在黑盒上。
完整引擎， 非沙箱环境。
多步骤工作流图、数千个社区节点，以及通过同一套命令调用的合作伙伴模型。这是创作引擎，不是托管端点的菜单。
为可复现性 而设计。
一次运行就是一个工作流文件加一个种子。提交进 git，在评审中 diff，在 CI 里重放，每次得到相同输出。
你的 GPU， 或我们的。
每条命令自动判断运行位置：登录后任务路由到 Comfy Cloud 的 GPU，否则运行在你机器上的 ComfyUI。用 --where 可按次覆盖。
与 MCP 并肩工作。
配置 Comfy MCP一个账户，两个入口。对话用 Comfy MCP，脚本用 CLI，让智能体按任务选择。无论哪种方式，云端输出都进入同一个资产库。
工作原理
01
安装
pip install comfy-cli，然后 comfy setup。用 OAuth 登录即可使用云端 GPU，comfy skills install 教会你的智能体其余一切。
02
发现
comfy --json discover 把完整命令树交给智能体；模板、模型和节点一次搜索即达。
03
创作
提交运行、等待任务、下载输出。或者把三步串成一行。
产品
完全掌控的 AI 创作引擎
掌控每个模型、每个节点、每个步骤、每个输出。