ComfyUI カスタムノードの入れ方とおすすめ5選｜手順と対処法

ComfyUI を使い始めて「このワークフローを動かしたいのにノードが足りない」と止まった経験はないでしょうか。カスタムノードの入れ方さえ覚えれば、ネットに公開されている多くのワークフローが手元で動かせるようになります。この記事では、ComfyUI-Manager を使った標準的な手順から、git clone による手動インストール、エラーの対処法、よく使われるおすすめノードまでを一まとめにします。

カスタムノードの仕組みを先に理解する

ComfyUI のカスタムノードは ComfyUI/custom_nodes/ 以下に配置したディレクトリを起動時に自動で読み込む仕組みです。各ノードは Python パッケージとして実装されており、__init__.py の中に NODE_CLASS_MAPPINGS と NODE_DISPLAY_NAME_MAPPINGS を定義することで ComfyUI に認識されます。

「インストール」の実体は「正しいディレクトリにファイルを置いて再起動する」だけです。ただし多くのノードは追加の Python パッケージに依存しているため、requirements.txt のインストールを忘れると起動時にエラーが出たり、ノードが赤くなって使えなかったりします。この点がつまずきやすいポイントです。

インストール前に確認する3つのこと

1. Python 仮想環境の場所を把握する

ComfyUI を venv で管理している場合、pip install は必ずその venv を有効にした状態で実行しなければなりません。systemd サービスや nohup で起動しているなら、ExecStart に書かれた Python のフルパスがそれです。

# venv が有効かを確認する
which python
# → /home/username/ComfyUI/venv/bin/python のような表示が正しい状態

# systemd で管理している場合
systemctl cat comfyui | grep ExecStart

2. ComfyUI 本体のバージョンを確認する

カスタムノードによっては ComfyUI 本体の特定バージョンを要求する場合があります。README に「ComfyUI 20240101 以降」のような記載があれば、本体側を先に更新してから進めます。

cd ~/ComfyUI
git log --oneline -1
# 最新にするなら
git pull

3. ディスク空き容量を確認する

ノードによっては追加モデルを数 GB ダウンロードします。df -h で事前に確認しておきます。/home 領域が逼迫している場合は、モデルファイルだけ別ドライブに置いてシンボリックリンクで参照する対応が有効です（環境によって異なります）。

ComfyUI-Manager でインストールする（推奨）

ComfyUI-Manager は、カスタムノードの検索・インストール・更新・無効化をブラウザ UI から一括で操作できるツールです。これ自体も custom_nodes/ に置くカスタムノードで、最初にこれを導入することを強く推奨します。

ComfyUI-Manager 自体のインストール

ComfyUI を停止した状態で実行します。

cd ~/ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git

ComfyUI を再起動すると、UI 右上（または下部）に「Manager」ボタンが表示されます。

注意（執筆時点）: ComfyUI-Manager は 2024年以降、security_level という設定を持ちます。デフォルトは normal でローカル環境での機能制限はありませんが、外部に公開する環境では Manager の「Security」タブから strict への変更を検討してください。

Manager からノードをインストールする手順

1. ComfyUI を起動し http://127.0.0.1:8188 を開く
2. 右上「Manager」→「Install Custom Nodes」をクリック
3. 検索窓にノード名か GitHub のリポジトリ名を入力して絞り込む
4. 対象ノードの「Install」をクリック
5. インストール完了のダイアログが出たら、指示に従って ComfyUI を再起動する

再起動後にノードがまだ表示されない場合は、ブラウザのハードリロード（Ctrl+Shift+R）を試してください。それでも出ない場合は次の手動インストールに切り替えます。

git clone で手動インストールする

Manager 未導入の環境や、リポジトリの特定コミットを使いたい場合は手動インストールが確実です。

# 例: ComfyUI_IPAdapter_plus を入れる場合
cd ~/ComfyUI/custom_nodes
git clone https://github.com/cubiq/ComfyUI_IPAdapter_plus.git

# requirements.txt があればインストール（venv を有効にした状態で実行）
cd ComfyUI_IPAdapter_plus
pip install -r requirements.txt

ComfyUI を再起動します。systemd サービスで管理している場合は sudo systemctl restart comfyui、手動起動なら Ctrl+C で停止してから再実行します。

よくある失敗パターンと対処

.disabled リネームによるロード除外は ComfyUI-Manager の「Disable」操作と同等です。問題の切り分けに便利です。

おすすめカスタムノード 5選

以下は、公開されているワークフローで前提とされることが多いノードです。いずれも広く使われており、ライセンス（商用利用可否など）は各リポジトリの README で必ず確認してください。

ComfyUI で Wan2.1 の I2V（Image to Video）ワークフローを動かす場合は依存するノードが複数あります。Wan2.1 I2V で画像から動画をローカル生成｜ComfyUI 設定と推奨値に必要なノード構成をまとめているので参考にしてください。

まとめ

ComfyUI カスタムノードのインストールは「custom_nodes/ にクローンして再起動する」が基本です。手順を整理すると次のとおりです。

1. ComfyUI/custom_nodes/ 内で ComfyUI-Manager を git clone する
2. ComfyUI を再起動して Manager ボタンが表示されることを確認する
3. Manager → Install Custom Nodes からノードを検索してインストールする
4. 再起動後にブラウザをハードリロードして動作確認する

次の一手として、Manager をインストールしたら「Missing Nodes」機能を使ってみてください。ワークフロー JSON を読み込んだときに不足しているノードを自動検出し、一括インストールの候補を出してくれます。ネットで見つけたワークフローをそのまま取り込む際に特に役立ちます。