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,而是为了让它在清晰边界内稳定工作。