ComfyUI カスタムノードを安全にインストールする方法

ComfyUI Manager または手動 Git クローンによるカスタムノードの安全なインストール手順。パッケージの競合や起動エラーの対策。

テスト環境

OS： Windows 10 / 11
ランチャー： Wonderful Launcher v1.x
ComfyUI： ポータブル版 / マネージドインストール
Python： 3.11+
CUDA / Torch： CUDA 12.x / Torch 2.x
検証日： 2026-05-19

ComfyUI に新しいカスタムノード（プラグイン）を導入して機能を追加したい場合は、以下の手順に従ってください。

カスタムノードは便利な反面、環境全体を最も壊しやすい原因でもあります。これは、各プラグインがそれぞれ異なる Python パッケージやバイナリライブラリを要求し、既存の Torch や NumPy などのバージョンを競合（上書き）させてしまうためです。

すでに環境がクラッシュしている場合

カスタムノードを導入した後に ComfyUI が起動しなくなったりエラーが出ている場合は、本ページではなくインストールカスタムノード后 ComfyUI 损坏？を参照し、環境を復旧させてください。

クイックガイド

目的	最善の手順
一般的なノードのインストール	WebUI 画面上の ComfyUI Manager を使用する
GitHub から手動でインストールする	`ComfyUI/custom_nodes/` にクローンし、起動用 Python パスを指定して依存関係を個別にインストールする
ワークフロー上の「赤いノード」を消す	Manager の「Install Missing Custom Nodes」機能を利用して自動インストールし、再起動する
コアパッケージの破損を防止する	`requirements.txt` の内容を確認し、Torch や OpenCV が上書きされないか点検する

カスタムノードのインストール方法

方法 1：ComfyUI Manager を使用する（推奨）

現在の一般的な ComfyUI および ComfyUI Desktop 版には、標準で Manager が組み込まれています。

ComfyUI Desktop の場合：起動後、画面のツールバーにある「Manager」ボタンをクリックして検索画面を開くだけで使用できます。

ポータブル版の場合：ポータブル版のルートディレクトリで以下を実行し、Manager の依存パッケージをインストールした上で起動します：

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

手動インストール（venv）の場合：仮想環境を有効化して以下を実行します：

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

方法 2：手動 Git クローン

端末で ComfyUI/custom_nodes/ ディレクトリに移動します。
対象リポジトリをクローンします：

cd ComfyUI/custom_nodes
git clone https://github.com/[作成者]/[リポジトリ名].git

該当ノードに requirements.txt が含まれる場合、ComfyUI を起動する Python 環境を明示的に指定してインストールを行います：

インストール環境	安全な実行コマンド
ポータブル版	ポータブルルートで実行：`.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\[ノード名]\requirements.txt`
手動インストール（venv）	venv 有効化状態で実行：`python -m pip install -r custom_nodes/[ノード名]/requirements.txt`

ComfyUI を完全に再起動します。

無条件に requirements.txt を実行しない

一番リスクが高いのは pip install -r requirements.txt です。実行する前に、中身をメモ帳などで開き、torch、numpy、opencv-python などの主要パッケージの上書きが含まれていないか必ず確認してください。

方法 3：単一スクリプトの配置

複雑なフォルダ構造を持たないシンプルなノード（単一の .py ファイルなど）は、直接 custom_nodes/ フォルダに配置するだけで認識されます：

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

配置後、ComfyUI を起動してください。

代表的なカスタムノードパック

ノードパック名	機能概要
ComfyUI-Manager	WebUI 上で他のカスタムノードを検索・導入できる必須ツール
ComfyUI-GGUF	少ない VRAM で FLUX 等の巨大モデルをロードするための GGUF ローダー
ComfyUI-Impact-Pack	顔検出・切り抜き・詳細自動補正（Detailer）
ComfyUI-AnimateDiff	画像をアニメーション化して動画を生成するスタック
ComfyUI-IPAdapter	画像プロンプト（参照画像によるスタイル転送）
ComfyUI-ControlNet	姿勢、深度、線画コントロール
ComfyUI-VideoHelperSuite	動画ファイルの読み込み、フレームデコード、動画保存

クイックガイド

目的	最善の手順
一般的なノードのインストール	WebUI 画面上の ComfyUI Manager を使用する
GitHub から手動でインストールする	`ComfyUI/custom_nodes/` にクローンし、起動用 Python パスを指定して依存関係を個別にインストールする
ワークフロー上の「赤いノード」を消す	Manager の「Install Missing Custom Nodes」機能を利用して自動インストールし、再起動する
コアパッケージの破損を防止する	`requirements.txt` の内容を確認し、Torch や OpenCV が上書きされないか点検する

カスタムノードのインストール方法

方法 1：ComfyUI Manager を使用する（推奨）

現在の一般的な ComfyUI および ComfyUI Desktop 版には、標準で Manager が組み込まれています。

ComfyUI Desktop の場合：起動後、画面のツールバーにある「Manager」ボタンをクリックして検索画面を開くだけで使用できます。

ポータブル版の場合：ポータブル版のルートディレクトリで以下を実行し、Manager の依存パッケージをインストールした上で起動します：

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

手動インストール（venv）の場合：仮想環境を有効化して以下を実行します：

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

方法 2：手動 Git クローン

端末で ComfyUI/custom_nodes/ ディレクトリに移動します。
対象リポジトリをクローンします：

cd ComfyUI/custom_nodes
git clone https://github.com/[作成者]/[リポジトリ名].git

該当ノードに requirements.txt が含まれる場合、ComfyUI を起動する Python 環境を明示的に指定してインストールを行います：

インストール環境	安全な実行コマンド
ポータブル版	ポータブルルートで実行：`.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\[ノード名]\requirements.txt`
手動インストール（venv）	venv 有効化状態で実行：`python -m pip install -r custom_nodes/[ノード名]/requirements.txt`

ComfyUI を完全に再起動します。

無条件に requirements.txt を実行しない

方法 3：単一スクリプトの配置

複雑なフォルダ構造を持たないシンプルなノード（単一の .py ファイルなど）は、直接 custom_nodes/ フォルダに配置するだけで認識されます：

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

配置後、ComfyUI を起動してください。

代表的なカスタムノードパック

ノードパック名	機能概要
ComfyUI-Manager	WebUI 上で他のカスタムノードを検索・導入できる必須ツール
ComfyUI-GGUF	少ない VRAM で FLUX 等の巨大モデルをロードするための GGUF ローダー
ComfyUI-Impact-Pack	顔検出・切り抜き・詳細自動補正（Detailer）
ComfyUI-AnimateDiff	画像をアニメーション化して動画を生成するスタック
ComfyUI-IPAdapter	画像プロンプト（参照画像によるスタイル転送）
ComfyUI-ControlNet	姿勢、深度、線画コントロール
ComfyUI-VideoHelperSuite	動画ファイルの読み込み、フレームデコード、動画保存

ComfyUI カスタムノードを安全にインストールする方法

クイックガイド

カスタムノードのインストール方法

方法 1：ComfyUI Manager を使用する（推奨）

方法 2：手動 Git クローン

方法 3：単一スクリプトの配置

代表的なカスタムノードパック

関連ガイド

目次

ComfyUI カスタムノードを安全にインストールする方法

クイックガイド

カスタムノードのインストール方法

方法 1：ComfyUI Manager を使用する（推奨）

方法 2：手動 Git クローン

方法 3：単一スクリプトの配置

代表的なカスタムノードパック

関連ガイド

目次