メインコンテンツへスキップ
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 MCPComfy 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 install comfy-cli
シェルの自動補完を有効にするには、以下のコマンドを実行します： 
comfy --install-completion

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

​
comfy generate の前提条件

​
最初の生成

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 MCPMCP経由でエージェントを接続し、チャット駆動の生成
GitHub の comfy-cliソースリポジトリ、Issue、最新の動作

​
フィードバック