Claude Code Mods：インストール、活用、安全な無効化
Mods はプロセス内の function hooks を持つプラグインで、インターフェースの再描画、コマンドの追加、ツール呼び出しの横取りができます。このガイドでは最初の mod、内蔵一覧、オフスイッチをたどります——全項目を公式ドキュメントに対して検証済み。
要約
- Mods は hooks モジュールを同梱した Claude Code プラグイン——Claude Code 内で動く JavaScript で、イベントの観察・書き換え・応答ができます。
- v2.1.287 以降なら mods は最初から使えます：/plugin install name@marketplace でインストールし、セッションを再起動すれば有効です。
- 内蔵の You Should Know はオプトイン式：/plugin enable cc-plugin-you-should-know@builtin を一度実行するだけ。
- オフにするには：/plugin で個別 mod を無効化、--safe-mode で 1 セッション起動、または "disableAllHooks": true で全インストール済み mod をオフに。
Claude Mods Make Claude Code 10x More Powerful
チャンネル: Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
チャンネル: Claude Code Changelog2:13
Mods overview — official docs (function hooks)
ドキュメント: code.claude.com/docs
スクリーンショットは上の 2 本の動画から取得。画面のきれいな区間とタイポグラフィ中心のチェンジログスライドだけを使用し、出演者の映る区間はすべて除外しました。事実は動画ではなく、公式の mods ドキュメントに対して検証しています。
フレームのタイムスタンプは元動画へディープリンクで戻り、制作側にアクセスが届きます。Claude Code は Anthropic の商標です。本ガイドは独立した内容で、公式とは提携していません。
最初の Claude Code mod をインストールして使う
mod とは何かを理解する
- 1
mod が何を変えるかを知る
Claude Code 2.1.287 は mods を導入しました：エージェントそのものの、より深い挙動を変えられるプラグインです。Mod はセッションイベントに反応し、独自の状態を保ち、インターフェースに直接描画できます——モデルへの追加の指示ではなく、ターミナルを拡張する小さなプログラムです。
v2.1.287 リリースノート：mods は、Claude Code 内のより深い挙動を変えられるプラグインとして紹介。動画 0:30 を見る - 2
他の拡張レイヤーの中で mods を位置づける
Skills はモデルの振る舞いを導き、MCP サーバーは外部ツールを公開し、shell hooks はライフサイクルイベントでコマンドを実行します。Mods は 4 つ目のレイヤー：プロセス内で動き、インターフェースを変え、イベントの前後で横取りできるコードです。5 レイヤーの比較はウォークスルー直下の早見表で。
- 3
Claude Code のバージョンを確認する
Mods には Claude Code v2.1.287 以降が必要で、このバージョンからデフォルトで有効です。claude --version で確認しましょう。古ければ、当サイトの Claude Code アップデートガイドに従って更新してから戻ってきてください。個別の mod はさらに新しいビルドを要求することがあります。
v2.1.287 リリースノートの内容：Claude Mods、You Should Know プラグイン、agent view のフィルタリング、バックグラウンドタスク管理。動画 0:09 を見る
1 個インストールして動かす
- 4
旧式の有効化フラグはスキップ
古い解説では CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 を設定するように書かれています——これは初期アクセスのプレビュー用でした。2.1.287 から mods はデフォルトで有効で、この環境変数は無視されるので、設定から消して構いません。Mods を有効化するのに追加の手順はありません。
- 5
マーケットプレースから mod をインストール
セッション内では /plugin install mod-name@marketplace。ターミナルからは claude plugin install mod-name@marketplace を実行し、すでにセッションが開いていれば /reload-plugins を続けます。サードパーティのコードを入れる前なら、claude plugin validate ./some-mod で検査できます。
- 6
mod の正体を読み解く
Mod の中身は hooks モジュールです：register(on) のエントリが、エンジンイベントへハンドラ関数を購読させます。各ハンドラは mods API、イベント、next() の継続を受け取る——Express ミドルウェアと同じ形で、イベントを観察・書き換え・応答してから、次へ渡せます。
実際の mod の register.tsx：on('ui.render') ハンドラが AbovePrompt コンポーネントを描き直し、テキストを 1 行追加している。動画 2:35 を見る - 7
セッションを動かして確認する
Claude Code を起動して証拠を確かめます：mod が登録したスラッシュコマンドがヘルプ一覧に現れ、/plugin ではタブの下に "1 mod active" のような行が表示されます。何も現れなければ、mod の説明を読み直しましょう——描画系 mod はターミナルとデスクトップアプリの Code タブでしか効きません。
ヘルプ一覧の /hello コマンドはインストール済み mod 由来——mod は Claude のターンを消費せず、即時実行の独自コマンドを登録できます。動画 2:32 を見る
内蔵 mods
- 8
内蔵 mods と出会う
/plugin を開いて Built-in セクションを見てみましょう：cc-plugin-agents-md は AGENTS.md をロードし、cc-plugin-diff は /diff ペインを支え、cc-plugin-plugin-authoring はプラグイン作成スキル、cc-plugin-sec-default は組織ポリシーを守り、cc-plugin-telemetry はアナリティクスを担当します。ソースは Claude Code リポジトリの mods ディレクトリにあります。
- 9
You Should Know を有効化する
You Should Know は Claude Code 内蔵のサイドエージェントです：一度有効にすればセッションを見守り、見落としそうな点を指摘してくれます。初期状態は無効——/plugin enable cc-plugin-you-should-know@builtin を一度実行すれば、今後のセッションでも有効のままです。
公式の you-should-know カード：セッションを監視するサイドエージェント。有効化は /plugin enable cc-plugin-you-should-know@builtin。動画 0:48 を見る - 10
3 つのオフスイッチを知る
個別の mod は /plugin の Installed タブで無効化。claude --safe-mode なら mod なしのセッションを 1 回だけ起動できます。または ~/.claude/settings.json に "disableAllHooks": true を設定すれば、元に戻すまで全インストール済み mod がオフのまま。内蔵 mod は 3 つの場合すべてで動き続けます——これは意図的な設計です。
主導権を握り続ける
- 11
セキュリティモデルを尊重する
Mods はあなたの権限で、サンドボックスなしで動きます：環境変数やシークレットを読め、プロンプトを書き換えられ、ツール呼び出しを事前承認でき、利用枠を使えます。自分のマシンで素のコードとして動かしてもよいものだけをインストールし、/plugin でセッションが実際に何をロードしたか監査しましょう。
- 12
mod がどこに描画できるかを知る
Mod の UI——トランスクリプトの横のペイン、プロンプト上の帯、独自タブ——はターミナルとデスクトップアプリの Code タブに描画されます。WSL セッション、VS Code のチャットパネル、claude -p 実行、Agent SDK、クラウドセッションでは描画されず、Claude Code の UI の再スタイルはできても、権限プロンプトだけは決して変えられません。
Mods、plugins、skills、MCP、hooks の違い
Claude Code には 5 つの拡張レイヤーがあり、名前はすぐ混ざります。短くまとめると——コードがどこで動き、何に触れるか：
- 1Skills は markdown の指示パッケージ。呼び出されたときのモデルの振る舞いを導きます——それ自体はコードを実行しません。
- 2MCP サーバーは Model Context Protocol 経由で外部ツールやデータソースにつなぎます——プロセスの外で、ツールとして公開。
- 3Shell hooks は設定ファイルに書いたコマンドをライフサイクルイベントで実行する仕組み。ツール呼び出しの前後など。
- 4Plugins はその全部——コマンド、エージェント、MCP サーバー、hooks——を 1 つのインストール可能なパッケージに束ねます。
- 5Mods は hooks モジュールをプロセス内で動かすプラグイン：TypeScript の関数で、UI を描き直し、イベントを途中で横取りし、イベント間で状態を保てます。
経験則：指示は skills、連携は MCP、自動化は shell hooks、梱包は plugin——そして Claude Code 自体の見た目やイベントの行方を変えたいとき、それが mod です。