SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Claude Code 自動模式成為預設:權限模式與 VPS 注意事項

Claude Code v2.1.283 起,終端機與 VS Code 預設使用 auto;但 v2.1.302 的非互動式 claude -p 仍是 default,VPS 請先確認版本與權限模式。

2026 年 8 月 14 日自動模式的變更

Claude Code 自動模式會在沒有例行權限提示的情況下執行工具呼叫,並使用獨立的分類器模型檢查操作。對受保護路徑以外的讀取與工作目錄編輯會略過分類器。自 2026 年 8 月 14 日起,Pro、Max 和 Team 方案的新工作階段會以此模式啟動。截至 2026 年 10 月 27 日,文件進一步說明:使用 Claude Code v2.1.283 或更新版本時,自動模式是所有方案與提供者的互動式終端機和 VS Code 工作階段內建的啟動模式。你可以隨時切換模式,已為自己設定的預設值不會被覆寫。

文件目前如此說明這項變更:

使用 Claude Code v2.1.283 或更新版本時,自動模式是互動式終端機和 VS Code 工作階段內建的啟動權限模式。在較早版本中,只有 Pro、Max、Ultra 和 Team 方案將其設為內建的啟動權限模式。

同一頁面的兩項規則比版本號更重要。你在自己的 ~/.claude/settings.json 中設定的 defaultMode 會保留:Claude Code 可能會詢問你是否要切換至自動模式;如果你拒絕,則會保留原本的設定。組織透過受管理設定部署的預設值也會保留。公告文章表示,自動模式起初會在 Enterprise 方案和 Claude API 中維持選擇加入;該文章於 2026 年 10 月 22 日更新後說明,Enterprise 管理員會在自動模式成為組織預設值前收到電子郵件。自 v2.1.283 起,文件不再對終端機和 VS Code 工作階段保留這項例外;但使用 v2.1.285 或更新版本時,套用 HIPAA 設定的組織仍會以 Manual 模式啟動。

如果你在 VPS(virtual private server)上執行 Claude Code,這項變更的影響會比在筆記型電腦上更大。權限提示是需要有人在鍵盤前確認的檢查點。在遠端主機上,你通常不在現場,因此工作階段啟動時使用的模式,可能會連續維持數小時。非互動式 claude -p 執行遵循不同規則:使用 v2.1.302 或更新版本時,如果未設定模式,這類執行會以 default 啟動,包括使用第三方提供者或關閉遙測的情況。截至 2026 年 10 月 31 日,目前版本為 v2.1.316,權限模式頁面已記載此行為。在 v2.1.302 之前,這兩種情況可能會以 auto 啟動;如果主機可能仍使用舊版本,請在主機上執行 claude --version。

Claude Code 的權限模式:從監督最多到最少

共有 6 種模式。每行開頭的名稱,是您在設定中寫入或傳給 --permission-mode 的值。這 6 種模式都由 Claude Code 本身強制執行,而不是由模型執行,因為判斷工具呼叫可執行哪些操作,是模型周圍的 harness 所負責的工作。

  • default:Claude 在執行大多數會編輯檔案、執行 shell 命令或存取網路的操作前,都會先詢問。工作目錄內的讀取操作仍會直接執行,不會提示。CLI(command line interface)將此模式標示為 Manual,並接受 manual 作為別名。
  • plan:Claude 會讀取檔案並執行命令來探索環境,但不會編輯您的原始碼。在您核准計畫前,編輯操作都會被封鎖;但在可用 bypass permissions 的互動式終端機工作階段中,規劃命令不適用 classifier,也不會顯示提示。
  • acceptEdits:檔案編輯會直接執行,不會顯示提示;檔案系統命令 mkdir、touch、rm、rmdir、mv、cp 和 sed 也相同。這只適用於工作目錄或 additionalDirectories 內的路徑。寫入受保護路徑,以及移除辨識出的重要路徑時,仍會顯示提示;只有使用一般檔案路徑時,touch 才會自動核准。其他所有 shell 命令都遵循一般權限規則。
  • auto:一般權限提示會由 classifier 檢查取代。明確的 ask 規則仍會強制顯示提示。
  • dontAsk:Claude Code 會自動拒絕原本需要提示的所有操作。除了已安裝的 mod 可核准的呼叫、工作目錄內的檔案讀取、您的 allow 規則、內建的唯讀 Bash 命令、預先核准的文件擷取,以及由 PreToolUse hook 核准的呼叫之外,其他操作都會被拒絕。工作階段不會等待輸入。
  • bypassPermissions:會略過提示與安全性檢查,包括寫入 .git 和 .claude 等受保護路徑。

