Claude Codeのsettings.jsonとsettings.local.jsonを使い分ける方法

プロジェクトの設定を共有するか、自分の端末だけで使うかでファイルを分けます。現行のスコープと優先順位はSettingsを正本にします。settings.local.jsonは秘密情報を置く場所ではありません。

共有設定と個人設定

共有するルールと、個人だけの例外を振り分けます。

• チームで合意した設定共有用の .claude/settings.json へ。
• このPC・自分だけの調整個人用の .claude/settings.local.json へ。
• APIキーや秘密鍵どちらにも直書きせず、資格情報の管理方法へ。

移す前に控えを取り、移した後に実効値とGitの差分を確認します。

.claude/settings.jsonは、チームで合意した設定や許可ルールをレビュー・配布する候補です。.claude/settings.local.jsonは、個人の好みや端末固有の設定を置く候補です。ユーザー全体の~/.claude/settings.jsonやmanaged settings、環境変数が加わると優先順位が変わるため、同じキーを複数箇所に書かず、All settingsで有効値を確認します。

APIキー、アクセストークン、秘密鍵はどちらにも書きません。.gitignoreでlocalを除外する場合も、既にコミットした秘密情報は漏えい済みとしてローテーションします。Gitの差分とリポジトリのアクセス権を確認してください。

安全な移行手順

1. 現在の設定をバックアップし、どのスコープで読み込まれているかを確認する。
2. 共有したいキーだけを.claude/settings.jsonへ移す。
3. 個人だけのキーを.claude/settings.local.jsonへ移す。
4. /doctorやconfiguration debugで実効値を確認する。

権限ルールは広いワイルドカードを避け、読み取り・テストなど目的ごとに限定します。Accept EditsやAutoを設定しても、変更レビューは必要です。権限モードとCLAUDE.mdは役割が違うため、規約を設定JSONへ詰め込みません。