Comfy CLI：从终端运行 ComfyUI

从终端驱动 Comfy：本地 ComfyUI、合作伙伴生成调用以及 Comfy Cloud 上的完整工作流。与 MCP 互补，适用于脚本、CI 和自动化。

comfy-cli 是 Comfy 的命令行工具。与 MCP 服务器 一起，它为代理和开发者提供了另一种从 UI 外部驱动 Comfy 的方式。

用于终端或脚本访问：批处理任务、CI 流水线、工作流自动化，以及通过捆绑的 CLI 技能与编码代理配对。

[!NOTE] 代理快速参考。 本页是精简概览：足以与 MCP 配合使用并运行常见的 comfy generate 调用。如需完整的 CLI 文档（本地安装、comfy setup、comfy run、模板、工作流编辑、节点/模型发现等），请参阅 Comfy CLI 入门。

[!NOTE] comfy generate 处于测试阶段。 标志名称、模型别名和输出格式可能会更改。底层的合作伙伴端点保持稳定。请在 comfy-cli GitHub 仓库 提交反馈。

如何与 MCP 配合使用

有关 MCP 设置、安装、工具列表和认证方法，请参阅 Comfy MCP。

CLI 能做什么

1. 本地 ComfyUI — 安装、启动、更新和管理自定义节点
2. 合作伙伴生成 — comfy generate 用于一次性图像/视频/音频/3D 合作伙伴 API 调用
3. 云端工作流 — comfy run、模板、插槽编辑和 Comfy Cloud 上的任务监控

[!NOTE] 两个环境，一个 CLI。 每条指令会自动检测运行位置。如果您已登录 Comfy Cloud，指令将路由到云端；否则在本地服务器上执行。每次调用可通过 --where local|cloud 覆盖，或使用 COMFY_WHERE 环境变量，或用 comfy set-default --where cloud 持久化设置。

安装和设置

pip install comfy-cli

brew tap Comfy-Org/comfy-cli
brew install comfy-org/comfy-cli/comfy-cli

获取 shell 自动补全提示：

comfy --install-completion

comfy setup

在 CI 或脚本中传递 -y 以进行非交互式安装。有关完整的 comfy setup 标志表，请参阅 Comfy CLI 入门。

登录 Comfy Cloud：

comfy cloud login
comfy cloud whoami

comfy generate 的前提条件

• 通过 comfy cloud login（浏览器 OAuth）获得活跃的 Comfy Cloud 会话，或 对于无头或 CI 使用，需要一个 Comfy API 密钥（--api-key / COMFY_API_KEY）
• 您账户上的积分
• 可选： 浏览合作节点与按次调用定价

首次生成

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

CLI 会上传本地文件，提交任务，轮询完成状态，并保存结果。

可用模型

comfy generate 涵盖图像和视频合作伙伴模型。发现你的 CLI 版本中可用的模型：

comfy generate list                            # 全部模型
comfy generate list --category text-to-video   # 筛选方式：文生视频
comfy generate list --partner kling            # 筛选方式：合作伙伴
comfy generate schema flux-kontext             # 某个模型的参数

常用别名包括：

运行 comfy generate list 获取你环境中的完整列表。

使用示例

文生图

comfy generate nano-banana \
    --prompt "a watercolor of a sleeping fox" \
    --download fox.png

图像编辑（参考图像）

传递本地文件路径。CLI 通过 Comfy 的存储端点上传或按需进行 base64 编码：

comfy generate nano-banana \
    --prompt "add a top hat" \
    --image ./cat.png \
    --download edited.png

comfy generate flux-kontext \
    --prompt "add a top hat and a monocle" \
    --input_image ./photo.jpg \
    --download out.png

comfy generate ideogram-edit \
    --image cat.png --mask mask.png \
    --prompt "add sunglasses" \
    --rendering_speed TURBO \
    --download edited.png

要上传一次并在多次调用中重复使用：

comfy generate upload ./photo.jpg     # 打印一个已签名的 URL

[!NOTE] 上传的参考资产将在24小时后自动删除。它们存储在Comfy管理的GCS中，并使用带签名的URL。对于长期运行的pipeline，请在每次任务之前重新上传。详情请参阅reference。

文生视频

视频任务是异步的。CLI 默认会阻塞并轮询：

comfy generate seedance \
    --prompt "a hummingbird hovering over a flower" \
    --resolution 1080p --duration 5 \
    --download hummingbird.mp4

comfy generate kling \
    --prompt "a paper boat drifting on a river at dusk" \
    --duration 5 \
    --download boat.mp4

使用 --async 立即返回，稍后恢复：

comfy generate luma --prompt "neon koi swimming through clouds" --aspect_ratio 16:9 --async
# prints a job id; resume with:
comfy generate resume luma <job_id> --download out.mp4

使用 JSON 编写脚本

comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'

超越 comfy generate

以上是对代理功能的总结。完整指南深入介绍了每个命令：

• comfy run、comfy jobs 和 comfy validate 用于完整工作流
• comfy templates 和 comfy workflow 插槽编辑
• comfy nodes / comfy models 发现
• --json 输出包以及用于代理的 comfy --json discover

→ Comfy CLI 入门（完整文档）

代理技能

将捆绑的Comfy代理技能安装到Claude Code、Cursor以及任何支持AGENTS.md的工具中，让你的编码代理可以直接驱动CLI：

comfy skills install
comfy skills list      # comfy, comfy-fragments, comfy-debug, comfy-relay, comfy-director
comfy skills status    # 查看各工具中已安装的技能

[!NOTE] 这些是通过 comfy skills install 安装的捆绑版CLI技能。它们与 Comfy Skills 仓库是分开的，后者托管了 comfy-cloud Claude Code 插件，用于 Comfy Cloud MCP。

相关资源

反馈

• GitHub：comfy-cli 问题
• Discord：#comfy-mcp-and-cli