選擇權限模式 - Claude Code Docs

當 Claude 想要編輯檔案、執行 shell 命令或進行網路請求時，它會暫停並要求您批准該操作。權限模式控制該暫停發生的頻率。您選擇的模式塑造了會話的流程：預設模式讓您在操作進行時審查每個操作，而較寬鬆的模式讓 Claude 在較長的不間斷時間內工作並在完成時報告。對敏感工作選擇更多監督，或在您信任方向時選擇較少中斷。

可用模式

每種模式在便利性和監督之間進行不同的權衡。下表顯示在每種模式中 Claude 無需權限提示即可執行的操作。

模式	無需詢問即可執行的操作	最適合
`default`	僅讀取	入門、敏感工作
`acceptEdits`	讀取、檔案編輯和常見檔案系統命令（`mkdir`、`touch`、`mv`、`cp` 等）	迭代您正在審查的程式碼
`plan`	僅讀取	在變更前探索程式碼庫
`auto`	所有操作，具有背景安全檢查	長時間執行的任務、減少提示疲勞
`dontAsk`	僅預先批准的工具	鎖定的 CI 和指令碼
`bypassPermissions`	所有操作	隔離容器和 VM 僅

在除 bypassPermissions 外的每種模式中，寫入受保護路徑永遠不會自動批准，保護倉庫狀態和 Claude 自己的配置免受意外損壞。模式設定基線。在頂部分層權限規則以預先批准或阻止特定工具。拒絕規則和明確詢問規則適用於每種模式，包括 bypassPermissions。允許規則在該模式中無效，因為其他所有操作都已經被批准。

切換權限模式

您可以在會話期間、啟動時或作為持久預設值切換模式。模式通過這些控制設定，而不是通過在聊天中詢問 Claude。選擇下面的您的介面以查看如何變更它。

CLI
VS Code
JetBrains
Desktop
Web and mobile

在會話期間：按 Shift+Tab 循環 default → acceptEdits → plan。目前模式出現在狀態欄中。並非每種模式都在預設循環中：

auto：當您的帳戶符合 auto 模式要求時出現；循環到它會在不確認提示的情況下切換模式
bypassPermissions：在您使用 --permission-mode bypassPermissions、--dangerously-skip-permissions 或 --allow-dangerously-skip-permissions 啟動後出現；--allow- 變體將模式添加到循環中而不啟動它
dontAsk：永遠不在循環中出現；使用 --permission-mode dontAsk 設定它

啟用的可選模式在 plan 後插入，bypassPermissions 優先，auto 最後。如果您同時啟用了兩者，您將在前往 auto 的途中循環通過 bypassPermissions。啟動時：將模式作為標誌傳遞。

claude --permission-mode plan

作為預設值：在設定中設定 defaultMode。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

相同的 --permission-mode 標誌適用於 -p 用於非互動式執行。

在會話期間：點擊提示框底部的模式指示器。作為預設值：在 VS Code 設定中設定 claudeCode.initialPermissionMode，或使用 Claude Code 擴充設定面板。模式指示器顯示這些標籤，對應於每個標籤適用的模式：

UI 標籤	模式
編輯前詢問	`default`
自動編輯	`acceptEdits`
Plan mode	`plan`
Auto mode	`auto`
繞過權限	`bypassPermissions`

Auto mode 在您的帳戶符合 auto 模式部分中列出的每項要求時出現在模式指示器中。claudeCode.initialPermissionMode 設定不接受 auto。要預設啟動 auto mode，請改為在您的使用者設定中設定 defaultMode。Claude Code 忽略專案和本機設定中的 defaultMode: "auto"。繞過權限需要擴充設定中的允許危險跳過權限切換，然後才會在模式指示器中出現。有關擴充特定詳細資訊，請參閱 VS Code 指南。

JetBrains 外掛在 IDE 終端中執行 Claude Code，因此切換模式的工作方式與 CLI 中相同：按 Shift+Tab 循環，或在啟動時傳遞 --permission-mode。

