settings.json

ConfigChange

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

使い方・用途

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

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.49 (1件)

Added
Hooks Settings
セッション中に設定ファイルが変更された際に発火する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のセッション中に設定ファイル(settings.jsonやスキルファイルなど)が外部から変更されても、それを自動的に検知して対応する仕組みがありませんでした。これにより、セキュリティポリシーの監査や、意図しない設定変更を防ぐことが困難でした。

変更後

新しく追加されたConfigChangeフックイベントは、設定ファイルがセッション中に変更されるとトリガーされます。このイベントを利用することで、企業は設定ファイルの変更をリアルタイムで監視し、監査ログに記録したり、特定の変更をブロックしたりするカスタムフックを実装できるようになります。

ユーザーへの恩恵

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

関連ドキュメント