工作階段期間按下 Shift+Tab,即可依序在 default、acceptEdits 和 plan 之間切換。從 auto 開始時,第一次按下會降至 default。狀態列會顯示目前所在的模式,例如 ⏵⏵ auto mode on 或灰色的 ⏸ manual mode on。其他模式預設不在此循環中。帳戶符合要求後,auto 才會加入循環。只有在工作階段以 --permission-mode bypassPermissions、--dangerously-skip-permissions 或 --allow-dangerously-skip-permissions 啟動,或在 user、--settings 或 managed settings 中設定 defaultMode: "bypassPermissions" 時,bypassPermissions 才會加入循環。dontAsk 永遠不會出現在循環中,因此請使用 claude --permission-mode dontAsk 設定它。

Auto 模式也需要較新的模型;它完全不出現時,通常就是這項要求未符合。截至 27 October 2026,文件列出的支援項目包括 Anthropic API 上的 Claude Opus 4.6 或更新版本、Sonnet 4.6 或更新版本、Haiku 5.5,或 Fable model;Amazon Bedrock、Google Cloud 和 Microsoft Foundry 支援的清單較短,且文件表示 Sonnet 4.5 等較舊模型不受任何 provider 支援。如果 Claude Code 回報 Auto 模式不可用,請先檢查這些要求及任何 disableAutoMode 設定。Anthropic 也可以在伺服器端關閉 Auto 模式;收到該回應的工作階段會持續停用 Auto 模式,直到工作階段結束。因此,請稍後啟動新的工作階段,不要在舊工作階段中等待。

兩項控制在所有模式中都有效,包括 bypassPermissions:deny 規則和明確的 ask 規則。當仍有其他工具可用時,兩者都不適用於 EndConversation。無論工作階段以哪種模式啟動,這些都是您持續保有的控制手段。

自動模式分類器會阻擋的內容

分類器是另一個模型。它會讀取待執行的動作,並判斷該動作是否符合你的要求。文件用一句話說明其職責:

個別的分類器模型會在動作執行前進行檢查,阻擋超出要求範圍的升權操作、針對未識別基礎架構的操作,以及可能由 Claude 讀取的惡意內容驅動的操作。

以下是預設會阻擋的項目,也是伺服器管理員最常遇到的類別:

  • 下載並執行程式碼,例如 curl | bash
  • Production deploy 與 migration
  • Force push
  • 修改共用基礎架構
  • 開啟 tunnel 或 reverse shell,讓本機服務可從公開網際網路存取
  • 將有效的 credential 或 token 列印到 transcript 或檔案

以下是預設允許的項目:

  • 在工作目錄中操作本機檔案
  • 安裝 lock file 或 manifest 宣告的相依套件
  • 唯讀 HTTP 請求
  • Push 到目前工作所在 repository 的分支,包括 default branch;但名稱表示 deploy 或 publication target 的非 default branch 除外。Push 的內容仍會依分類器的其他規則處理。

不要只根據上述摘要進行操作。執行 claude auto-mode defaults,以 JSON 列印完整規則清單,並閱讀目前已安裝版本所附的規則。/auto-mode-setup 是另一個獨立指令:它會從專案與你最近在其中進行的 session 草擬 autoMode.environment 項目;如果你接受草稿,便會將其寫入 ~/.claude/settings.json。具備版本要求的是該指令,而不是 claude auto-mode defaults。在 Pro、Max、Ultra 與 Team 方案中,/auto-mode-setup 需要 v2.1.228 或更新版本;在原生 Windows 上則需要 v2.1.233 或更新版本。在 Enterprise 方案或使用 Claude Console API key 時,需要 v2.1.283 或更新版本。在 v2.1.304 之前,對於不會取得 feature flags 的 session,/auto-mode-setup 不會出現,例如關閉 telemetry 的主機,或使用第三方 provider 的主機。因此,如果你的伺服器符合上述情況,請先更新。

在依賴這項功能前,必須注意兩項已記錄的限制。第一,在 Claude Code 自行送出的 classifier request 中,分類器會看到你的訊息、除檔案讀取與搜尋等唯讀查詢以外的 tool call,以及你的 CLAUDE.md 內容;tool result 會被移除。因此,Claude 讀取的檔案或網頁中的文字,無法直接對分類器發揮作用。第二,當分類器連續 3 次阻擋動作,或在單一 session 中阻擋 20 次時,自動模式會暫停,Claude Code 會恢復向你發出提示。核准該提示中的動作後,自動模式便會恢復。這些門檻無法設定。使用 -p flag 執行非互動工作,且未提供 --permission-prompt-tool 時,沒有任何人可供提示;文件明確指出 Claude Code 不會停止工作:遭阻擋的動作不會執行,而 Claude 會繼續工作。

