A Claude Code permission mode 決定了 agent 可以在不暫停詢問的情況下執行哪些動作。共有四種模式：plan 僅讀取但不更改任何內容；default 依據你的權限規則在編輯和執行指令前先行詢問；acceptEdits 不詢問就直接套用檔案編輯，但執行指令時仍會詢問；bypassPermissions 則完全不詢問。選擇哪種模式，代表了你在該目錄下對 agent 的信任程度。
一旦輸入請求的人不是機器的「主人」，事情就變得更複雜了。這篇文章會先解釋 Claude Code 所定義的各種模式，接著探討在共享房間中會有哪些改變。
The four modes
plan。 agent 會讀取檔案、進行搜尋與推理，並產出一份計畫。它不會編輯或執行任何東西。這個模式適合用於「告訴我你會怎麼做」，或是讓某人在無法修改程式碼庫的情況下進行探索。
default。 agent 在每次編輯與執行每個指令前都會詢問，除非你的權限規則已事先允許該特定工具或模式。這適合結對協作（pairing），此時你在一旁關注，每個 prompt 都是一次切實的決策。
acceptEdits。 檔案編輯會直接通過而不跳出提示；指令則依然會詢問。這在還原不良編輯成本很低（有版本控制）、但執行錯誤指令成本極高的專案庫中非常實用。
bypassPermissions。 一律不詢問。Anthropic 的建議是將其保留給沙盒化、拋棄式的環境，因為任何錯誤或被注入的指令都會以你在本機的完整權限執行。
從 plan 到 bypassPermissions 的階梯，以及在共享 agent 時無論何種模式都會暫停的四個動作。
Why modes are about directories, not people
權限模式是針對 session 設定的，實際上也就是針對工作目錄。當你獨自一人時，這是合適的單位：文件庫可以在 acceptEdits 下執行、基礎設施庫在 default 下執行，而隨手做的實驗則在 bypassPermissions 下執行。
然而，一旦有第二個人可以發送請求，這種方式就不足夠了。他們的請求會以你的 session 模式執行。一位只需要檢視程式碼的共同創辦人，現在卻能編輯程式碼，只因為你上週為自己設定了 acceptEdits。模式本身並沒有依個別人員劃分的維度。
What changes in a room
在 muti 房間中，agent 依然擁有一個 Claude Code 權限模式，這是在你為目錄建立 agent 時所選擇的。而在其之上，還疊加了兩層機制。
個別人員權限。 來自主人以外之人的每個請求，不是單次核准，就是受限於你針對該 agent 授予該名人員的長期「一律允許」授權。你可以隨時撤銷這項長期授權；該人員排隊中的請求也會被取消。
一律暫停的四個動作。 無論處於何種模式、無論給予了何種授權，推送到共享分支、刪除、花費金錢以及接觸憑證等行為，都一定會暫停並等待主人確認。即使是在 bypassPermissions 模式下的 agent，只要請求來自其他人，遇到這些動作時也會暫停。其背後的考量請參閱 agent 在執行前一律該詢問的四個動作。
A practical mapping
- 供他人探索： 在
plan模式下建立 agent。訪客可以提出問題，磁碟上的內容不會有任何改變。 - 與信任的人進行日常協作： 使用
acceptEdits，並為這些人提供長期授權。執行指令依然會詢問；四個動作依然會暫停。 - 你個人的拋棄式沙盒： 使用
bypassPermissions沒問題，因為房間裡沒有其他人。但在你 Invite 其他人的那一刻，請重新考慮。 - 目錄中含有正式環境憑證的任何專案： 使用
default，不給予長期授權，並針對不需要這些憑證的部分建立獨立的 agent。
Frequently asked questions
Does a room override Claude Code’s mode? 不會。該模式依然主導 agent 在單次執行中的行為。房間額外增加的是「誰可以啟動執行」以及「無論如何都必須暫停哪些動作」。
Can a requester choose the mode? 不行。由主人針對每個 agent 個別選擇。請求者可以在請求中要求唯讀行為，而主人在回覆核准時也可以選擇「continue read-only」。
Is bypassPermissions ever acceptable for a shared agent? 只有在不會發生任何不可逆後果的目錄下才適用，而且即便如此，那四個動作依然會暫停。另一篇文章專門討論了為什麼 bypassPermissions 對你自己沒問題，對其他人卻很危險。
What about Codex? Codex 有自己的核准設定，形式也很類似。在房間中，個別人員授權與四個一律暫停的動作同樣適用。
為目錄設定模式，為人員設定授權，並讓那四個動作主動詢問。這就是整個模型。為你的 agent 開設一個房間，親自體驗它的運作方式。
發布於