ComfyCLI

在你的终端 驱动 ComfyUI。 也交给你的智能体。

一个 CLI 驱动完整引擎:生成图像、视频、音频和 3D,运行真实的工作流图,把每个输出接进你需要的地方。为编程智能体、CI 任务和每个用终端的人而造。

快速开始

配置 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 会话:生成猫咪、运行灯塔工作流,并展示两个已保存的输出。录制响应已精简;不会执行任何命令。

录制示例 · 不执行命令

$ comfy generate flux-pro --prompt "a cat on the moon, cinematic lighting" --width 1024 --height 1024 --download cat.png

Request accepted
Outputs: cat.png
Saved: cat.png

$ comfy templates fetch image_z_image_turbo --out zimage.json

{"schema":"envelope/1","ok":true,"command":"templates fetch","data":{"title":"Z-Image-Turbo Text to Image","out":"zimage.json","node_count":11},"error":null}

$ comfy workflow set-slot zimage.json 57.text="a lighthouse at dusk, volumetric fog, cinematic"

{"schema":"envelope/1","ok":true,"command":"workflow set-slot","data":{"workflow":"zimage.json","applied":["57.text"],"wrote":"zimage.json"},"error":null}

$ comfy run --workflow zimage.json --where cloud --wait | comfy download

{"schema":"envelope/1","ok":true,"command":"download","data":{"files":[{"path":"f5308bc5_000.png"}]},"error":null}

✓ 2 files saved

会话文字记录:comfy generate 生成猫咪并保存 cat.png。comfy templates fetch 将 image_z_image_turbo 保存为 zimage.json。comfy workflow set-slot 将提示词改为黄昏灯塔。comfy run 在云端运行工作流,comfy download 保存 f5308bc5_000.png。动画最后展示两张已保存的图片。

智能体技能

你的智能体已经掌握的技能。

一条命令安装五个自带技能,让 Claude Code、Cursor 和任何支持 AGENTS.md 的工具掌握整个 CLI。下面是六个生产简报,每条提示都可以直接粘贴。

comfy skills install

示例图片

批量产品图

为 ./skus.csv 里的每个 SKU 运行我们的产品图工作流,每个 4 个角度,路由到云端,全部下载到 ./shots。

comfy-fragments
批量产品图

关键帧分镜

根据 BRIEF.md 为一支 30 秒广告做分镜:8 张关键帧,主角保持一致,16:9,最后输出联览表。

comfy-director
关键帧分镜

角色设定表

加载我们保存的角色工作流,为 ./characters 中的每个主角生成 4 视图转面。

comfy
角色设定表

场景扩展

把这张底板扩展到 21:9,接景绘制风格。保持地平线和光线方向。

comfy
场景扩展

3D 主道具

根据 sketch.png 制作一个可直接用于游戏的 3D 主道具,输出 .glb 给我。

comfy
3D 主道具

营销主视觉

匹配 frame_04.png 的配色,产出 1:1、4:5 和 16:9 三种比例的营销主视觉。

comfy
营销主视觉
AI 模型

运行全球领先的 AI 模型

新模型发布后会第一时间上线。

探索工作流
智能体契约

为智能体而造, 不是事后适配。

契约就写在 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 创作引擎

掌控每个模型、每个节点、每个步骤、每个输出。

常见问答