第二種行為在遠端主機上尤其容易造成問題,且有兩種情況。互動式 session 如果持續執行並觸發限制,會停在提示畫面,等待未在查看 terminal 的人員回應。-p 執行則永遠不會等待,因此工作可能在部分步驟遭阻擋且未完成的狀態下結束。同一台主機上的另一個 Claude Code session 不能取代該人員,因為 從一個 session 傳送到另一個 session 的文字 絕不會被視為你的同意,也無法回答待處理的權限提示;因此,暫停中的 session 仍需要人工回應。縮小 agent 預定執行的範圍,是解決方法的另一部分;將 agent 引導至能完成工作的最小變更的 skill 可避免 session 漂移到分類器會阻擋的大範圍操作。skill 會引導單一工作,而 output style 會直接編輯 system prompt;因此,要求進行小幅、精準變更的 style 會套用到 session 的每個回合,而不只是在你啟動它時指定的單一工作。

settings.json 中的模式位置

上文內容在設定檔中都是同一個物件。

{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Bash(npm run test *)",
      "Bash(git status)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(docker compose up *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(curl *)"
    ]
  }
}

規則會依序評估:deny、ask,然後是 allow。依此順序找到的第一個相符規則會決定結果;較窄的規則不會覆寫較早出現的較廣泛規則。針對 Bash(aws *) 的 deny 規則會封鎖 aws s3 ls,即使你也允許了該確切命令。因此,allow 規則無法從 deny 規則中切出例外。Read 和 Edit 的 deny 或 ask 規則支援 gitignore 否定語法:在同一個設定檔的 deny 清單中,先寫入 Read(*.env),再寫入 Read(!sample.env),即可讓檔名為 sample.env 的檔案免於前一個規則。這個例外只會套用到同一個設定來源中較早出現的相對路徑規則;無法覆寫其他來源的 deny 規則,也無法重新開放整個目錄已封鎖的其中檔案。

ask 是 auto mode 中真正發揮作用的規則類型。Auto mode 會移除例行提示,而 ask 規則可針對你希望由人員確認的特定命令重新加入提示。部署命令應放在這裡。如果你希望程式碼離開這台機器前先經過確認,Bash(git push *) 也應放在這裡。將認證檔案保存在 deny 是另一項必要措施,並且應搭配預先讓認證資料遠離 agent 可存取的範圍。

設定檔本身的優先順序如下,從最低優先順序開始:

  • ~/.claude/settings.json:你的使用者設定,套用到每個專案。
  • .claude/settings.json:專案設定,會提交至 repository。
  • .claude/settings.local.json:你針對單一 repository 的個人設定。Claude Code 建立此檔案時會將其加入 git-ignore;如果手動建立,請將它加入 .gitignore。
  • Managed settings:由管理員部署。在 Linux 上,該檔案是 /etc/claude-code/managed-settings.json。任何設定都無法覆寫 managed permission rule,包括命令列旗標。

這裡有一個已有文件說明原因的陷阱。當 defaultMode: "auto" 來自 .claude/settings.json 或 .claude/settings.local.json 時,不會生效,這可避免 repository 透過提交設定檔自行啟用 auto mode。來自這兩個檔案的 bypassPermissions 也會被忽略。在這些檔案中設定 auto 時,Claude Code 會回復使用內建預設值,略過 ~/.claude/settings.json 中的任何 defaultMode,且不會在任何位置輸出錯誤。若該版本或方案的內建預設值是 Manual,工作階段會在沒有提示的情況下以 default mode 啟動。請將該行移至 ~/.claude/settings.json。執行 /permissions,即可列出每個作用中的規則及其來源檔案。

關閉模式的兩個開關

管理員有兩個停用開關,兩者都接受字串 "disable",而不是布林值。

{
  "permissions": {
    "disableAutoMode": "disable",
    "disableBypassPermissionsMode": "disable"
  }
}

文件指定,這兩項設定可在任何設定檔中接受字串 "disable"。這些設定最適合用於無法被覆寫的受管理設定。

