Claude Code Modsとは？Skills・MCPとの違いと使い方【2026年10月時点】

図1：modにできること5つの概念図（出典：Claude Code公式ドキュメント「Mods overview」をもとに作成）

Claude Code Mods（以下、mod）とは、Claude Codeの見た目や動きを変えるプラグインの一種です。「Claude Codeの画面に自分用の表示を足したい」「危険な操作の前に確認を挟みたい」といった調整を、Claude Codeの内側で行えます。

この記事は、2026年10月30日時点の公式ドキュメントをもとに、modの定義、Skills・MCPとの違い、Anthropic公開のサンプル、使い方（確認と停止まで）、安全上の注意を1本にまとめたものです。

Claude Code Modsとは？

Claude Code Modsとは、JavaScriptまたはTypeScriptで書いたイベントハンドラ（イベントが起きたときにClaude Codeが呼び出す関数）を持つプラグインで、Claude Codeの見た目と動作を変えます（Mods overview）。イベントには、ツールの呼び出し、プロンプトの送信、画面の一部の描画などがあります。

modにできることは、公式のmodsページでは次のように整理されています。

• 操作できる画面を描く：プロンプトの上の帯（バンド）や、会話の横のペイン（表示領域）に、タブ・ボタン・入力欄を出せます
• Claude Code自身の画面を描き直す：ツール呼び出しの行、スピナー（待機中の表示）、質問ダイアログなどを差し替えたり、見た目を変えたりできます
• ツール呼び出しやリクエストに介入する：ツールの実行を保留してユーザーに確認したり、別のモデルにリクエストを送ったりできます
• 独自の /command を追加する：Claudeの処理を待たずに、modの関数をすぐ実行するコマンドを作れます
• フック間でデータを共有する：同じmodのフックは変数を共有できるため、あるフックが記録した値を、別のフックが表示できます

対象は、Claude Codeのターミナル版、デスクトップアプリのCodeタブ、VS Code拡張です。ただし、デスクトップアプリのWSLセッションではプラグイン自体が使えないため、modも動かないと公式のmodsページは説明しています。

/diff もmodの1つ

Claude Code標準の /diff は、modと対立する機能ではなく、組み込みmod（cc-plugin-diff）が画面を描いています。組み込みmodは、/plugin のInstalledタブの「Built-in」に並びます。更新やアンインストールはできません。cc-plugin-diff が有効になるのは、ターミナルの対話セッションです。/plugin で無効にしても /diff は残り、Claude Code組み込みの /diff が応答します。

つまり、modは「後から足す特別な拡張」だけでなく、Claude Code自身の一部の機能にも使われている仕組みです。

Skills・MCP・設定フックとの違いは？

図2：mod・設定フック・Skill・MCPサーバーの違いの概念図（出典：Claude Code公式ドキュメント「Mods overview」の比較表をもとに作成）

modは、Claude Code自身のプロセスの中で動く関数で、画面に描画できる点が、Skills・MCPサーバー・設定ファイルのフックとの違いです。公式の比較表をもとに、観点ごとに整理します。

この表から言えるのは、画面への描画やイベントの書き換えがほしければmod、同じ指示の繰り返しならSkill、Claudeを外部システムにつなぐ目的ならMCPサーバー、という使い分けです。

なお、公式は設定フックとmodの両方を「hook」と呼ぶため、modsのページでは、設定ファイルに書くものを「設定フック」と区別しています。また、1つのプラグインにSkill・MCPサーバー・modを同梱できます。

▼ Claude Codeのスキルについては、下記の記事をご覧ください。

Anthropic公開のサンプルでできることは？

Anthropicが公開しているサンプルは3つあり、内容は、コンテキストウィンドウの使用率の表示、危険なコマンドの保留、ファイル編集の振り返りです。コンテキストウィンドウとは、AIが一度に処理できる文章の量のことです。

3つとも、claude-code-playground リポジトリの claude-code/mods に置かれています。

