完全なComfy CLIユーザーガイド

Comfy CLIは、ComfyUIの公式コマンドラインツールです。ターミナルからノードやモデルのインストール、管理、ワークフローの実行、パートナー画像/ビデオモデルの呼び出しがすべて行えます。

ℹ️ 更新についての注意: 最新のCLIリファレンスについては、公式README または docs.comfy.org をご確認ください。

要件

Python 3.10+

インストール

推奨：pipを使う

pip install comfy-cli

pipxを使う（隔離環境）

pipx install comfy-cli

uvを使う（高速なPythonパッケージインストーラー）

uv tool install comfy-cli

シェルのオートコンプリート

comfy --install-completion

これで comfy <TAB> でコマンドやオプションが展開されます。

クイックスタート

# インタラクティブセットアップウィザードを実行
comfy setup

comfy setup は、ローカルまたはクラウドのルーティング、認証、エージェントスキルのインストールなど、すべてを1つのインタラクティブウィザードで案内します。非インタラクティブ（CI/スクリプト）インストールの場合は -y オプションを指定してください。

また、明示的にインストールすることもできます：

comfy install

その後、起動：

comfy launch

## ワークスペース管理

Comfy CLI は複数の ComfyUI ワークスペースの管理をサポートしており、異なる ComfyUI 環境を同時に維持できます。

### 基本的なワークスペース操作

```bash
# 現在のワークスペースパスを確認
comfy which

# デフォルトワークスペースを設定
comfy set-default /path/to/your/workspace

# 起動パラメータ付きでデフォルトワークスペースを設定
comfy set-default /path/to/your/workspace --launch-extras="--listen 0.0.0.0 --port 8080"

異なるワークスペースでのコマンド実行

オプション	使用例
`--workspace=<path>`	指定したワークスペースにインストール済みの ComfyUI から実行
`--recent`	最近使用した ComfyUI から実行
`--here`	カレントディレクトリの ComfyUI から実行

# 指定したワークスペースで ComfyUI を起動
comfy --workspace=~/projects/project-a launch

# 最新のワークスペースにノードをインストール
comfy --recent node install ComfyUI-Impact-Pack

# カレントディレクトリに ComfyUI があるか確認
comfy --here which

注: --workspace、--recent、--here は同時に使用できません。

ワークスペースの優先順位ルール

ワークスペースが指定されていない場合：

comfy set-default <path> で設定されたデフォルトパス
最後に実行またはインストールされた ComfyUI
カレントディレクトリ内の ComfyUI

起動オプション

基本起動

# デフォルト起動
comfy launch

# バックグラウンドで実行
comfy launch --background

# バックグラウンドインスタンスを停止
comfy stop

# 追加引数を指定して起動
comfy launch -- --cpu --listen 0.0.0.0

ネットワーク設定

comfy launch -- --listen 0.0.0.0 --port 8080

パフォーマンスオプション

comfy launch -- --cpu       # CPUのみモード
comfy launch -- --lowvram   # 低VRAMモード
comfy launch -- --novram     # 超低VRAMモード

プルリクエストのテスト

# 特定のComfyUI PRをインストール
comfy install --pr "#1234"
comfy install --pr "https://github.com/comfyanonymous/ComfyUI/pull/1234"

# フロントエンドPRをテスト
comfy launch --frontend-pr "#456"
comfy launch --frontend-pr "username:branch-name"

フロントエンドPRのビルドはキャッシュされ、素早く切り替えられます。キャッシュの管理:

comfy pr-cache list              # キャッシュされたPRビルドを一覧表示
comfy pr-cache clean             # すべてのキャッシュビルドを削除
comfy pr-cache clean 456         # 特定のPRキャッシュを削除

## カスタムノード管理

### ノード情報の表示

```bash
comfy node show all                               # 利用可能な全ノード
comfy node simple-show installed                  # インストール済みノードの簡易表示
comfy node show enabled                           # 有効なノードのみ
comfy node show not-installed                     # 未インストールのノード
comfy node show disabled                          # 無効なノード
comfy node show all --channel recent              # 最新チャンネルのノード
comfy node show snapshot                          # 現在のスナップショット情報を表示
comfy node show snapshot-list                     # 保存済みスナップショットを一覧表示

ノードのインストールと更新

comfy node install ComfyUI-Impact-Pack            # カスタムノードをインストール
comfy node update all                             # すべてのノードを更新
comfy node update ComfyUI-Impact-Pack             # 特定のノードを更新

高速な依存解決

Comfy CLI では、uv を使用して依存解決を高速化する2つの方法を提供します。

機能	`--fast-deps`	`--uv-compile`
対象範囲	`comfy install`、ノードのインストール/再インストール	カスタムノードコマンドのみ
依存解決エンジン	comfy-cli 組み込み	ComfyUI-Manager v4.1+ 統合依存解決エンジン
競合処理	対話型プロンプト	ノード属性による自動処理

