Mod のリファレンス

Mod（モッド、mod）が扱えるイベント、呼べる mods API のメソッド、描ける描画先を、Claude Code の CLI と Desktop アプリについて引く一覧です（v2.1.289 時点）。作り方は Mod を作る・試す、画面への描き方は Mod で画面に描く、入れ方と管理は Mod（モッド）を使うにあります。

ファイル#

Mod は、次のファイルを持つプラグインのディレクトリです。

register は on と options を受け取ります。options は、マニフェストが宣言した userConfig フィールドの値で、既定値が入っています。

フック関数#

Mod は、register の中で on を呼んで、フック（イベントハンドラー）を登録します。on には、イベント名、省略できるマッチャー（イベントのフィールドに対する絞り込み）、フックを渡します（on('tool.call', { tool: 'Bash' }, async ($, e, next) => next(e))）。on は登録を返し、そのメソッド .catch(handler) でフックのエラーハンドラーを設定できます。

イベントの扱い方#

同じイベントのフックはミドルウェアの連鎖になります。next(e) は次のハンドラー（別の Mod のフック、連鎖の最後では Claude Code 自身の動き）を呼び、その結果で解決します。next の使い方で、フックの働きは3つに分かれます。

// 観察：ツールが動く前に1行出し、イベントは変えずに渡す
on('tool.call', async ($, e, next) => {
  $.ui.log('Claude is about to use ' + e.tool)
  return next(e)
})

// 応答：next を呼ばないので、コマンドは動かない
on('tool.call', { tool: 'Bash' }, async () => {
  return { deny: 'Bash is turned off in this project. Use the file tools.' }
})

観察の例では、ツールが動く前にトランスクリプトへ ● my-mod: Claude is about to use Bash のような薄い行が出ます（my-mod はプラグイン名）。応答の例では、Claude は deny の文をツールの結果として読みます。

マッチャーで絞る#

on の第2引数のマッチャーは、イベントのフィールドと比べるオブジェクトです。すべてのフィールドが一致したときだけフックが動きます。

// 文字列は1つの値：Bash の呼び出しだけ
on('tool.call', { tool: 'Bash' }, hook)
// 配列はどれか1つ：Edit と Write の呼び出し
on('tool.call', { tool: ['Edit', 'Write'] }, hook)
// 正規表現はパターン：1つの MCP サーバーのすべてのツール
on('tool.call', { tool: /^mcp__github__/ }, hook)

イベント名にはワイルドカードも使えます。'classic.*' はすべての設定フックのイベント、'*' はテレメトリ以外のすべてのイベントです（テレメトリのイベントは、自分の名前と { to: 'collector' } のマッチャーで受けます）。

同じイベントは、マッチャーごとに1回だけ登録できます。マッチャー無しで session.start に on を2回呼ぶと、モジュールは on("session.start") is registered twice without a matcher で読み込みに失敗するので、セッション開始時の処理は1つのフックにまとめます。

ツール呼び出しを止める・直す#

tool.call は、Claude がツールを使う直前に発火します（サブエージェントと MCP ツールの呼び出しも含む）。ツール名は e.tool、引数は e のフィールド（Bash なら e.command）です。next(e) を呼ぶと、Claude Code が権限の確認をしてからツールを実行します。

on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (/git push .*--force/.test(e.command)) {
    // next を呼ばずに返すので、コマンドは動かない
    return { deny: 'Force pushes are not allowed in this repository. Push to a new branch instead.' }
  }
  // ほかのコマンドは、権限の確認を経て Bash へ
  return next(e)
})

deny の文は Claude がツールの結果として読むので、Claude が従える指示として書きます。そのほかの扱い方です。

組織の管理設定にあるフックは、どの Mod の tool.call よりも前に動き、そこでのブロックは覆りません。

ユーザーが決めるまで呼び出しを止める#

tool.call のフックが next を呼ぶ前に await しているあいだ、ツール呼び出しは保留されます。ユーザーに聞くには $.ui.ask を使います。Claude が質問に使うダイアログに質問と番号付きの選択肢が出て（そのあとに別の答えを打つ行と「Chat about this」の行も付く）、ユーザーが選んだラベルで解決します。

次の RISKY は、rm -r・rm -rf・git reset --hard・--force 付きの git push に一致します。git push -f のような別の書き方には一致しません。

const RISKY = /\brm\s+-rf?\b|\bgit\s+reset\s+--hard\b|\bgit\s+push\b.*--force/

