ComfyUIのエラー一覧と直し方｜CUDA・モデルが見つからない・メモリ不足・赤いノード【2026年10月】

1. まず確認すること

1. エラーのダイアログ（「Prompt execution failed」）が出たら、「Show report」を押して詳細を見る
2. Comfy Desktopなら、インスタンスの「Manage → Terminal」タブにComfyUI本体の出力が出ている。アプリ自体の記録は Desktop Settings → Logs → Diagnostics →「Open logs folder」の app.log
3. ComfyUIが古くないか確認する（Desktopは「Manage → Update」、Portable版は update_comfyui.bat）

2. GPU・PyTorchのエラー

NVIDIA GPUの場合の入れ直し手順（公式ドキュメント）：

pip uninstall torch
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
python -c "import torch; print(torch.cuda.is_available())"

最後の行で True と表示されれば、GPUが使える状態だ。

3. モデルのエラー

モデルが見つからない

Prompt execution failed
Prompt outputs failed validation:
CheckpointLoaderSimple:
- Value not in list: ckpt_name: 'model-name.safetensors' not in []

ワークフローが指定したモデルが、所定のフォルダにないという意味だ。チェックポイントなら models/checkpoints/、LoRAなら models/loras/ のように、種類ごとの正しいフォルダに置く。置いたのに一覧に出ないときは、画面で r キーを押して更新するか再起動する。フォルダ分けの一覧はモデルの置き場所とLoRAの使い方にまとめた。

4. メモリ不足のエラー

RuntimeError: CUDA out of memory は、GPUのメモリ（VRAM）が足りない状態だ。公式ドキュメントは、起動オプションを次の順で試すよう案内している。

このほか、--reserve-vram 2（VRAMを一部残しておく）、--disable-smart-memory、--cache-none なども用意されている。画像の解像度やバッチ数を下げる、動画なら長さを短くするのも効果がある。Comfy Desktopでは起動オプションをインスタンスの「Manage → Startup Args」で設定する。手元のGPUで足りない場合は、96GBのGPUを使えるComfy Cloudに切り替える手もある。

5. カスタムノードのエラー

ノードが赤くなる（カスタムノードが入っていない）

他の人が作ったワークフローを開くと、必要なカスタムノードが入っていないためにノードが赤く表示されることがある。ComfyUI Managerの新しい画面では、ワークフローを読み込んだときに案内が出るので、「Install All」でまとめて入れるか、「Open Manager」で中身を確認してから入れる。新しい画面で入れられるのは公式レジストリに登録されたノードだけで、GitのURLからは入れられない。

手動で入れる場合

ComfyUI/custom_nodes に git clone し、必要なライブラリを入れる。Portable版では次のように実行する。

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[ノードのフォルダ名]\requirements.txt

起動時のログに import failed が出ていないか確認する。

どのノードが原因か分からないとき

python main.py --disable-all-custom-nodes

カスタムノードをすべて止めて起動し、半分ずつ有効にして原因を絞り込む（公式ドキュメントの二分探索の方法）。comfy-cliのbisect機能でも自動で絞り込める。

ComfyUI Managerのエラー

6. Comfy Desktop（アプリ）のトラブル

よくある質問