設定權限

​

權限系統

​

管理權限

• Allow 規則讓 Claude Code 使用指定的工具，無需手動批准。
• Ask 規則在 Claude Code 嘗試使用指定工具時提示確認。
• Deny 規則防止 Claude Code 使用指定的工具。

​

權限模式

​

權限規則語法

​

符合工具的所有使用

​

使用指定符進行細粒度控制

​

按輸入參數進行符合

• 參數名稱必須是工具輸入的直接欄位，例如 Agent 工具上的 model。巢狀在物件或陣列內的欄位不可符合
• 每個規則命名一個參數。若要在 model 和 isolation 上設定閘道，請寫入兩個規則 Agent(model:opus) 和 Agent(isolation:worktree)，而不是在一個規則中組合它們
• 值支援 * 作為符合任何字元序列的萬用字元，因此 Agent(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

​

使用 hooks 擴展權限

​

工作目錄

• 在啟動期間：使用 --add-dir <path> CLI 引數
• 在工作階段期間：使用 /add-dir 命令
• 持久設定：新增到 settings files 中的 additionalDirectories

​

其他目錄授予檔案存取權，而非設定

• 使用者級別設定：將檔案放在 ~/.claude/agents/、~/.claude/output-styles/ 或 ~/.claude/settings.json 中，使其在每個專案中可用
• 外掛：將設定打包並分發為 plugin，供團隊安裝
• 從設定目錄啟動：從包含您想要的 .claude/ 設定的目錄執行 Claude Code

​

權限如何與沙箱互動

• 權限控制 Claude Code 可以使用哪些工具以及它可以存取哪些檔案或網域。它們適用於所有工具，包括 Bash、Read、Edit、WebFetch 和 MCP。
• 沙箱提供作業系統級別的強制執行，限制 Bash 工具的檔案系統和網路存取。它僅適用於 Bash 命令及其子程序。

• 權限 deny 規則阻止 Claude 甚至嘗試存取受限資源
• 沙箱限制防止 Bash 命令到達定義邊界外的資源，即使提示注入繞過 Claude 的決策制定
• 沙箱中的檔案系統限制結合 sandbox.filesystem 設定與 Read 和 Edit deny 規則；兩者都合併到最終沙箱邊界中
• 網路限制結合 WebFetch 權限規則與沙箱的 allowedDomains 和 deniedDomains 清單

• 內容範圍的 ask 規則（如 Bash(git push *)）仍然強制提示
• 明確的 deny 規則仍然適用
• 針對 /、您的主目錄或其他關鍵系統路徑的 rm 或 rmdir 命令仍然會觸發提示

​

受管理設定

​

僅受管理的設定

​

設定優先順序

1. 受管理設定：無法被任何其他級別覆蓋，包括命令列引數
2. 命令列引數：臨時工作階段覆蓋
3. 本機專案設定 (.claude/settings.local.json)
4. 共用專案設定 (.claude/settings.json)
5. 使用者設定 (~/.claude/settings.json)

​

專案允許規則和工作區信任

• 您啟動 Claude Code 的目錄不在 git 儲存庫內。
• 工作階段在您自己的設定主目錄中執行：您的主目錄或任何您已設定為 CLAUDE_CONFIG_DIR 的 .claude 子目錄。

• Yes, I trust this folder：儲存該工作區的信任並在同一工作階段中套用規則。
• No, continue without these permissions：繼續工作，忽略這些規則。對話框將在下一個工作階段中再次出現。

​

範例設定

​

另請參閱

• Settings：完整設定參考，包括權限設定表
• Configure auto mode：告訴 auto mode 分類器您的組織信任哪些基礎設施
• Sandboxing：Bash 命令的作業系統級別檔案系統和網路隔離
• Authentication：設定使用者對 Claude Code 的存取
• Security：安全防護措施和最佳實踐
• Hooks：自動化工作流程並擴展權限評估