• token-weather：コンテキストウィンドウの使用率を、天気のアイコンと言葉でプロンプトの上の帯に表示する機能

  使用率が25%未満なら「Clear」、90%以上なら「Compact soon」といった5段階です。表示される割合はウィンドウ全体に対するもので、Claude Code自身の通知とは基準が異なると、READMEは注記しています（claude-code-playground公式リポジトリ token-weather/README.md）

• blast-radius：特定の危険なBashコマンドの実行をいったん保留し、想定される影響範囲を表示して、実行・中止を選べる機能。ただし、検知対象は限定されており、実行前の影響調査でプロジェクトのコードが読み込まれる場合もあるため、完全な安全性を保証するものではありません。

  対象は、Claudeが rm -rf、git reset --hard、force push、データベースの移行コマンドなどをBashで実行しようとしたときです。「Proceed（実行）」「Cancel（中止）」のボタンが出ます。READMEは「安全網であって、権限システムではない」と明記し、完全に止めたい場合は権限ルールを使うよう案内しています。監視するのはBashツールだけです。$(...)、eval、bash -c などを使ったコマンドは検知しません。10分間応答がなければ、コマンドは拒否されます（claude-code-playground公式リポジトリ blast-radius/README.md）

• replay-theater：直前のターンでClaudeが行ったファイル編集を、1件ずつ差分で振り返る機能

  /replay コマンドで呼び出します。編集を記録して見せるだけで、止めたり変えたりはしません。拒否した編集や失敗した編集も表示に残り、記録はそのセッションのメモリー上にだけあります（claude-code-playground公式リポジトリ replay-theater/README.md）

動作環境は、token-weatherとreplay-theaterのREADMEがターミナルを挙げています。blast-radiusのREADMEは、サイドペインにターミナルの幅約144列以上を求め、それより狭いとプロンプト上の帯に表示すると書いています。3つのREADMEに、デスクトップアプリの記載はありません。

3つのREADMEは、「そのままの形で共有しているもので、Anthropicの公式製品ではなく、サポートや保守は想定していない」旨を記載しています。

Claude Code Modsの使い方は？

図3：modを使い始めてから止めるまでの6ステップの概念図（出典：Claude Code公式ドキュメント「Create a mod」をもとに作成）

使い方は、バージョンの確認、Claudeに頼んで作成、許可ダイアログへの回答、読み込みの確認、Anthropic公開のサンプルの試用、停止または保存の6段階です。以降の手順は、ターミナル版とデスクトップアプリで、画面や方法が違う箇所を、それぞれ書いています。

Step 1：バージョンを確認する

modは既定で有効ですが、使う場所ごとに必要なバージョンが違います。

古い場合は、Claude Codeを更新します。先行利用期間（early access）中に、環境変数 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS を設定していた場合は、削除します。v2.1.287以降はこの変数を無視するため、0 を設定してもmodは止まりません。

Step 2：Claudeに頼んでmodを作る

Claude Codeの対話セッションで、作りたいmodを言葉で説明すると、Claudeがmodを書きます（Create a mod）。自分でコードを書く必要はないため、コードが書けなくても作り始められます。Claudeは、modの書き方を知っている組み込みのSkill（plugin-authoring）をもとに作成します。/plugin-authoring を入力して、自分でこのSkillを読み込ませることもできます。

公式の例を日本語にすると、次のような頼み方です。

現在のgitブランチをプロンプトの上に表示するmodを作って

Claudeは、セッションごとのmod用フォルダ（~/.claude/dev-mods/ の下に、セッションIDのフォルダ）にmodを書きます。default と acceptEdits の権限モードでは、このフォルダが保護されたパスのため、ファイルを作るたびに承認を求められます。1ファイルずつ内容を確認して承認します。この承認は、次のStep 3の確認（modを有効にするか）とは別のものです。

次の場合は、承認してもmodが読み込まれません。

• 承認する人がいないセッション（claude -p での実行、dontAsk モード）
• 信頼確認（trust prompt）に答えていないディレクトリ
• --safe-mode・--bare、disableAllHooks、組織の管理設定でmodが無効になっている場合

Step 3：許可ダイアログに答える