在 claude.ai/code 或行動應用中使用提示框旁邊的模式下拉菜單。權限提示出現在 claude.ai 中以供批准。哪些模式出現取決於會話執行的位置：

雲端會話在 Claude Code on the web：Accept edits、Plan mode 和 Auto mode。Accept edits 對應於 default 模式：雲端環境預先批准檔案編輯，無論模式如何，因此下拉菜單顯示 Accept edits 而不是 Ask permissions。來自設定的 defaultMode: "acceptEdits" 仍然被遵守。Auto mode 僅在您的組織允許且選定的模型支援時出現。Bypass permissions 不可用。
Remote Control 會話在您的本機上：Ask permissions、Auto accept edits 和 Plan mode。Auto 和 Bypass permissions 不可用。

對於 Remote Control，您也可以在啟動主機時設定啟動模式：

claude remote-control --permission-mode acceptEdits

使用 acceptEdits 模式自動批准檔案編輯

acceptEdits 模式讓 Claude 在您的工作目錄中建立和編輯檔案而不提示。狀態欄顯示 ⏵⏵ accept edits on 當此模式處於活動狀態時。除了檔案編輯外，acceptEdits 模式自動批准常見的檔案系統 Bash 命令：mkdir、touch、rm、rmdir、mv、cp 和 sed。這些命令在以安全環境變數（如 LANG=C 或 NO_COLOR=1）或流程包裝器（如 timeout、nice 或 nohup）為前綴時也會自動批准。與檔案編輯一樣，自動批准僅適用於您的工作目錄或 additionalDirectories 內的路徑。該範圍外的路徑、寫入受保護路徑和所有其他 Bash 命令仍然提示。當啟用 PowerShell tool 時，acceptEdits 模式也會自動批准 Set-Content、Add-Content、Clear-Content 和 Remove-Item 在範圍內的路徑上，以及它們的常見別名。相同的範圍和受保護路徑規則適用。當您想在編輯器中或通過 git diff 之後審查變更而不是在線批准每個編輯時，使用 acceptEdits。從預設模式按 Shift+Tab 一次進入它，或直接啟動它：

claude --permission-mode acceptEdits

使用 plan mode 在編輯前分析

Plan mode 告訴 Claude 研究和提議變更而不進行變更。Claude 讀取檔案、執行 shell 命令進行探索，並寫入計劃，但不編輯您的原始程式碼。權限提示的應用方式與預設模式相同。通過按 Shift+Tab 或在單個提示前加上 /plan 進入 plan mode。您也可以從 CLI 啟動 plan mode：

claude --permission-mode plan

再次按 Shift+Tab 離開 plan mode 而不批准計劃。

審查並批准計劃

當計劃準備好時，Claude 呈現它並詢問如何進行。從該提示您可以：

批准並在 auto mode 中啟動
批准並接受編輯
批准並手動審查每個編輯
繼續規劃並提供反饋
使用 Ultraplan 進行基於瀏覽器的審查進行細化

批准計劃會退出 plan mode 並將工作階段切換到每個批准選項描述的權限模式，因此 Claude 開始編輯。若要再次規劃，使用 Shift+Tab 循環回到 plan mode，或在您的下一個提示前加上 /plan。按 Ctrl+G 在您的預設文字編輯器中開啟提議的計劃並在 Claude 繼續之前直接編輯它。當啟用 showClearContextOnPlanAccept 時，每個批准選項也提供首先清除規劃上下文的選項。接受計劃也會根據計劃內容自動命名工作階段，除非您已經使用 --name 或 /rename 設定了名稱。

將 plan mode 設定為預設值

若要將 plan mode 設定為專案的預設值，請在 .claude/settings.json 中設定 defaultMode：

{
  "permissions": {
    "defaultMode": "plan"
  }
}

使用 auto mode 消除提示

Auto mode 需要 Claude Code v2.1.83 或更新版本。

