Claude Code settings.json設定一覧｜権限の雛形と優先順位

Claude Code の settings.json とは、権限ルール・既定のモデル・環境変数などを JSON で書いておく設定ファイルです。 置き場所は 4 か所あり、同じキーが重なったときは「managed → コマンドライン → project local → shared project → user」の順で上にあるものが使われます。

この記事では、そのまま置ける settings.json の全文を用途別に 4 種類、公式リファレンスの 17 分類・243 キーの日本語一覧、権限ルールの書き方の対比表、設定が効かない時の確認手順をまとめました。雛形はすべて JSON の構文チェックと claude doctor を通した結果を載せています。

確認環境：Claude Code 2.1.292（Linux x64）、Python 3.11.15、git 2.43.0。仕様は 2026年10月7日に公式ドキュメント（code.claude.com/docs）を開いて確認しました。

settings.json の早見表

ルールの判定順は deny → ask → allow で、最初に当たったものが結果になります。ルールの細かさは順番に影響しません。

settings.json はどこに置くか

Claude Code をインストールしただけでは設定ファイルは作られません。自分で作るか、Claude Code が必要になった時点で書き出します（/config で変更したとき、権限の確認で「Yes, and don't ask again」を選んだときなど）。

このほかに ~/.claude.json というファイルもあります。こちらは Claude Code 自身が書き込むファイルで、サインイン情報、MCP サーバーの設定、フォルダの信頼状態、/config が書くグローバル設定キーが入ります。settings.json とは別物なので、権限ルールを書く場所ではありません。

設定ファイルは厳密な JSON です。// のコメントや末尾のカンマは構文エラーになり、次回起動時に Settings Error として表示されます。

そのまま置ける settings.json の雛形 4 種

4 つとも、不要なキーを消して値を書き換えれば使えます。$schema の行を入れておくと、VS Code などの JSON スキーマ対応エディタで補完と検証が効きます。

1. 個人用：~/.claude/settings.json

すべてのプロジェクトに効く自分用の設定です。読み取り専用の git コマンドを確認なしにし、push は毎回確認、鍵やクラウドの認証情報は読ませない構成です。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "language": "japanese",
  "model": "sonnet",
  "autoUpdatesChannel": "stable",
  "cleanupPeriodDays": 30,
  "spinnerTipsEnabled": false,
  "permissions": {
    "defaultMode": "default",
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)"
    ],
    "ask": [
      "Bash(git push *)"
    ],
    "deny": [
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Read(//**/.env)"
    ]
  }
}

user 設定でパスを書くときは ~/ か // で始めます。 /secrets/** のようにスラッシュ 1 つで始めると、user 設定では ~/.claude/secrets/** を指すためです（後述の対比表を参照）。

2. チーム共有：.claude/settings.json

リポジトリのルートに置いてコミットするファイルです。lint・テスト・ビルドは確認なし、push とパッケージ追加は確認あり、秘密情報とマイグレーションには触れさせない構成です。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Bash(npm run build)",
      "Bash(git commit *)",
      "WebFetch(domain:docs.example.com)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(npm install *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Edit(./migrations/**)",
      "Bash(curl *)",
      "Bash(wget *)"
    ],
    "additionalDirectories": [
      "../shared-docs"
    ]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "plansDirectory": "./plans",
  "respectGitignore": true
}

共有ファイルの allow と additionalDirectories は、各メンバーがそのフォルダを信頼（workspace trust）してから有効になります。 deny と ask は制限する側のルールなので、信頼の前から効きます。

3. 個人上書き：.claude/settings.local.json

チームの設定はそのままに、自分だけ値を変えたいときのファイルです。shared project より優先されます。

{
  "model": "opus",
  "spinnerTipsEnabled": false,
  "permissions": {
    "allow": [
      "Bash(npm run dev)",
      "Bash(docker compose ps)"
    ]
  },
  "env": {
    "LOG_LEVEL": "debug"
  }
}

4. 組織管理：managed-settings.json

管理者が各端末のシステムディレクトリに配布するファイルです。ここに書いた値は、user・project・local・--settings のどれからも上書きできません（一部の、より厳しい値を尊重するキーを除く）。

