AI Agent / 系统课时

理解沙箱与审批机制

理解沙箱与审批机制

Codex 能否读文件、改代码、运行命令或访问网络,不由一个“是否信任”开关决定,而是由沙箱边界和审批策略共同控制。理解这两个层次后,你才能为日常开发、只读审查和高权限自动化选择合适的安全组合。

学习目标

  • 区分沙箱负责的能力边界与审批负责的升级流程
  • 理解 read-only、workspace-write 和 danger-full-access 的差异
  • 配置并验证一个低风险的本地工作模式

先分清沙箱与审批

沙箱回答“当前动作在不升级权限时能做到什么”。read-only 主要用于读取;workspace-write 允许在工作区内编辑并运行常规本地命令;danger-full-access 则移除沙箱限制。审批策略回答“动作碰到边界时是否暂停并请求授权”。常用的 on-request 会让 Codex 先在沙箱内工作,需要越界时再请求审批。:contentReference[oaicite:5]{index=5}

审批不是沙箱的替代品。即使启用自动审批评审,改变的也只是“谁来审”,而不是可读写的目录或网络边界;已经在沙箱内允许的动作不会因为自动评审而多出一道检查。:contentReference[oaicite:6]{index=6}

Codex沙箱边界与审批闸门的关系

三种沙箱边界怎么选

模式 默认能力 适合场景
read-only 读取文件;修改、命令执行或网络等动作需要额外授权 代码阅读、审计、陌生仓库初查
workspace-write 可在工作区内读写并运行常规本地命令,越出工作区或访问网络时需要审批 日常编码、测试和修复
danger-full-access 不受 Codex 沙箱限制 已有外层隔离的受控容器或专用环境

官方把 workspace-write 配合 on-request 作为低摩擦的本地工作方式;真正的 Full access 则等价于移除沙箱并不再弹审批,因此不应把它当成普通开发默认值。:contentReference[oaicite:7]{index=7}

配置一个日常开发基线

下面配置可放入 ~/.codex/config.toml。它允许 Codex 在工作区内编辑,但网络默认关闭;当任务需要越过边界时,由用户审批。

toml
approval_policy = "on-request"
sandbox_mode = "workspace-write"
approvals_reviewer = "user"

[sandbox_workspace_write]
network_access = false

生效行为是:工作区内的常规编辑和本地命令可直接进行,外部路径或被策略阻止的能力不会静默放开。启动 Codex 后可用 /permissions 查看和调整当前权限;会话中的显式权限选择会覆盖启动时的默认行为。:contentReference[oaicite:9]{index=9}

用只读会话验证边界

需要检查陌生仓库而不希望自动写入时,可以临时覆盖默认配置:

bash
codex --sandbox read-only --ask-for-approval on-request

预期结果

text
<CODEX_INTERACTIVE_SESSION>
仅阅读工作区文件:允许
写文件、运行命令或访问网络:请求审批

实际界面文案会随客户端版本不同。验证时不要只看启动提示,而应让 Codex先读取一个文件,再尝试创建一个临时文件:前者应在只读能力内完成,后者应触发审批或被拒绝。这样才能确认“默认边界”和“越界处理”都按预期生效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解沙箱与审批机制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通