最初のファイルが保存されると、Claude Codeが「Turn on the mods Claude writes in this session?」（このセッションで、Claudeが書いたmodを有効にしますか）と尋ねます。説明文には、「ターンの終わりにmodが読み込まれ、変更のたびに読み込み直される」という内容が書かれています。公式ドキュメントは、この確認を、変更を即時に反映する仕組み（ホットリロード）を有効にするかどうかの確認として説明しています。

ターミナル版では、次のように表示されます。

図4：ターミナル版で、modを有効にするかを尋ねられる画面

デスクトップアプリのCodeタブでは、次のように表示されます。選択肢は3つです。

図5：デスクトップアプリのCodeタブで、modを有効にするかを尋ねられる画面

答えの中心は2つです。

• Turn them on（公式ドキュメントでは「Enable for this session」と書かれている選択肢にあたると考えられます）：ターン（1回の依頼とClaudeの応答のひとまとまり）が終わるときにmodを読み込み、modを変更したターンの終わりごとに読み込み直します。答えは、セッションを再開しても続きます
• Not now：その場では何も読み込まれません。ファイルは残り、そのセッションを次に始めるときに読み込まれます。読み込ませたくない場合は、modのディレクトリを削除します

「Turn them on」を選ぶと、ターンの終わりにmodが読み込まれます。先ほどの例（現在のgitブランチを表示するmod）なら、入力欄の上にブランチ名の帯が出ます。modが有効になった画面は、次のとおりです。

ターミナル版

図6：ターミナル版でmodが読み込まれ、入力欄の上にブランチ名が出た画面（ブランチ名の一部は黒塗り）

デスクトップアプリ

図7：デスクトップアプリのCodeタブでmodが読み込まれ、入力欄の上にブランチ名が出た画面（ブランチ名の一部は黒塗り）

Step 4：読み込まれたか確認する

まず、画面を見ます。頼んだ機能が動けば、読み込まれています（Step 3の図6・図7）。思ったとおりでなければ、Claudeに直したい点を伝えます。modはファイルを変更したターンの終わりに読み込み直されるため、Claudeの作業が終わればすぐ試せます。

画面に何も出ないときや、独自コマンドを足すmodのように、画面に表示のないmodのときは、別の方法で確認します。

ターミナルでは、/plugin を実行してTabキーでInstalledタブを選ぶと、読み込まれたmodが一覧に出ます。ここからmodを無効にすることもできます（手順はStep 6にあります）。

図8：ターミナル版で「/plugin」を入力した画面（ブランチ名の一部は黒塗り）

/plugin を開くと、タブの下の薄い行に、読み込まれたmodの数と名前が 1 mod active · first-mod のように出ます。この行には、組み込みmodは含まれません。実際に2つのmod（gitブランチと、日付・時刻を表示するもの）を作った画面では、「2 mods active · clock-band, git-branch-band」と出ました。

図9：ターミナル版の「Installed」タブを開いた画面（MCPの名前の一部は黒塗り）

デスクトップアプリでの確認手順は、公式のmodsページに記載が見当たりません。筆者が試したところ、Codeタブの入力欄に /plugin を入力しても確認できず、設定の「プラグイン」画面にも、Claudeに作らせたmodは出ませんでした。画面に表示のないmodについては、筆者の環境では、Claudeに会話履歴を確認してもらうことで、modの読み込みに関する記録を確認できました。ただし、これは公式に案内された動作確認方法ではありません。読み込みに問題がある場合は、公式のトラブルシューティングに従ってログを確認する必要があります。

Step 5：Anthropic公開のサンプルを試す

Anthropic公開のサンプルは、リポジトリをコピーして --plugin-dir で1回のセッションだけ読み込ませると試せます。サンプルは、それぞれ完成したプラグインです。

サンプルの入手と読み込み（token-weatherの例）

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods
claude plugin validate ./token-weather
claude --plugin-dir ./token-weather

