
【Tips】Claude Codeで個人設定をgitに含めない方法——settings.local.jsonの使い方
チームでClaude Codeを使っていて、自分だけの設定を入れたいけど `.claude/settings.json` を変更するとgitに差分が出てしまう——そんな悩みを解決する方法があります。
このnoteでは、非エンジニアでも再現できるAI活用法を実測データつきで解説しています。
Claude Codeには `.claude/settings.local.json` という設定ファイルがあります。`.claude/settings.json` と同じ書式で、Claude Codeが初回作成時に `~/.config/git/ignore` へ自動追加するため、リポジトリにコミットされません。チームで確実に除外するなら、プロジェクトの `.gitignore` にも追加しておくと安全です。
私は5つのプロジェクトを並行運用していますが、チームメンバーと共有する `.claude/settings.json` と、個人用の `.claude/settings.local.json` を使い分けることで、設定の衝突がなくなりました。
Claude Code settings.local.jsonの使い方
プロジェクトの `.claude/` ディレクトリに `settings.local.json` を作成するだけです。以下は私が実際に使っている設定です。
{
"permissions": {
"allow": [
"Bash(npm test:*)",
"Bash(python -m pytest:*)",
"Bash(npx eslint:*)"
]
},
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "echo 'Reminder: 日本語で応答すること。開発ログはObsidianに出力する。'"
}
]
}
]
}
}`permissions` でテスト・リント系コマンドの自動許可を設定し、`hooks` でセッション開始時にリマインダーを注入しています。チームの `settings.json` では Hooks を使っていないプロジェクトでも、個人環境でだけ自動化を追加できます。
settings.jsonとsettings.local.jsonのマージ動作
両方のファイルが存在する場合、設定はマージ(結合)されます。配列設定(`permissions.allow` 等)は両ファイルの値が結合され、スカラー設定(`model` 等)は settings.local.json の値が優先されます。
`settings.json` — チーム共有の設定(gitにコミット)
`settings.local.json` — 個人用の追加設定(gitignore対象、配列はマージ・スカラーは上書き)
`CLAUDE.md` と `CLAUDE.local.md` の関係と同じ考え方です。チーム共有のルールをベースに、個人の環境差分だけをlocalファイルに書きます。
settings.local.json の注意点
`settings.local.json` は プロジェクトスコープ専用 です(`.claude/settings.local.json`)。グローバル(`~/.claude/`)には配置できません。グローバルで個人設定を管理したい場合は `~/.claude/settings.json` を使います。
私は最初、グローバルの `~/.claude/settings.json` にプロジェクト固有のテストコマンド(`npm test`)を許可していましたが、Pythonプロジェクトでも `npm test` が許可されてしまい、混乱しました。プロジェクト固有の設定はプロジェクトの `.claude/settings.local.json` に書くのが安全です。
Claude Code活用の実践ノウハウを引き続き発信しています。この記事が参考になったら、スキとフォローで応援お願いします。
参考: Claude Code公式ドキュメント — Settings / CLAUDE.mdの書き方ガイド / Claude Code Hooks入門