---
site: "zyx.tw"
title: "權限規則先拒絕、再詢問、最後放行，沒有命中才交給模式"
description: "沿著執行前的比對順序，設定不可越過的界線。"
url: "https://www.zyx.tw/map/harness/permission-gates"
---

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

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

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

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

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

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

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

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

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

```text
 tool call
    │
    v
╭────────╮  match   ╭──────────────────────╮
│  DENY  │ ───────> │ refuse, say why      │
╰───┬────╯          ╰──────────────────────╯
    │ no match
╭───┴────╮  match   ╭──────────────────────╮
│  ASK   │ ───────> │ wait for a person    │
╰───┬────╯          ╰──────────────────────╯
    │ no match
╭───┴────╮  match   ╭──────────────────────╮
│ ALLOW  │ ───────> │ run inside a SANDBOX │
╰───┬────╯          ╰──────────────────────╯
    │ no match
    v
 the MODE decides
```

Figure: A tool request meets deny rules, then ask rules, then allow rules. A denied request is refused with a reason. An asked one waits for a person. An allowed one runs inside a sandbox. The mode decides the rest.

1. Deny: 先比對拒絕規則。命中就不執行，並把原因回傳給模型。
2. Ask: 再比對詢問規則。命中就停下來等人決定。
3. Allow: 最後比對放行規則。放行的指令在沙箱裡執行。
4. Mode: 三種規則都沒命中時，由權限模式決定。

## 沒有命中，不等於自動放行

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

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

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

```text
def gate(call, mode):
    for rule in DENY:
        if rule.matches(call):
            return refuse(call, rule.reason)
    for rule in ASK:
        if rule.matches(call):
            return ask_person(call)
    for rule in ALLOW:
        if rule.matches(call):
            return run_sandboxed(call)
    return fallback(mode, call)

def run_sandboxed(call):
    box = sandbox(write=[PROJECT_DIR],
                  network=ALLOWED_DOMAINS)
    return box.run(call)
```

Figure: Pseudo code of a permission gate: deny rules first, then ask rules, then allow rules, then a fallback set by the mode; an allowed call runs in a sandbox that limits writes and network.

1. Deny: 拒絕的原因回傳給模型。模型讀到後才會換做法。
2. Ask: 詢問會打斷工作。只留給不能復原的動作。
3. Allow: 放行的請求交給沙箱執行。
4. Mode: 沒有規則命中時，依模式決定詢問或放行。
5. Sandbox: 沙箱只允許寫入專案目錄，只連線到清單上的網域。

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

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

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

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

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

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

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

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

## 來源

- [Configure permissions](https://code.claude.com/docs/en/permissions), Claude Code docs
- [Choose a permission mode](https://code.claude.com/docs/en/permission-modes), Claude Code docs
- [Configure the sandboxed Bash tool](https://code.claude.com/docs/en/sandboxing), Claude Code docs
- [Codex: Sandbox](https://developers.openai.com/codex/concepts/sandboxing), OpenAI
- [Implementing a secure sandbox for local agents](https://cursor.com/blog/agent-sandboxing), Cursor
- [The lethal trifecta for AI agents](https://simonwillison.net/2025/Jun/16/the-lethal-trifecta/), Simon Willison
- [Permissions](https://opencode.ai/docs/permissions/), opencode docs

## 地圖

- 先讀：[工具以名稱、說明與參數格式約定請求，再用同一個 id 對回結果](https://www.zyx.tw/map/harness/tool-calls.md)
- 原理：[作業系統沙箱限制指令能碰到的資源，與權限規則是兩道邊界](https://www.zyx.tw/map/harness/os-sandbox.md)
- 原理：[先做最小的 harness，遇到問題再加零件](https://www.zyx.tw/map/harness/build-a-small-harness.md)
- 相關：[我把通訊 bot 的工具、對話與工作空間分開設定](https://www.zyx.tw/map/beyond/outside-the-terminal.md)
- 相關：[我用鑰匙圈傳入密碼，隔開模型讀取與程式使用](https://www.zyx.tw/map/beyond/what-an-agent-has-seen.md)
- 相關：[工具讀回的內容可能被當成指令，防護要限制讀取與傳送的組合](https://www.zyx.tw/map/harness/untrusted-input.md)
- 回到：[Harness](https://www.zyx.tw/map.md)