3行目の claude plugin validate は、modを実行せずに、受け取るイベントと呼び出す機能を一覧するコマンドです。結果の見方は、後述の「安全上の注意は？」で説明します。他のサンプルを試すときは、token-weather の部分を blast-radius や replay-theater に置き換えます。

token-weatherを読み込むと、プロンプトの上に、コンテキストウィンドウの使用率が表示されます。筆者がターミナル版で動かしたところ、使用率が6%のときは、太陽のマークと「Clear」が表示されました。

図10：ターミナル版でtoken-weatherを読み込んだ画面。プロンプトの上に、コンテキストの使用率が表示される

blast-radiusのREADMEは、危険なコマンドを試す手順として、使い捨てのリポジトリで、rm -rf build でbuildフォルダを削除するようClaudeに頼む例を示しています。また、動作に bash、git、find、du が必要と書かれています。

サンプルを常用したい場合や、他の人が配布するmodを入れる場合は、次の方法を使います。

• marketplaceから入れる（marketplaceは、プラグインの配布元です）：セッション内で /plugin install プラグイン名@marketplace名 を実行します。例は /plugin install token-chart@your-org です
• シェルから入れる：claude plugin install プラグイン名@marketplace名 を実行します。開いているセッションでは /reload-plugins を実行すると、読み込まれます
• サンプルを残す：コピーした claude-code/mods フォルダをmarketplaceとして追加し、そこからインストールします。このmarketplaceはコピーしたフォルダを指すため、フォルダを移動・削除すると読み込まれなくなります

Step 6：止める、または残す

止める範囲は、1つのmod、1回のセッション、すべてのセッションの3段階から選べます。ただし、ターミナル版とデスクトップアプリでは、止め方が違います。元に戻すときは、止めたときの変更を取り消します。

ターミナル版

1つのmodを止める（Installedタブ）

手順は、公式の説明（Install and manage plugins）と、実際の画面で確認した内容にもとづきます。

1. /plugin を開き、←→キーで「Installed」タブに移ります
2. 一覧で止めたいmod（例：clock-band）を、↑↓キーで選び、Enterキーを押します
3. 詳細の画面で「Disable plugin」を選び、Enterキーを押します。「Disabled clock-band. Applies when you close this menu.」（clock-bandを無効にしました。このメニューを閉じると反映されます）と出ます
4. Escキーでパネルを閉じます。変更が反映され、そのmodの表示（この例では時刻の帯）が消えます

図11：clock-bandの詳細画面。「Disable plugin」を選ぶと無効になる

図12：無効にした後の画面。時刻の帯が消え、ブランチの帯だけが残る（ブランチ名の一部は黒塗り）

ターミナル版で、Claudeに作らせたmodの詳細メニューには、「Uninstall」の項目が出ませんでした。

止めたmodを戻す

1. /plugin の「Installed」タブを開き、一覧の最下部にある「Show disabled」でEnterキーを押します
2. 開いた一覧で、無効なmod（「disabled · inline」と表示されるもの）を選んでEnterキーを押し、「Enable plugin」を選びます
3. Escキーでパネルを閉じます。mod（この例では時刻の帯）が戻ります

図13：「Show disabled」を開いた一覧。無効にしたclock-bandが出る

図14：無効なclock-bandの詳細画面。「Enable plugin」を選ぶと有効に戻る

図15：有効に戻した後の画面。時刻の帯が戻る（ブランチ名の一部は黒塗り）

1回のセッションでmodを止める

claude --safe-mode

--safe-mode は、他のカスタマイズも無効にします。

すべてのセッションで、インストール済みのmodを止める（~/.claude/settings.json）

{
  "disableAllHooks": true
}

すでに settings.json に別の設定がある場合は、既存の内容に1行だけ足します。disableAllHooks は、modに加えて設定フックとカスタムステータスラインも止めますが、同じプラグインのSkillやMCPサーバーは読み込まれたままです。組織が管理するものは動き続け、リポジトリのプロジェクト設定で false に戻されている場合は、ユーザー設定だけでは止まりません。組み込みmodは、--safe-mode でも disableAllHooks でも止まりません。ここまでの内容は、公式の「Mods overview」の記載と一致します（プロジェクト設定で上書きされる点は、「Configure permissions」の記載です）。