on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (!RISKY.test(e.command)) return next(e)
  // 誰も答えなかったときに拒否になるよう、安全な答えから始める
  let answer = 'Refuse'
  try {
    // ユーザーが選ぶまで、ツール呼び出しはここで待つ
    answer = await $.ui.ask('Run this command? ' + e.command, ['Run it', 'Refuse'])
  } catch {
    // 質問が閉じられた、または claude -p で聞く相手がいない
  }
  if (answer !== 'Run it') {
    return { deny: 'The user declined this command. Ask before trying a different approach.' }
  }
  return next(e)
})

ユーザーに聞く前に承認・拒否する#

tool.check は、権限ルールと設定フックが「実行してよいか」を決めたあとに発火します。next(e) はその決定（allow・ask・deny）で解決し、フックはそれか別の決定を返します。ツールの引数は e.input（Bash なら command）です。

決まったコマンドやパスなら、コードの要らない Bash(npm test) のような権限ルールで足ります。いまの Git ブランチや、別のフックが記録した値のように、その時の状況で決めたいときに tool.check を使います。

on('tool.check', { tool: 'Bash' }, async ($, e, next) => {
  // 権限ルールと設定フックの決定：'allow'・'ask'・'deny'
  const decided = await next(e)
  if (!e.input.command.includes('git push')) return decided
  const branch = await $.process.run(['git', 'branch', '--show-current'])
  if (branch.stdout.trim() !== 'main') return decided
  return { decision: 'deny', reason: 'Push from a branch other than main' }
})

main にいるときだけ、ルールが許していても git push を拒みます。ほかのブランチやコマンドは、Mod が無いときと同じ決定です。コマンドの文字列で照合しているので、これは Claude への注意にとどまります。全員の main への push を止めるなら、Git のホスト側でブランチを保護します。

フックは allow も返せるので、管理設定の外の PreToolUse フックが止めた呼び出しも承認できます。どの決定が Mod より優先されるかは権限ルールにあります。

プロンプトを書き換える・足す#

prompt.submit のフックは、ターンが始まる前の各プロンプトを受け取ります。打たれた文は e.text です。

on('prompt.submit', async ($, e, next) => {
  // pull request に触れないプロンプトはそのまま通す
  if (!/\bPR\b|pull request/i.test(e.text)) return next(e)
  const git = await $.process.run(['git', 'branch', '--show-current'])
  // Git のリポジトリの外ではコマンドが失敗するので、足すものは無い
  if (git.exitCode !== 0) return next(e)
  // 前のフックが足した文脈を残し、1行足す
  return next({ ...e, context: [...(e.context ?? []), 'Current branch: ' + git.stdout.trim()] })
})

open a PR for this change と打つと、発言はそのままで、Claude はそのあとに Current branch: feature/auth のような行も読みます。pull request に触れないプロンプトでは git も動きません。

Claude が読むそのほかのもの（システムプロンプトの節ごとの prompt.section、最初のメッセージと送る文脈の prompt.context、スキルの文の skill.prompt など）は、下のイベントの表にあります。こうしたフックが足す文がリクエストごとに変わると、プロンプトキャッシュが無効になります。

ターンを追う#

ターンは、1つのプロンプトに対して Claude がすることの全部です。

turn.step はストリームなので、フックは非同期ジェネレーターで書きます。yield* next(e) は、応答を流れてくるまま転送し、終わった結果として評価されます。

on('turn.step', async function* ($, e, next) {
  // 応答を流しながら転送し、終わった結果を受け取る
  const result = yield* next(e)
  if (result.usage) {
    $.ui.log('cache read ' + result.usage.cache_read_input_tokens + ' · wrote ' + result.usage.cache_creation_input_tokens)
  }
  // 結果は変えずに返す
  return result
})

応答はいつもどおり画面に流れ、リクエストが終わるたびに、キャッシュから読んだトークン数と書いたトークン数の薄い行が出ます。result.usage には、Claude API が報告するトークン数（input_tokens・output_tokens・cache_read_input_tokens・cache_creation_input_tokens）と、答えた model が入っています。サブエージェントのリクエストでも動くので、メインの会話だけにするなら e.agentId を調べます。

設定フックのイベントを扱う#

設定ファイルに置くフック（コマンド・HTTP・プロンプト・エージェント）のイベントは、どれも classic. を前に付けた名前（classic.Stop・classic.SessionEnd・classic.PostToolUse など）で Mod からも扱えます。e は、設定フックが標準入力で受け取る JSON（transcript_path を含む）です。

