權限規則先拒絕、再詢問、最後放行,沒有命中才交給模式

深讀 L2 978 字 2 分鐘 v2.0.0 更新 2026-11-16

agent 提出的指令可能刪除檔案,也可能把資料送到外部,因此請求會在執行前接受權限檢查。權限規則決定拒絕、詢問或放行;沒有規則命中時,由權限模式決定怎麼辦。

這篇處理的是執行前的決策。放行後能接觸哪些資源,屬於另一層限制,見 作業系統沙箱。

拒絕規則優先,命中就不再往下比對

模型提出請求後,Claude Code 先檢查拒絕規則。例如,刪除請求命中 DENY 時,檢查程序拒絕請求並說明原因,不會繼續尋找允許規則。

沒有命中拒絕規則,Claude Code 才檢查詢問規則。命中 ASK 時,程序停下來等待人決定,不會因為後面還有允許規則就直接執行。只有詢問規則也沒有命中,請求才會進入允許規則的檢查。

命中 ALLOW 時,Claude Code 放行請求,再進沙箱執行。gate 函式依序走過這三組規則,每一組只要找到符合條件的項目,就回傳該組的處理結果,結束這次比對。

下圖示範同一個請求在哪一關停下:命中就沿著分支處理,沒有命中才往下檢查。

先比對拒絕規則。命中就不執行,並把原因回傳給模型。

沒有命中,不等於自動放行

三組規則都沒有命中時,Claude Code 才採用權限模式的預設行為。

預設行為可以是每次詢問、自動接受檔案修改,或只規劃不執行。不同產品的模式名稱不同,因此設定時要確認模式實際做什麼,不能只靠名稱判斷未命中的請求會不會執行。

下圖把檢查寫成程式流程。gate 函式走完規則比對後,會以 fallback(mode, call) 將未命中的請求交給模式處理;圖中的 run_sandboxed 則屬於放行後的資源限制。

拒絕的原因回傳給模型。模型讀到後才會換做法。

從不能復原的動作開始設定

先列出不能復原的動作,例如刪除、寄信與付款,再把這些動作寫成詢問或拒絕規則,其餘放行。需要人決定的動作進入詢問規則;不能有例外的限制,則寫成拒絕規則。

Claude Code 每次新對話開始時會載入規則檔,相關寫法見 CLAUDE.md。但 CLAUDE.md 的文字仍可能沒有被模型遵守,不能把「已經寫進檔案」當成「執行前一定會被擋下」。

也不要把每個指令都設成詢問。每個指令都詢問,人會習慣直接同意。詢問規則需要保留給真正要由人決定的動作,否則增加的只是確認次數。

結果不符預期時,沿著分支查

已經設定允許,請求卻被拒絕或要求確認時,先找出已命中的規則。新增允許規則改不了前面已命中的決定。

如果三組規則都沒有涵蓋該請求,就檢查目前的權限模式。這時再找允許規則的內容,無法解釋最後採用的預設行為。

如果限制只寫在 CLAUDE.md,檢查重點則是這條限制是否也被設定成權限規則。

來源

讀完之後

HarnessLLM迴圈工具context快取KV接手協定權限沙箱層注入子 agent實作評測