Claude Codeの新機能「Claude Mods」とは？できること・安全面の注意・オン/オフの方法

2026年10月1日公開のClaude Code v2.1.287で、「Claude Mods（モッズ）」が追加されました。プラグインがClaude Codeのより深い動作を変えられるようになる仕組みです。Claude Codeを日常的に使っている方や、チームへの導入を担当している方に向けた記事です。この記事では、Modsとは何か、できること、使える場所、安全面の注意、オン/オフの方法を整理します。

Claude Modsとは何か

公式のリリースノートは、v2.1.287の変更点を「Claude Modsを追加。プラグインがより深い動作を変更できるようになった」と記しています。

公式ドキュメントでは、mod（モッド）を「Claude Codeの見た目や動作を変えるプラグイン」と説明しています。中身は、JavaScriptまたはTypeScriptで書いた「イベントハンドラー（出来事が起きたときに呼ばれる処理）」です。出来事の例は、ツールの呼び出し、プロンプトの送信、画面の一部の描画などです。ハンドラーは、その出来事を見るだけでなく、書き換えたり、処理を引き取ったりできます。

プラグインは、mod、設定フック、スキル、MCPサーバーを1つに入れて配れる仕組みです。公式ドキュメントによると、イベントハンドラーを登録するコードを持つプラグインを「mod」と呼びます。

Modsはv2.1.287以降が必要で、標準でオンです。バージョンは、シェルで claude --version を実行すると確認できます。

Modsでできること

従来のスキル、設定ファイルのフック、ステータスライン、MCPサーバーは、Claude Codeの外側で動きます。modはClaude Codeの内側で動くため、公式ドキュメントでは次のようなことができるとされています。

• 操作できる画面を描く（記録の横のペイン、プロンプトの上の帯。タブ、ボタン、入力欄つき）
• Claude Code自身の画面を描き直す（ツール呼び出しの行、スピナー、質問のダイアログなど）
• ツール呼び出しやリクエストに割り込む（ユーザーに質問するまで保留する、ツールを動かさずに答える、1つのリクエストを別のモデルに送る、など）
• コマンドで自分の関数を動かす（Claudeのターンを使わずに、すぐに実行）
• フック同士でデータを共有する（片方が数えた値を、もう片方が表示する、など）

処理の選び方は3つ

公式ドキュメントでは、ハンドラーは出来事に対して次の3つのうちどれかを選びます。

選択	内容
見るだけ（Observe）	出来事を記録して、そのまま続ける
書き換える（Rewrite）	出来事を変えてから続ける
引き取る（Answer）	自分で処理して、通常の動作は動かさない（コマンドの拒否など）

公式の小さな例は、Claudeが使ったツールの回数を数え、スピナーの横に「Thinking · tool calls: 3…」のように表示するmodです。ファイルは3つ（plugin.json、hooks.json、register.js）で構成されます。

mod・設定フック・スキル・MCPサーバーの違い

公式ドキュメントは、4つの違いを次のように整理しています。

	mod	設定フック	スキル	MCPサーバー
何か	Claude Codeが自分のプロセスで呼ぶ、プラグイン内の関数	出来事のたびにClaude Codeが動かす、シェルコマンド・HTTPリクエスト・プロンプト	Claudeが読む SKILL.md の指示	Claudeにツールを渡す外部のプロセスやサービス
画面に描けるか	描ける	描けない	描けない	描けない
書くもの	JavaScriptかTypeScript	スクリプトと settings.json の記述	Markdown	任意の言語のサーバー
選ぶ場面	ペイン、帯、独自コマンドが欲しいとき。出来事を書き換えたいとき	手持ちのスクリプトで、出来事を止める・許可する・記録したいとき	同じ指示を何度も貼り付けているとき	外部のシステムにClaudeを接続したいとき

すでに設定フック、スキル、MCPサーバーで足りる場合は、先にそちらを比べるよう公式は案内しています。

使える場所

公式ドキュメントによると、modのフック（処理）は、そのプラグインを読み込むすべての種類のセッションで動きます。ただし、画面への描画が出るのは、ターミナルとデスクトップアプリに限られます。

実行場所	フックが動く	描いた画面が出る
ターミナルの claude（エディタ内のターミナルやJetBrainsプラグインを含む）	動く	出る
デスクトップアプリのCodeタブ（WSLセッションを除く）	動く	出る（一部の要素はターミナルのみ）
デスクトップアプリのWSLセッション	動かない（WSLではプラグインが使えない）	出ない
VS Code拡張のチャットパネル	動く	出ない
claude -p とAgent SDK	動く	出ない
クラウドセッション	動く（クラウドに引き継がれるプラグインの場合）	出ない

組み込みのmod「You should know」

Claude Codeの機能の一部は、すでにmodとして作られています。たとえば /diff です。/plugin を開き、Installed タブの Built-in に一覧が出ます。

