> ## 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-cli` は、Comfy のインストールと管理を効率化し、ローカルまたはクラウド上で ComfyUI エコシステム全体にスクリプト可能な単一コマンドでアクセスできる[コマンドラインツール](https://github.com/Comfy-Org/comfy-cli)です。

主な機能は3つです。

1. **ローカルの ComfyUI インストールを管理** — ComfyUI とカスタムノードのインストール、起動、更新、スナップショット、bisect を行います。
2. **ホスト型パートナーノードにアクセス** — Seedance、Nano Banana（Gemini）、Grok、Flux、Ideogram、DALL·E、Recraft、Stability、Kling、Luma、Runway、Pika、Vidu、Hailuo、Moonvalley などのプロバイダーから画像、動画、音声、3D を単一コマンドで生成します。
3. **Comfy Cloud で完全なワークフローを実行** — ワークフローグラフの送信、厳選されたテンプレートギャラリーのブラウズ、スロット編集によるワークフローの編集、ジョブの完了までの監視を、ローカル GPU なしで行います。

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

## CLIのインストール

<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
```

## クイックセットアップ（推奨）

最新バージョンでの新機能: ルーティング、認証、エージェントスキルを1つのステップで処理する対話型ウィザードが追加されました。

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

このウィザードでは、ルーティング先（ローカルまたはクラウド）の選択、**ブラウザ経由のサインイン（OAuth）**、プロジェクトディレクトリの選択、そしてオプションでエージェントスキルのインストールを順に行います。推奨される方法です。ブラウザのサインインを自動で開くため、キーをコピーする必要はありません。

```bash theme={null}
comfy setup --where cloud
```

<Note>
  **非対話型（CIのみ）。** ブラウザOAuthには対話型セッションが必要です。CI、devcontainers、スクリプト化されたインストールなどブラウザが利用できない環境では、代わりにAPIキーを渡してください:

  ```bash theme={null}
  comfy setup --where cloud --api-key comfyui-... --non-interactive
  ```
</Note>

| フラグ                     | 目的                                                            |
| ----------------------- | ------------------------------------------------------------- |
| `--where local\|cloud`  | ルーティング先。プロンプトをスキップ                                            |
| `--project-dir`         | ワークフロー、入力、出力用のディレクトリ                                          |
| `--api-key`             | *(オプション)* ヘッドレス/CI用のComfy Cloud APIキー。`--where cloud` を暗黙的に指定 |
| `-y, --non-interactive` | プロンプトなし。すべての設定をフラグで指定                                         |
| `--skip-skills`         | エージェントスキルをインストールしない                                           |
| `--skip-verify`         | 接続確認をスキップ                                                     |

## ComfyUI（ローカル）のインストール

Python 3.9 よりも新しい任意のバージョンを使用して仮想環境を作成します。

<CodeGroup>
  ```bash conda theme={null}
  conda create -n comfy-env python=3.11
  conda activate comfy-env
  ```

  ```bash venv theme={null}
  python3 -m venv comfy-env
  source comfy-env/bin/activate
  ```
</CodeGroup>

ComfyUI のインストール

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

<Warning>GPU に応じて、CUDA または ROCm のインストールが必要です。</Warning>

## ComfyUIを実行する（ローカル）

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

バックグラウンドで実行し、後で停止する：

```bash theme={null}
comfy launch --background
comfy stop
```

どのワークスペースが選択済みで、何がインストール済みかを確認する：

```bash theme={null}
comfy which
comfy env
```

## Comfy Cloud

Run workflows and partner nodes on Comfy's hosted GPUs. No local install required.

```bash theme={null}
comfy cloud login          # browser OAuth + PKCE
comfy cloud whoami         # show sign-in status, auth method, base URL
comfy cloud logout         # clear the local session
```

Once signed in, commands auto-route to cloud. **Browser OAuth is the recommended path.** No keys to manage, and the CLI handles token refresh for you. To point at a custom environment (for example a PR preview) before signing in:

```bash theme={null}
comfy cloud set-base-url https://my-preview.comfy.org
```

<Note>
  **API key is optional.** You only need an API key for headless or CI use where a browser sign-in is not possible. It is a fallback, not the default:

  ```bash theme={null}
  export COMFY_API_KEY=comfyui-...   # or pass --api-key per call
  ```
</Note>

<Note>
  **Session lifetime.** Cloud session tokens are short-lived (\~1h). The CLI auto-refreshes them on demand. If a command reports `cloud_unauthorized`, run `comfy cloud login` again.
</Note>

## パートナーノードで生成

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

ターミナルまたはスクリプトから Comfy の[パートナーノード](/ja/tutorials/partner-nodes/overview)を呼び出す最も高速な方法です。ComfyUI ワークフローと同じホストされたエンドポイントを使用しますが、単一の CLI 呼び出しとして実行します。完全な ComfyUI グラフが不要なバッチジョブ、クイック実験、自動化に最適です。

### 前提条件

* `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はローカルファイルをアップロードし、ジョブを送信し、完了をポーリングし、結果を保存します。

