2026-09-28 のドキュメント更新は、フックから MCP サーバーのツールを直接呼び出せる新しいフック種別の追加と、設定ファイルの整合性を一括検査する /doctor prompt-audit コマンドの導入が中心です。
フックから MCP ツールを呼び出す新しいフック種別
フックに type: "mcp_tool" を指定することで、設定済みの MCP サーバー上のツールをフックから直接呼び出せるようになりました。引数には ${tool_input.file_path} のような形式で JSON 入力からの値を展開でき、たとえば Write や Edit の後にセキュリティスキャンツールを自動実行する構成が取れます。
String values support ${path} substitution from the hook's JSON input , such as "${tool_input.file_path}"
（出典 [1]）
（訳：文字列値は、フックの JSON 入力から ${path} の形式で値を展開できます。例として "${tool_input.file_path}" が示されています。）
ツールの実行結果は既存のコマンドフックの標準出力と同じルールで読み取られます。ツールが isError: true を返した場合は非ブロッキングエラーとして扱われ、処理は続行されます。
サーバーの接続状態によって挙動が変わる点も明文化されました。PreToolUse や Stop のように処理を止められるイベントでは、サーバーが接続中であれば MCP_TIMEOUT の範囲内で待機します。一方、Notification や SessionEnd のような観察専用イベントでは待機しません。
セッション起動時の制約も記載されています。SessionStart と Setup はセッションの MCP サーバーが利用可能になる前に発火するため、これらに設定した mcp_tool フックはスキップされます。
Events that fire before MCP servers are available
（出典 [1]）
（訳：MCP サーバーが利用可能になる前に発火するイベントがあります。）
起動時に何かを実行したい場合は、type: "command" フックを SessionStart に設定する必要があります。なお /clear やコンパクション後に SessionStart が再び発火した際には mcp_tool フックは実行されます。OAuth 認証が必要なサーバーについては、/mcp からあらかじめ認証を済ませておく必要があります。フックが OAuth フローを起動することはないとドキュメントに記載されており、それ以上の詳細は不明です。
/doctor prompt-audit による設定ファイルの検査
/doctor prompt-audit コマンドが追加されました。このコマンドは CLAUDE.md、CLAUDE.local.md、AGENTS.md のほか、.claude/ および ~/.claude/ 以下のスキルやコマンド等を対象に問題を検出します。
It looks for problems such as instructions written for older models, references to files or commands that don't exist, and files that contradict each other.
（出典 [2]）
（訳：古いモデル向けに書かれた指示、存在しないファイルやコマンドへの参照、互いに矛盾するファイルといった問題を検出します。）
実行後はレポートと編集案が提示されますが、実際にファイルが変更されるのはユーザーが適用を指示した後です。特定のファイルやディレクトリだけを対象にしたい場合はパスを渡せます。このコマンドは bundled /claude-api スキルが有効な状態でのみ動作します。
/doctor prompt-audit requires Claude Code v2.1.283 or later
（出典 [2]）
（訳：/doctor prompt-audit を使うには Claude Code v2.1.283 以降が必要です。）
また、CLAUDE.md でコミットやプルリクエストのルールを設定している場合、Claude Code が自動で付加するデフォルト指示と競合する可能性があることも追記されています。その場合は includeGitInstructions で組み込み指示を無効化し、attribution でテキストを設定する方法が示されています。
その他の更新
- パーミッションモードのドキュメントに、allow ルールが一致した場合でも保護パスへの書き込みはクラシファイアに送られるという動作の詳細が追加されました。シンボリックリンク経由で保護パス外に解決される書き込みも自動承認の対象外になります。
まとめ
今回の更新で最も影響が大きいのは MCP ツールフックの追加です。これにより、フックを通じた自動化において MCP サーバーを直接呼び出せる経路が生まれ、シェルコマンドに頼らない構成が可能になります。/doctor prompt-audit は、複数の設定ファイルを管理しているプロジェクトで矛盾や古い記述を一括発見する手段として機能します。利用には Claude Code v2.1.283 以降へのアップデートが必要です。パーミッションモードの変更は動作の明文化にとどまっており、シンボリックリンクを含む構成を使っている場合は動作を確認することが推奨されます。
出典
本稿の引用はすべて一次資料と逐語照合（verify_article 通過）のうえ掲載しています（2026-09-29 検証）。
[1] https://code.claude.com/docs/en/hooks
[2] https://code.claude.com/docs/en/memory
[3] https://code.claude.com/docs/en/permission-modes