権限を設定する

​

権限システム

​

権限を管理する

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

​

権限モード

​

権限ルール構文

​

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

​

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

​

入力パラメータでマッチさせる

• パラメータ名は Agent ツール上の model など、ツールの入力の直接フィールドである必要があります。オブジェクトまたは配列内にネストされたフィールドはマッチ可能ではありません
• 各ルールは 1 つのパラメータに名前を付けます。model と isolation の両方でゲートするには、1 つのルールで組み合わせるのではなく、Agent(model:opus) と Agent(isolation:worktree) の 2 つのルールを記述します
• 値は * をワイルドカードとしてサポートし、任意の文字シーケンスにマッチするため、Agent(isolation:*) は任意の明示的な isolation 値にマッチします。* がない場合、マッチは正確です
• モデルが省略するパラメータは決してマッチしないため、Agent(model:*) は model が設定されていない呼び出しにはマッチしません
• 値は Claude が送信するリテラル入力と比較され、正規化の前です。Agent(model:opus) は別名 opus にマッチしますが、完全なモデル ID にはマッチしません。--verbose で実行して、各ツール呼び出しの正確なパラメータ名と値を確認してください
• コロンの周りのホワイトスペースは無視されます

​

ワイルドカードパターン

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

​

ツール名ワイルドカード

{
  "permissions": {
    "deny": [
      "mcp__*"
    ]
  }
}

​

ツール固有の権限ルール

​

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 log --oneline main などのコマンドをマッチさせます

​

複合コマンド

​

プロセスラッパー

​

読み取り専用コマンド

​

PowerShell

{
  "permissions": {
    "allow": [
      "PowerShell(Get-ChildItem *)",
      "PowerShell(git commit *)"
    ],
    "deny": [
      "PowerShell(Remove-Item *)"
    ]
  }
}

​

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/ から読み取ります

• Allow ルール：シンボリックリンクパスとそのターゲットの両方がマッチする場合にのみ適用されます。許可されたディレクトリ内のシンボリックリンクがそれの外を指している場合でも、プロンプトが表示されます。
• Deny ルール：シンボリックリンクパスまたはそのターゲットのいずれかがマッチする場合に適用されます。拒否されたファイルを指すシンボリックリンク自体が拒否されます。

​

WebFetch

• WebFetch(domain:example.com) は example.com へのリクエストをマッチさせます
• WebFetch(domain:*.example.com) は api.example.com や a.b.example.com などの任意の深さのサブドメインをマッチさせますが、example.com 自体はマッチさせません
• WebFetch(domain:*) はすべてのドメインをマッチさせ、ベア WebFetch ルールと同等です

​

MCP

• mcp__puppeteer は puppeteer サーバーによって提供されるツールをマッチさせます
• 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)"]
  }
}

​

Cd

​

フックで権限を拡張する

​

作業ディレクトリ

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

​

追加ディレクトリはファイルアクセスを許可し、設定ではありません

• ユーザーレベルの設定：~/.claude/agents/、~/.claude/output-styles/、または ~/.claude/settings.json にファイルを配置して、すべてのプロジェクトで利用可能にします
• プラグイン：設定を プラグインとしてパッケージ化および配布し、チームがインストールできるようにします
• 設定ディレクトリから起動する：使用する .claude/ 設定を含むディレクトリから Claude Code を実行します

​

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

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

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

• Bash(git push *) のようなコンテンツスコープ ask ルールは、引き続きプロンプトを強制します
• 明示的な deny ルールは引き続き適用されます
• /、ホームディレクトリ、またはその他の重要なシステムパスをターゲットとする rm または rmdir コマンドは、引き続きプロンプトをトリガーします

​

管理設定

​

管理のみの設定

​

設定の優先順位

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

​

プロジェクトの許可ルールとワークスペーストラスト

• Claude Code を起動したディレクトリが git リポジトリ内にない。
• セッションがあなた自身の設定ホームで実行される。つまり、ホームディレクトリ、または .claude サブディレクトリを CLAUDE_CONFIG_DIR として設定したディレクトリ。

• Yes, I trust this folder: そのワークスペースのトラストを保存し、同じセッション内でルールを適用します。
• No, continue without these permissions: これらのルールを無視して作業を続けます。ダイアログは次のセッションで再度表示されます。

​

設定例

​

関連項目

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