<Tip>
  モデルの実際のパラメータを事前に確認しましょう。フラグ名はモデルごとに異なります（例：`flux-ultra` は `--width`/`--height`、`seedance` は `--ratio`/`--resolution`/`--duration`）。スクリプト化する前に必ず確認してください：

  ```bash theme={null}
  comfy generate schema flux-ultra
  ```
</Tip>

### よく使われるモデル

**Nano Banana（Google Gemini）：テキストから画像へと編集：**

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

# 画像編集：
comfy generate nano-banana \
    --prompt "add a top hat" \
    --image ./cat.png \
    --download edited.png

# モデルバリアントの指定：
comfy generate nano-banana \
    --prompt "neon city skyline" \
    --model gemini-3-pro-image-preview \
    --download city.png
```

**Flux 1.1 Pro Ultra：高解像度テキストから画像へ：**

```bash theme={null}
comfy generate flux-ultra \
    --prompt "a purple Victorian house in San Francisco, golden hour" \
    --width 896 --height 1152 --seed 11 \
    --download house.png
```

**Seedance（ByteDance）：テキストから動画へと画像から動画へ、最大1080p / 12秒：**

```bash theme={null}
# テキストから動画へ：
comfy generate seedance \
    --prompt "a hummingbird hovering over a flower" \
    --resolution 1080p --duration 5 \
    --download hummingbird.mp4

# 画像から動画へ（ローカル画像をアニメーション化、自動アップロード）：
comfy generate seedance \
    --model seedance-1-0-pro-250528 \
    --image ./painting.png \
    --ratio 3:4 --resolution 1080p --duration 5 \
    --prompt "the painting gently comes alive, a soft breeze stirs the trees" \
    --download animated.mp4
```

**Grok（xAI）：画像とビデオ：**

```bash theme={null}
comfy generate grok --prompt "a cyberpunk street market at night" --download street.png
comfy generate grok-edit --prompt "swap the umbrella for a parasol" --image ./photo.jpg --download out.png
comfy generate grok-video --prompt "a paper plane gliding through a cathedral" --download flight.mp4
```

### モデルを見つける

```bash theme={null}
comfy generate list                            # すべてのモデル
comfy generate list --category text-to-video   # カテゴリでフィルタ
comfy generate list --partner kling            # パートナーでフィルタ
comfy generate schema flux-kontext             # モデルのパラメータを表示
```

### 参照画像を使った画像編集

ローカルファイルパスを渡します。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出力

パイプライン統合用に生の API レスポンスを出力：

```bash theme={null}
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'
```

コマンド、フラグ、モデルエイリアスの全リストについては[リファレンス](/ja/comfy-cli/reference)を参照してください。

## ワークフローの実行（`comfy run`）

単独のパートナー呼び出しを超えて、`comfy run` は完全な ComfyUI ワークフローグラフを送信します。API形式とエクスポートされたUI形式の両方のJSON（UIワークフローはクライアント側でAPI形式に変換されます）を受け付け、他のコマンドと同様にローカルまたはクラウドにルーティングします。デフォルトでは**非同期**で動作します。バックグラウンドのウォッチャーが進捗を追跡しつつ、ミリ秒単位で `prompt_id` を返します。ブロックして待機するには `--wait` を指定します。

```bash theme={null}
# 送信：即座に prompt_id を返す
RES=$(comfy --json run --workflow my_workflow.json)
PROMPT_ID=$(echo "$RES" | jq -r .data.prompt_id)