Auto mode 讓 Claude 執行而不顯示例行權限提示。單獨的分類器模型在執行前審查操作，阻止任何超出您要求的操作、針對無法識別的基礎設施的操作，或似乎由 Claude 讀到的敵對內容驅動的操作。明確的詢問規則仍然會強制提示。 Auto mode 也指示 Claude 繼續工作而不停止以提出澄清問題，儘管當您的提示或技能明確依賴它時，Claude 仍然會提問。若要在保持權限提示的情況下獲得更強的自主行為，請改為設定主動輸出風格。

Auto mode 是研究預覽。它減少提示但不保證安全。將其用於您信任一般方向的任務，而不是作為敏感操作審查的替代品。

Auto mode 僅在您的帳戶符合所有這些要求時可用：

計劃：所有計劃。
擁有者：在 Team 和 Enterprise 上，擁有者必須在 Claude Code 管理設定中啟用它，使用者才能打開它。管理員也可以通過在受管設定中將 permissions.disableAutoMode 設定為 "disable" 來鎖定它。
模型：在 Anthropic API 上，Claude Opus 4.6 或更新版本，或 Sonnet 4.6 或更新版本。在 Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry 和已登入的 Claude apps gateway 會話上，僅支援 Claude Sonnet 5、Opus 4.7 和 Opus 4.8。不支援較舊的模型，包括 Sonnet 4.5、Opus 4.5、Haiku 和 claude-3 模型，在任何提供商上都不支援。
提供商：在 Anthropic API 上預設可用。在 Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry 和已登入的 Claude apps gateway 會話上，auto mode 關閉，直到您設定 CLAUDE_CODE_ENABLE_AUTO_MODE。

如果 Claude Code 報告 auto mode 不可用，其中一項要求未滿足；這不是暫時性中斷。單獨的訊息命名模型並說 auto mode「無法確定」操作的安全性是暫時性分類器中斷；請參閱錯誤參考。如果您在設定中設定 defaultMode: "auto" 並且會話以 default 模式啟動且沒有錯誤，該設定可能在 .claude/settings.json 或 .claude/settings.local.json 中。Claude Code v2.1.142 及更新版本忽略來自這些檔案的 auto，因此倉庫無法授予自己 auto mode。將其移至 ~/.claude/settings.json。

在 Bedrock、Vertex AI 或 Foundry 上啟用 auto mode

在 Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry 和已登入的 Claude apps gateway 會話上，auto mode 不會出現在 Shift+Tab 循環中，直到 CLAUDE_CODE_ENABLE_AUTO_MODE 設定為 1。該變數在 Claude Code v2.1.158 及更新版本中有效。這些提供商上僅支援 Claude Sonnet 5、Opus 4.7 和 Opus 4.8。若要為一個開發人員啟用它，請將變數添加到 ~/.claude/settings.json 中的 env 區塊：

{
  "env": {
    "CLAUDE_CODE_ENABLE_AUTO_MODE": "1"
  }
}

若要為您的組織啟用它，請將相同的 env 區塊添加到受管設定。設定變數後，auto mode 會出現在每個會話的 Shift+Tab 循環中。若要使其成為預設啟動模式，也請在使用者或受管設定中設定 "permissions": {"defaultMode": "auto"}。在這些提供商上，Claude Code 忽略 defaultMode: "auto"，除非也設定了 CLAUDE_CODE_ENABLE_AUTO_MODE。若要防止開發人員啟用 auto mode，請在受管設定中將 disableAutoMode 設定為 "disable"。這會覆蓋啟用變數。如果您通過配置了 ANTHROPIC_BASE_URL 的 LLM gateway 連接，auto mode 可能已經可以在沒有啟用變數的情況下到達，因為網關通過 Anthropic API 路由請求。這不適用於已登入的 Claude apps gateway 會話，它是自己的提供商類別，需要啟用變數。disableAutoMode 設定在任一配置中以相同方式應用。

分類器預設阻止的內容

分類器信任您的工作目錄和您的倉庫配置的遠端。其他所有內容都被視為外部，直到您配置受信任的基礎設施。 預設阻止：