Claudeが書いたmodは、そのセッションでしか読み込まれません。セッション用のフォルダは、cleanupPeriodDays より古くなると削除されます。残すときは、ディレクトリを自分の場所（例：~/mods/git-branch）にコピーし、次のコマンドで読み込みます。

コピーしたmodを新しいセッションで読み込む

claude --plugin-dir ~/mods/git-branch

デスクトップアプリ

筆者が確認できたのは、チャットでClaudeに頼んで、不要なmodのフォルダを削除してもらう方法です。

modは、セッションごとのフォルダ（~/.claude/dev-mods/ の下に、セッションIDのフォルダ）に保存されます。まず、Claudeに「保存されているmodを一覧で表示してください」と頼み、消すものを選びます。この一覧は、保存されているmodで、読み込まれているmodとは限りません。別のセッションで作られたmodは、中身が分からないことがあるため、削除する前に、どのフォルダを消すかを確認してください。

作ったmodを、別のセッションや、すべてのセッションで使う

Claudeが書いたmodは、作ったセッションでしか読み込まれません。デスクトップアプリでは、筆者がClaudeにチャットで依頼すると、modをすべてのセッションで読み込める設定にしてもらえました。

~/.claude/settings.json を書き換える依頼になるため、変更の内容を確認してから許可してください。

うまく動かないときは？

modが動かないときは、バージョン、読み込み状況、無効化の設定の順に確認します。公式のトラブルシューティングは、壊れたmodはフックがスキップされるだけでセッションは続くため、「何も起きない」ように見えると説明しています（Troubleshoot a mod）。以下の確認方法は、ターミナル版のものです。

デバッグログを書き出して起動する

claude --debug

自分でコードを書く場合は？

自分でmodのコードを書く場合は、3つのファイルで構成します。Node.jsやビルドの手順は不要で、Claude Codeが .js と .ts を直接読み込みます。

• plugin.json：プラグインの名前や説明を書く設定ファイル
• hooks.json：コードのファイルの場所を指す設定ファイル
• register.js：どのイベントでどの関数を動かすかを書くコード

公式のcreateページには、ツール呼び出しの回数をスピナーの横に表示する例があります。この記事では、コードの書き方には踏み込みません。

安全上の注意は？

modは隔離された環境（サンドボックス）で動くわけではなく、自分の権限で動くコードなので、信頼できる作者とmarketplaceのものだけを入れるのが前提です。公式は、modsのページでこの点を警告しています。

読み込まれたmodは、次のことができます。

• マシン上で自分として動く：自分のアカウントが触れるファイルの読み書き、プログラムの起動、ネットワーク要求ができます
• 秘密情報を読む：環境変数や設定ファイル（そこに置いたAPIキーを含む）を読めます
• セッションを見る：自分が送るすべてのプロンプトと、Claudeのすべてのツール呼び出しが見えます
• セッションを変える：プロンプトやツール呼び出しの書き換え、自分が入力したかのようなプロンプトの送信、他のセッションへのメッセージ送信ができます
• 確認なしで進める：ツール呼び出しを、確認を求められる前に承認できます
• 利用枠を使う：自分のプランまたはAPIキーでモデルを呼び出せます

サンドボックスを有効にしても、modが起動したプロセス（実行中のプログラム）はその外で動きます。ただし、modは権限確認の表示（permission prompt）を変更できません。表示される内容を書き換えることもできません。

modの承認が既存のルールを越えられるかは、環境で変わります。管理設定がある、またはTeam・Enterpriseのログインを使っている場合、modの承認は既定では ask ルールや PreToolUse フックを越えられません。PreToolUse フックは、ツールの実行前に動く設定フックです。

どちらもない場合は、deny ルールで拒否される呼び出しや、ask ルールで確認されるはずの呼び出し、PreToolUse フックが止めた呼び出しを、modが承認できることがあります（Configure permissions）。

導入前に中身を一覧する

