Claude Codeに「mods」登場|TypeScriptで動きや画面を自分用に作り変える

Claude Code mods Claude Codeを自分用に作り変える

Claude Codeを毎日使っていると、「ここだけ自分の仕事に合わせたい」という場面が出てきます。本番の設定に触る前には必ず一度止まってほしい、作業の進み具合を横に出しておきたい、ログに混ざった秘密の情報はClaudeに見せたくない。これまでは、機能が増えるのを待つか、設定ファイルの「フック」で外から止めるくらいしか手がありませんでした。

2026年10月1日、AnthropicはClaudeの公式ブログで「Customize Claude Code with mods」を公開しました。mods(モッド)は、Claude Codeの動きや見た目を変えるTypeScriptの小さな関数です。自分で書くことも、Claude Codeに書いてもらうこともできます。

この記事では、公式ブログとClaude Codeのドキュメントで確認できたことだけを使って、modsで何が変わるのか、仕事でどう使い分けるとよいのか、入れる前に知っておきたい注意点を整理します。

トミー

道具を「待つ」から「自分で足す」へ、という発表です。毎日使う道具ほど、小さな不便を自分の手で直せるのはうれしいところです。

何が発表された?

公式ブログ(2026年10月1日)の要点です。

  • modsは、Claude Codeの動きを変えるTypeScriptの関数。プロンプトを書き換える、新しい画面を足す、もともとある機能を置き換える、まったく新しい機能を足す、といったことができる
  • 自分で書くか、Claude Codeに書いてもらう。Claudeに頼むと、TypeScriptを書いて、入れて、その場で読み込み直すところまで進められる
  • プラグインに入れて配る。ふつうのプラグインと同じように入れたり、人と共有したりできる
  • Claude CodeのCLIとデスクトップアプリで動く
  • もともとの機能の一部もmodになった。たとえば変更点を見る /diff はmodになり、止めたり、自分の版に置き換えたりできる
  • サンドボックス(隔離された環境)では動かない。Claude Codeと同じ権限でパソコン上で動くので、信頼できる提供元のものだけを入れるよう案内されている

これまでと何が違う?

Claude Codeには、これまでもフックという仕組みがありました。設定ファイルに書いておくと、決まったタイミングでスクリプトを動かせるものです。公式ブログは、フックでもある程度は動きを変えられたが、出来事を書き換える・新しい画面を描く・機能を置き換えることはできなかった、modsならそれができる、と説明しています。

ドキュメントでは違いをこう整理しています。フックやスキル、MCPサーバーは「Claude Codeの外から」スクリプトを動かしたり、Claudeに文章や道具を渡したりするもの。modはClaude Codeの中で動くので、それらにはできないことができる、という位置づけです。なお、ドキュメントではmodの関数のことも「hook」と呼ぶため、設定ファイルのほうは「settings hook」と呼び分けています。

もうひとつの違いは、Claude Code自身がmodで組み立てられ始めたことです。公式ブログには、今後ももともとの機能をmodに移していき、小さな中心部分に必要なものだけを足して使えるようにしたい、と書かれています。

何ができるようになった?

modの仕組みを、図にまとめました。

modsの仕組み(Claude Codeの出来事に、前・あと・代わり・包む形でつながり、書き換えや画面の追加ができる)
modsの仕組み(Claude Codeの出来事に、前・あと・代わり・包む形でつながり、書き換えや画面の追加ができる)

出来事に「前・あと・代わりに・包んで」つながる

Claude Codeは、何かをするたびに出来事(イベント)を出します。道具を使う、許可を求める、画面の一部を描く、などです。modはこの出来事につながる関数で、出来事の前に動く・あとに動く・代わりに動く・前後を包んで動くのどれかを選べます。

公式ブログが挙げている例は、モデルに届く前にプロンプトを書き換える、道具の実行を止める・書き換える・やり直す、許可の確認に自動で答える、道具の出力から秘密の情報を消してからClaudeに読ませる、の4つです。

画面に、自分用のパーツを足せる

modは見た目も変えられます。道具の結果やClaudeからの質問など、Claude Codeが描いている部分を変えたり置き換えたりでき、ボタンや入力欄も足せます。ドキュメントには、会話の横に出すペインや、入力欄の上に出す帯を作れることが書かれています。

いくつも重ねて使える

同じ出来事に複数のmodがつながっている場合は、読み込んだ順に動きます。先に読み込まれたmodが、最初に出来事を見て、最後に結果を見る形です。これで、別の人が作ったmodを重ねて使えるようになっています。

ほかの仕組みとの使い分け

ドキュメントには、mod・設定のフック・スキル・MCPサーバーの比較表があります。要点を図にしました。

mod・設定のフック・スキル・MCPサーバーの使い分け(Claude Code Docs「Mods overview」の比較表をもとに作成)
mod・設定のフック・スキル・MCPサーバーの使い分け(Claude Code Docs「Mods overview」の比較表をもとに作成)

ドキュメントは、すでにフックやスキル、MCPサーバーで足りるなら、modを書く前に比べてから選ぶよう案内しています。4つとも1つのプラグインに入れられます。

仕事ではどう使えそう?

ここからは、公式情報をもとにした、KAKERUデザインとしての見立てです。

本番に触る前に、必ず一度止める