{
  "forceLoginMethod": "claudeai",
  "availableModels": [
    "opus",
    "sonnet"
  ],
  "enforceAvailableModels": true,
  "permissions": {
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "allowManagedPermissionRulesOnly": false,
  "requiredMinimumVersion": "2.1.150",
  "cleanupPeriodDays": 30,
  "companyAnnouncements": [
    "社内ガイドライン: https://docs.example.com/claude-code"
  ]
}

allowManagedPermissionRulesOnly を true にすると、権限ルールの出どころが managed 設定だけになり、利用者側の allow / ask / deny は使われなくなります。最初は false で配り、方針が固まってから切り替えると移行しやすくなります。

.gitignore に足す 1 行

.claude/settings.local.json を Claude Code が初めて書き出すときは、グローバルの git 除外ファイルに **/.claude/settings.local.json が自動で追加されます。手で作った場合は、次の行をリポジトリの .gitignore に足します。

# Claude Code: 個人用の設定はコミットしない
.claude/settings.local.json

追加後に git で確かめた結果です。settings.local.json だけが対象から外れ、共有する settings.json は残っています。

$ git check-ignore -v .claude/settings.local.json
.gitignore:3:.claude/settings.local.json    .claude/settings.local.json
$ git status --short -uall
?? .claude/settings.json
?? .gitignore

JSON の構文を確かめるスクリプト

置く前に構文を確かめる小さなスクリプトです。標準ライブラリだけで動きます。

import json, sys

for path in sys.argv[1:]:
    try:
        with open(path, encoding="utf-8") as f:
            data = json.load(f)
    except json.JSONDecodeError as e:
        print(f"NG  {path}: {e.lineno}行目 {e.colno}文字目 {e.msg}")
        continue
    perms = data.get("permissions", {})
    counts = ", ".join(f"{k}={len(perms.get(k, []))}" for k in ("allow", "ask", "deny"))
    print(f"OK  {path}: トップレベル {len(data)} キー / {counts}")

上の 4 つの雛形と、コメントと末尾カンマを入れた broken.json を渡した結果です。

$ python3 check_json.py user.settings.json project.settings.json local.settings.json managed-settings.json broken.json
OK  user.settings.json: トップレベル 7 キー / allow=3, ask=1, deny=3
OK  project.settings.json: トップレベル 5 キー / allow=5, ask=2, deny=6
OK  local.settings.json: トップレベル 4 キー / allow=2, ask=0, deny=0
OK  managed-settings.json: トップレベル 8 キー / allow=0, ask=0, deny=4
NG  broken.json: 2行目 3文字目 Expecting property name enclosed in double quotes

broken.json の中身は次のとおりで、2 行目のコメントで止まっています。

{
  // 個人用
  "language": "japanese",
}

permissions 配下の 7 キー

disableBypassPermissionsMode は真偽値ではなく文字列の "disable" を書きます。 true と書くと claude doctor が Invalid value. Expected one of: "disable" と知らせます（後の「設定が効かない時」に出力を載せています）。auto モードを外す disableAutoMode も同じく "disable" です。

additionalDirectories に書いたディレクトリはファイルアクセスだけが広がります。そのディレクトリの .claude/ にあるスキルや設定は読み込まれません。

defaultMode に書ける値

• default は画面上で Manual と表示され、v2.1.200 以降は manual という別名でも書けます。
• auto と bypassPermissions は、project と local の設定ファイルに書いても効きません。 user か managed に書くか、claude --permission-mode <値> で 1 セッションだけ指定します。
• v2.1.283 以降、対話型のターミナルと VS Code のセッションは auto モードで始まるのが組み込みの既定です。
• deny ルールはどのモードでも効きます（bypassPermissions を含む）。allow ルールは bypassPermissions では意味を持ちません。
• セッション中は Shift+Tab でモードを切り替えられます。

優先順位は 5 段

同じキーが複数の場所にあるとき、Claude Code はいちばん上の段で設定されている値を使います。

flowchart TB
    A["1. managed<br/>managed-settings.json・MDM・管理コンソール<br/>（組織）"]
    B["2. コマンドライン<br/>claude --settings<br/>（その 1 セッション）"]
    C["3. project local<br/>.claude/settings.local.json<br/>（自分・このプロジェクト）"]
    D["4. shared project<br/>.claude/settings.json<br/>（プロジェクトの全員）"]
    E["5. user<br/>~/.claude/settings.json<br/>（自分・全プロジェクト）"]
    A -->|上が優先| B --> C --> D --> E

環境変数はこの段には含まれません。 たとえばシェルで export した ANTHROPIC_MODEL はどのファイルの model より優先されますが、どちらが使われるかはキーと変数の組ごとに決まっています。設定ファイルの中の env ブロックは普通のキーなので、上の 5 段に従います。

配列はマージされる

permissions.allow のような配列のキーは、上の段が下の段を置き換えるのではなく、全部が合わさります。この記事の雛形 1〜3 を同時に置いた場合は次のようになります。

ここから 2 つのことが言えます。

• どこか 1 か所で deny されたものは、ほかの段の allow では通せません。 user の deny は project の allow より先に判定され、その逆も同じです。
• local の allow は、project や managed の ask を上書きしません。 「Yes, and don't ask again」を選んだのにまた確認される場合は、上位のファイルに ask ルールがないかを見ます。

なお、モデルの並びを持つ fallbackModel は順番に意味があるためマージされず、いちばん上の段の配列がそのまま使われます。

権限ルールの書き方：広すぎる例と直した例

ルールは Tool または Tool(specifier) の形です。ツール名だけを書くと、そのツールの利用すべてに当たります。

パスの 4 つの書き方は次のとおりです。Read と Edit のルールは gitignore のパターン記法に従います。

知っておくと設計しやすい点を 3 つ挙げます。

• Bash のルールはコマンドの文字列に対して当てます。 Bash(rm *) を deny にしても、/bin/rm や bash -c 'rm ...' という書き方には当たりません。境界として確実に効かせたいものは、サンドボックス（sandbox キー）や PreToolUse フックと組み合わせます。
• && や | でつないだコマンドは、部分ごとに判定されます。 Bash(safe-cmd *) を allow にしても safe-cmd && other-cmd は通りません。
• Read の deny は Edit と Write も止めます。 同じパスへの新規作成も対象です。

設定キーの日本語一覧（17 分類・243 キー）

公式の設定リファレンスの索引（2026年10月7日時点）に載っている全キーを、分類ごとに並べました。

• 型は、Claude Code 2.1.292 の claude doctor に型の合わない値を渡したときのメッセージ（Expected boolean など）と、公式リファレンスの記載から取っています。— は doctor がメッセージを出さなかったキーです。
• 置けるファイルの「すべて」は user・shared project・project local・managed の 4 つを指します。~/.claude.json と書いたキーは settings.json ではなく ~/.claude.json に入ります。
• 入れ子のキーは permissions.allow のようにドットで表しています。JSON では {"permissions": {"allow": [...]}} と書きます。

1. モデルと応答（Model and responses）

2. 権限（Permission settings）

3. サンドボックス（Sandbox settings）

4. フックと自動化（Hooks and automation）

5. MCP（MCP）

6. プラグインとスキル（Plugins and skills）

7. メモリとコンテキスト（Memory and context）

8. Git と帰属表示（Git and attribution）

9. 画面とターミナル（Interface and terminal）

10. エージェント・セッション・worktree（Agents, sessions, and worktrees）

11. リモート・デスクトップ・通知（Remote, desktop, and notifications）

12. 認証とプロバイダー（Authentication and providers）

13. プライバシーと記録の保持（Privacy and telemetry）

14. 更新とバージョン（Updates and versioning）

15. ツール（Tools）

16. グローバル設定（Global config settings）

17. 組織向けの管理（Enterprise and managed settings）

既定値が明記されているキーの例

設定していないキーの多くは「未設定」として扱われ、Claude Code やアカウントの既定の動きになります。公式リファレンスに既定値が明記されているものの例です。

設定が効かない時の確認手順

まず /status を開き、Status タブの Setting sources の行で、どのファイルが読み込まれたかを見ます。次に claude doctor で、読み飛ばされた項目を確認します。

claude doctor の出力例

わざと書式の合わない値を入れた .claude/settings.json を用意しました。

{
  "permissions": {
    "defaultMode": "ask",
    "disableBypassPermissionsMode": true,
    "allow": [
      "mcp__*",
      "Bash(git * main)",
      "Write(docs/**)",
      "mcp__github__create_issue(title:*)",
      "bash(npm run *)",
      "Bash(npm run build"
    ],
    "deny": [
      "Bash(command:rm *)",
      "Raed(./.env)",
      "Glob(secrets/**)"
    ]
  },
  "cleanupPeriodDays": "30",
  "tui": "classic"
}

このフォルダで claude doctor を実行したときの Invalid settings の部分です（Claude Code 2.1.292）。

Invalid settings
- .claude/settings.json › permissions.allow: Invalid permission rule "mcp__*" was skipped: Wildcard tool name "mcp__*" is not supported in allow rules. An allow pattern must name the scope it widens — globs are permitted only in the tool position after a literal mcp__<server>__ prefix. Deny and ask rules accept wildcards anywhere
- .claude/settings.json › permissions.allow: Invalid permission rule "mcp__github__create_issue(title:*)" was skipped: MCP rules do not support patterns in parentheses. Use "mcp__github__create_issue" without parentheses, or use "mcp__github__*" for all tools
- .claude/settings.json › permissions.allow: Invalid permission rule "bash(npm run *)" was skipped: Tool names must start with uppercase. Use "Bash"
- .claude/settings.json › permissions.allow: Invalid permission rule "Bash(npm run build" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal
- .claude/settings.json › cleanupPeriodDays: Expected number, but received string
- .claude/settings.json › permissions.defaultMode: Invalid value. Expected one of: "acceptEdits", "auto", "bypassPermissions", "default", "dontAsk", "plan"
  Suggested fix: Valid modes: "acceptEdits" (ask before file changes), "plan" (analysis only), "bypassPermissions" (auto-accept all), or "default" (standard behavior)
- .claude/settings.json › permissions.disableBypassPermissionsMode: Invalid value. Expected one of: "disable"
  Suggested fix: Valid values: "disable"
- .claude/settings.json › tui: Invalid value. Expected one of: "default", "fullscreen"
  Suggested fix: Valid values: "default", "fullscreen"

読み取れることは次のとおりです。

• 読み飛ばされるのはその項目だけで、ファイルの残りは有効なままです（Settings Warning の扱い）。
• ツール名は大文字で始めます（bash ではなく Bash）。
• defaultMode に ask という値はありません。確認しながら進めたいときは default です。
• doctor の Invalid settings に出なかった Bash(git * main)、Write(docs/**)、Bash(command:rm *)、Raed(./.env)、Glob(secrets/**) は、公式ドキュメントでは起動時の警告の対象、または「受け付けるが判定には使われない」と説明されているものです。doctor に何も出なくても、対比表の書き方に合っているかは別に確かめると安心です。

雛形 1〜3 を同じ手順で置いたときは、Invalid settings の欄そのものが表示されませんでした。

よくある質問

Q. settings.json と CLAUDE.md はどう使い分けますか？ A. 権限ルールは Claude Code 本体が強制するもので、モデルへの指示ではありません。CLAUDE.md やプロンプトの指示は Claude が何を試みるかに影響しますが、何が許可されるかは変えません。許可・禁止は settings.json、進め方の指示は CLAUDE.md に書きます。

Q. 編集したら再起動が必要ですか？ A. 多くのキーは不要です。Claude Code は設定ファイルを監視していて、permissions や hooks の変更は実行中のセッションに反映されます。model や effortLevel のようにセッション開始時に 1 回だけ読むキーは、/model や /effort で切り替えます。

Q. 保存せずに 1 回だけ試したいときは？ A. claude --settings '{"model": "opus"}' のように JSON かファイルパスを渡します。managed より下、設定ファイルより上の段として扱われ、どのファイルにも書き込まれません。

Q. チームの設定を自分だけ変えたいときは？ A. .claude/settings.local.json に同じキーを書きます。project local は shared project より上の段なので、自分のセッションだけ値が変わります。ただし deny と ask は足し合わされるため、チームの deny を local の allow で外すことはできません。

まとめ

• 置き場所は 4 つ＋コマンドライン。優先順位は managed → コマンドライン → project local → shared project → user。
• 配列（permissions.allow など）はマージされ、判定は deny → ask → allow の順。どこかの deny は、ほかの段の allow では通せない。
• auto と bypassPermissions の defaultMode は user か managed に書く。project / local に書いても効かない。
• パスは //（絶対）・~/（ホーム）・/（設定ファイル基準）・./（現在地） を使い分ける。
• ファイル編集のルールは Edit(...)、MCP は mcp__サーバー名__ツール名 で書き、allow のワイルドカードはサーバー名の後ろだけ。
• 効かないときは /status → claude doctor → /permissions の順に見る。
• 手で作った .claude/settings.local.json は .gitignore に追加する。

参考・出典

確認日：2026年10月7日

• Claude Code Docs: Settings files and precedence — https://code.claude.com/docs/en/settings
• Claude Code Docs: Settings reference — https://code.claude.com/docs/en/settings-reference
• Claude Code Docs: Example settings files — https://code.claude.com/docs/en/settings-example
• Claude Code Docs: Configure permissions — https://code.claude.com/docs/en/permissions
• Claude Code Docs: Choose a permission mode — https://code.claude.com/docs/en/permission-modes
• Claude Code Docs: Deploy managed settings — https://code.claude.com/docs/en/managed-settings

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。