図16：導入前に claude plugin validate でmodの中身を一覧する流れの概念図（出典：Claude Code公式ドキュメント「Create a mod」をもとに作成）

導入前に、modを実行せずに「受け取るイベント」と「呼び出す機能」を一覧できます。modのファイルを手元に取得し、シェルで claude plugin validate をmodのディレクトリに対して実行します。

modの中身を一覧する（実行はされません）

claude plugin validate ./some-mod

出力の hooks: の行が、modが受け取るイベントです。calls: の行が、modがClaude Codeに依頼する内容（ファイルの読み取りやネットワーク要求など）です。

実際にtoken-weatherに実行すると、次のように出ました（出力の一部）。hooks: には session.start、turn.complete、ui.render{component=AbovePrompt} が、calls: には $.session.usage、$.ui.invalidate、$.ui.resolve が並びました。ファイルの読み書きやネットワーク要求は含まれていません。

図17：token-weatherに claude plugin validate を実行した出力の一部

calls: にファイルの読み書きやネットワーク要求が含まれていれば、そのmodは自分のファイルや外部に触れる可能性があります。コードを読めなくても、導入するかどうかを判断する材料になると考えられます。ただし、このコマンドは一覧を出すもので、安全性を保証するものではありません。

組織で使う場合は？

組織で使う場合は、管理者が管理設定でmodを許可するか、どのmodを許可するかを決められます。たとえば、組織が用意したmodだけを許可する設定（allowManagedModsOnly）があります。自分で入れたmodが読み込まれないときは、組織の設定で許可されていない可能性があります。

業務で使えるmodの案は？

modは、画面に表示を足したり、ボタンや入力欄を描いたりできます。ここでは、筆者が実際に動かしたmodと、今後試す案を分けて紹介します。

筆者が動かして確認したmodは、次のとおりです。どれも、確認できたのは、画面への表示です。

そのうえで、今後試す候補として、次の3つの活用案が考えられます。いずれも、公式の機能（modがボタン・入力欄・ペインを描けること）から実現できると考えられます。

まとめ

Claude Code Modsとは、JavaScriptまたはTypeScriptのイベントハンドラでClaude Codeの見た目と動きを変える、プラグインの一種です。

• 定義：画面の描画、ツール呼び出しへの介入、独自コマンドの追加ができ、/diff も組み込みmod（cc-plugin-diff）です
• 違い：Claude Code自身のプロセスの中で動き、画面に描画できる点が、Skills・MCPサーバー・設定ファイルのフックとの違いです。Claudeを外部システムにつなぐ目的ならMCPサーバーです
• Anthropic公開のサンプル：token-weather、blast-radius、replay-theaterの3つで、サポートが保証された完成製品ではありません
• 使い方：バージョンを確認し、Claudeに頼んで作り、許可ダイアログに答え、画面の表示で読み込みを確認します（ターミナル版は /plugin のInstalledタブでも確認できます）。止めるときは、1つのmod、1回のセッション、すべてのセッションから範囲を選びます
• 安全上の注意：modは隔離されておらず、自分の権限で動くため、信頼できる作者とmarketplaceのものだけを入れ、導入前に claude plugin validate で一覧します
• 活用案：筆者が動かして確認したのは、gitブランチ、日付と時刻、token-weatherの表示です。今後試す3つの活用案は、効果が未検証の候補です

まずは claude --version でバージョンを確認し、使い捨てのリポジトリでAnthropic公開のサンプルを1つ試すところから始めると、modで何が変わるかを、リスクを抑えながら確かめられます。

---

出典一覧

1. Claude Code公式ドキュメント「Mods overview」
2. claude-code-playground公式リポジトリ token-weather/README.md
3. claude-code-playground公式リポジトリ blast-radius/README.md
4. claude-code-playground公式リポジトリ replay-theater/README.md
5. Claude Code公式ドキュメント「Create a mod」
6. Claude Code公式ドキュメント「Troubleshoot a mod」
7. Claude Code公式ドキュメント「Configure permissions」
8. Claude Code公式ドキュメント「Install and manage plugins」