--- title: "Comfy CLI - 在终端和任何编程智能体中驱动 ComfyUI" description: "完整 ComfyUI 引擎的命令行。在 Claude Code、Codex、Cursor 或任意 shell 中生成图像、视频、音频和 3D，在 Comfy Cloud 上运行，或就在你自己的 GPU 上。" canonical: https://comfy.org/zh-CN/cli/ lang: zh-CN index: https://comfy.org/llms.txt --- CLI # 在你的终端 驱动 ComfyUI。 也交给你的智能体。 一个 CLI 驱动完整引擎：生成图像、视频、音频和 3D，运行真实的工作流图，把每个输出接进你需要的地方。为编程智能体、CI 任务和每个用终端的人而造。 安装 CLI [查看文档](https://docs.comfy.org/agent-tools/cli) comfy — zsh $ 适用于 Claude Code Codex Cursor Gemini CLI OpenClaw Hermes 任意终端 快速开始 ## 配置 Comfy CLI 一次安装，两种运行方式：Comfy Cloud 的 GPU，或你自己机器上的 ComfyUI。 把一条提示粘贴给你的编程智能体，或亲自运行这些命令。 云端运行消耗 Comfy 积分。添加积分，或使用现有的 [Comfy Cloud 订阅](https://comfy.org/zh-CN/pricing)。浏览模板、模型和节点只需一个 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 处于测试阶段：参数名、模型别名和输出格式可能变化。底层合作伙伴端点是稳定的。 所有命令和参数详见 [命令参考](https://docs.comfy.org/comfy-cli/reference)。 ## 一次真实会话，从头到尾。 面向 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-fragments 为 ./skus.csv 里的每个 SKU 运行我们的产品图工作流，每个 4 个角度，路由到云端，全部下载到 ./shots。 为 ./skus.csv 里的每个 SKU 运行我们的产品图工作流，每个 4 个角度，路由到云端，全部下载到 ./shots。 ### 关键帧分镜 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 仓库](https://github.com/Comfy-Org/comfy-skills)。 AI 模型 ## 运行全球领先的 AI 模型 新模型发布后会第一时间上线。 [Seedance 2.5](https://comfy.org/workflows/) [MiniMax H3](https://comfy.org/workflows/) [Gemini Omni 1.1 Flash](https://comfy.org/workflows/) [Wan 3.0](https://comfy.org/workflows/) [Wan 2.2](https://comfy.org/workflows/) [GPT Image 2](https://comfy.org/workflows/) [探索工作流](https://comfy.org/workflows/) 智能体契约 ## 为智能体而造， 不是事后适配。 契约就写在 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](https://comfy.org/zh-CN/mcp) 一个账户，两个入口。对话用 Comfy MCP，脚本用 CLI，让智能体按任务选择。无论哪种方式，云端输出都进入同一个资产库。 ## 工作原理 01 ### 安装 pip install comfy-cli，然后 comfy setup。用 OAuth 登录即可使用云端 GPU，comfy skills install 教会你的智能体其余一切。 02 ### 发现 comfy --json discover 把完整命令树交给智能体；模板、模型和节点一次搜索即达。 03 ### 创作 提交运行、等待任务、下载输出。或者把三步串成一行。 安装 CLI [查看文档](https://docs.comfy.org/agent-tools/cli) 产品 ## 完全掌控的 AI 创作引擎 掌控每个模型、每个节点、每个步骤、每个输出。 [Comfy 桌面版 在您自己的硬件上运行 ComfyUI。 查看桌面版属性](https://comfy.org/zh-CN/download) [Comfy Cloud 随时随地使用 ComfyUI 的全部能力。 查看云端属性](https://comfy.org/zh-CN/cloud) [开发者 平台 部署并扩展 ComfyUI 工作流。 查看平台功能](https://comfy.org/zh-CN/platform) [Comfy 企业版 为组织内的创作引擎提供企业级基础设施。 查看企业版属性](https://comfy.org/enterprise) ## 常见问答 任何能运行 shell 命令的编程智能体。comfy skills install 为 Claude Code、Cursor 及任何支持 AGENTS.md 的工具添加自带技能，粘贴提示的配置方式同样适用于 Codex、Gemini CLI、OpenClaw、Hermes 等。人类用户：任何终端都可以，comfy --install-completion 提供补全。 两者驱动同一个引擎、共用同一个账户。Comfy MCP 适合对话中的交互式智能体工作：结果直接返回会话。CLI 适合自动化：批量运行、CI、shell 管线，输出用 --download 存盘或以 --json 输出。很多团队两个都用，让智能体按任务选择。Comfy MCP 见 [https://comfy.org/mcp](https://comfy.org/mcp)。 CLI 免费且开源。有 Comfy 账户即可免费浏览模板、模型和节点，在你自己硬件上的运行也是免费的。合作伙伴模型是例外：它们在合作伙伴的基础设施上运行，消耗 Comfy 积分。云端运行同样消耗积分，可以直接添加，也可以使用现有的 [Comfy Cloud 订阅](https://comfy.org/cloud/pricing)。 每条命令自动判断运行位置：登录 Comfy Cloud 后命令路由到云端，否则运行在你的本地服务器上。可用 --where local 或 --where cloud 按次覆盖，设置 COMFY_WHERE 环境变量，或用 comfy set-default --where cloud 固定默认值。 推荐使用浏览器 OAuth：comfy cloud login 打开登录页，CLI 会为你自动刷新令牌。API 密钥是无浏览器的 headless 与 CI 场景的备选：在 [https://platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 创建，然后设置 COMFY_API_KEY 或每次传入 --api-key。 --download 把 generate 的结果存到你指定的路径。comfy download 把一次运行的输出拉到 ./outputs/，还能直接从管道 stdin 读取 prompt ID，所以 comfy run --workflow flux.json --wait | comfy download 一行就是完整流程。云端运行的输出同时进入你的 Comfy Cloud 资产库。 是的。comfy-cli 的代码在 [https://github.com/Comfy-Org/comfy-cli](https://github.com/Comfy-Org/comfy-cli)，可通过 pip install comfy-cli 从 PyPI 安装，也支持 Homebrew。它驱动的 ComfyUI 引擎同样开源。 comfy generate 处于测试阶段：参数名、模型别名和输出格式在迭代中可能变化。底层合作伙伴端点是稳定的。欢迎在 comfy-cli 的 GitHub 仓库提交反馈。 可以，它就是为此而生。comfy setup --where cloud --api-key comfyui-... --non-interactive 无需浏览器即可配置 runner，每条命令都支持 --json 输出，comfy validate --workflow 能在消耗算力之前发现未知节点和缺失模型。 • 通过 Flux、Seedance、Kling、Ideogram 等合作伙伴模型生成图像、视频、音频和 3D • 构建、编辑、校验并运行工作流图；保存并重跑 • 批量排队、等待任务并下载全部输出 • 搜索模板、模型和节点，附带完整模式 • 用类型化片段组合多阶段工作流 运行一次 comfy skills install，自带技能会把这一切教给你的智能体。