Comfy CLI

ターミナルからComfyを操作：ローカルComfyUI、パートナー生成呼び出し、Comfy Cloud上の完全なワークフロー。スクリプト、CI、自動化でMCPを補完します。

comfy-cli はComfyのコマンドラインツールです。MCPサーバーと並んで、エージェントや開発者にUI外からComfyを操作するもう一つの方法を提供します。

ターミナルまたはスクリプトからアクセスする場合に使用します。バッチジョブ、CIパイプライン、ワークフローの自動化、バンドルされたCLIスキルを介したコーディングエージェントとの連携に最適です。

エージェント向けクイックリファレンス。 このページは簡略化された概要です。MCPと共に方向性を掴み、一般的な comfy generate 呼び出しを実行するのに十分な内容です。完全なCLIドキュメント（ローカルインストール、comfy setup、comfy run、テンプレート、ワークフロー編集、ノード/モデルの発見など）については、Comfy CLI はじめにを参照してください。

comfy generate はベータ版です。 フラグ名、モデルエイリアス、出力形式が変更される可能性があります。基礎となるパートナーエンドポイントは安定しています。フィードバックは comfy-cli GitHub リポジトリ にお寄せください。

MCPとの連携

	Comfy Cloud MCP	Comfy CLI
インターフェース	MCPクライアント（Claude Code、Claude Desktopなど）とのチャット	ターミナルコマンドとスクリプト
最適な用途	チャットでの対話的なエージェントワークフロー	自動化、バッチ実行、CI、シェルパイプライン
認証	MCPクライアントのOAuth、またはAPIキー（ヘッドレス）	comfy cloud login（OAuth）またはAPIキー（CI）
出力	チャットセッション内に返される	ディスクに保存（--download）またはJSON（--json）

MCPのセットアップ、インストール、ツール一覧、認証方法については、Comfy Cloud MCP を参照してください。

CLIの機能

1. ローカルComfyUI — インストール、起動、更新、カスタムノードの管理
2. パートナー生成 — comfy generate で画像・動画・オーディオ・3DパートナーAPIをワンショットで呼び出し
3. クラウドワークフロー — comfy run、テンプレート、スロット編集、Comfy Cloudでのジョブ監視

2つのサーフェス、1つのCLI。 すべてのコマンドは自動的に実行場所を検出します。Comfy Cloud にサインインしている場合、コマンドは クラウド にルーティングされます。それ以外の場合は、ローカル サーバーに対して実行されます。コールごとに --where local|cloud や COMFY_WHERE 環境変数で上書きするか、comfy set-default --where cloud で永続化できます。

インストールとセットアップ

pip

pip install comfy-cli

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

シェルの自動補完を有効にするには、以下のコマンドを実行します：

comfy --install-completion

comfy setup

CIやスクリプトでの非対話型インストールには -y を渡します。完全な comfy setup フラグテーブルについては Comfy CLI はじめに を参照してください。

Comfy Cloudにログイン:

comfy cloud login
comfy cloud whoami

comfy generate の前提条件

• comfy cloud login によるアクティブな Comfy Cloud セッション（ブラウザ OAuth）、または ヘッドレスや 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             # 1つのモデルのパラメータ

一般的なエイリアス:

カテゴリ	例
画像	flux-pro, flux-ultra, flux-kontext, nano-banana, grok, grok-edit, ideogram-edit, dalle, recraft, stability
動画	seedance, kling, luma, runway, pika, vidu, hailuo, moonvalley, grok-video

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

1回アップロードして、複数の呼び出しで再利用するには：

comfy generate upload ./photo.jpg     # prints a signed URL

アップロードされた参照アセットは24時間後に自動削除されます。これらは署名付きURLを使用してComfy管理のGCSに保存されます。長時間実行されるパイプラインの場合は、各ジョブの前に再アップロードしてください。詳細についてはリファレンスを参照してください。

テキストから動画へ

ビデオジョブは非同期です。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
# ジョブIDが表示されます。後で再開：
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    # what's installed where

これらは comfy skills install でインストールされるバンドル済みCLIスキルです。Comfy Skills リポジトリ（Comfy Cloud MCP 用の comfy-cloud Claude Codeプラグインをホスト）とは別のものです。

関連リソース

リソース	用途
Comfy CLI はじめに	完全なインストールガイドとコマンドの解説
Comfy CLI リファレンス	コマンド、フラグ、モデルエイリアス
Comfy Cloud MCP	MCP経由でエージェントを接続し、チャット駆動の生成
GitHub の comfy-cli	ソースリポジトリ、Issue、最新の動作

フィードバック

• GitHub: comfy-cli issues
• Discord: #comfy-mcp-and-cli