on('classic.Stop', async ($, e, next) => {
  $.ui.log('Transcript saved at ' + e.transcript_path)
  // 渡すので、設定ファイルの Stop フックもいつもどおり動く
  return next(e)
})

Claude が応答を終えるたびに、トランスクリプトのファイルのパスが薄い行で出ます。next(e) を返すので、ターンの終わり方は変わりません。

イベントの一覧#

イベントは関わる対象ごとに分かれ、発火するときと、フックが返せるものを持ちます。turn.step と process.spawn のフックは非同期ジェネレーターで、そのほかのフックは非同期関数です。

「フックが返せるもの」の列は省略した書き方です。next(e) はイベントを変えずに渡します。next({ ...e, text }) は、名前を挙げたフィールドを変えたコピーを渡します（next({ ...e, text: e.text.trim() })）。オブジェクトは、next を呼ばずにイベントに答えます。reason のような語は、自分で書く文字列です（{ deny: 'Use the file tools.' }）。

ツール#

ツールのイベントは、Claude が行う各ツール呼び出しの前後で発火します。

プロンプトと Claude が読むもの#

プロンプトのイベントは、ユーザーが打つ文と、システムプロンプトやリマインダーのように Claude Code が自分で Claude へ送る文を扱います。

コマンドと設定#

コマンドと設定のイベントは、コマンドが実行される・一覧に出るとき、/config の行が表示される・変わるときに発火します。

ターン#

ターンのイベントは、1つの答えを、その中のモデルへの各リクエストも含めて、始めから終わりまで追います。

セッション#

セッションのイベントは、セッションの開始・終了・コンパクト・ほかのセッションとのメッセージのやり取りを表します。

サブエージェント#

サブエージェントのイベントは、サブエージェントの種類が Claude に提示されるとき、サブエージェントやエージェントチームのチームメイトが起動する直前に発火します。

インターフェース#

インターフェースのイベントは、Claude Code が描画先を描くとき、Mod が描いたコントロールをユーザーが使うときに発火します。

別の Mod#

これらのイベントは、ほかの Mod が読み込まれるときに働きかけ、拒否したり、その Mod が受け取る mods API を変えたりします。

テレメトリ#

テレメトリのイベントは、Claude Code が記録する利用記録について発火します。

設定フックのイベント#

設定フックのイベントはどれも classic.<Event>（classic.Stop・classic.PostToolUse など）という名前のイベントで、e はそのフックの標準入力の JSON です。

mods API の呼び出し#

mods API のメソッドはどれも、ネームスペースとメソッドの名前（fs.read・model.complete・ui.open など）のイベントでもあります。そのフックは、自分より後ろで動く Mod からの呼び出しを横取りし、next(e)・{ deny: reason }・{ value } を返せます。

フックの順序と失敗#

Mod が動く順序#

同じイベントのフックは、1本のミドルウェアの連鎖になります。各 Mod の next が次の Mod のフックを呼び、最後の next が Claude Code 自身の動きに届きます。最初の Mod がいちばん外側で、ほかの Mod より先にイベントを見て、後ろの結果も見て、ほかの Mod を走らせるかどうかを決めます。後ろの Mod は、前の Mod がイベントを見るのを止められません。

Claude Code は、各 Mod の出どころで連鎖を並べます。

1. 組み込みのガード sec-default@builtin（/plugin では cc-plugin-sec-default）、組織が prependPlugins に並べた Mod、そのあとに、組織のものと数えられ appendPlugins にない Mod
2. 自分がインストールした Mod
3. 組織が appendPlugins に並べた Mod
4. Claude Code に組み込まれたそのほかの Mod

自分がインストールした Mod のあいだでは、Mod は、マニフェストの dependencies に挙げた Mod より先に動きます。1つのモジュールの中では、register が on を呼んだ順にフックが動きます。

設定ファイルの PreToolUse フックも、ツール呼び出しの間、Mod の連鎖の決まった位置で動きます。

• 管理設定の PreToolUse フック：最初の Mod の tool.call フックより前に動く。そこでのブロックは覆らないので、どの Mod もその呼び出しを見ない
• ほかのすべての設定ファイルと、プラグインの hooks/hooks.json の PreToolUse フック：最後の Mod が next を呼んだあと、Claude Code 自身の動きの一部として動く。next を呼ばずに tool.call に答える Mod は、これらを動かさない。next を呼ぶ Mod は、返ってきた結果にそれらの決定を見る

