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 条评论

登录 后参与评论

还没有评论,来抢沙发~