modsを使用して Claude Code をカスタマイズする

本日は、Claude Code の仕組みを変える小さな TypeScript 機能である「mods」を紹介します。mod はプロンプトの書き換え、新しい UI の追加、組み込み機能の置き換え、あるいはまったく新しい機能の追加を行うことができます。 自分で mod を書くことも、Claude Code に書いてもらうこともできます。 Mods はプラグインに含まれているため、他のプラグインと同様にインストールして共有できます。Claude Code CLI とデスクトップアプリで動作します。

Mods は、Claude Code 自体と同様にマシンにアクセスできる状態で動作します。これらはサンドボックス化されておらず、コンピューターにコードをインストールする場合と同じように、信頼できるソースからの mods のみをインストールするようにしてください。

mods で何ができるかを確認するには、初めての mod 作成ガイドをご覧ください。

mods を作った理由

開発者からは、当社が機能をリリースするのを待つことなく、Claude Code の仕組みをより詳細に制御できるよう求められています。 Hooksはユーザーにこうした制御の一部を与えるのに役立ちますが、イベントを書き換えたり、新しい UI を描いたり、機能を置き換えたりすることはできません。Modsなら可能です。

私たちは、Claude Code を自分のもののように感じさせ、自分の仕事に合わせてカスタマイズできるようにしたいと考えています。 リリース前に GitHub で mods 向けのデザインを共有し、開発者からのフィードバックを得ました。 ご意見をお寄せくださった皆様に感謝いたします。

mods の仕組み

Claude Code が何かをするたびに、イベントを発行します。例として、ツールを呼び出す、許可を求める、画面の一部を描画することが挙げられます。mod とは、これらのイベントのいずれかにフックする機能です。mod はイベントの前でも、後でも、またはイベントの代わりに実行できます。イベントをラップし、前後にコードを実行することもできます。 1つの機能で、mod は次のことを行うことができます：

• モデルに到達する前にプロンプトを書き直す。
• ツールコールをブロック、書き直し、または再試行します。
• 権限リクエストを承認または拒否します。
• Claude が読み取る前に、ツールの出力からシークレットを秘匿化します。

mod によって、表示される画面が変わることもあります。ツールの結果や Claude からの質問など、Claude Code が表示するインターフェースの一部を編集または置換できます。ボタンや入力を追加でき、それらを押すと他の mod が応答します。現在、mod はターミナル、デスクトップアプリ、またはその両方をターゲットにできます。

同一のイベントに複数の mod がフックした場合、それらはロード順に実行されます。最初にロードされる mod はイベントを最初に受け取り、結果を最後に受け取ります。これにより、異なる作者の mod を併用することができます。

Claude Code を使用して、Claude Code を改造することもできます。Claude に依頼してmodを作成させれば、TypeScript の記述、インストール、そしてセッション内でのホットリロードまで実行可能です。

組み込み機能を独自の機能に置き換える

Claude Code の組み込み機能の一部が mod として提供されるようになりました。たとえば、組み込みの /diff 機能は現在modになっているため、（/プラグイン で）オフにしたり、独自のバージョンに置き換えたりすることができます。今後、より多くの組み込み機能を mod に移行していく予定です。そうすることで、Claude Code を小規模なコアにまで縮小し、必要なものだけを追加できるようになります。

チームや組織向けのMods

Mods はプラグイン内に含まれているため、既存のプラグイン制御が適用されます。 管理者は、プラグインマーケットプレイスを許可またはブロックできます。 Team プランと Enterprise プランでは、オーナーが管理コンソールで設定します。 Claude API およびサードパーティの API プランでは、管理者が管理設定をユーザーのマシンにプッシュします。

Team プランと Enterprise プラン、および管理設定を持つマシンでは、sec-default （「セキュリティデフォルト」）と呼ばれる組み込みの mod が最初に読み込まれます。 ユーザーがインストールした mod が権限拒否ルールを上書きするような危険な行為を行わないようにします。ソースコードで、何が制限されているかを確認するために、ソースコードを表示できます。代わりに、管理者はまず自分の mod をロードできます。そうする場合は、その制限を維持するために、sec-default をリストに追加してください。

チームはmodを使用して、独自の制御や機能を構築することもできます。 例：

• CI/CD ステータス：modを使用すると、会話の横のペインにパイプラインのステータスを表示し、ビルドの成功や失敗に合わせて更新することができます。
• 本番環境の保護措置：コマンドが本番環境の設定に影響を与える前に、モデレーターによる確認を必須にすることができます。
• 監査ログ：最初にロードされる mod は、他のすべての mod が行うすべての通話を記録できます。

ご利用にあたって

Modsは本日から Claude Code CLI とデスクトップアプリで利用可能になりました。Claude ディレクトリから、または CLI で /plugin を実行して、mods を含むプラグインをインストールします。modを共有するには、プラグインにパッケージ化し、ディレクトリに送信します。

独自の mod を構築するには、開始入門ガイドまたはドキュメントをご覧ください。