> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy CLI トラブルシューティングガイド

> Comfy CLI でよくあるセットアップの問題を解決します：git の不足、Python と仮想環境の要件、ブラウザなしでの Comfy Cloud 認証、GPU ライブラリのインストール。

Comfy CLI のほとんどの問題は、前提条件の不足かセットアップ手順の抜けが原因です。問題を報告する前に、以下を順に確認してください。

## 前提条件

Comfy CLI を使用するには、システムに [git](https://git-scm.com/downloads) がインストールされている必要があります。先に git をインストールすると、`comfy install` と `comfy update` が ComfyUI とカスタムノードをクローンできます。

## 仮想環境に ComfyUI をインストールする

`comfy install` は有効な Python 環境に ComfyUI をインストールします。Python 3.9 以降が必要です。先に仮想環境を作成して有効化してください：

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

## GPU ライブラリは別途インストールする

`comfy install` は CUDA や ROCm をインストールしません。起動前にハードウェアに合った GPU ライブラリをインストールしてください。インストールしないと、`comfy launch` で起動した ComfyUI は GPU を使用できません。

## ブラウザなしで Comfy Cloud を設定する

`comfy setup` はブラウザ経由でサインインするため、CI、devcontainer、ヘッドレスサーバーでは完了できません。代わりに API キーを渡し、非対話モードで実行してください：

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

## さらにサポートが必要な場合

* [Comfy CLI をはじめよう](/ja/comfy-cli/getting-started) では、インストール、ルーティング、生成を説明しています。
* [Comfy CLI コマンドリファレンス](/ja/comfy-cli/reference) にはすべてのコマンドとフラグが掲載されています。
* 再現可能な CLI の不具合は [comfy-cli リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues) で報告してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.