Mods の概要

​

mod でできること

• 使用できるインターフェイスを描画する: トランスクリプトの横のペイン、またはプロンプトの上のバンド。タブ、ボタン、テキストフィールドを含みます。インターフェイスに描画する を参照してください。
• Claude Code 独自のインターフェイスを再描画する: ツール呼び出しの行、スピナー、Claude が質問をするダイアログなど、Claude Code が自身で描画する部分を置き換えたり、スタイルを変更したりします。Claude Code が既に描画しているものを変更する を参照してください。
• ツール呼び出しまたはリクエストに介入する: たとえば、ツール呼び出しを保持しながらユーザーに質問したり、ツールを実行せずに回答したり、1 つのリクエストを別のモデルに送信したりします。ツール呼び出しをガードまたは変更する と ターンをフォローする を参照してください。
• コマンドで独自のコードを実行する: Claude ターンなしで、Claude が作業中でも、すぐに関数を実行する /command。コマンドまたはツールを追加する を参照してください。
• hooks 間でデータを共有する: mod の hooks はそのファイル内の変数を共有するため、1 つの hook が記録したものを別の hook が表示できます。たとえば、1 つの hook がツール呼び出しをカウントしながら別の hook がスピナーの横にカウントを表示したり、1 つが各リクエストのトークン使用量を読み取りながら別がペインでチャートしたりできます。イベントに反応する を参照してください。

​

mod を取得する

• 既に持っているものを使用する: Claude Code 独自の機能の一部は mod です。たとえば /diff。Claude Code に組み込まれた Mod を参照してください。
• 作成する: Claude Code セッションで必要なものを説明すると、Claude が mod を作成します。Claude に mod を依頼する を参照してください。mod のコードの仕組みを学ぶには、自分で作成してください。
• インストールする: mod をインストールまたは更新する を参照してください。

​

mod をインストールまたは更新する

• Claude Code セッションで /plugin install token-chart@your-org を実行します。
• シェルで claude plugin install token-chart@your-org を実行します。

​

mod を信頼するかどうかを判断する

​

mod が到達できる範囲

• あなたのマシンであなたとして動作する: ユーザーアカウントがアクセスできる場所ならどこでもファイルを読み書きし、プログラムを起動し、ネットワークリクエストを行う
• あなたのシークレットを読む: 環境変数と設定ファイル（どちらかに保存している API キーを含む）
• あなたのセッションを見る: 送信するすべてのプロンプトと Claude が行うすべてのツール呼び出し
• あなたのセッションを変更する: プロンプトまたはツール呼び出しを書き直し、あなたが入力したかのようにプロンプトを送信し、別のセッションにメッセージを送信する
• あなたに尋ねずに動作する: あなたが尋ねられる前にツール呼び出しを承認する
• あなたの使用量を消費する: あなたのプランまたは API キーでモデルを呼び出す

​

mod をインストールする前に、mod が何をするかをリストアップする

claude plugin validate ./some-mod

​

mod をオンまたはオフにする

• 1 つの mod: Installed タブの /plugin からそのプラグインを無効化またはアンインストールする
• すべてのインストール済み mod、1 つのセッション: --safe-mode で Claude Code を開始します。これは他のカスタマイズも除外します。
• インストールしたすべての mod、すべてのセッション: ~/.claude/settings.json で "disableAllHooks": true を設定します。Settings hooks とカスタムステータスラインも停止します。組織が管理するものは実行し続けます。

​

セッションがロードした mod を確認する

​

mod の仕組み

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

• plugin.json: プラグインの マニフェスト
• hooks.json: コードファイルを指す
• register.js: コード。hooks モジュールと呼ばれます。Claude Code にどのイベントで関数を実行するかを指示します。

// 以下の 2 つの hooks で共有されるカウント
let calls = 0

// Claude Code は mod がロードされるときにこれを 1 回呼び出す
export function register(on) {
  // Claude がツールを使用しようとするたびに実行される
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Claude Code にインターフェイスを再度描画するよう要求し、新しいカウントが表示されるようにする
    $.ui.invalidate('ui.render')
    // ツールを通常通り実行させる
    return next(e)
  })

  // Claude Code がスピナーを描画するたびに実行される
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Claude Code のスピナーを保持し、単語の後にカウントを追加する
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

• tool.call hook は Claude がツールを使用しようとするたびに実行されます。calls に 1 を追加し、Claude Code にインターフェイスを再度描画するよう要求し、ツールを通常通り実行させます。
• ui.render hook は Claude Code がスピナーを描画するたびに実行されます。Claude Code 独自のスピナーを保持し、単語の後にカウントを追加します。

​

hook がイベントで何ができるか

• 観察: 何が起こっているかに注意し、例の tool.call hook のように変更されずに続行させる
• 書き直す: イベントを変更してから続行する。ui.render hook がスピナーにカウントを追加するとき
• 回答: イベント自体を処理し、通常の動作が実行されないようにする。たとえば、コマンドを拒否する

​

mod が実行される場所

​

組織の mod を制御する

​

Mod、settings hooks、skills、MCP サーバーを比較する

​

Claude Code に組み込まれた Mod

​

組み込み mod のソースを読む

• diff: /diff ペイン。キーボードアクションにバインドされたボタンとスクロール。mod が自身で処理
• agents-md: AGENTS.md をプロジェクト指示としてロード。userConfig オプション付き
• sec-default: デフォルトで何が起こるかを知る で説明されているガード。ポリシーを実施する mod のモデル
• telemetry: 他の mod が呼び出せるメソッドを追加し、それらの型を出荷

​

次のステップ

• Mod を作成する: ツール呼び出しをカウントし、スピナーの横にカウントを表示し、コマンドを追加するものを構築し、編集とリロードループを学ぶ
• インターフェイスに描画する: ペイン、プロンプトの上のバンド、ボタン、テキストフィールド、状態
• イベントに反応する: ツール呼び出し、プロンプト、ターン、mod が実行される順序
• mods API を使用する: コマンド、ツール、モデル呼び出し、タイマー、ファイル
• Mod をテストする: セッションなしで実行される自動テスト
• Mod をトラブルシューティングする: mod が何もしない理由とデバッグログ
• 組織の mod を管理する: デフォルト、管理設定、mod のレビュー、ポリシー mod
• Mods リファレンス: すべてのイベント、メソッド、要素、制限