下載和執行程式碼，如 curl | bash
將敏感資料發送到外部端點
生產部署和遷移
雲端儲存上的大量刪除
授予 IAM 或倉庫權限
修改共享基礎設施
不可逆轉地銷毀會話開始前存在的檔案
強制推送或直接推送到 main
git reset --hard、git checkout -- .、git restore .、git clean -fd、git stash drop 或 git stash clear，分類器推測這些會捨棄未提交的變更
git commit --amend，當 HEAD 的提交不是在此會話中建立的
terraform destroy、pulumi destroy、cdk destroy 或 terragrunt destroy，以及應用會銷毀資源的計劃

Claude Code v2.1.195 及更新版本預設阻止更多類別。有些取決於環境項目，例如敏感遠端目標和受保護的 IaC 範圍，您可以將其縮小到具體名稱。

寫入密鑰管理器，或變更 DNS 記錄或 TLS 憑證
合併人類未批准的拉取請求、批准 Claude 自己的拉取請求，或禁用 CI 檢查
發佈本身是自動化命令的評論，例如 atlantis apply 或機器人的 /deploy 或 /merge
切換、調整或刪除生產功能旗標
將基礎設施變更應用到受保護的 IaC 範圍，或排空和移除叢集節點
寫入超出您命名的資源的共享計算叢集，例如標籤選擇器或 --all 捕捉其他使用者的工作
建立在每個節點上執行或攔截叢集流量的 Kubernetes 資源，例如 DaemonSets 和准入 webhooks
互動式 shell 或連接埠轉發到敏感遠端目標
開啟隧道或反向 shell，使本地服務可從公開網際網路到達
將即時認證或令牌列印到記錄或檔案
存取 PII 或受管制資料位置，或從其中複製資料
繞過您的內部套件登錄將套件安裝路由到公開登錄
執行帶有標誌的命令，該標誌會解除安全防護，如 --insecure
Chrome 中的 Claude 瀏覽器操作，可能會將頁面內容、Cookie 或認證發送到跨來源

預設允許：

工作目錄中的本地檔案操作
安裝在您的鎖定檔案或清單中聲明的依賴項
讀取 .env 並將認證發送到其匹配的 API
唯讀 HTTP 請求
推送到您啟動的分支或 Claude 建立的分支

Claude Code v2.1.195 及更新版本也預設允許這些：

刪除 Claude 在同一會話中稍早建立的確切工作
作為您的任務的一部分，讀取、審查或編寫安全相關的程式碼、配置和威脅模型
在同一多代理會話中協同工作的代理之間的訊息
將資料發送到您在 environment 中列出的受信任網域、儲存桶和服務。這僅涵蓋資料流，不涵蓋相同基礎設施上的破壞性或認證操作
Chrome 中的 Claude 導航到受信任的內部網域、localhost 或您命名的 URL

沙箱網路存取請求通過分類器路由，而不是預設允許。執行 claude auto-mode defaults 以查看完整規則列表。如果例行操作被阻止，管理員可以通過 autoMode.environment 設定添加受信任的倉庫、儲存桶和服務：請參閱配置 auto mode。

您在對話中陳述的邊界

分類器將您在對話中陳述的邊界視為阻止信號。如果您告訴 Claude「不要推送」或「在我審查前等待再部署」，分類器阻止匹配的操作，即使預設規則會允許它們。邊界保持有效，直到您在稍後的訊息中解除它。Claude 自己的判斷條件已滿足不會解除它。邊界不作為規則儲存。分類器在每次檢查時從記錄中重新讀取它們，因此如果上下文壓縮移除陳述邊界的訊息，邊界可能會丟失。為了硬保證，請改為添加拒絕規則。

當 auto mode 回退時

每個被拒絕的操作顯示通知並出現在 /permissions 下的「最近拒絕」標籤中，您可以按 r 使用手動批准重試它。如果分類器連續 3 次或總共 20 次阻止操作，auto mode 暫停，Claude Code 恢復提示。批准提示的操作恢復 auto mode。這些閾值不可配置。任何允許的操作重置連續計數器，而總計數器在會話期間持續，僅在其自己的限制觸發回退時重置。在非互動式模式中使用 -p 標誌，重複阻止中止會話，因為沒有使用者可以提示。重複阻止通常意味著分類器缺少有關您的基礎設施的上下文。使用 /feedback 報告誤報，或讓管理員配置受信任的基礎設施。

