---
description: "Codex 权限管理指南，说明文件访问、命令审批、网络权限、敏感数据和高风险操作的控制方式，适合任务前核对。"
---

::: tip 最后核对
官方资料最后核对日期：2026-06-15。本文参考 [Codex app settings](https://developers.openai.com/codex/app/settings)、[Sandboxing](https://developers.openai.com/codex/concepts/sandboxing#how-you-control-it)、[Permissions](https://developers.openai.com/codex/permissions) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)。不同版本的界面具体名称、入口和可用选项会有所不同，请以你当前使用的客户端界面为准。
:::

# 权限管理

这一节介绍 Codex App 里的权限选项。包括：
1. 聊天框下方的权限选择
2. 设置里的“配置”项

权限管理和**沙盒**（Sandbox）本质上是同一个概念。想深入可以看 [OpenAI 官方文档](https://developers.openai.com/codex/concepts/sandboxing#how-you-control-it) 或者 [沙盒与审批](./07-sandbox-approvals.html) 以了解更多。

## 聊天框里的权限选项

权限入口在聊天框下方，官方叫它 permissions selector。四个常见选项：
1. `Default permissions`（默认权限）
2. `Auto-review`（自动审核）
3. `Full access`（完全访问）
4. `Custom (config.toml)`（自定义配置）

![Codex App 权限选择器示例](https://cdn.canghecode.com/codexguide/docs/images/codex-app-permissions-selector-menu-watermarked-small.png)

对于 CLI 而言，权限配置的细粒度和复杂度都会更高。这里不做展开。

### 默认权限

又称：请求批准。

默认权限是 Codex 的安全基线。Codex 运行在**沙盒**（Sandbox）内，只能读写当前工作区（即你打开的文件夹）里的文件、运行常规本地命令。一旦操作超出该文件夹范围、访问网络，或调用更敏感的能力（如读取系统环境变量、操作已登录的 CLI），Codex 会暂停并请求确认——通过对话询问，或弹出审批窗口。

这个“沙盒”本质上是一道围栏，将 Codex 的活动范围限制在当前项目内，防止误触外部文件。

官方文档里，这套默认配置对应：
- `sandbox_mode = "workspace-write"`
- `approval_policy = "on-request"`
- `approvals_reviewer = "user"`（即用户本人审批）。

**适用场景：**
- 修改文档、样式、测试或小范围代码。
- 安全性敏感的任务。

若任务步骤较多，频繁弹窗可能影响效率，此时可考虑切换至**自动审核**。

### 自动审核

又称：替我审批。

自动审核适合希望减少手动审批打断、但又不愿完全放开权限的场景。执行命令时，Codex 会将请求转给 **reviewer agent**（一个专门负责风险评估的助手）判断。低风险或中风险直接放行；高风险仍需要用户明确同意。

这是最**推荐**的权限机制。保证安全性的同时也能兼顾用户体验和工作效率。

![Codex App 自动审核拒绝高风险操作示例](https://cdn.canghecode.com/codexguide/docs/images/codex-app-auto-review-rejection-watermarked-small.png)

**适用场景：**
- 项目经常需要访问当前文件夹以外的资源，如调用本机 CLI、联网查询，且风险可控。
- 本地开发任务步骤较多，不希望被频繁弹窗打断。
- 已信任当前项目目录，但仍希望拦截危险操作（如删除文件、修改配置、泄露凭据）。

### 完全访问权限

只在明确需要时**临时开启**。官方将 Full access 对应到 `sandbox_mode = "danger-full-access"` 和 `approval_policy = "never"`：沙盒限制被完全移除，Codex 不再触发审批弹窗，直接执行任何它打算执行的命令。

这是**最高权限机制**，务必考虑可能带来的风险。

**适用场景：**
- 调试特殊本机环境、Computer Use 或系统级操作。
- 任务必须高频访问工作区外的本机资源。
- 操作范围清晰，且项目有 Git 或备份机制可回滚。

### 自定义配置

选择 `Custom (config.toml)`，Codex 会按本地 `config.toml` 中的设置工作。例如同时开放多个可写目录、给特定网络域名放行、将审批交给自动审核，或通过 rules 对某些命令前缀设置“允许 / 询问 / 禁止”标识。

属于进阶配置，适合已熟悉沙盒和权限机制、希望按个人习惯定制权限边界的用户。

| 选项 | 大致含义 | App 里怎么理解 |
| --- | --- | --- |
| `sandbox_mode = "read-only"` | 只读。可以检查文件，但编辑文件或运行命令需要审批 | 适合只看代码、做审查、先问方案 |
| `sandbox_mode = "workspace-write"` | 允许在当前工作区内读写并运行常规本地命令 | 默认权限的主要工作边界 |
| `sandbox_mode = "danger-full-access"` | 移除本地沙盒限制 | 完全访问权限，高风险 |
| `approval_policy = "on-request"` | 默认在沙盒内工作，越过边界时请求审批 | 默认权限下常见的审批方式 |
| `approval_policy = "never"` | 不请求审批 | 完全访问权限的一部分，风险最高 |
| `approvals_reviewer = "user"` | 审批提示交给用户 | 默认权限 |
| `approvals_reviewer = "auto_review"` | 符合条件的审批请求交给 reviewer agent | 自动审核 / 替我审批 |
| `sandbox_workspace_write.writable_roots` | 给 `workspace-write` 增加可写目录 | 需要跨目录时，优先考虑 |

![Codex App config.toml 配置示例](https://cdn.canghecode.com/codexguide/docs/images/codex-app-config-toml-settings-watermarked-small.png)

上表仅展示部分常见配置选项，更多请查看[OpenAI Premission](https://developers.openai.com/codex/permissions)。

## 推荐

1. **新项目建议先使用默认权限**，观察 Codex 在该模式下的行为。
2. **日常修文档、补测试、改小功能**，默认权限通常够用。
3. **任务步骤多、审批频繁时**，切换至自动审核。它是最通用的选项，也可以一开始就选。
4. **只有明确知道默认权限的卡点时**，再临时切换至完全访问权限。
5. **长期习惯固定后**，再用 `Custom (config.toml)` 将沙盒、审批、网络和 writable roots 固化为固定配置。
6. **不确定某个操作是否会执行？** 先让 Codex 说明其准备运行的命令、修改的文件，以及访问的外部资源，再决定是否继续。

最后提醒：删除文件、数据库迁移、发布、支付、修改权限、访问凭据、操作生产服务——这些场景必须由用户亲自把关。权限机制仅是约束，并非保险。特别是在“完全访问权限”下，Codex 一旦误判，可能产生预期外的破坏性操作。

## 注意

- 权限越高，任务范围应越小。
- 自动审核会消耗额外模型调用，也可能因超出额度限制、超时或失败而拒绝执行。
- 浏览器、MCP、Computer Use、App 连接器和外部服务通常还有独立的权限控制，不完全由沙盒模式控制。

## 下一步

下一步：[Automation](./05-automation.md)。