# ターミナル状態になるまで監視し、出力を収集
comfy --json jobs watch "$PROMPT_ID" | comfy download
```

単一のブロッキング呼び出しを希望しますか？ `--wait` を使用します：

```bash theme={null}
comfy run --workflow my_workflow.json --wait | comfy download
```

ジョブの追跡と管理：

```bash theme={null}
comfy jobs ls                 # ローカルの非同期送信 + サーバーのキュー/履歴
comfy jobs status <prompt_id> # 1つのジョブ
comfy jobs wait <id1> <id2>   # 全てがターミナル状態に達するまでブロック
comfy jobs cancel <prompt_id> # べき等
```

<Tip>
  送信前に検証しましょう。不明なノード、不足しているモデル、誤った配線を、クラウド計算を消費する前に発見します：

  ```bash theme={null}
  comfy validate --workflow my_workflow.json
  ```
</Tip>

## テンプレートから始める

厳選された `Comfy-Org/workflow_templates` ギャラリーは、特定のタスクに対して既知の優れたワークフローを入手する最速の方法です。ゼロから構築する必要はありません。

```bash theme={null}
comfy templates ls --type image --tag "Text to Image"   # ブラウズ
comfy templates show <name>                              # 完全なメタデータ
comfy templates fetch <name> --out my.json               # ワークフローJSONを取得
```

ダウンロードされたJSONはフロントエンド形式です。`comfy run --where cloud` は送信時に自動的にAPI形式に変換します。

## ワークフローのその場編集

`comfy workflow` は、フロントエンド形式のワークフロー内でエージェントが調整可能なスロットを公開し、それらを上書きできるようにします。手動の JSON 編集は不要です。

```bash theme={null}
comfy workflow slots my.json                 # アドレス可能なスロットを一覧表示
comfy workflow set-slot my.json 6.text="a fox in the snow"
comfy workflow vary my.json \
    --slot positive.text='["a cat","a dog","a fox"]' \
    --out-dir ./variants                     # N個のバリエーションを生成
```

Comfy Cloud に保存されたワークフロー:

```bash theme={null}
comfy workflow list                          # 保存されたワークフローの一覧
comfy workflow get <id> --out my.json
comfy workflow save my.json --name "My Flow"
comfy workflow delete <id>
```

複雑なマルチステップパイプラインでは、小さな再利用可能な断片を組み合わせて1つのグラフにします:

```bash theme={null}
comfy workflow compose blueprints/my_pipeline.yaml -o workflows/my_pipeline.json
comfy workflow decompose my.json             # 逆: ワークフローを断片に分解
```

## ノードとモデルを発見する

解決済みのバックエンドで利用可能なすべてを詳細に確認します。

**ノード:**

```bash theme={null}
comfy nodes search "checkpoint"              # あいまい検索
comfy nodes show KSampler                    # 完全なスキーマ：入力、出力、デフォルト値
comfy nodes ls --produces IMAGE --limit 10   # 出力タイプでフィルタ
comfy nodes ls --api-only                    # パートナーAPIノードのみ
```

**モデル:**

```bash theme={null}
comfy models list-folders                    # すべてのモデルフォルダー
comfy models search --text "wan2.2" --type lora
comfy models show wan2.2_vae.safetensors     # 完全なメタデータ
```

## ファイルのアップロードとダウンロード

```bash theme={null}
comfy upload photo.png video.mp4             # → サーバー入力ディレクトリ
comfy download <prompt_id>                   # → ./outputs/
```

<Tip>
  **慣用的なパイプ:**

  ```bash theme={null}
  comfy run --workflow flux.json --wait | comfy download
  ```

  `comfy download` は、パイプされた標準入力から prompt\_id と出力URLを自動的に読み取ります。手動でキーを抽出したり、`jq` を使う必要はありません。
</Tip>

## カスタムノードの管理

```bash theme={null}
comfy node install <NODE_NAME>
```

このツールはカスタムノードのインストールに `cm-cli` を使用します。詳細は [ComfyUI Manager cm-cli ドキュメント](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md) を参照してください。

## モデルの管理（ローカル）

モデルを簡単にダウンロード：

```bash theme={null}
comfy model download --url <url> --relative-path models/checkpoints
```

## スクリプトとエージェント向けのJSON出力

すべてのコマンドは `--json` を受け付け、同一のエンベロープ形状を出力します。これにより、CLIは完全にスクリプト可能でエージェントフレンドリーになります。

```json theme={null}
{
  "ok": true,
  "command": "...",
  "version": "1.11.1",
  "where": "local | cloud | null",
  "data": { },
  "error": null
}
```

`error` が存在する場合は、`hint` を読み、それに従って行動します。

```bash theme={null}
comfy --json run --workflow my.json | jq '.error.hint'
```

エージェント向けのインターフェースは完全に自己記述的です。コマンドツリー全体、出力スキーマ、エラーコードをダンプします。

```bash theme={null}
comfy --json discover
```

## エージェントスキル

インストール済みの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 GitHub リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues)でイシューを開くか、プルリクエストを送信してください。詳細は[開発ガイド](https://github.com/Comfy-Org/comfy-cli/blob/main/DEV_README.md)を参照してください。

## 分析

使用状況の追跡はCLIの改善に役立ちます。以下のコマンドで無効にします：

```bash theme={null}
comfy tracking disable
```

追跡を再度有効にする：

```bash theme={null}
comfy tracking enable
```

また、`DO_NOT_TRACK` または `COMFY_NO_TELEMETRY` 環境変数を設定して、完全にオプトアウトすることもできます。