tool.check はこれらのフックと権限ルールが決めたあとに発火するので、そのフックは、後者のグループのフックが止めた呼び出しも承認できます。

フックが失敗したとき#

失敗したフックはセッションを壊さず、代わりに何が起きるかを決められます。.catch ハンドラーの無いフックが、例外を投げる・時間切れになる・形の違う結果を返すと、そのあとは next を呼んでいたかで決まります。

• next を呼ぶ前に失敗した：Claude Code がそれを飛ばし、次のハンドラーが代わりに動く
• next が解決したあとに失敗した：その結果が残り、2回目は何も動かない

Mod・イベント・理由を挙げる1行が出ます（my-mod: tool.call hook skipped: threw Error: boom）。どこで読むかは、Mod を作る・試すの「Mod が何もしない原因を探す」にあります。

呼び出しを止めるフックが失敗したら閉じる側（呼び出しを通さない）に倒すには、代わりに答える .catch エラーハンドラーを足します。guard は自分のフック関数です。

// on は登録を返し、.catch はそのフックだけにハンドラーを付ける
on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {
  // next.error.kind は 'throw' か 'timeout'（guard がどう失敗したか）
  return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }
})

guard が動いている間、ハンドラーは動きません。Bash の呼び出しで guard が例外を投げるか時間切れになると、Claude Code は同じイベントでハンドラーを呼びます。ハンドラーが { deny } を返すのでコマンドは動かず、Claude は文の末尾に throw か timeout を付けて読みます。ハンドラーが無いと、Claude Code は guard を飛ばしてコマンドを実行してしまいます。ハンドラーには、より短い独自の制限時間があります。

mods API のメソッド#

mods API は、どのフックも受け取る $ 引数です。メソッドは $.ui のようなネームスペースに分かれています。表はネームスペースごとにメソッド名を並べたもので、$.ui の行の open は $.ui.open(...) の呼び出しを指します。

コマンドとツールを足す#

ユーザーが実行するコマンドも、Claude が呼ぶツールも、session.start のフックで登録します。Claude Code は最初のプロンプトの前にこのフックを待つので、最初のターンから使えます。

コマンド#

登録して、その名前の command.run を扱います。次は、日数を省略できる /standup の例です。

on('session.start', async ($, e, next) => {
  // description は / の一覧に出る説明
  await $.command.register({ name: 'standup', description: 'Summarize what changed today', argumentHint: '[days]' })
  return next(e)
})

on('command.run', { command: 'standup' }, async ($, e) => {
  // e.args はコマンド名のあとに打った文字（無ければ空文字）
  return { text: 'Summary for the last ' + (e.args || '1') + ' day(s): ...' }
})

• / を打ったときの一覧に、説明付きで /standup が出る。argumentHint は、コマンドと空白を打ったあとに /standup [days] のように出る
• 返した text はトランスクリプトに出て、Claude も読む。何も出さない（ペインを開くだけなど）なら {} を返す
• Claude の作業中でも実行できるようにするには、登録に immediate: true を足す

ツール#

名前・Claude が読む説明・入力の JSON Schema を渡して登録します。Claude からは、mcp__・プラグイン名・アンダースコア2つ・登録した名前をつないだ長い名前で見えるので、呼び出しはその名前に絞った tool.call フックで扱います。次は my-mod というプラグインが、課題管理の票を引く ticket（完全な名前は mcp__my-mod__ticket）を足す例です。

on('session.start', async ($, e, next) => {
  await $.tool.register({
    name: 'ticket',
    // Claude はこの説明を見て、いつ呼ぶかを決める
    description: 'Look up a ticket by its id and return its title and status',
    // 必須の文字列 id を1つ受け取る
    inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
  })
  return next(e)
})

on('tool.call', { tool: 'mcp__my-mod__ticket' }, async ($, e) => {
  // ツールの引数は e のフィールドなので、id は e.id
  const response = await $.http.fetch('https://tickets.example.com/api/' + encodeURIComponent(e.id))
  // 失敗したことも Claude に伝わるよう、どちらでも結果を返す
  return { result: response.ok ? response.text : 'Lookup failed with status ' + response.status }
})

モデルを呼ぶ#

$.model.complete は、会話の外で、並べ替えや要約のような小さな仕事のために、セッションの認証情報で1つのプロンプトをモデルへ送り、返事で解決します。会話の履歴は含まれません。

