概要
Claude Codeにおける指示書(CLAUDE.md)と動作設定(settings.json)の役割、スコープの優先順位、権限モデルの評価ロジックを体系的に整理した解説記事。
詳細内容
### Claude Code 設定体系の全体像
Claude Codeには、AIへの永続的な指示を行う「CLAUDE.md」と、ツール自体の動作を定義する「settings.json」の2系統の設定が存在します。これらはUser、Project、Localの3つのスコープを持ち、指示ファイルは全スコープが連結され、設定ファイルは項目の種類(スカラー、配列、オブジェクト)に応じてマージされる仕組みです。
### 指示とルールの管理
- **CLAUDE.md**: セッション開始時に読み込まれる指示書。コンテキスト節約のため200行以下が推奨されます。
- **.claude/rules/**: 特定のディレクトリやファイルに限定したルールを定義し、必要な時だけロードさせることで精度とコストを最適化します。
### 権限管理とチーム運用
権限モデル(allow/deny/ask)では`deny`が最優先され、どのスコープで設定しても他の`allow`で上書きできない安全設計です。チーム開発では、共有規約をProjectスコープでGit管理し、個人の環境依存設定をLocalスコープで分ける運用がベストプラクティスとされています。