メインコンテンツへスキップ
見出し画像

【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入門

     
     
    「AI、実際どこまで仕事で使えるの?」を非エンジニア目線で検証しています。ChatGPT・Claude・Geminiを実務で試して、使えた/ダメだったを実測と失敗談つきで正直に書きます。

    あなたへのおすすめ