disableAutoMode會將 auto 從 Shift+Tab 週期中移除,使用 --permission-mode auto 啟動的工作階段則會改以 Manual 模式開始。disableBypassPermissionsMode 對 bypass 模式執行相同的工作,而且可在任何範圍中生效。因此,您可以將它設在自己的 ~/.claude/settings.json 中,禁止自己進入不希望在凌晨 2am 的正式伺服器上使用的模式。若伺服器供其他人使用,請改將兩項設定放入 /etc/claude-code/managed-settings.json,因為使用者設定檔屬於該使用者,而受管理設定檔則不屬於使用者。

為什麼 VPS 上的 auto mode 需要隔離邊界

分類器一次只審查一個動作。它不會限制核准的動作之後執行的內容。文件清楚說明:

分類器是每個動作的控制機制,不是隔離邊界。因此,對無人值守執行而言,隔離邊界仍能提供縱深防禦;但它不像 --dangerously-skip-permissions 那樣是必要條件。

因此,對遠端主機而言,正確的搭配是 auto mode 加上可接受遺失的環境,而不是 bypassPermissions 再寄望一切順利。文件指出,繞過模式僅適用於隔離環境:例如無法連線網際網路的容器、虛擬機器或開發容器。在這些環境中,Claude Code 無法損害主機系統。執行資料庫與反向代理的 VPS 不屬於上述任何一種環境。

在伺服器上,以下 3 件事最為重要。以一般使用者身分執行 Claude Code,絕不要使用 root。為該使用者提供工作目錄,不要提供其他值得讀取的內容。與其修復主機,不如重新建置主機;這也是採用每項工作結束後即丟棄的臨時 VM的理由。從建立使用者到設定防火牆規則,這些措施背後的強化細節已涵蓋於在 VPS 上執行 Claude Code 的完整安全檢查,因此此處不再重複。

Claude Code 會自行強制執行 root 規則。在 Linux 和 macOS 上,若以 sudo 或 root 身分啟動,Claude Code 會拒絕以繞過模式執行:

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

在受辨識的沙箱內,這項檢查會被略過。因此,文件對自主容器作業所建議的做法,是使用以非 root 使用者執行 Claude Code 的開發容器。如果你透過 SSH 從手機或筆記型電腦控制代理程式,則同樣的理由也適用於在 tmux 中保持開啟的長時間 Claude Code 工作階段:工作階段執行期間,沒有人會查看提示內容。登入本身成功之前,其他步驟都無法開始。因此,如果主機以 Permission denied (publickey) 拒絕你的登入,詳細的 SSH 輸出會告訴你實際遇到 5 種故障中的哪一種。

在 Ubuntu VPS 上設定 Bash sandbox

內建 sandbox 會限制 Claude 執行之 sandboxed Bash 命令的檔案系統與網路存取,作業系統也會將相同限制套用至子程序。排除的命令與核准後在未受 sandbox 限制環境中重試的命令會在其外部執行。在 Linux 上需要 2 個套件。

sudo apt-get install bubblewrap socat

啟動 Claude Code 並執行 /sandbox。面板會開啟 Mode、Overrides 與 Config 分頁。如果缺少必要套件,只會顯示 Dependencies 分頁,並列出要安裝的套件。相依性檢查會在啟動時執行,因此安裝套件後請重新啟動 Claude Code,否則面板仍會顯示套件不存在。

在 Ubuntu 24.04 及更新版本中,預設的 AppArmor 政策會阻止 bubblewrap 建立所需的 user namespace,因此 sandbox 無法啟動。請檢查此限制是否適用於您的主機:

sysctl kernel.apparmor_restrict_unprivileged_userns

顯示 0,或顯示指出該 key 不存在的錯誤,表示無須處理。顯示 1 表示 bwrap 需要自己的 profile:

sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
  include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmor

此 profile 套用至 bwrap 本身,而不是套用至其在 sandbox 內執行的命令。接著在設定中縮小範圍:

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

該區塊應放在專案的 .claude/settings.json 中,因為只有從專案設定解析 . 時,結果才會是專案根目錄。若將相同幾行放入 ~/.claude/settings.json,. 會改為解析至 ~/.claude,因此 denyRead 規則會阻止存取您的專案檔案,且每個命令都無法讀取其預定編輯的程式碼。

請了解此設定未涵蓋的範圍。sandbox 會限制 Bash 及其子程序。內建檔案工具會在 Claude Code 程序內執行,而 MCP(model context protocol)伺服器與 hooks 是在主機上不受限制執行的獨立程序。若要讓所有這些元件都受同一個邊界限制,請將完整的 Claude Code 程序執行在 container、virtual machine 或 @anthropic-ai/sandbox-runtime 套件中;截至本文撰寫時,該套件仍是 beta research preview。