on('command.run', { command: 'triage' }, async ($, e) => {
  const r = await $.model.complete({
    model: 'haiku',
    system: 'Reply with one word: bug, feature, or question.',
    prompt: e.args,
    // 1語で足りるので少なく。15秒で諦める
    maxTokens: 20,
    timeoutMs: 15000,
  })
  // r.text はモデルが答えたときだけあるので、先に r.isAnswered を見る
  const label = r.isAnswered ? r.text.trim() : 'unknown'
  return { text: 'Label: ' + label }
})

/triage the export button does nothing なら Label: bug のように出ます。モデルが答えなければ unknown です。

• Claude API の失敗では呼び出しは拒否されない。r.isAnswered を調べ、false なら r.reason を読む
• 組織が止めているモデルなど、Claude Code が送らないリクエストでは、呼び出しが拒否される
• effort などほかのオプションは使っている版の型定義に、maxTokens の既定値は下の「制限」の表にある
• $.model.fork({ prompt }) は、同じモデルとシステムプロンプトで、いまの会話に対して1つ質問する。大半は Claude API がプロンプトキャッシュから返す
• どちらの呼び出しも、ユーザーのプランか API キーを使う

バックグラウンドで動かす#

フックは1つのイベントのために動き、実行時間に制限があります（next と mods API の呼び出しを待つ時間は、$.clock.sleep を除いて数えません）。1つのイベントより長く続く仕事（1分ごとに何かを調べる、など）は、session.start で始めるタイマーで動かします。

• $.clock.every と $.clock.after は setInterval と setTimeout の代わりで、遅延のミリ秒を先に書く（$.clock.after(5000, fn) は5秒後に fn を1回呼ぶ）。どちらも cancel() を持つタイマーを返す
• await $.clock.now() はミリ秒の時刻を返す

次は、1分ごとに pull request のチェックを調べ、プロンプトの下に出す例です（summarize は、コマンドの JSON 出力を数語にまとめる自作の関数）。

on('session.start', async ($, e, next) => {
  // 60,000 ミリ秒ごとに呼ぶ（最初は1分後）
  $.clock.every(60_000, async () => {
    const status = await $.process.run(['gh', 'pr', 'checks', '--json', 'state'])
    // プロンプトの下の行を、最新のまとめで置き換える
    $.ui.status('checks: ' + summarize(status.stdout))
  })
  // タイマーを待たずに返すので、セッションはすぐ始まる
  return next(e)
})

タイマーのコールバックはイベントの外で動くので、ターンの合間も動き続け、ターンは始めません。例外を投げるとエラーはデバッグログへ行き、次の間隔でまた動きます。タイマーはモジュールの読み直しで止まります。フックの中の長く続く処理には、イベントが放棄されたとき（ユーザーが中断したときなど）に中断される AbortSignal の next.signal を渡します。

ターンを始めずにユーザーへ見せる呼び出しは次のとおりです。

Claude に動いてほしいものを見つけたら、$.prompt.submit({ text }) でプロンプトを送ってターンを始められます。Claude は、Mod を送り手と名指しする1文のあとにその文を読みます（asUser: true を足すと、その1文なしでユーザー自身の言葉として送ります）。呼び出しはセッションが空くのを待って新しいターンを始め、そのターンが始まったときに解決するので、Claude の作業中に動くハンドラーでは await しません。

セッション間でメッセージを送る・受ける#

Mod は、ほかの自分のセッションや、このセッションのサブエージェントへプレーンテキストのメッセージを送れ、出入りするメッセージを観察できます。送るのは $.session.send({ to, text }) で、SendMessage ツールと同じ配送です。to には次のどれかを渡します。

• セッション：{ sessionId }
• サブエージェント：$.agent.list() から得た { agentId }
• 受け取ったメッセージの送り元の、文字列のアドレス

キューに入れば { isDelivered: true }、届かなければ { isDelivered: false, reason } で解決します（reason が理由）。

on('command.run', { command: 'ping' }, async ($, e) => {
  // e.args は /ping のあとに打ったセッション ID
  const sent = await $.session.send({ to: { sessionId: e.args }, text: 'Status? One line.' })
  // どちらでも解決するので、isDelivered で結果を見る
  if (!sent.isDelivered) $.ui.toast('Not delivered: ' + sent.reason)
  return {}
})

観察には session.receive と session.send を使います。どちらも next(e) を返せば、メッセージは変わらずに通ります。

