メインコンテンツへスキップ
AI Tools 13分で読める

Claude Code Modsとは|エージェントを内側から書き換えるTypeScript拡張

「Modsは驚異的だ。プロンプトを1つ入れるだけで、Claudeを自分の望む方法で動かせて、見た目も変えられる。コードの書き方は人それぞれで、全員が同じClaude体験を持つ必要はない」。Claude Codeの作者Boris Chernyは2026年10月1日のリリース直後にそうXに投稿した(AI Weekly, 2026年10月)。

同日夜、AIスタートアップOneWaveのエンジニアはこう書いた。「一晩でClaude Code modを12個作った。リアルタイムの消費金額メーター、テスト失敗を敵キャラにしたボスバトルUI、秘密鍵の自動マスク処理……うち10個をオープンソースで公開した」(onewave-ai.com, 2026年10月)。

一方、セキュリティ研究者からは別の声も届いている。「modはサンドボックスなしで動作する。インストールするだけで、提供元にあなたのマシンを部分的に渡すことになる」(pluto.security, 2026年10月)。

バージョン2.1.287で投入されたClaude Code modsは、AIエージェントのカスタマイズを根本から変える機能だ。熱狂と懸念が同時に噴出している理由を、仕組みとリスクの両面から解説する。

この記事はこんな人におすすめ
  • Claude Codeを日常的に使う開発者で、繰り返し作業を自動化したい人
  • TypeScriptプラグインでAIエージェントの動作を制御することに興味がある人
  • modをインストールする前にリスクを正確に把握しておきたいエンジニア

Modsとは何か:Claude Codeを「内側」から変える仕組み

Claude Code modsは、Claude Codeのプロセス内部で動作するTypeScript(またはJavaScript)の関数だ。既存の「hooks」がシェルコマンドを外部から呼び出すのに対し、modsはClaude Code本体と同じプロセス空間で実行される。これがすべての違いを生む。

modが介入できるのは以下の場面だ(Anthropic公式ブログ, 2026年10月)。

  • before: イベントが処理される前に実行。プロンプトの書き換えや検索クエリの変更が可能
  • after: イベント完了後に実行。ツールの出力を加工したり、ログに記録できる
  • instead: そのイベント自体を乗っ取る。Claudeの代わりに別の処理を走らせられる
  • wrap: before + afterを組み合わせてイベントの前後を統合制御する

介入できるイベントは広範囲にわたる。プロンプトがモデルに送られる直前、ツール呼び出しの前後、権限要求の承認・拒否、UIの描画タイミングなどだ。

modはpluginsの中に格納される。インストールはCLIの /plugin コマンドまたはデスクトップアプリから行う(aicatchup.com, 2026年10月)。

できることの実例:公式modとコミュニティmod

Anthropicはすでに4つの公式modをanthropic/claude-codeリポジトリで公開している。

diff: /diffコマンド専用パネルを開く。これまでClaude Code本体に固定実装されていた機能がmodとして切り出された。

agents-md: プロジェクトのAGENTS.mdを恒久的な指示として読み込む。セッションをまたいで同じルールを維持できる。

sec-default: Team・Enterpriseプランおよびマネージドデバイス向けのセキュリティガード。組織が設定した権限拒否ルールを、ユーザーが個別にインストールしたmodが上書きしないよう保護する。

telemetry: 使用状況データを内部の分析システムに送信する。

コミュニティ側の動きも速い。コミュニティ発でAnthropicが公式採用した「Ralph Loop」は、Claude Codeに反復実行を導入するmodだ。成功条件を定義すると、Claudeが自身のアウトプットをレビューし、未達なら再試行し続ける。品質向上を目的とした反復タスクに向いているとして紹介されている(lucaberton.com, 2026年10月)。

OneWaveが公開した「spend-meter」は、現在のセッションで消費しているAPI費用をリアルタイムでステータスバーに表示する。UberがClaude Codeで2026年分の予算を4ヶ月で使い果たした経緯を踏まえると(詳細はこちら)、これは純粋に実用的な需要に応えたmodだ。

セキュリティの死角:「サンドボックスなし」が意味すること

modsの最大リスクを、Anthropicは公式ブログで隠さず書いている。「modsはClaude Code本体と同じマシンアクセス権で動作する」(Anthropic公式ブログ, 2026年10月)。

具体的に何が可能かというと(nerdschalk.com, 2026年10月):

  • アカウントがアクセスできるファイルの読み書き
  • プログラムの起動とネットワーク通信
  • 環境変数や設定ファイル(APIキーや秘密鍵を含む)の読み取り
  • 権限要求を自動承認してユーザーの確認をスキップ
  • モデルへの呼び出しをあなたのプランまたはAPIキーに課金

インストール画面でこれらの能力が明示されるわけではない。「信頼できるソースのmodのみインストールする」というAnthropicの注意書きは、npm installやbrew installのそれと同等の意味しか持たない。

Enterprise向けにはsec-defaultが一定の防衛線を張る。しかし個人のPro・Maxプラン利用者には組織レベルの保護はなく、インストール前のコードレビューが唯一の防衛手段だ。

セキュリティ研究者は「modがモデルへのプロンプトを書き換えられる設計は、プロンプトインジェクション攻撃(入力に悪意ある指示を混入してAIに意図しない動作をさせる手法)の新たな経路になりうる」と指摘している(runtimewire.com, 2026年10月)。

Claude Code hooksやCLAUDE.mdとmodsの使い分け

Claude Codeには既存のカスタマイズ手段が複数ある。modsはそれらを置き換えるわけではない。

CLAUDE.md: Claudeへの指示書。モデルの挙動を変えるが、ツール呼び出しの制御やUI変更はできない。 hooks: 特定のライフサイクルイベントでシェルコマンドを実行する。外部ツールとの連携に向いているが、プロセス内部へのアクセスはない。 mods: Claude Codeプロセス内に入り込み、プロンプト・ツール呼び出し・権限・UIをすべて制御できる。最も強力だが最もリスクも高い。

「外部の通知・ログ・スクリプト実行」ならhooks、「Claudeの思考や返答の傾向を変えたい」ならCLAUDE.md、「エージェントの動作そのものを変えたい、UI要素を追加したい」ならmodsという使い分けが基本だ。

Claude Code modsのインストール手順(3ステップ)
  1. プラグインのURLまたはリポジトリを確認する: modはpluginとしてパッケージされている。GitHubリポジトリのコードを事前に読み、内容を確認する
  2. /plugin install [URL] を実行する: CLIまたはデスクトップアプリのコマンドパレットで/pluginを開き、URLを指定してインストール
  3. Claude Codeを再起動する: modsはセッション開始時にロードされる。インストール後は再起動が必要

Claude Codeの最新機能をまとめて把握したい開発者へ

modsはClaude Code 2.1.287で追加された機能の一つ。並列スレッドやProjects機能など、直近のアップデートを把握しておくと開発フローを改善できる可能性がある。

Claude Code Projectsの詳細を見る

Claude Code関連記事


本記事の情報は2026年10月7日時点のものです。Claude Codeおよびmods仕様は随時更新されます。インストール前に必ずAnthropic公式ドキュメントを確認してください。本記事はAnthropicの公式見解を代表するものではありません。本記事の情報に基づいてmodをインストール・使用した結果生じたセキュリティ被害・API課金・データ損失等のいかなる損害についても、筆者は責任を負いません。

Share