Claude Code の settings.json と settings.local.json で permissions を設計する

Claude Code は既定では、ファイルの編集やコマンドの実行のたびに確認を求めます。安全ではありますが、そのままでは作業のテンポが上がりません。かといって全許可にすると、rm -rf や git push --force のような取り返しのつかない操作まで自動で通ってしまいます。

この記事では、settings.json の permissions を使って「安全な操作は自動、危険な操作は確認か禁止」という線引きを作る方法と、チームで共有する settings.json と個人用の settings.local.json の役割分担を解説します。

settings.json の置き場所と優先順位

複数のファイルに同じキーがある場合、管理者設定 → コマンドライン(claude --settings)→ ローカル → プロジェクト → ユーザーの順に強く、上位に書かれた同じキーが下位を上書きします。permissions のルールだけは別で、deny → ask → allow の順に評価され、先に一致したものが結果を決めます。そのため、チームで禁止したい操作をプロジェクトの deny に書いておけば、個人の allow で解除されることはありません。

permissions の基本構造

{
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Bash(git diff:*)",
      "Bash(git log:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(npm install:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(git push --force:*)"
    ],
    "defaultMode": "acceptEdits"
  }
}

ルールの書き方

ルールは ツール名(パターン) の形で書きます。パターンを省略するとそのツール全体が対象です。

settings.json と settings.local.json の役割分担

.claude/ ディレクトリには、settings.json のほかに settings.local.json というファイルができていることがあります。Claude Code が自動生成する個人用の設定ファイルで、チームで共有する settings.json とは役割が違います。

「今後も許可」で何が起きるか

対話中に確認ダイアログで「今後も許可する」を選ぶと、そのコマンドのパターンが settings.local.json の allow に追記されます。

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(git diff:*)"
    ]
  }
}

気付かないうちに allow が増えていくため、/permissions コマンドで定期的に確認し、不要なものは削除してください。「あのコマンドが確認なしで走るのはなぜか」と思ったら、まずこのファイルを見ます。設定の読み込み元が分からないときは claude config list や /status で確認できます。

どちらに何を書くか

チームの settings.json は慎重側に倒し、速く進めたい人は settings.local.json で上書きする、という分担が扱いやすいです。

Git 管理から外れる仕組み

ここは誤解されやすい点です。Claude Code はリポジトリの .gitignore を書き換えません。まだ無視されていない git リポジトリで settings.local.json を初めて書き出すとき、グローバルの git 除外ファイルに **/.claude/settings.local.json を追加します。これによって、どのリポジトリでもこのファイルがコミットに入らなくなります。

対象のファイルは、グローバルの git 設定で core.excludesFile が絶対パスか ~ 始まりのパスに設定されていればそれ、設定されていなければ $XDG_CONFIG_HOME/git/ignore、XDG_CONFIG_HOME が未設定なら ~/.config/git/ignore です。

.claude/settings.local.json
CLAUDE.local.md

Git 管理外とはいえ、hooks の command に API キーを直接書くのは避けてください。環境変数から読ませる形にします。

推奨設定、個人開発

編集は自動許可し、外部に影響する操作だけ確認する構成です。

{
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Bash(npm run *)",
      "Bash(npx tsc *)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(npm install:*)",
      "Bash(npm uninstall:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Bash(rm -rf:*)",
      "Bash(git push --force:*)",
      "Bash(git reset --hard:*)"
    ]
  }
}

推奨設定、チーム開発

.claude/settings.json には全員に適用したい deny と、誰が実行しても安全な allow だけを入れます。個人の好みは settings.local.json に任せます。

{
  "permissions": {
    "allow": [
      "Bash(pnpm lint)",
      "Bash(pnpm test:*)",
      "Bash(pnpm typecheck)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./infra/secrets/**)",
      "Edit(./.github/workflows/**)",
      "Bash(git push --force:*)",
      "Bash(git push -f:*)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)",
      "Bash(wget:*)"
    ]
  }
}

curl や wget を deny に入れているのは、任意の URL からのダウンロードや外部へのデータ送信を防ぐためです。必要なら ask に移してください。

関連する設定

npm scripts の自動許可、git push の確認、force push の禁止を 1 つの設定にまとめた実例は Claude Code の permissions 設定例 にあります。権限だけでなく、hooks で「編集後に自動で lint を走らせる」仕組みを組み合わせると、自動許可の範囲を広げても品質を保ちやすくなります(hooks で lint と format を自動実行する)。秘密情報の保護は AI コーディングツールに秘密情報を読ませないための設定 で扱っています。

まとめ

• 設定はユーザー → プロジェクト → ローカルの順に上書きされ、permissions の deny は常に最優先
• Bash(npm run test:*) のように「ツール名(パターン)」で書く
• settings.json はチーム共有(Git 管理)、settings.local.json は個人用。「今後も許可」はローカルの allow に追記されるので /permissions で定期的に見直す
• settings.local.json はリポジトリの .gitignore ではなくグローバルの git 除外設定で外れる。全員に効かせるなら .gitignore にも書く
• defaultMode: "acceptEdits" と少数の allow から始め、危険な操作は deny に入れる