跳转到主要内容
comfy-cli 是 Comfy 的命令行工具。与 MCP 服务器 一起,它为代理和开发者提供了另一种从 UI 外部驱动 Comfy 的方式。 用于终端或脚本访问:批处理任务、CI 流水线、工作流自动化,以及通过捆绑的 CLI 技能与编码代理配对。
代理快速参考。 本页是精简概览:足以与 MCP 配合使用并运行常见的 comfy generate 调用。如需完整的 CLI 文档(本地安装、comfy setupcomfy run、模板、工作流编辑、节点/模型发现等),请参阅 Comfy CLI 入门
comfy generate 处于测试阶段。 标志名称、模型别名和输出格式可能会更改。底层的合作伙伴端点保持稳定。请在 comfy-cli GitHub 仓库 提交反馈。

如何与 MCP 配合使用

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

CLI 能做什么

  1. 本地 ComfyUI — 安装、启动、更新和管理自定义节点
  2. 合作伙伴生成comfy generate 用于一次性图像/视频/音频/3D 合作伙伴 API 调用
  3. 云端工作流comfy run、模板、插槽编辑和 Comfy Cloud 上的任务监控
两个环境,一个 CLI。 每条指令会自动检测运行位置。如果您已登录 Comfy Cloud,指令将路由到云端;否则在本地服务器上执行。每次调用可通过 --where local|cloud 覆盖,或使用 COMFY_WHERE 环境变量,或用 comfy set-default --where cloud 持久化设置。

安装和设置

获取 shell 自动补全提示:
在 CI 或脚本中传递 -y 以进行非交互式安装。有关完整的 comfy setup 标志表,请参阅 Comfy CLI 入门 登录 Comfy Cloud:

comfy generate 的前提条件

首次生成

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

可用模型

comfy generate 涵盖图像和视频合作伙伴模型。发现你的 CLI 版本中可用的模型:
常用别名包括: 运行 comfy generate list 获取你环境中的完整列表。

使用示例

文生图

图像编辑(参考图像)

传递本地文件路径。CLI 通过 Comfy 的存储端点上传或按需进行 base64 编码:
要上传一次并在多次调用中重复使用:
上传的参考资产将在24小时后自动删除。它们存储在Comfy管理的GCS中,并使用带签名的URL。对于长期运行的pipeline,请在每次任务之前重新上传。详情请参阅reference

文生视频

视频任务是异步的。CLI 默认会阻塞并轮询:
使用 --async 立即返回,稍后恢复:

使用 JSON 编写脚本

超越 comfy generate

以上是对代理功能的总结。完整指南深入介绍了每个命令:
  • comfy runcomfy jobscomfy validate 用于完整工作流
  • comfy templatescomfy workflow 插槽编辑
  • comfy nodes / comfy models 发现
  • --json 输出包以及用于代理的 comfy --json discover
Comfy CLI 入门(完整文档)

代理技能

将捆绑的Comfy代理技能安装到Claude Code、Cursor以及任何支持AGENTS.md的工具中,让你的编码代理可以直接驱动CLI:
这些是通过 comfy skills install 安装的捆绑版CLI技能。它们与 Comfy Skills 仓库是分开的,后者托管了 comfy-cloud Claude Code 插件,用于 Comfy Cloud MCP

相关资源

反馈