# 高速な初期インストール
comfy install --fast-deps

# カスタムノード管理の uv-compile（ComfyUI-Manager v4.1+ が必要）
comfy node install comfyui-impact-pack --uv-compile

# スタンドアロン実行（既存の全カスタムノード依存関係を解決）
comfy node uv-sync

# --uv-compile をデフォルトにする
comfy manager uv-compile-default true

ノードスナップショット管理

comfy node save-snapshot                           # 現在のスナップショットを保存
comfy node restore-snapshot <snapshot_name>        # 保存したスナップショットを復元

依存関係管理

comfy node install-deps --workflow=workflow.json   # ワークフローJSONから
comfy node install-deps --workflow=workflow.png    # ワークフローPNGから
comfy node install-deps --deps=dependencies.json   # 依存関係JSONファイルから
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json

ノードのトラブルシューティング（bisect）

どのカスタムノードがバグの原因かを特定します。

comfy node bisect start                            # bisectセッション開始
comfy node bisect good                             # 現在の状態を正常とマーク
comfy node bisect bad                              # 現在の状態を異常とマーク
comfy node bisect reset                            # セッションをリセット

## ワークフローJSONなしで画像を生成

Comfy CLIはワークフローグラフを必要とせず、直接パートナー画像およびビデオモデルを呼び出せます：

```bash
comfy generate --prompt "a cat on a beach" --model flux/schnell
comfy generate --prompt "anime girl" --model stability/stable-diffusion-3.5
comfy generate --prompt "city street" --model ideogram/ideogram-v2

対応プロバイダー：Flux、Ideogram、DALL·E、Recraft、Stability、Gemini、Kling、Luma、Runway、Pika、Vidu、Hailuo、Seedanceなど。

クラウドへのルーティング

任意のワークフローをComfy Cloudで実行（ローカルGPU不要）：

comfy launch -- --where cloud
# または
comfy generate --model recraft/recraft-v3 --where cloud

エージェント向け構造化出力

すべてのコマンドは機械可読出力用の--jsonをサポート。CI/CDやAIエージェント連携に最適です：

comfy generate --prompt "a cat" --model flux/schnell --json

## モデル管理

### モデルのダウンロード

```bash
# Hugging Face から
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

# CivitAI から
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints

# APIトークンを使用
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token YOUR_TOKEN

APIトークンは環境変数（CIVITAI_API_TOKEN、HF_API_TOKEN）でも設定できます。CI/CD環境ではこちらの方が安全です。

モデルの管理

comfy model list                                  # デフォルトパス内のモデルを一覧表示
comfy model list --relative-path models/loras     # サブフォルダ内を一覧表示
comfy model remove --model-names "model.safetensors"  # モデルを削除

## ComfyUI-Manager 管理

```bash
comfy manager disable-gui                         # マネージャーGUIを無効化
comfy manager enable-gui                          # マネージャーGUIを有効化
comfy manager clear                               # 予約された起動アクションをクリア

## 環境情報

```bash
comfy env                                         # Show detailed environment info
comfy tracking status                             # Check tracking settings
comfy tracking disable                            # Disable usage tracking
comfy tracking enable                             # Enable usage tracking

## 高度な機能

### comfy-lock.yaml（ベータ）

`comfy-lock.yaml`ファイルを使ってプロジェクトの依存関係を管理します：

```yaml
basic:

models:
  - model: SD1.5 Base
    url: https://huggingface.co/...
    paths:
      - path: models/checkpoints
    hashes:
      - hash: abc123...
        type: SHA256
    type: checkpoint

custom_nodes:
  git_custom_nodes:
    https://github.com/user/ComfyUI-Node:
      disabled: false
      hash: a1b2c3d...

## よくある使用シナリオ

### 開発環境管理

```bash
# Create workspace for stable development
comfy --workspace=~/dev/comfyui-stable install

# Create workspace for experimental features
comfy --workspace=~/dev/comfyui-experimental install

# Install experimental nodes
comfy --workspace=~/dev/comfyui-experimental node install ComfyUI-AnimateDiff-Evolved

プロジェクト依存関係管理

# Create a snapshot for a project
comfy node save-snapshot my-project-v1

# Restore project dependencies
comfy node restore-snapshot my-project-v1

# Install workflow dependencies
comfy node install-deps --workflow=project.json

## トラブルシューティング

### よくある問題

1. **ワークスペースパスの問題**
   ```bash
   comfy which              # 現在のワークスペースを確認
   comfy set-default /path  # 正しいパスにリセット

ノードの競合

comfy node bisect start  # bisectを使用して問題のあるノードを特定

権限の問題

ls -la ~/comfy           # ディレクトリの権限を確認

要件