Claude Codeの設定は、JSONのファイルに書きます。どこに置くかで、その設定が誰に効くかが変わります。
置き場所は4つ
- ユーザー設定
~/.claude/settings.json:このパソコンのすべてのプロジェクトで、自分にだけ効きます。 - 共有プロジェクト設定
.claude/settings.json:gitにコミットすると、同じプロジェクトを使う人全員に届きます。 - プロジェクトローカル設定
.claude/settings.local.json:このプロジェクトで、自分にだけ効きます。Claude Codeがこのファイルを作るときは、gitに入らないようにしてくれます。手で作ったときは、自分で.gitignoreに足します。 - 管理設定
managed-settings.jsonなど:組織が配る設定です。
どれが優先されるか
同じ項目が複数の場所にあるときは、上のものが勝ちます。
- 管理設定
- コマンドライン(起動時の
--settings) - プロジェクトローカル設定
- 共有プロジェクト設定
- ユーザー設定
管理設定で決められた項目は、自分のファイルでは変えられません。何が組織に決められているかは、/status の「Setting sources」で確かめられます。
変え方
- いちばん手軽なのは
/configのメニューです。多くの項目は~/.claude/settings.jsonに保存されます。 - ファイルを直接書き換えることもできます。たとえば、
permissionsのallowに"Bash(npm run lint)"を書くと、lintは確認なしで動きます。denyに"Read(./.env)"を書くと、.envを読ませません。
注意
- 設定ファイルは厳密なJSONです。
//のコメントや、最後の要素のあとのカンマはエラーになり、次に起動したときに設定エラーとして表示されます。 - チームで決めた設定は共有プロジェクト設定に、自分だけの例外はプロジェクトローカル設定に分けると、ほかの人の設定を変えずにすみます。