【AIニュース】Claude Code の mods とは何か

Transcript

1. AIニュース（2026年10月） Claude Code の mods とは何か Claude Code の中で動いて、処理と画面を変えるプラグイン 赤神 青空
2. ▪2026年10月1日のバージョン mods とは2.1.287 で正式に入り、既定でオン mod は、Claude Code の⾒た⽬と振る舞いを変えるプラグイン JavaScript / TypeScript の関数を、Claude Code のイベントに登録して動かす 画⾯を描く ＝ mod が⾜す‧動く部分 処理に割り込む コマンドを⾜す ツール呼び出し‧プロンプト ⾃分の /コマンドを⼊⼒ 帯 プロンプト mod ⾒る‧書き換える‧⽌める mod の処理 Claude のターンなしで動く 会話の横のペインや、 プロンプトの上の帯を⾜せる ツール呼び出しやプロンプトを ⾒て、書き換えて、⽌められる ⾃分の /コマンドを、 Claude のターンなしですぐ動かせる 会話 今ココ mods とは ペイン 2/13
3. ▪skill・settings ほかの拡張との違い hook・MCP は外から働き、mod は中で動く 外から働く skill Claude Code の中 Claude が読む指⽰（Markdown） Claude Code の処理と画⾯ settings hook ツール呼び出し‧プロンプト‧描画のたびにイベント イベントで動くシェル‧HTTP など MCP サーバー Claude に道具を渡す外部の仕組み mod（JavaScript / TypeScript の関数） ⾒る‧書き換える‧⾃分で答える ペインや帯を描く‧コマンドを⾜す 公式の呼び分け：mod の関数は「hook」、設定ファイルに書く従来の hooks は「settings hook」 今ココ mods とは 3/13
4. ▪公式ドキュメントの比較表から、選ぶときの目安 どれを選ぶか こんなときは これを選ぶ 同じ指⽰を何度もチャットに貼っているとき skill ⼿元のスクリプトで、⽌める‧許す‧記録したいとき settings hook Claude を外部のシステムにつなぎたいとき MCP サーバー ペイン‧帯‧独⾃のコマンドが欲しいとき イベントを書き換えたいとき mod 今ココ mods とは 外から働く 中で動く 画⾯に描けるのは mod だけ 4/13
5. ▪Claudemod の動き方 Code はイベントのたびに mod の hook を呼ぶ ⾒る（observe） 記録してそのまま通す イベント （例: ツール呼び出し） mod の hook 書き換える（rewrite） 中⾝を変えて通す ⾃分で答える（answer） いつもの処理を動かさない 外のものに触るときは、必ず mods API（$）を通す だから claude plugin validate で、受け取るイベントと呼ぶ API を実行せずに一覧できる 今ココ 仕組み 5/13
6. ▪ツール呼び出しを数えて、スピナーの横に出す（公式の例を短くしたもの） いちばん小さな mod ファイルは3つ。 plugin.json ・ hooks.json ・この register.js javascript let calls = 0 export function register(on) { on('tool.call', async ($, e, next) => { calls += 1 $.ui.invalidate('ui.render') return next(e) }) on('ui.render', { component: 'Spinner' }, async ($, e, next) => next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })) } 今ココ 仕組み 6/13
7. ▪プラグインを読み込める所なら どこで動くかhook は動くが、画面に描けるのはターミナルとデスクトップアプリ 画⾯まで使える hook：動く hook だけ動く 画⾯：出る hook：動く ターミナルの claude エディタの端末や JetBrains も VS Code 拡張のチャット claude -p デスクトップアプリの Code タブ Agent SDK クラウドのセッション ⼀部の要素と WSL のセッションは不可 今ココ 仕組み 画⾯：出ない 届いたプラグインのみ 7/13
8. ▪/pluginすでに入っている mod と、試せる mod の Installed タブで、組み込みの mod を見られる Claude Code に⼊っている mod 試せるサンプル /plugin の Installed タブで⾒られる Anthropic が公開している 組み込み /diff のペイン AGENTS.md の読み込み mod を書くスキル 組織の設定を守るガード 組み込み（既定オフ‧使える環境のみ） You should know 裏のエージェントが⾒落としを知らせる 今ココ 仕組み token-weather コンテキストの埋まり具合を表⽰ blast-radius 危ないコマンドを⽌めて確認 8/13
9. ▪公式も「信頼できる作者とマーケットプレイスからだけ入れる」と書いている 入れる前に知っておくこと mod は「あなたの権限で動くコード」 ファイル‧プログラム‧通信 秘密 会話 あなたができることは全部できる 環境変数や設定の API キーを読める プロンプトとツール呼び出しを⾒る 書き換え 承認 利⽤枠 プロンプトやツール呼び出しを変える 聞かれる前に呼び出しを許可できる あなたのプランでモデルを呼べる サンドボックスではない。Claude のツールへの deny ルールは、mod ⾃⾝の読み書きには効かない （Read(.env) を拒否していても、mod は $.fs.read で .env を読める） 管理設定がなく Team / Enterprise でもない環境では、deny で拒否した Claude のツール呼び出しまで mod が許可できる 今ココ 注意 9/13
10. ▪入れる前に中身を見て、困ったらすぐ止められるようにしておく 確かめ方と止め方 確かめる ⽌める ⼊れる前に の Installed タブで、 1つだけ /plugin その mod を無効にする claude plugin validate 受け取るイベントと使う API を 実⾏せずに⼀覧する 読み込まれたか /plugin を開く 「1 mod active · first-mod」のように出る 今ココ 注意 全部 このセッションだけ：--safe-mode ずっと：disableAllHooks allowManagedModsOnly で、 組織で 管理者が ⾃社の mod だけに絞る 10/13
11. ▪skill が「Claude まとめに教える」なら、mod は「Claude Code そのものを変える」 Claude Code の中で動くプラグイン イベントのたびに呼ばれ、⾒る‧書き換える‧⾃分で答える hook 画⾯とコマンドまで⾜せる mod だけ あなたの権限で動く validate ペインや帯、ターンを待たずに動くコマンドは、ほかの拡張にない サンドボックスではないので、⼊れる前に validate で中⾝を⾒る 今ココ まとめ 11/13
12. ▪動画に付けたクイズから回答できます。答えは次のページで 今回のクイズ deny ルールで Read(.env) を拒否している。このとき、mod は $.fs で .env を 読める？ A 読めない 今ココ まとめ B 読める C 管理設定があれば読め ない D --safe-mode のとき だけ読める 12/13
13. ▪deny ルールは、mod クイズの答えは「B」 自身の $.fs には効かない 今回のクイズ deny ルールで Read(.env) を 拒否している。このとき、 mod は $.fs で .env を読める？ deny ルールが効くのは Claude のツール呼び出しだけ 答えは B 今ココ まとめ A 読めない deny は mod ⾃⾝の読み書きには効かない B 読める mod はあなたの権限でそのまま動く C 管理設定があれば読めない 管理設定のガードも $.fs には効かない のときだけ読める D --safe-mode safe-mode では mod ⾃体が⽌まる 13/13