分類器如何評估操作

每個操作都經過固定的決策順序。第一個匹配的步驟獲勝：

與您的允許或拒絕規則相符的操作立即解決，除了寫入受保護路徑，即使允許規則相符也會路由到分類器
唯讀操作和工作目錄中的檔案編輯自動批准，除了寫入受保護路徑
其他所有內容都發送到分類器
如果分類器阻止，Claude 接收原因並嘗試替代方法

進入 auto mode 時，授予任意程式碼執行的廣泛允許規則被刪除：

全面 Bash(*) 或 PowerShell(*)
通配符解釋器，如 Bash(python*)
套件管理器執行命令
Agent 允許規則

像 Bash(npm test) 這樣的狹義規則保留。刪除的規則在您離開 auto mode 時恢復。分類器看到使用者訊息、工具呼叫和您的 CLAUDE.md 內容。工具結果被剝離，因此檔案或網頁中的敵對內容無法直接操縱它。單獨的伺服器端探針掃描傳入的工具結果並在 Claude 讀取前標記可疑內容。有關這些層如何協同工作的更多資訊，請參閱 auto mode 公告和工程深度探討。

Auto mode 如何處理子代理

分類器在三個點檢查子代理工作：

在子代理啟動前，委派的任務描述被評估，因此看起來危險的任務在生成時被阻止。
當子代理執行時，它的每個操作都通過分類器，使用與父會話相同的規則，子代理前置事項中的任何 permissionMode 都被忽略。
當子代理完成時，分類器審查其完整操作歷史；如果該返回檢查標記了一個問題，安全警告被添加到子代理結果前面。

步驟 1 需要 Claude Code v2.1.178 或更新版本。較早的版本在步驟 2 和 3 應用分類器，但在子代理啟動前沒有評估任務描述。

成本和延遲

分類器在伺服器配置的模型上執行，獨立於您的 /model 選擇，因此切換模型不會改變分類器可用性。分類器呼叫計入您的令牌使用量。每次檢查發送記錄的一部分加上待處理操作，在執行前添加往返。工作目錄外受保護路徑的讀取和編輯跳過分類器，因此開銷主要來自 shell 命令和網路操作。

使用 dontAsk 模式僅允許預先批准的工具

dontAsk 模式自動拒絕每個否則會提示的工具呼叫。僅與您的 permissions.allow 規則和唯讀 Bash 命令相符的操作可以執行；明確的 ask 規則被拒絕而不是提示。這使模式完全非互動式，適合 CI 管道或受限環境，您可以在其中預先定義 Claude 可能執行的操作。Cloud 工作階段在 Claude Code on the web 上忽略 defaultMode: "dontAsk"；詳見 bypassPermissions 以了解詳情。在啟動時使用標誌設定它：

claude --permission-mode dontAsk

使用 bypassPermissions 模式跳過所有檢查

bypassPermissions 模式禁用權限提示和安全檢查，因此工具呼叫立即執行。自 v2.1.126 起，這包括寫入受保護路徑，較早版本仍會提示。明確的詢問規則仍會在此模式中強制提示，針對檔案系統根目錄或主目錄的移除操作，例如 rm -rf / 和 rm -rf ~，仍會作為針對模型錯誤的斷路器而提示。僅在隔離環境（如容器、VM 或 dev container）中使用此模式，沒有網際網路存取，其中 Claude Code 無法損害您的主機系統。您無法從未使用啟用標誌啟動的會話進入 bypassPermissions；使用其中一個重新啟動以啟用它：

claude --permission-mode bypassPermissions

--dangerously-skip-permissions 標誌等同於此。在 Linux 和 macOS 上，當以 root 身份或在 sudo 下執行時，Claude Code 拒絕以此模式啟動：

--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