各種設定適用哪種模式?

自己筆電上的個人儲存庫

使用 auto,並為需要確認後才執行的操作設定 ask 規則。您人在鍵盤前,分類器的 fallback 確實能將提示送達您,且損害範圍限於您控制的一台機器。14 August 的預設值就是針對這種情境設計的。

共用 VPS

每位使用者各自使用 auto,並在自己的 ~/.claude/settings.json 中設定。執行 Claude Code 的帳戶不得是 root,也不得讀取其他使用者的工作內容。將 disableBypassPermissionsMode 設為 "disable",放在 /etc/claude-code/managed-settings.json 中,並一併加入保護共用路徑的拒絕規則。共用主機最能清楚說明為何 bypassPermissions 不適用,因為該模式假設的隔離邊界並不存在:其他租戶就在隔離範圍內。

CI 與無人值守工作階段

使用 dontAsk,並明確列出工作所需的命令,設定為 allow 清單。無人值守時,自動拒絕是正確的失敗模式,因為不會有人查看提示。自動模式同樣會以非互動方式執行,但 -p 執行若反覆遇到分類器封鎖,不會停止:遭封鎖的操作會略過,Claude 仍會繼續工作,因此工作可能在部分步驟未完成的情況下結束。僅在會從映像檔重建的容器或虛擬機器中使用 bypassPermissions,不要在同時執行重要服務的主機上使用。

FAQ

auto mode 何時會成為 Claude Code 的預設模式?

對 Pro、Max 和 Team 方案的新工作階段而言,auto mode 已於 2026 年 8 月 14 日成為預設模式。截至 2026 年 10 月 27 日,文件指出,Claude Code v2.1.283 或更新版本會在所有方案與提供者的互動式終端機及 VS Code 工作階段中,將 auto mode 設為內建啟動模式;但套用 HIPAA 設定的組織除外,這類組織在 v2.1.285 或更新版本中會以 Manual mode 啟動。非互動式 claude -p 執行會以 default 啟動,除非你指定模式。在 v2.1.302 之前,使用第三方提供者或關閉遙測功能的執行可能會以 auto 啟動;從 v2.1.302 起,這些執行也會以 default 啟動。你自行設定的預設值會持續生效,除非你接受一次性的切換提示;由組織管理的預設值則不會變更。查看狀態列即可確認工作階段實際使用的模式;auto mode 會顯示 ⏵⏵ auto mode on。

在 VPS 上,我應該使用 auto mode 還是 bypassPermissions?

使用 auto mode,並搭配隔離邊界。分類器會在動作執行前進行審查;位於受保護路徑以外的讀取操作與工作目錄編輯會略過審查。但文件明確說明,這是逐項動作的控制機制,不是隔離邊界。因此,無人值守的執行仍應使用容器、虛擬機器,或可接受重建的主機。bypassPermissions 會完全略過檢查,文件僅建議在隔離環境中使用。Claude Code 在 Linux 上以 root 執行時拒絕以該模式啟動,並輸出 --dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons。

如何禁止伺服器上的所有人使用 auto mode 或 bypass mode?

在 /etc/claude-code/managed-settings.json 中,將 permissions.disableAutoMode 和 permissions.disableBypassPermissionsMode 設為字串 "disable"。受管理設定的優先層級高於所有其他範圍,因此使用者設定檔或命令列旗標都無法覆寫這些設定。disableAutoMode 會從 Shift+Tab 循環中移除 auto,而使用 --permission-mode auto 啟動的工作階段會改以 Manual mode 啟動。disableBypassPermissionsMode 也可在任何範圍中使用,因此單一使用者可以在自己的 ~/.claude/settings.json 中設定它。

為什麼我的 defaultMode: "auto" 設定未生效?

因為設定位於錯誤的檔案中。當 defaultMode: "auto" 來自 .claude/settings.json 或 .claude/settings.local.json 時,不會生效;這可避免儲存庫透過附帶設定檔自行啟用 auto mode。Claude Code 會改用內建預設值,並略過使用者設定中的任何 defaultMode,且不會輸出錯誤;如果內建預設值是 Manual,工作階段便會以 default 模式啟動。將設定移至 ~/.claude/settings.json,然後執行 /permissions,確認每項有效規則的來源檔案。如果 auto mode 仍無法使用,請檢查模型需求:Sonnet 4.5 等較舊模型在任何提供者上都不受支援。

這篇文章對您有幫助嗎?