Codex Rules(.rules 規則文件)怎麼寫:prefix_rule 沙箱外命令放行與攔截詳解

每次讓 Codex 跑沙箱外的只讀命令(如 gh pr view)都要彈窗點允許太打斷思路?本文根據 OpenAI Codex 官方 Rules 文檔,講清 ~/.codex/rules/ 目錄位置、Starlark 語法的 prefix_rule 字段、內置單測校驗與複合命令防夾帶機制。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. .rules 文件專門管「哪些命令允許跳出沙箱運行、哪些必須彈窗問、哪些直接封禁」,採用類似 Python 的 Starlark 配置語法編寫。
  2. 你在 CLI 交互介面順手點的「允許該命令前綴」,底層正是自動追加到了用戶目錄 ~/.codex/rules/default.rules 裏;想撤回誤放行的命令,直接打開這個文件刪掉對應段落重啟即可。
  3. 多條規則同時命中時,「最嚴優先(forbidden > prompt > allow)」:哪怕個人配置寫了 allow,只要項目或管理員規則寫了 forbidden,一律攔截。
  4. 自帶防私貨夾帶能力:面對 git add . && 危險刪除命令 這類用 && 拼接的複合命令,Codex 會用 Tree-sitter 把它拆開逐條過篩子,絕不會因為開頭匹配了 git add 就整行放行。

prefix_rule 三種審批決策對照

圖:本站根據 OpenAI Codex 官方文檔 Rules 整理的示意圖

本文根據 OpenAI Codex 官方文檔《Rules》整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。

適用於誰

  • 搜「codex rules 怎麼寫」「codex default.rules」「codex 命令白名單配置」的開發者;
  • 在沙箱模式下(基礎機制見 /guides/codex-permissions-sandbox)頻繁需要調用需要聯網的只讀 CLI(比如查 GitHub PR、看內部工單),想把安全前綴固定放行、把高危命令徹底封死的人;
  • 在終端裏點過「加入允許列表」之後,好奇這條放行記錄到底寫進了電腦哪個文件、想手動編輯或刪掉誤點規則的人。

如果你遇到的是自動審查直接攔截了某條正常命令,也可先對照排查篇 /guides/codex-auto-review-denied-command。

一、規則文件放在哪,誰會生效

