権限を設定する

​

権限システム

​

権限を管理する

• Allow ルールは、Claude Code が手動承認なしで指定されたツールを使用できるようにします。
• Ask ルールは、Claude Code が指定されたツールを使用しようとするたびに確認を促します。
• Deny ルールは、Claude Code が指定されたツールを使用することを防止します。

​

権限モード

​

権限ルール構文

​

ツールのすべての使用をマッチさせる

​

細かい制御のためにスペシファイアを使用する

​

ワイルドカードパターン

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git commit *)",
      "Bash(git * main)",
      "Bash(* --version)",
      "Bash(* --help *)"
    ],
    "deny": [
      "Bash(git push *)"
    ]
  }
}

​

ツール固有の権限ルール

​

Bash

• Bash(npm run build) は正確な Bash コマンド npm run build をマッチさせます
• Bash(npm run test *) は npm run test で始まる Bash コマンドをマッチさせます
• Bash(npm *) は npm で始まるコマンドをマッチさせます
• Bash(* install) は install で終わるコマンドをマッチさせます
• Bash(git * main) は git checkout main、git merge main などのコマンドをマッチさせます

​

Read と Edit

• Edit(/docs/**): <project>/docs/ での編集（/docs/ ではなく、<project>/.claude/docs/ でもありません）
• Read(~/.zshrc): ホームディレクトリの .zshrc を読み取ります
• Edit(//tmp/scratch.txt): 絶対パス /tmp/scratch.txt を編集します
• Read(src/**): <current-directory>/src/ から読み取ります

​

WebFetch

• WebFetch(domain:example.com) は example.com へのフェッチリクエストをマッチさせます

​

MCP

• mcp__puppeteer は puppeteer サーバーによって提供されるツール（Claude Code で設定された名前）をマッチさせます
• mcp__puppeteer__* ワイルドカード構文は、puppeteer サーバーからのすべてのツールもマッチさせます
• mcp__puppeteer__puppeteer_navigate は puppeteer サーバーによって提供される puppeteer_navigate ツールをマッチさせます

​

Agent（subagents）

• Agent(Explore) は Explore subagent をマッチさせます
• Agent(Plan) は Plan subagent をマッチさせます
• Agent(my-custom-agent) は my-custom-agent という名前のカスタム subagent をマッチさせます

{
  "permissions": {
    "deny": ["Agent(Explore)"]
  }
}

​

フックで権限を拡張する

​

作業ディレクトリ

• 起動時。--add-dir <path> CLI 引数を使用します
• セッション中。/add-dir コマンドを使用します
• 永続的な設定。設定ファイルの additionalDirectories に追加します

​

権限がサンドボックスとどのように相互作用するか

• 権限は、Claude Code が使用できるツール、およびアクセスできるファイルまたはドメインを制御します。すべてのツール（Bash、Read、Edit、WebFetch、MCP など）に適用されます。
• サンドボックスは、Bash ツールのファイルシステムとネットワークアクセスを制限する OS レベルの強制を提供します。Bash コマンドとその子プロセスにのみ適用されます。

• 権限 deny ルールは、Claude が制限されたリソースへのアクセスを試みることさえ防止します
• サンドボックス制限は、プロンプトインジェクションが Claude の意思決定をバイパスしても、Bash コマンドが定義された境界外のリソースに到達することを防止します
• サンドボックス内のファイルシステム制限は、Read と Edit deny ルールを使用し、別のサンドボックス設定は使用しません
• ネットワーク制限は、WebFetch 権限ルールとサンドボックスの allowedDomains リストを組み合わせます

​

管理設定

​

管理のみの設定

​

auto モード分類器を設定する

​

信頼できるインフラストラクチャを定義する

{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it",
      "Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
      "Trusted internal domains: *.corp.example.com, api.internal.example.com",
      "Key internal services: Jenkins at ci.example.com, Artifactory at artifacts.example.com"
    ]
  }
}

• 組織。会社名と Claude Code が主に使用される用途（ソフトウェア開発、インフラストラクチャ自動化、データエンジニアリングなど）
• ソースコントロール。開発者がプッシュするすべての GitHub、GitLab、または Bitbucket org
• クラウドプロバイダーと信頼できるバケット。Claude が読み取りおよび書き込みできるバケット名またはプレフィックス
• 信頼できる内部ドメイン。*.internal.example.com のようなネットワーク内の API、ダッシュボード、サービスのホスト名
• 主要な内部サービス。CI、アーティファクトレジストリ、内部パッケージインデックス、インシデントツール
• 追加コンテキスト。規制業界の制約、マルチテナントインフラストラクチャ、または分類器がリスクとして扱うべき内容に影響するコンプライアンス要件

{
  "autoMode": {
    "environment": [
      "Organization: {COMPANY_NAME}. Primary use: {PRIMARY_USE_CASE, e.g. software development, infrastructure automation}",
      "Source control: {SOURCE_CONTROL, e.g. GitHub org github.example.com/acme-corp}",
      "Cloud provider(s): {CLOUD_PROVIDERS, e.g. AWS, GCP, Azure}",
      "Trusted cloud buckets: {TRUSTED_BUCKETS, e.g. s3://acme-builds, gs://acme-datasets}",
      "Trusted internal domains: {TRUSTED_DOMAINS, e.g. *.internal.example.com, api.example.com}",
      "Key internal services: {SERVICES, e.g. Jenkins at ci.example.com, Artifactory at artifacts.example.com}",
      "Additional context: {EXTRA, e.g. regulated industry, multi-tenant infrastructure, compliance requirements}"
    ]
  }
}

​

ブロックルールと allow ルールをオーバーライドする

{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it"
    ],
    "allow": [
      "Deploying to the staging namespace is allowed: staging is isolated from production and resets nightly",
      "Writing to s3://acme-scratch/ is allowed: ephemeral bucket with a 7-day lifecycle policy"
    ],
    "soft_deny": [
      "Never run database migrations outside the migrations CLI, even against dev databases",
      "Never modify files under infra/terraform/prod/: production infrastructure changes go through the review workflow",
      "...copy full default soft_deny list here first, then add your rules..."
    ]
  }
}

​

デフォルトと有効な設定を検査する

claude auto-mode defaults  # the built-in environment, allow, and soft_deny rules
claude auto-mode config    # what the classifier actually uses: your settings where set, defaults otherwise
claude auto-mode critique  # get AI feedback on your custom allow and soft_deny rules

​

設定の優先順位

1. 管理設定。コマンドライン引数を含む他のレベルでオーバーライドできません
2. コマンドライン引数。一時的なセッションオーバーライド
3. ローカルプロジェクト設定（.claude/settings.local.json）
4. 共有プロジェクト設定（.claude/settings.json）
5. ユーザー設定（~/.claude/settings.json）

​

設定例

​

関連項目

• 設定。権限設定テーブルを含む完全な設定リファレンス
• サンドボックス。Bash コマンドの OS レベルのファイルシステムとネットワーク分離
• 認証。Claude Code へのユーザーアクセスを設定します
• セキュリティ。セキュリティ保護とベストプラクティス
• フック。ワークフローを自動化し、権限評価を拡張します