Codex Manual
权限与安全
Codex 能改文件和运行命令。好用的前提是边界清楚。
两个关键词
Sandbox 控制 Codex 能访问和写入哪里。
Approval 控制 Codex 执行某些命令或越界操作前是否需要你确认。
新手推荐
codex --sandbox workspace-write --ask-for-approval on-request含义:
- Codex 可以在当前工作区内写文件。
- 需要更高权限时会请求确认。
- 你可以在执行前看到命令和理由。
三种 sandbox 模式(sandbox_mode):
| 模式 | 含义 |
|---|---|
read-only | 只能读文件,不改文件,运行命令需确认 |
workspace-write | 可在工作区和临时目录写文件,运行常规本地命令;默认不联网 |
danger-full-access | 无沙箱限制 |
审批策略(approval_policy)常用 on-request(沙箱内直接执行,越界时询问)和 never(从不询问,仍受沙箱限制)。untrusted 已不再支持;如果旧配置还在用它,可改为 sandbox_mode = "read-only" 加 approval_policy = "on-request"。
默认情况下,受版本控制的目录使用 workspace-write + on-request,未受版本控制的目录使用 read-only,在你信任该目录之前 Codex 也可能以 read-only 启动。会话中用 /permissions 切换。在 workspace-write 下,.git、.agents、.codex、.aws 即使位于可写目录内也保持只读。
自动审查与网络
把 approvals_reviewer 设为 auto_review(App 中的 “Approve for me”),符合条件的审批请求会先交给审查代理处理,而不是每次都问你。它不改变沙箱边界,会产生额外的模型调用,需要配合 on-request 使用。默认值是 user。
workspace-write 下网络默认关闭,需要时在 config.toml 中设置:
[sandbox_workspace_write]
network_access = true还可以用 default_permissions 选择命名的权限档案(内置 :read-only、:workspace、:danger-full-access),但不要与 sandbox_mode 同时使用。Windows 原生使用 Windows 沙箱,不需要 WSL。
谨慎使用全权限
--yolo(即 --dangerously-bypass-approvals-and-sandbox)或 danger-full-access 会显著放宽限制。只建议在这些场景使用:
- 临时容器。
- 可丢弃虚拟机。
- 只包含测试代码的目录。
- 你已经有明确回滚方案。
不要在生产机器、含敏感凭据的目录、个人主目录或重要数据盘里随意使用全权限。
操作习惯
- 先让 Codex 说明计划,再允许修改。
- 每轮修改后查看 diff。
- 让 Codex 运行相关测试。
- 对涉及删除、迁移、覆盖、权限提升的命令保持警惕。
- 把密钥放在环境变量或密钥管理中,不要让 Codex 把密钥写进仓库。
安全不是为了限制 Codex,而是为了让它在清晰边界内稳定工作。