v2.1.287では、新しい組み込みmod「You should know」も加わりました。リリースノートは「側で見守るエージェントが、あなたやClaudeが見落とすかもしれないことを知らせる」modと説明しています。公式ドキュメントでは、長めの作業中に動き、見落としそうなことが見つかると、プロンプトの上にメモを表示するとされています。

• 標準では無効です。
• 有効にするコマンドは /plugin enable cc-plugin-you-should-know@builtin です。
• リリースノートは「テレメトリ（利用状況の送信）がオンの、ファーストパーティのセッション向け」と書いています。
• 組織によっては、/plugin の一覧で「Show disabled」を選んだときに出るとされています。

安全面の注意：信頼できるものだけを入れる

公式ドキュメントは、modを「あなたの権限で動くコード」と説明し、信頼できる作者とマーケットプレイスからだけ入れるよう求めています。読み込まれたmodは、次のことができます。

• あなたのユーザーアカウントが読み書きできるファイルの読み書き、プログラムの起動、ネットワーク通信
• 環境変数や設定ファイル（保存したAPIキーを含む）の読み取り
• すべてのプロンプトとClaudeのツール呼び出しの閲覧
• プロンプトやツール呼び出しの書き換え
• 確認される前にツール呼び出しを承認すること
• あなたのプランやAPIキーでモデルを呼び出して、利用量を使うこと

また、modはサンドボックス（隔離された実行環境）に入りません。サンドボックスをオンにしても、隔離されるのはClaudeが動かすBashコマンドで、modが起動したプロセスは外で動きます。

ただし、modは権限確認の画面（パーミッションプロンプト）の見た目は変えられません。画面が何を示すかは変えられない、とされています。

入れる前に中身を調べる

公式ドキュメントは、実行せずに中身を調べる方法を示しています。プラグインのファイルを手元に取得してから、シェルで次を実行します。

claude plugin validate ./some-mod

出力の hooks: と calls: の行に、modが扱う出来事と、Claude Codeに頼む操作（ファイルの読み取りやネットワーク通信など）が並びます。

プラグイン全般の確認手順として、/plugin で選んだプラグインの詳細に出る「Will install」の欄と、claude plugin details <プラグイン名> で見られる「Component inventory」（部品の一覧）が案内されています。

オン/オフの方法

modは標準でオンです。止めたい範囲に応じて、次の方法があります。

1. 1つのmodだけ止める：/plugin の Installed タブで、そのプラグインを無効化またはアンインストールします。
2. 1つのセッションで、インストール済みのmodをすべて止める：--safe-mode をつけてClaude Codeを起動します。ほかのカスタマイズも使われなくなります。
3. すべてのセッションで、インストールしたmodをすべて止める：~/.claude/settings.json に "disableAllHooks": true を設定します。設定ファイルのフックと、自作のステータスラインも止まります。

組織の管理者は、どのmodを読み込むかを制限できます。管理者向けの手順は、公式の「Manage mods for your organization」にあります。

なお、disableAllHooks や組織の allowManagedModsOnly はmodを止めますが、プラグインそのものは残り、スキル・コマンド・エージェント・MCPサーバーは読み込まれます。組み込みのmodは、インストール済みmodを止める設定やフラグでは止まりません。

よくある質問

Q. modを使うには何が必要ですか。 A. Claude Code v2.1.287以降です。標準でオンになっています。

Q. modは自分で作れますか。 A. はい。公式ドキュメントでは、Claude Codeのセッションで作りたい内容を説明すると、Claudeがmodを書く方法が案内されています。自分で書く方法もあります。

Q. 入れたmodが動いているかを確かめる方法はありますか。 A. ターミナルのセッションで /plugin を開くと、タブの下に「1 mod active · first-mod」のように、数と名前が出ます。組み込みmodは、この表示に含まれません。

Q. 安全のために、まず何をすればよいですか。 A. 信頼できる作者とマーケットプレイスのものだけを入れ、入れる前に claude plugin validate で、扱う出来事と呼び出す操作を確認します。

まとめ

• Claude Modsは、プラグインがClaude Codeの内側で動作や画面を変えられる仕組みで、v2.1.287以降に対応しています。
• modは「あなたの権限で動くコード」です。ファイル、環境変数、プロンプトに触れられるため、信頼できる作者のものだけを入れます。
• 1つのmod、1つのセッション、すべてのセッションの3段階で止められます。
• 組み込みの「You should know」は標準で無効です。使うときは /plugin enable cc-plugin-you-should-know@builtin で有効にします。

まず claude --version でバージョンを確認し、気になるmodがあれば claude plugin validate で中身を調べてから入れるかどうかを決めてください。最新の仕様は、公式ドキュメントで確認してください（この記事は2026年10月2日時点の内容です）。

関連記事として、Claudeのモデルの話題は Claude Sonnet 5.5の公開・料金・移行ガイド もあわせてどうぞ。