檢查在識別的沙箱內自動跳過。若要在容器中自主執行，請使用 dev container 配置，該配置以非 root 使用者身份執行 Claude Code。 Claude Code on the web 不遵守您設定檔案中的 defaultMode: "bypassPermissions" 或 "dontAsk"，因此儲存庫的簽入設定無法在略過權限模式下啟動雲端會話。該設定會被無聲地忽略，會話會改為以模式下拉式選單中顯示的模式啟動。請參閱切換權限模式以了解雲端會話提供哪些模式。

bypassPermissions 不提供針對提示注入或意外操作的保護。對於沒有許多提示的背景安全檢查，請改為使用 auto mode。管理員可以通過在受管設定中將 permissions.disableBypassPermissionsMode 設定為 "disable" 來阻止此模式。

受保護的路徑

寫入一小組路徑永遠不會自動批准，在除了 bypassPermissions 之外的每種模式中。這防止了倉庫狀態和 Claude 自己的配置的意外損壞。

模式	受保護路徑寫入
`default`、`acceptEdits`、`plan`	提示
`auto`	路由到分類器
`dontAsk`	拒絕
`bypassPermissions`	允許

permissions.allow 設定檔中的規則不會預先批准受保護路徑的寫入。安全檢查在 Claude Code 評估設定中的允許規則之前執行，因此在 ~/.claude/settings.json 或 .claude/settings.json 中的 Edit(.claude/**) 之類的項目不會改變上表中的每種模式結果。在提示的模式中，.claude/ 寫入的提示會提供是的，並允許 Claude 在此工作階段編輯其自己的設定，這會在該工作階段中批准後續的 .claude/ 寫入而不再提示。受保護的目錄：

.git
.config/git
.vscode
.idea
.husky
.cargo
.devcontainer
.yarn
.mvn
.claude，除了 .claude/worktrees，其中 Claude 儲存其自己的 git worktrees

受保護的檔案：

.gitconfig、.gitmodules
.bashrc、.bash_profile、.bash_login、.bash_aliases、.bash_logout、.zshrc、.zprofile、.zshenv、.zlogin、.zlogout、.profile、.envrc
.npmrc、.yarnrc、.yarnrc.yml、.pnp.cjs、.pnp.loader.mjs、.pnpmfile.cjs、bunfig.toml、.bunfig.toml
.bazelrc、.bazelversion、.bazeliskrc
.pre-commit-config.yaml、lefthook.yml、lefthook.yaml、.lefthook.yml、.lefthook.yaml
gradle-wrapper.properties、maven-wrapper.properties
.devcontainer.json
.ripgreprc、pyrightconfig.json
.mcp.json、.claude.json

另請參閱

Permissions：允許、詢問和拒絕規則；受管策略
Configure auto mode：告訴分類器您的組織信任哪些基礎設施
Hooks：通過 PreToolUse 和 PermissionRequest hooks 的自訂權限邏輯
Ultraplan：在 Claude Code on the web 會話中執行 plan mode，具有基於瀏覽器的審查
Security：安全保障和最佳實踐
Sandboxing：Bash 命令的檔案系統和網路隔離
Non-interactive mode：使用 -p 標誌執行 Claude Code

​可用模式

​切換權限模式

​使用 acceptEdits 模式自動批准檔案編輯

​使用 plan mode 在編輯前分析

​審查並批准計劃

​將 plan mode 設定為預設值

​使用 auto mode 消除提示

​在 Bedrock、Vertex AI 或 Foundry 上啟用 auto mode

​分類器預設阻止的內容

​您在對話中陳述的邊界

​當 auto mode 回退時

​使用 dontAsk 模式僅允許預先批准的工具

​使用 bypassPermissions 模式跳過所有檢查

​受保護的路徑

​另請參閱

可用模式

切換權限模式

使用 acceptEdits 模式自動批准檔案編輯

使用 plan mode 在編輯前分析

審查並批准計劃

將 plan mode 設定為預設值

使用 auto mode 消除提示

在 Bedrock、Vertex AI 或 Foundry 上啟用 auto mode

分類器預設阻止的內容

您在對話中陳述的邊界

當 auto mode 回退時

使用 dontAsk 模式僅允許預先批准的工具

使用 bypassPermissions 模式跳過所有檢查

受保護的路徑

另請參閱