settings.json

hooks.ConfigChange

型array

セッション中に設定、管理設定、またはスキルファイルが変更された際に実行されるフック。

使い方・用途

  • 設定ファイルへの外部からの変更をリアルタイムで監視し、監査ログに記録したり、未承認の変更をブロックしたりしてセキュリティとコンプライアンスを強化します。
英語原文(公式ドキュメントより)

Hooks that run when settings, managed settings, or skill files change during a session. Supports matchers: user_settings, project_settings, local_settings, policy_settings, skills. Command handlers only. Exit code 2 blocks the change (except policy_settings which is audit-only). See https://code.claude.com/docs/en/hooks#configchange

関連ドキュメント

関連する変更履歴

v2.1.290(1件)

Fixed
Linux でサンドボックス化された Bash コマンド実行時、.claude/settings.json や .claude/settings.local.json が存在しない場合に ConfigChange フックが実行され、コマンド実行中に設定が再読み込みされる問題を修正した。
英語原文を表示
Fixed sandboxed Bash commands on Linux running ConfigChange hooks and reloading settings mid-command when .claude/settings.json or .claude/settings.local.json does not exist

関連ドキュメント

v2.1.140(1件)

Fixed
シンボリックリンクされた設定ファイルにおいて、設定のホットリロードが誤った変更イベントを検知し、不要な ConfigChange フックをトリガーしていたデグレードを修正
英語原文を表示
Fixed a regression in settings hot-reload where symlinked settings files caused misattributed change events and spurious ConfigChange hooks

変更後

設定管理の柔軟性を保ちつつ、自動化スクリプトの誤作動を回避して安定したワークフローを維持できます。

関連ドキュメント

v2.1.49(1件)

Added
セッション中に設定ファイルが変更された際に発火するConfigChangeフックイベントが追加されました。これにより、エンタープライズレベルでのセキュリティ監査や設定変更のブロックが可能になります。
英語原文を表示
Added ConfigChange hook event that fires when configuration files change during a session, enabling enterprise security auditing and optional blocking of settings changes.

変更後

企業はClaude Codeのセキュリティとコンプライアンスをより厳密に管理できるようになります。設定変更が追跡可能になり、承認されていない変更を自動的に防ぐことで、開発環境の安全性が向上し、管理者は安心してClaude Codeを導入・運用できます。

関連ドキュメント