> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy CLI

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

[comfy-cli](https://github.com/Comfy-Org/comfy-cli) はComfyのコマンドラインツールです。[MCPサーバー](/ja/agent-tools)と並んで、エージェントや開発者にUI外からComfyを操作するもう一つの方法を提供します。

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

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

<Info>
  **`comfy generate` はベータ版です。** フラグ名、モデルエイリアス、出力形式が変更される可能性があります。基礎となるパートナーエンドポイントは安定しています。フィードバックは [comfy-cli GitHub リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues) にお寄せください。
</Info>

## 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](/ja/agent-tools/cloud) を参照してください。

## CLIの機能

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

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

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

<CodeGroup>
  ```bash pip theme={null}
  pip install comfy-cli
  ```

  ```bash homebrew theme={null}
  brew tap Comfy-Org/comfy-cli
  brew install comfy-org/comfy-cli/comfy-cli
  ```
</CodeGroup>

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

```bash theme={null}
comfy --install-completion
```

```bash theme={null}
comfy setup
```

CIやスクリプトでの非対話型インストールには `-y` を渡します。完全な `comfy setup` フラグテーブルについては [Comfy CLI はじめに](/ja/comfy-cli/getting-started#quick-setup-recommended) を参照してください。

Comfy Cloudにログイン:

```bash theme={null}
comfy cloud login
comfy cloud whoami
```

## `comfy generate` の前提条件

* `comfy cloud login` によるアクティブな Comfy Cloud セッション（ブラウザ OAuth）、**または** ヘッドレスや CI での使用のための [Comfy APIキー](/ja/development/api-development/getting-an-api-key)（`--api-key` / `COMFY_API_KEY`）
* アカウントに [クレジット](/ja/interface/credits) があること
* *オプション:* [パートナーノードと呼び出しごとの価格をブラウズ](/ja/tutorials/partner-nodes/pricing)

## 最初の生成

```bash theme={null}
comfy generate flux-pro \
    --prompt "a cat on the moon, cinematic lighting" \
    --width 1024 --height 1024 \
    --download cat.png
```

CLIはローカルファイルをアップロードし、ジョブを送信し、完了をポーリングし、結果を保存します。

## 利用可能なモデル

`comfy generate` は画像および動画のパートナーモデルをカバーします。お使いのCLIバージョンで利用可能なモデルを確認:

```bash theme={null}
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` を実行して、お使いの環境の全セットを確認してください。

## 使用例

### テキストから画像へ

```bash theme={null}
comfy generate nano-banana \
    --prompt "a watercolor of a sleeping fox" \
    --download fox.png
```

### 画像編集（参照画像）

ローカルファイルパスを渡します。CLIは、Comfyのストレージエンドポイントを介してアップロードするか、必要に応じてbase64エンコードします。

```bash theme={null}
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回アップロードして、複数の呼び出しで再利用するには：

```bash theme={null}
comfy generate upload ./photo.jpg     # prints a signed URL
```

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

### テキストから動画へ

ビデオジョブは非同期です。CLIはデフォルトでブロッキングしてポーリングします：

```bash theme={null}
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` で即座に戻り、後で再開します：

```bash theme={null}
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でのスクリプティング

```bash theme={null}
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 はじめに](/ja/comfy-cli/getting-started)（完全なドキュメント）

## エージェントスキル

インストール済みのComfyエージェントスキルをClaude Code、Cursor、およびAGENTS.md対応ツールにインストールすると、コーディングエージェントがCLIを直接操作できるようになります：

```bash theme={null}
comfy skills install
comfy skills list      # comfy, comfy-fragments, comfy-debug, comfy-relay, comfy-director
comfy skills status    # what's installed where
```

<Note>
  これらは `comfy skills install` でインストールされる**バンドル済みCLIスキル**です。[Comfy Skills](https://github.com/Comfy-Org/comfy-skills/) リポジトリ（[Comfy Cloud MCP](/ja/agent-tools/cloud) 用の **comfy-cloud** Claude Codeプラグインをホスト）とは別のものです。
</Note>

## 関連リソース

| リソース                                                         | 用途                         |
| ------------------------------------------------------------ | -------------------------- |
| [Comfy CLI はじめに](/ja/comfy-cli/getting-started)              | 完全なインストールガイドとコマンドの解説       |
| [Comfy CLI リファレンス](/ja/comfy-cli/reference)                  | コマンド、フラグ、モデルエイリアス          |
| [Comfy Cloud MCP](/ja/agent-tools/cloud)                     | MCP経由でエージェントを接続し、チャット駆動の生成 |
| [GitHub の comfy-cli](https://github.com/Comfy-Org/comfy-cli) | ソースリポジトリ、Issue、最新の動作       |

## フィードバック

* **GitHub**: [comfy-cli issues](https://github.com/Comfy-Org/comfy-cli/issues)
* **Discord**: [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R)