公式ブログは、チーム向けの例として「本番の設定に触るコマンドの前に確認を求めるmod」を挙げています。Webサイトの更新を請け負う会社なら、公開中のサーバーや設定ファイルに関わる操作だけを確実に止める、という使い方がはっきりした場面です。

作業の状況を、会話の横に出しておく

同じく公式の例に、CI/CD(自動テストや自動公開)の状況をペインに出し、成功・失敗に合わせて更新するmodがあります。ドキュメントの例には、リクエストのたびに、コンテキスト(Claudeが一度に覚えておける量)がどれだけ埋まったかをグラフにするペインもあります。「今どうなっている?」を別の画面に見に行かずに済む使い方です。

秘密の情報を、Claudeに見せる前に消す

道具の出力から秘密の情報を消してからClaudeに読ませる、というのも公式が挙げている使い方です。お客様のサーバーのログや設定を扱う場面で、パスワードやキーが混ざったまま会話に入るのを防ぐ、という考え方です。

チームでの使い方を記録する

公式ブログには、最初に読み込まれるmodで、ほかのmodが行った操作をすべて記録する「監査ログ」の例もあります。複数人でClaude Codeを使う会社が、あとから「何が起きたか」を確かめられるようにする使い方です。

KAKERUならこう使う/使わない

KAKERUとして線を引くなら、modsは「止める」「見せる」ために使います。本番の設定やお客様のサーバーに関わる操作の前で必ず止まる、作業の状況を横に出しておく、出力に混ざった秘密の情報を消す。どれも、作業のミスを減らす方向の使い方です。

反対に、許可の確認に自動で「はい」と答えるmodは使いません。ドキュメントには、modが許可を自動で出すと、本来なら確認が出る操作や、自分で止めるよう設定した操作まで通してしまう場合があると書かれています。また、中身を確かめていない人のmodは入れません。modは自分と同じ権限でファイルを読み書きでき、ネットワークにもつながるからです。Claudeにmodを書いてもらう場合も、何をするコードなのかを読んで、入れるかどうかを決めるのは人です。

トミー

「Claude CodeでClaude Codeを改造する」というのは、元プログラマーとしては面白い一文です。まずは小さな表示の追加あたりから試してみたいと思います。

誰が使える?

ドキュメントに書かれている条件は次のとおりです。

  • 使える場所:Claude CodeのCLI(ターミナル)と、デスクトップアプリのCodeタブ。VS Code拡張のチャット欄や claude -p では、modの処理は動くが画面には描かれない
  • バージョン:Claude Code v2.1.287以降。最初から有効になっている
  • 入れ方:Claudeのディレクトリから入れるか、CLIで /plugin を使う。共有したいときは、プラグインにまとめてディレクトリに申請する
  • 止め方:1つだけなら /plugin でそのプラグインを無効に。そのセッションだけ全部止めるなら --safe-mode で起動する

modsのための追加料金や、対象プランの制限については、公式ブログとドキュメントに記載はありませんでした。

注意点

modは「自分と同じ権限」で動くコード

ドキュメントは、modができることをはっきり書いています。自分としてファイルを読み書きする、プログラムを動かす、ネットワークにつなぐ、環境変数や設定ファイルにあるキーを読む、送ったプロンプトと道具の使い方をすべて見る、それらを書き換える、自分の利用枠でモデルを呼ぶ。入れる前に claude plugin validate で、どの出来事につながり何をしようとするかを一覧にできる、とも案内されています。

会社で使うなら、管理者の設定も見る

TeamとEnterpriseのプランでログインしている場合や、管理された設定があるパソコンでは、sec-defaultという組み込みのmodが最初に読み込まれ、ユーザーが入れたmodが許可のルールを上書きするといった危ない動きを止めます。管理者はプラグインの入手先を許可・禁止でき、ユーザーが入れたmodを読み込ませない設定もあります。

画面への表示は、場所によって出ない

modが描くペインや帯が出るのは、ターミナルとデスクトップアプリだけです。デスクトップアプリでも、WSLのセッションではプラグイン自体が使えません。クラウドのセッションでも画面には描かれない、とドキュメントの表にあります。

まとめ

  • 2026年10月1日、Claude Codeの動きや見た目を変えるmodsが登場。TypeScriptの小さな関数で、自分で書くことも、Claude Codeに書いてもらうこともできる
  • Claude Codeの出来事に前・あと・代わりに・包んでつながり、プロンプトや道具の使い方の書き換え、画面の追加ができる
  • プラグインに入れて配る。CLIとデスクトップアプリで動き、v2.1.287以降なら最初から有効
  • サンドボックスでは動かず、自分と同じ権限で動く。信頼できる提供元のものだけを入れる
  • KAKERUなら「止める」「見せる」ために使う。許可の自動化と、中身を確かめていないmodは使わない

すでにClaude Codeを使っているなら、まずは /plugin を開いて、組み込みのmodが何なのかを見るところから始められます。

参考・情報源

確認日:2026年10月2日。機能や提供状況は変わることがあります。最新の情報は公式ページでご確認ください。

ふだんの制作の話や、作ったものの裏側は Instagram と X でも出しています。

関連記事

Claude Plugins 作ったプラグインを公式の一覧へ申請
Claude Code mods Claude Codeを自分用に作り変える

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA