permissions設定の早見表

defaultModeにreadonlyと書くとclaude doctorが弾きました。allow・ask・denyの書式を表で引けます。

Claude Code の settings.json の permissions を、書き方の早見表にまとめました。allow・ask・deny、defaultMode、additionalDirectories、ルールの書式、設定ファイルの優先順位、そのまま使える設定例3つの順に載せています。書式はすべて公式ドキュメントで確かめました。編集部の検証環境（macOS、Claude Code 2.1.303、jq 1.7.1、2026年10月19日）では、jq と claude doctor で書式のチェックだけをしています。実際のセッションでの挙動は試していません。評価の順番の理由や、allow を広げすぎない考え方はAIエージェントの権限設計で扱っています。

allow・ask・deny

ルールは deny、ask、allow の順に評価され、最初に当たったものが結果になります。ルールが具体的かどうかで順番は変わりません。広い Bash(aws *) を deny すると、狭い Bash(aws s3 ls) を allow しても止まります。

出典：https://code.claude.com/docs/en/permissions 、2026-10-19確認

defaultMode の値

plan mode の入り方と計画の承認の流れはClaude Codeのplan modeの使い方で説明しています。

出典：https://code.claude.com/docs/en/permissions 、2026-10-19確認

値を書き間違えると、その値は使われません。 "defaultMode": "readonly" と書いて claude doctor を実行すると、次のように出ました。

- <project>/.claude/settings.json › permissions.defaultMode: Invalid value. Expected one of: "acceptEdits", "auto", "bypassPermissions", "default", "dontAsk", "plan"

"manual" と書いた場合は、何も指摘されませんでした。

ルールの書式

ファイルのルールに効くのは Read(...) と Edit(...) だけです。Write(docs/**) と書いても受け付けられますが、参照されません。代わりに Edit(docs/**) と書きます。Read の deny は、同じパスへの Edit と Write も止めます。ただし grep -r のように、ファイル名を書かずに読むコマンドには効きません。

出典：https://code.claude.com/docs/en/permissions 、2026-10-19確認

括弧付きの MCP ルールは、claude doctor でこう出ました。

- <project>/.claude/settings.json › permissions.allow: Invalid permission rule "mcp__github__create_issue(repo:x)" was skipped: MCP rules do not support patterns in parentheses. ...

Write(docs/**) と Bash(git * main) は、claude doctor では指摘されませんでした。公式によると、これらはセッションの起動時に警告が出ます（起動時の警告は未確認）。

作業ディレクトリを足す

Claude が確認なしで読めるのは、起動したディレクトリの中です。ほかのディレクトリを足す方法は3つあります。起動時の --add-dir <path>、セッション中の /add-dir、設定の additionalDirectories です。足したディレクトリにも、元の作業ディレクトリと同じルールがかかります。ただし足したディレクトリの .claude/ の設定は、ほとんど読み込まれません。

出典：https://code.claude.com/docs/en/permissions 、2026-10-19確認

設定ファイルの場所と優先順位

permissions.allow のようなリストは、上書きされず足し合わされます。deny はどの階層にあっても効きます。ユーザー設定で allow しても、プロジェクトの設定で deny されていれば止まります。セッション中は /permissions で、すべてのルールと、それぞれがどのファイルから来たかを見られます。読み込まれた設定ファイルは /status の Setting sources で確かめます。

出典：https://code.claude.com/docs/en/settings 、https://code.claude.com/docs/en/permissions 、2026-10-19確認

そのまま使える設定例

3つとも jq empty を通り、claude doctor でも不正な設定は出ませんでした。

読み取り中心で、安全寄りの設定です。

{
  "permissions": {
    "defaultMode": "plan",
    "allow": ["Bash(git status)", "Bash(git diff *)", "Bash(git log *)"],
    "deny": ["Edit", "WebFetch"],
    "additionalDirectories": ["../shared-docs"]
  }
}

テストとビルドだけを許す設定です。

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(npm run build)",
      "Bash(npm run lint)",
      "Edit(/src/**)",
      "Edit(/tests/**)"
    ],
    "ask": ["Bash(npm install *)", "Bash(git push *)"],
    "deny": ["Bash(npm publish *)", "Bash(curl *)"]
  }
}

秘密ファイルを読ませない設定です。

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Bash(printenv *)"
    ]
  }
}

git -C . push のように書き方を変えたコマンドは、Bash(git push *) に当たりません。確実に止めたいものは hook も併用します。書き方はClaude Code hooks実践を、秘密情報の扱いはClaude Codeに秘密を渡さないを読んでください。

まとめ

• ルールは deny、ask、allow の順に評価され、allow で deny に例外は作れない
• defaultMode の値は6つ。書き間違いは claude doctor で見つかる
• * はサブコマンドの後ろに置く。:* は末尾だけで使える
• ファイルのルールは Read と Edit だけが効く。/path は設定ファイルの場所が基準で、絶対パスは //path
• 括弧付きの MCP ルールは読み飛ばされる
• 優先順位は managed、--settings、local、project、user の順。リストは足し合わされる

関連記事

• PreToolUse hookの例集
• PostToolUseで整形とテストを自動化
• Stop hookで完了を確かめる
• UserPromptSubmitの使い方