• 受信を断る設定のセッションは、session.receive が発火する前に断るので、フックには来ない
• あなたの承認待ちで保留されたメッセージは、フックが先に受け取る。Mod は、まだ承認していないメッセージも読める
• メッセージが配送されないと、フックの next(e) は拒否される
• 送り手の名前は送り手が書いたとおりなので、判断の根拠にしない

ファイル・プロセス・ネットワークに届く#

フックモジュール自身には、Node.js の API も、setTimeout のようなタイマーのグローバルも、ネットワークやファイルへのアクセスもありません。ファイルシステム・プロセス・ネットワークには、mods API を通して、Claude Code を動かすユーザーと同じ権限で届きます。URL・TextEncoder・AbortController・crypto.subtle のような標準の JavaScript と Web の API は使えます。

ファイルとプロセスには、次の決まりがあります。

• パス：相対パスは、セッションの作業ディレクトリを基準に解決される
• $.fs.list：1つのディレクトリの項目を { name, kind, size, isLink } で返す。再帰はしない
• $.process.run：引数の一覧を取り、シェルを使わない。終了コードによらず { exitCode, stdout, stderr } で解決する。プログラムが起動できない、またはタイムアウト（既定 30 秒）でも動いているときは拒否されるので、try と catch で包む

これらの呼び出しは、どれも $. を除いた名前（$.fs.read なら fs.read）のイベントでもあります。連鎖の前にいる Mod がほかの Mod の呼び出しを観察・書き換え・拒否でき、組織が Mod の届く範囲を制限できるのはこのためです。

描画先#

描画先は、Claude Code のインターフェースにある拡張の差し込み口です。表の各行は、ui.render フックの e.component の値で、e.props のフィールドと、描くアプリを示します。e.surface は terminal か desktop です。

e.viewport は columns・rows・isFullscreen を持ちます。アプリがウィンドウを測るまでは存在しません。rows は、ペインの高さではなく、ウィンドウ全体の高さです。

木を描画先に合わせるには、フックで次の props を読みます。

• Pane や帯の幅：e.props.bodyColumns に合わせて描く
• トランスクリプトの横の Pane の高さ：e.props.placement が 'dock' のとき、e.props.scroll.bodyRows がペインの持つ行数
• プロンプトの上の Pane の高さ：e.props.placement が 'inline' のとき、ペインは木に合わせて上限まで伸び、bodyRows は今見えている行だけを数える。$.ui.open の rows フィールドで別の上限を頼める

ペインより背の高い木は、全体でスクロールします。

要素#

要素は、ui.render フックが返す木の部品で、$.ui.resolve(e) から得ます。チェックマークは、そのアプリが描けることを表します。

Button の決まりが、さらにあります。

• action は、Claude Code 自身のキーバインドのアクションの1つを指す。ユーザーのそのアクションへの割り当てが、複数キーの組み合わせ（コード）か修飾キー付きのキーのとき、そのキーでボタンが押される
• 帯の中のボタンの数字の hotkey は、空のプロンプトにその数字だけを打って少し待ったときにも発火する
• 1つの描画に同じ hotkey のボタンが2つあると、後のほうが得る
• autoFocus は、どのコントロールでも true だけを受け付ける。切るには、prop を書かない

制限#

フックと mods API の呼び出しには、時間とサイズの制限があります。Claude Code は、時間の制限を超えたフックを飛ばし、サイズの制限を超えた呼び出しを拒否します。

設定と環境変数#

Mod に関わる設定と環境変数です。「どこで」の列は、どの設定ファイルや環境から読まれるかを示します。

sec-default@builtin は Claude Code に組み込まれたガードで、/plugin とデバッグログでは cc-plugin-sec-default と出ます。管理設定のあるマシン、または Team か Enterprise プランでサインインしたユーザーでは、人がインストールするどの Mod より先に読み込まれます。管理設定の prependPlugins があるときは、その一覧が名前を挙げた場合だけ、挙げた位置で読み込まれます。

コマンド#

Mod を読み込む・調べる・テストするコマンドとフラグです。claude のコマンドはシェルで、/ のコマンドは Claude Code のプロンプトで実行します。<directory> は自分で打つパスで、角括弧は省略できる引数です。

次に読むページ#

• Mod を作る・試す：作り方・型定義・validate・自動テスト・トラブルシューティング
• Mod で画面に描く：ペイン・帯・ボタン・入力欄・要素の見本
• Mod（モッド）を使う：入れ方・信頼・オンオフ・組織での管理