PR｜この記事にはアフィリエイト広告（A8.net）が含まれます。
Claude Codeの「mods」が発表されたものの、フックやスキル、プラグインと何が違うのか、自分のプランで使えるのか、入れても安全なのかが分からない。そんな疑問に、Anthropicの公式ブログと公式ドキュメントの範囲で答えます。
modsは、Claude Codeの動きと見た目を自分で書き換えるための小さなプログラムです。AnthropicはmodsをTypeScriptの関数として2026年10月1日に発表し、公式ドキュメントではJavaScriptでも書けると説明しています。プロンプトやツール呼び出しを書き換えたり、画面に自分用のパネルやボタンを足したりできます。modsはプラグインの中に入れて配布され、動く場所はClaude CodeのCLIとデスクトップアプリです。Claude Code自体はPro・Max・Team・Enterpriseの各プランかConsoleアカウントで使え、modsにはバージョン2.1.287以降が必要です。
情報確認日：2026年10月2日
Anthropicの公式ブログと、Claude Codeの公式ドキュメント（日本語版・英語版）をもとにまとめた解説です。
- modsを使うにはClaude Codeのバージョン2.1.287以降が必要です。対象のバージョンでは、modsは最初から有効になっています。
- 画面に何かを描くmodは、ターミナルのClaude Codeとデスクトップアプリの「Code」タブでだけ表示されます。VS Code拡張のチャット欄やクラウドセッションでは、処理は動いても画面には出ません。
- modsはサンドボックスの外で、あなたのユーザー権限のまま動きます。Anthropicも「信頼できる提供元のmodだけを入れる」よう案内しています。
PR 生成AIを仕事で使う力をまとめて学ぶなら、DMM 生成AI CAMP 学び放題（職種別11コースが月額14,800円（税込16,280円）で学び放題）。先に仕組み・料金・解約条件の解説を読むこともできます。
Claude Codeのmodsとは？2026年10月1日に発表された仕組み
Claude Codeは、ツールを呼び出す、許可を求める、画面の一部を描くといった動作のたびに「イベント」を出します。modは、このイベントに合わせてClaude Codeが呼び出す関数です。modの関数は、イベントの前・後・代わりに処理を挟めます。前後の両方で処理を走らせることもできます。
公式ドキュメントは、modの関数がイベントに対して取れる動きを3つに分けています。何が起きたかを記録してそのまま先へ進める「見るだけ」、中身を変えてから進める「書き換え」、本来の処理を走らせずにmod側で結果を返す「自分で答える」です。コマンドを拒否する処理は3つ目にあたります。
Anthropicは、利用者が機能の追加を待たずにClaude Codeの動きを変えたいという要望に応えるためにmodsを作ったと説明しています。従来のフックでもイベントに処理を足せましたが、イベントの書き換え、新しい画面の描画、機能の置き換えはできませんでした。modsはこの3つができます。Anthropicは公開前にGitHubで設計を示し、開発者から意見を集めています。
modsで何ができる？プロンプトの書き換えから画面の追加まで
公式ブログと公式ドキュメントが挙げている用途は、次のとおりです。
- モデルに届く前にプロンプトを書き換える
- ツール呼び出しを止める、書き換える、やり直させる
- 許可を求める確認に、modが承認または拒否で答える
- ツールの出力に含まれる秘密の値を、Claudeが読む前に伏せる
- 会話の横にパネルを出したり、入力欄の上に帯を出したりする。タブ、ボタン、テキスト入力も置ける
- ツール呼び出しの行やスピナー、Claudeが質問するときのダイアログなど、Claude Codeが描く画面の一部を差し替える
- Claudeのターンを使わずに自分の関数を実行する
/コマンドを追加する
公式ドキュメントの例では、Claudeがツールを呼んだ回数を数え、作業中のスピナーの横に回数を出すmodを紹介しています。同じファイルにある複数の関数は変数を共有できるため、ある関数が数えた値を別の関数が画面に表示できます。
チーム向けの例として、公式ブログは3つを挙げています。CI/CDの結果を会話の横に表示して更新し続けるmod、本番環境の設定に触れるコマンドの前に確認を求めるmod、最初に読み込まれて他のmodの呼び出しをすべて記録する監査用のmodです。
同じイベントに複数のmodが関わる場合、modは読み込まれた順に動きます。最初に読み込まれたmodは、イベントを最初に受け取り、結果を最後に受け取ります。この順番があるため、別々の作者が作ったmodを重ねて使える仕組みです。
Claude Codeの組み込み機能の一部もmodになった
Claude Codeの/diffは、組み込みのmodとして動くようになりました。/pluginの画面でオフにしたり、自分で作った版に置き換えたりできます。Anthropicは、ほかの組み込み機能も順次modに移し、利用者が小さな中核部分に必要な機能だけを足せるようにする予定だと説明しています。
組み込みのmodは、/pluginの「Installed」タブで「Built-in」の欄に並びます。公式ドキュメントには、AGENTS.mdをプロジェクトの指示として読み込むmod、/diffの画面を描くmod、modを書くためのスキルを渡すmod、後で説明する安全用のmod、分析記録を送るmodなどが載っています。このうち/diff、AGENTS.md、安全用のsec-default、分析記録のtelemetryの4つは、ソースコードがGitHubのClaude Codeリポジトリで公開されています。
フック・スキル・MCP・プラグインとmodsの違いは？
modsはプラグインの一種です。プラグインは配布の単位で、1つのプラグインにmod、スキル、MCPサーバーなどをまとめて入れられます。公式ドキュメントの比較表をもとに、似た仕組みとの違いを整理しました。
| 仕組み | 中身 | 変えられるもの | 画面に描けるか | 向く場面 |
|---|---|---|---|---|
| mod | プラグインの中のJavaScriptまたはTypeScriptの関数。Claude Codeの中で動く | ツール呼び出し、プロンプト、コマンド、ターン、画面の表示 | 描ける | パネルや入力欄の上の帯、独自コマンドが欲しいとき。イベントを書き換えたいとき |
| 設定ファイルのフック | 設定ファイルに書くシェルコマンド、HTTPリクエスト、プロンプト | ツール呼び出しやプロンプトを通すかどうか、ツールの引数と結果、Claudeに足す情報 | 描けない | 手元のスクリプトでイベントを止める、許可する、記録するとき |
| スキル | Claudeが読む指示を書いたSKILL.md | Claudeが知っていることとやること | 描けない | 同じ指示を何度も貼っているとき |
| MCPサーバー | Claudeにツールを渡す外部のプロセスやサービス | Claudeが使えるツール | 描けない | Claudeを外部のシステムにつなぎたいとき |
公式ドキュメントは、やりたいことが設定ファイルのフック、スキル、MCPサーバーで済むなら、modを書く前にこの比較を確かめるよう勧めています。既存のスクリプトでコマンドを止めたいだけなら、従来のフックで足ります。画面に情報を出したいときや、Claude Codeの動き自体を差し替えたいときがmodの出番です。
なお、公式ドキュメントのmodsのページでは、modの関数も「hook」と呼びます。設定ファイルに書く従来のフックは「settings hook」と呼び分けているので、ドキュメントを読むときは区別してください。
modsはどのプラン・どの環境で使える？
公式ブログとmodsのドキュメントには、mods専用の対象プランは書かれていません。modsはClaude Codeの機能で、公式資料が挙げている条件はバージョンと使う場所だけなので、Claude Codeを使える契約であればmodsも使えると判断できます。Claude Codeを使うには、Pro・Max・Team・Enterpriseのいずれかのプランか、Anthropic Consoleのアカウントが必要です。claude.aiの無料プランにはClaude Codeが含まれません。Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryといった外部のAPI提供元経由でもClaude Codeを使えます。デスクトップアプリでClaude Codeを使う場合は有料のサブスクリプションが必要です。
使う場所によって、modの動き方が変わります。公式ドキュメントの表を、主な場所に絞ってまとめました。
| Claude Codeを使う場所 | modの処理 | modが描く画面 |
|---|---|---|
ターミナルのclaude（エディタ内のターミナル、JetBrainsプラグインを含む） | 動く | 表示される |
| デスクトップアプリの「Code」タブ（WSLセッションを除く） | 動く | 表示される（ターミナル専用の部品を除く） |
| デスクトップアプリのWSLセッション | 動かない（プラグインが使えないため） | 表示されない |
| VS Code拡張のチャット欄 | 動く | 表示されない |
claude -pとAgent SDK | 動く | 表示されない |
| クラウドセッション | クラウドに引き継がれたプラグインなら動く | 表示されない |
公式ドキュメントのmodsのページには日本語版があります。地域や言語による提供の制限は、確認した公式資料には書かれていません。日本で使う場合も、上のプランとバージョンの条件を満たしているかを確認してください。なお、公式ドキュメントのトラブルシューティングには、Anthropicが遠隔で入れたmodを止めている場合があると書かれています。自分の環境でmodを読み込めるかは、modの無いフォルダでclaude plugin testを実行すると確かめられます。
TeamとEnterpriseでは安全用のmodが先に読み込まれる
TeamまたはEnterpriseのプランでログインしている場合と、管理者が配った設定（マネージド設定）があるパソコンでは、sec-defaultという組み込みのmodが最初に読み込まれます。sec-defaultは、利用者が入れたmodが組織の管理する設定を書き換えないように守ります。たとえば、権限ルールのdenyで拒否している操作は、ルールがどの設定ファイルにあっても、利用者のmodでは承認できません（管理者がマネージド設定でこの制限を外した場合を除きます）。管理者はマネージド設定にsec-defaultのオプションallowManagedModsOnlyを書いて、利用者が持ち込んだmodを一切読み込ませないようにもできます。
ProやMaxで個人として使い、マネージド設定もない場合、sec-defaultは読み込まれません。APIキーや外部のAPI提供元で使う場合も、マネージド設定がなければ同じです。
modsの始め方は？Claudeに作ってもらう方法と、公開されたmodを入れる方法
最初に、ターミナルでclaude --versionを実行してバージョンを確かめます。2.1.287より古い場合は、Claude Codeを更新してください。公式ドキュメントが示す始め方は、/diffなどの組み込みのmodを使う、Claude Codeに作ってもらう、公開されているmodをプラグインとして入れる、の3通りです。
Claude Codeにmodを作ってもらう手順
公式ドキュメントでは、対話中のClaude Codeに作りたいmodを説明すると、Claudeが組み込みのスキルplugin-authoringを使ってmodを書く流れを案内しています。Node.jsやビルドの手順は要りません。
- 作りたいmodを説明します。公式ドキュメントの例は「現在のgitブランチを入力欄の上に表示するmodを作って」という依頼です。Claudeは
~/.claude/dev-mods/の下に、セッションごとのフォルダを作ってファイルを書きます。~/.claudeは保護されたパスなので、権限モードがdefaultかacceptEditsのときは、ファイルを作るたびに確認が出ます。 - 最初のファイルが保存されると、このセッションでホットリロードを有効にするかを聞かれます。「Enable for this session（このセッションで有効にする）」を選ぶと、ターンの終わりにmodが読み込まれ、Claudeが修正するたびに読み込み直されます。「Not now（今はしない）」を選んだ場合は、次にそのセッションを始めたときに読み込まれます。選択肢の表記は公式ドキュメントの英語版と日本語版によるもので、実際の画面での表示は確認していません。
/pluginを実行して「Installed」タブを開き、作ったmodが並んでいるかを確かめます。ここからオフにもできます。- 依頼した機能を実際に使ってみます。思いどおりでなければ、直してほしい点をClaudeに伝えます。
Claudeが書いたmodは、作ったセッションの中でだけ読み込まれます。セッション用のフォルダはcleanupPeriodDaysの設定で決まる期間を過ぎると削除されます。ほかのセッションでも使いたい場合は、フォルダを自分の場所にコピーし、claude --plugin-dirでそのフォルダを指定して起動すれば読み込まれます。claude -pの実行中など承認の確認を出せないセッションや、信頼を承認していないフォルダでは、Claudeが書いたmodは読み込まれません。
公開されているmodをプラグインとして入れる
modはプラグインとしてマーケットプレイスから入れます。公式ブログは、Claudeのディレクトリから入れる方法と、CLIで/pluginを実行する方法を案内しています。プラグイン名とマーケットプレイス名が分かっていれば、Claude Codeの中で/plugin install プラグイン名@マーケットプレイス名を実行して入れられます。ターミナルからならclaude plugin install プラグイン名@マーケットプレイス名でも同じです。
セッションを開いたままターミナルから入れた場合は、そのセッションで/reload-pluginsを実行すると読み込まれます。実行しなければ、次にClaude Codeを起動したときに読み込まれます。自分のmodを共有したいときの窓口は、Claudeのディレクトリの申請ページです。modをプラグインにまとめてから申請します。
自分で書く場合の最小構成
自分で書く場合、小さなmodは3つのファイルでできています。プラグインの説明書きにあたる.claude-plugin/plugin.json、コードの場所を示すhooks/hooks.json、処理を書くhooks/register.jsです。hooks.jsonのmodulesにコードのファイルを指定すると、そのプラグインがmodとして扱われます。Claude Codeは.jsや.tsなどのファイルをそのまま読み込みます。手順の全体は、公式ドキュメントの「modを作成する」にチュートリアルとして載っています。
modsを止めたいとき
- 1つのmodだけ止める：
/pluginの「Installed」タブで、そのプラグインを無効にするかアンインストールする - そのセッションだけ、入れたmodをすべて止める：
--safe-modeを付けてClaude Codeを起動する。ほかのカスタマイズも読み込まれなくなる - すべてのセッションで、入れたmodを止める：
~/.claude/settings.jsonに"disableAllHooks": trueを書く。設定ファイルのフックと独自のステータスラインも止まる
これらの方法では、組み込みのmodは止まりません。組み込みのmodは、それぞれ/pluginなどで個別にオフにします。ただし、安全用のsec-defaultは利用者側では止められません。
modsを入れる前に知っておきたい安全面の注意
modはClaude Codeと同じ権限で、サンドボックスなしに動きます。公式ドキュメントは、読み込まれたmodができることとして次の項目を挙げています。
- あなたのユーザーアカウントで読み書きできるファイルの読み書き、プログラムの起動、ネットワーク通信
- 環境変数や設定ファイルに置いたAPIキーなどの秘密の値の読み取り
- あなたが送るプロンプトと、Claudeのツール呼び出しの閲覧
- プロンプトやツール呼び出しの書き換え、あなたが入力したかのようなプロンプトの送信
- あなたに確認する前のツール呼び出しの承認
- あなたのプランやAPIキーでのモデル呼び出し（利用枠を使う）
ツール呼び出しを承認するmodは、権限ルールのaskで確認が出るはずの操作も通せます。sec-defaultが読み込まれていない個人の環境では、denyで拒否している操作も承認できると公式ドキュメントは説明しています。自動モードでは、modが承認した操作は自動判定のチェックを通らずに実行されます。一方で、権限の確認画面はmodでは書き換えられず、確認画面に表示される内容は変えられません。
入れる前に中身を確かめる方法も用意されています。プラグインのファイルを手元に取得し、ターミナルでclaude plugin validate ./フォルダ名を実行すると、modを動かさずに、扱うイベントとClaude Codeに頼む処理（ファイルの読み取りやネットワーク通信など）が一覧で出ます。出力のhooks:とcalls:の行を見て、用途に対して不要な処理が含まれていないかを確かめてください。
最初は、Claude Codeに自分で作ってもらうmodから試すのがよいと筆者は考えます。自分の依頼から作られたコードなので中身を読みやすく、作ったセッションでだけ動くため、合わなければ消すだけで済みます。他人が作ったmodを入れるときは、作者とマーケットプレイスを確かめ、claude plugin validateの結果を見てからにしてください。仕事用のパソコンで使う場合は、組織の管理者がmodを制限していないかも先に確認しておくと安心です。
Claude Codeをこれから使い始める人へ
modsはClaude Codeを使っていることが前提の機能です。まだClaude Codeを契約していない方や、何ができるのかを先に知りたい方は、Claude Codeの全体像と料金、商用利用の条件をまとめた記事を読んでいただくと、どのプランから始めればよいかが分かります。WordPressのサイト作りに使いたい方は、2本目の記事が参考になります。
modsが承認できる操作と関係の深い権限の仕組みについては、Claude Codeの自動モードとは？Pro・Maxなどで8月から既定に。止められる操作と、毎回確認するモードに戻す方法を読んでいただくと、Claude Codeが操作の前にどう確認するかが分かります。
クラウドで動かすClaude Codeについては、Claude Codeのクラウドセッション用クレジットの受け取り方。Pro 100ドル・Max 250ドル、10月7日の期限と規約の条件、始め方を読んでいただくと、クラウドセッションの始め方が分かります。