Codex 啟動時會自動掃描所有生效配置層下的 rules/ 文件夾,按範圍分三處:

  • 個人用戶級:~/.codex/rules/*.rules(例如 default.rules),對你本機所有項目生效;
  • 受信任項目級:倉庫下的 .codex/rules/*.rules,方便團隊隨 Git 共享統一命令策略(前提是該項目的 .codex/ 目錄已被你標記為受信任);
  • 企業管理員強制層:管理員可在託管配置(如 requirements.toml,工作區權限見 /guides/codex-admin-permissions-business-workspace)中下發不可繞過的限制性 prefix_rule。

二、標準 prefix_rule 寫法與內置「啟動自測」

和容易寫歪的純文本通配符不同,Codex 的 prefix_rule 按命令參數數組逐個位置精確匹配,而且極其貼心地內置了 match 和 not_match 自測斷言——啟動加載規則時如果斷言沒過,會當場報錯提醒你改,不讓寫錯的寬泛規則帶病上崗。

新建或編輯 ~/.codex/rules/default.rules:

python
# 1. 允許只讀查看和列出 GitHub PR 時需要人工確認(也可按需改為 "allow")
prefix_rule(
    pattern = ["gh", "pr", ["view", "list"]],
    decision = "prompt",
    justification = "允許在確認後查看遠程 PR 資訊",
    match = [
        "gh pr view 1024",
        "gh pr list --state open",
    ],
    not_match = [
        # 全局參數插在中間改變了前綴順序,因此不會誤命中
        "gh --repo owner/repo pr view 1024",
        "gh pr merge 1024",
    ],
)

# 2. 直接封禁強制推送等高危參數前綴,並給出文明替代提示
prefix_rule(
    pattern = ["git", "push", "--force"],
    decision = "forbidden",
    justification = "嚴禁使用 --force 覆蓋遠程歷史,請改用普通推送或新建分支。",
)

看清兩個很關鍵的語法細節:

  1. 同位置多選一用嵌套數組:上例的 ["gh", "pr", ["view", "list"]] 表示第 3 個參數既可以是 view 也可以是 list,一條規則頂兩條,不會誤放行同級的 merge 或 close;
  2. justification 理由別省:當 decision = "forbidden" 攔截生效時,Codex 會把你寫的這段理由直接反饋給模型——寫清楚「請改用什麼命令(例如用 rg 代替慢速 grep)」,模型下一輪就會乖乖換路走,不會原地死磕報錯。

編寫並自測 Codex .rules 規則四步

圖:本站根據 OpenAI Codex 官方文檔 Rules 整理的示意圖

三、看懂複合 Shell 命令的「拆解與不拆解」邊界

很多安全團隊擔心:大模型經常生成 bash -lc "命令A && 命令B",前綴規則會不會被繞過?官方文檔專門解釋了底層的拆分邊界:

  • 會自動安全拆開評估的情況:當腳本是由普通字面量單詞通過 &&、||、; 或管道 | 線性串聯時,Codex 用語法樹將它拆成獨立子命令逐個查規則,只要其中任意一段落入未放行或 forbidden,整條請求都會被攔住;
  • 不會拆開(直接走嚴格審批)的情況:一旦腳本里包含了重定向(>、>>)、命令替換($(...))或內聯環境變量賦值(FOO=bar),Codex 不會冒險瞎拆放行。如果你需要對更復雜的參數內容做深度腳本校驗,建議配合 PreToolUse 鉤子一起使用(見 /guides/codex-hooks-json-lifecycle-config-guide)。

平時開啟預設智能審批(Smart approvals)時,Codex 在請求沙箱外提權時也會主動給你擬好一段建議的 prefix_rule——點確認前務必掃一眼前綴是不是把 python -c 或 bash -c 這種萬能解釋器放進去了(絕對不要對任意代碼解釋器設無條件 allow)。需要核對 Codex 所屬各檔 ChatGPT 官方訂閱權益的讀者,可參考 /chongzhi/chatgpt-plus。

常見問題

Q:改完 .rules 文件為什麼在當前開着的終端裏沒立刻生效?

Codex 在啟動階段集中掃描並校驗所有配置層的 rules/ 目錄。手動編輯儲存 .rules 文件後,退出重開一次 Codex 會話即可加載新規則。

Q:為什麼我放行了 ["gh", "pr", "view"],模型敲 gh --repo xxx pr view 還是彈窗了?

因為 prefix_rule 是嚴格的從左到右參數位置前綴匹配——插在第 2 位的 --repo 打斷了 pr 的位置。你可以在項目 AGENTS.md 裏順手交代一句「調用 gh 時把子命令寫在最前面,把 --repo 等選項放在末尾」,既安全又能穩定命中規則。

相關教學

參考資料

  • OpenAI Codex 官方文檔:Rules — https://learn.chatgpt.com/docs/rules
  • OpenAI Codex 開發者中心 — https://developers.openai.com/codex

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    多 Agent 協同開發怎麼落地:「一個寫、一個審」雙代理工作流搭建指南

    多 Agent 協同開發裏投入產出比最高的模式就是「一個寫、一個審」。本文依據 Anthropic 與 OpenAI 官方編碼最佳實踐,講清為什麼同會話自審容易漏問題,以及用只讀子代理、跨模型交叉審查(Claude Code + Codex)和自動化閉環落地的具體方法。

    ClaudeCodex0
  2. 02

    codebase-memory 類 MCP 是什麼、怎麼用:基於語法樹圖譜的本地代碼索引原理與配置

    codebase-memory-mcp(DeusData/codebase-memory-mcp)是一類本地代碼圖譜 MCP 伺服器:用 Tree-sitter 把倉庫解析成函數與調用關係的 SQLite 圖庫,幫編碼助手查調用鏈並省下讀整份文件的額度。

    ClaudeCodex0
  3. 03

    Chrome DevTools MCP 怎麼用、怎麼保留登入態:安裝配置、獨立目錄與遠程調試端口連接

    Chrome DevTools MCP 本身免費且無需註冊帳號,大家搜「登入」通常是為了讓 AI 調試需要登入的網頁後台。本文按官方倉庫文檔講清安裝命令,以及用 --userDataDir 持久化獨立配置目錄、用 --browserUrl 掛載已登入瀏覽器的兩種標準做法。

    ClaudeCodex0
  4. 04

    Codex 接入 Amazon Bedrock 與 Google Cloud Vertex AI 教學:企業雲託管配置

    企業合規要求模型流量統一走自家 AWS 或 GCP 雲帳單時,不需要硬拼第三方代理。本文根據 OpenAI Codex 官方文檔,講清原生接入 Amazon Bedrock(四種 AWS 憑證方式)與 Google Cloud Vertex AI(ADC 認證與區域駐留)的完整步驟。

    Codex0
  5. 05

    Codex 自動審查 GitLab Merge Request 怎麼配:公有云與自託管實例接入指南

    代碼託管在 GitLab 的團隊同樣可以用上 OpenAI 官方的雲端代碼審查。本文根據官方文檔講清 GitLab.com 與企業自託管實例的服務帳號配置、Developer 權限、Webhook 開啟與 AGENTS.md 規則約束。

    ChatGPTCodex0
  6. 06

    Codex 接入 Linear 怎麼用:指派 Issue、評論 @Codex 自動改碼與 Triage 分流教學

    用 Linear 管研發任務單的團隊,可以直接把 Issue 指派給 Codex 或在評論區 @Codex 自動拉起雲端環境改代碼。本文按 OpenAI 官方文檔講清雲端環境前置準備、連接器安裝、多倉庫指定技巧以及 Triage 規則自動派單配置。

    ChatGPTCodex0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~