私家版 Claude Mods まとめ

mod とは

mod は Claude Code のプロセス内で動くプラグインです。ツール呼び出し・プロンプト送信・画面描画などのイベントにフックを差し込み、観察する・書き換える・自分で答える、の三通りの対応ができます。設定ファイルの hooks やスキル、MCP サーバーと違い、ペイン・プロンプト上部領域・ステータス行・ボタンなどの画面を自分で描けるのが特徴です。

最小構成は 3 ファイル

first-mod/
├── .claude-plugin/plugin.json   # マニフェスト
└── hooks/
    ├── hooks.json               # { "modules": ["./register.ts"] }
    └── register.ts              # export const register = (on) => { on('tool.call', ...) }

どこで動くか

• ターミナルの claude と Desktop アプリの Code タブ: フックも描画も動く
• VS Code 拡張のチャット、claude -p、クラウドセッション: フックは動くが描画は出ない
• Desktop アプリの WSL セッションではプラグイン自体が使えない

入れ方・外し方

# 入れる（作者の marketplace を追加してからインストール）
claude plugin marketplace add owner/repo
claude plugin install mod-name@marketplace-name
# セッション内なら /plugin marketplace add と /plugin install
# シェルから入れた直後は /reload-plugins

# 入れる前に何をするか確認（実行せずにフックと呼び出しを列挙）
claude plugin validate ./some-mod

# 外す・止める
/plugin                 # Installed タブで無効化・アンインストール
claude --safe-mode      # このセッションだけ全 mod を止める

早期アクセス期に必要だった CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 は v2.1.287 以降では無視されます。古い README に残っていても設定不要です。逆に 0 にしても mod は止まりません。