Claude Codeの新機能「Claude Mods」徹底解説
Claude Codeに新たに登場した実験的機能「Claude Mods(Function Hooks)」について解説する動画です。これまでのフック機能とは異なり、Claude Codeの内部プロセスに直接TypeScriptの関数を差し込むことで、UIの描画やユーザー入力の制御、ツール実行結果の改変などが可能になります。AIエージェントの挙動をより高度にカスタマイズできる仕組みとして注目されます。
背景
これまでClaude Codeで外部処理を連携させるには、settings.jsonのフック機能が使われてきました。しかし、従来のフックはイベントごとに新しいプロセスを起動して終了する仕組みであり、実行できることは処理の停止、通過、文言の追加といった限定的なものでした。また、画面への描画やボタン入力の受け付けといったUIへの干渉は不可能でした。今回登場したClaude Modsは、Claude Code本体の内部で起きる出来事に対し、自身のTypeScript関数を常駐させて差し込む「Function Hooks」という仕組みを採用しており、より密接な干渉を可能にしています。
この動画の要点
1. Claude Mods(Function Hooks)は、Claude Code内部のイベントにTypeScript関数を登録する仕組みです。従来のフックと異なり、関数としてプロセス内に生き続けるため、値を記憶したりUIを動的に描画したりすることが可能です。起動時に一度読み込まれ、セッション中はずっと機能し続けます。
2. 実装にはplugin.json、hooks.json、register.tsxの3つのファイルが必要です。環境変数CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1を設定し、プラグインディレクトリを指定して起動します。中心となるのはnext(e)という関数で、これを通じて「次に控えている処理」を呼び出し、入力の書き換えや出力の加工、処理の停止を制御します。
3. 具体的な活用例として、ツール実行結果の機密情報を伏せ字にする「secret-mask」や、rm -rfのような危険なコマンドを検知してユーザーに理由を入力させる「admin-guard」などが紹介されています。UI上の帯(AbovePrompt)に情報を表示したり、ボタンや入力欄を設置したりすることも可能です。
なぜ重要か
Claude Modsの重要性は、AIエージェントの実行過程に対して、開発者がプログラムレベルで細かなガバナンスやUI拡張を施せる点にあります。単なるテキストのやり取りを超え、特定のコマンド実行を論理的に拒否したり、実行結果をリアルタイムでフィルタリングしたりできるため、実務利用における安全性と利便性が向上します。また、TypeScriptで記述できるため、既存のWeb開発の知識を活かしてAIの挙動を「OSのカーネルにパッチを当てるような感覚」でカスタマイズできる点は、開発者にとって非常に強力な武器となるでしょう。現在は実験的な早期アクセス段階ですが、AIエージェントの操作感を根本から変える可能性を秘めています。
こんな人におすすめ
Claude Codeを使いこなしたい開発者や、AIエージェントの挙動をプログラムで厳密に制御したいエンジニアに最適です。TypeScriptを用いた高度なカスタマイズ手法や、UI拡張の具体的な実装イメージを得ることができます。
見どころ
この記事は まさおAIじっくり解説ch が公開した動画をAI(Google Gemini)が視聴して 日本語にまとめ、公開前に運営者が内容を確認したうえで掲載しています。 要約の性質上、細部が元の発言と異なる場合があります。 正確な内容は元の動画をご確認ください。
YouTubeで元の動画を見る