不存放秘密的工作环境,加上拒绝读取的设置。请先把这两者结合起来。

只读、审批和训练设置各自的作用不同。请分别确认它们能否真正阻止对秘密文件的访问。

分别确认“读取”“执行”和“发送”

读取范围

从工作环境中移除不需要的秘密。对目标文件可以考虑使用拒绝读取的 deny。

越过边界的操作

确认审批的对象。不要通过 Full access,或在沙箱外执行的许可来扩大边界。

通信与其他工具

分别确认命令的通信、发送给模型的内容,以及浏览器、MCP 等。

读取、执行和发送,分别由不同的设置来阻止。

1. 只读、审批与训练设置的区别

“无法修改文件”与“无法读取文件”是两回事。

read-only

限制写入的模式。它并不是阻止读取可读文件内容的功能。

workspace-write

指定可以编辑的范围。读取的范围也不一定只限于同一位置。

控制项主要决定的内容它无法保证的内容
只读文件能否被修改不会读取可访问的秘密文件
审批策略由谁审核越过边界的操作允许范围内的读取每次都由人确认
文件的 deny拒绝对目标路径的读写删除已粘贴的内容,或通过其他工具进行的访问
命令的联网限制沙箱内命令的通信目标阻止模型、认证、浏览器、MCP 等所有通信
训练设置处理过的数据是否用于改进模型不进行处理或发送本身

在 on-request 下,允许范围内的命令仍可无需额外审批直接执行。如果需要人工确认,请同时查看审批策略和审核方。

与 AI 自动审查的区别

approvals_reviewer = "auto_review" 是将对象的审查交给 AI 的设置。它不是人工确认,也不是为所有已获允许的操作增加审查的设置。

出处:OpenAI:审批与沙箱的边界。关于训练,请参阅ChatGPT 与 Codex 的训练设置和机密信息,那里另有单独的说明。

2. 先把秘密从工作环境中分离出来

如果只是修改界面,源代码和虚拟数据可能就足够了。生产环境的 API 密钥、客户数据和家庭文件,不必放在同一个环境中。

仅把文件移到其他文件夹是不够的。如果仍保留较宽的读取权限,被移走的文件也可能被访问到。

工作副本中只放必要的内容

1
准备源代码和虚拟数据

使用能够重现问题的小型输入,代替生产数据。

2
不带入秘密的值

环境配置示例只写项目名称。同时检查日志、备份和历史记录。

3
确认该环境的权限

查看能否访问其他文件夹、主目录、共享存储空间或已连接的应用。

即使是独立的工作副本、独立用户或容器,只要存在共享文件夹或已交付的认证信息,也需要另行确认其范围。
用 Git 的忽略设置能阻止读取吗?

.gitignore 是指定 Git 忽略的未跟踪文件的设置。它并不是取消操作系统读取权限的机制。即使搜索工具通常会忽略这些文件,也不能保证直接指定路径的读取会被拒绝。后来添加的忽略设置,对已被 Git 跟踪的文件同样不会生效。Git 官方:gitignore 的对象范围。

作业指示与技术性拒绝的区别

在 AGENTS.md 中写明“不读取秘密”,作为作业指示是有用的。但它本身并不会建立操作系统级别的访问限制。基本做法是将作业指示与技术性拒绝叠加使用。关于匿名化输入的具体示例,也可以参考向 AI 输入信息时的注意事项。

3. 拒绝读取的设置示例

Permission profiles 是测试版功能。使用前请确认支持的环境,以及当前会话所选的设置。

read:读取

读取目标的权限

write:编辑

允许对目标进行写入

deny:拒绝

拒绝对目标的读取和写入

与旧版 sandbox 设置并用时需注意
如果旧设置仍然存在,Permission profiles 可能不会生效。

检查冲突的设置与管理员控制

不要与旧设置混用:default_permissions 和 [permissions] 并不是与旧版的 sandbox_mode、[sandbox_workspace_write] 配合使用的方式。通常,如果读取的设置中包含 sandbox_mode,或者启动时传入了 --sandbox,就会使用旧方式。管理员通过 allowed_permission_profiles 进行的控制则是另外的条件。

以下是设置示例:将官方的工作范围限定示例,与拒绝秘密文件和人工审批结合起来。请勿整体替换现有设置,应确认所用版本、组织的限制以及所需的执行路径,并在虚拟环境中进行测试。

设置写在哪里:用户级与项目级
用户设置

~/.codex/config.toml

项目设置

.codex/config.toml

两者的适用范围和加载条件不同。项目设置只会在受信任的项目中加载。

设置示例:拒绝秘密文件,并关闭命令联网
default_permissions = "project-private"
approval_policy = "on-request"
approvals_reviewer = "user"

[permissions.project-private]
extends = ":workspace"

[permissions.project-private.filesystem]
":root" = "deny"
":minimal" = "read"

[permissions.project-private.filesystem.":workspace_roots"]
".env" = "deny"
".env.production" = "deny"
"secrets" = "deny"

[permissions.project-private.network]
enabled = false

这个设置示例对哪些文件生效?

适用于当前工作区,以及每个追加的工作区

.env拒绝的对象
.env.production拒绝的对象
secrets/ 及其下的内容拒绝的对象
子文件夹/.env本示例中需另行确认
用其他名称保存的同一秘密,或日志中的副本本示例中需另行确认
这是表示拒绝指定范围的概念图。
工作区之外

用 :root 拒绝读取。但执行所需的 :minimal,以及继承来源所允许的临时目录,属于例外。

工作区之内

继承 :workspace 以允许编辑,并拒绝上面指定的特定路径。这不是能够捕获输出中嵌入的秘密的示例。

关于设置名称、多个范围和临时文件的补充说明

project-private 是本示例中起的名称。:workspace_roots 适用于当前工作区和追加的工作区,并分别指定各自直属的目标路径。secrets 指的是同名的文件或子树。

这并不是能让工作区之外完全无法读取的配置。还需要养成不把秘密复制到临时区域的习惯。

出处:OpenAI:Permission profiles 的设置、拒绝与对象范围。

4. .env 模式与容易遗漏的范围

按确切路径指定,适用于位置固定的秘密。使用模式时,请注意 *.env 与 .env.* 是不同的东西。不要因为官方示例 **/*.env 存在,就认为 .env.production 也能按相同条件被拒绝。

指定示例预期的对象需另行确认的内容
.env工作区根目录下的同名文件子文件夹,以及名称后附加后缀的文件
.env.production根目录下的生产环境配置文件其他名称的生产环境配置,或其副本
secrets根目录下的同名路径及其下的内容日志、备份等其他位置的副本
**/*.env跨多个层级、名称以 .env 结尾的文件带后缀的名称;搜索深度与启动后的变更

确认层级深度与启动后的追加

在 Linux、WSL 和原生 Windows 上,包含不受限 ** 的拒绝模式,可能需要在启动前将展开范围限定在一定之内。官方的说明有两种方法:将 glob_scan_max_depth 设为 1 或更大的值,或者像 *.env、*/*.env、*/*/*.env 那样明确指定深度。如果使用更深的层级,就需要确认到该深度为止。

之后创建的文件仍可能被读取。根据官方的说明,在 Linux、WSL 和 Windows(MXC 或 elevated)上,符合拒绝模式的文件会在每个进程启动时被列举。在该进程运行期间创建的符合条件的文件,不会被纳入拒绝对象;若其他权限允许,仍然可以读取。例如,已经启动的 shell 或开发服务器,可以读取之后创建的 .env。启动新进程时会重新列举,因此创建秘密文件后,请重新启动正在运行的进程。

权限重叠时,以哪一个为准?

更具体的路径指定可以覆盖更宽泛的指定。对于同一路径,deny 优先;但在宽泛的拒绝之中,也可以建立狭窄的允许。还需确认额外的设置层级,以及从父级配置文件的继承。

出处:OpenAI:通过确切路径或通配符拒绝读取、设置的加载顺序。项目的 .codex/config.toml 只会在受信任的项目中加载。请区分文件中写了什么,与当前会话中实际生效的是什么。

5. 关闭联网后会被阻止和不会被阻止的内容

关闭命令的联网后,可以限制在目标沙箱内运行的程序使用网络。但是,Codex 客户端的模型与认证请求,与命令的联网控制是分开的。不要因为命令联网已关闭,就认为读取的代码被传入模型上下文的途径也会被阻断。

命令的联网限制所能覆盖的范围

对象:沙箱内

命令、脚本及其子进程进行的通信。

单独管理:其他途径

模型与认证、网页搜索、已连接的应用、MCP、浏览器与 Computer Use、云端任务。

单独管理的工具,请通过各自的连接、权限和环境控制进行确认。

若要在允许联网的同时限定发送目标,除了域名规则之外,还需要启用网络代理。仅在配置文件中写入允许的域名,并不会生效。

命令的联网代理结果
关闭任意不允许命令联网
开启关闭可以直接通信,配置文件中的域名规则不适用
开启开启由代理应用域名规则;除非有允许项,否则拒绝外部目标

即使是被允许的发送目标,也可能接收到秘密。限定域名并不等同于检查发送的内容。批准在沙箱之外执行时,也不要以为当前的拒绝设置仍会起到保护作用;请确认该批准扩大了什么范围。OpenAI:网络许可与代理的条件。

6. 环境变量、操作系统与云端的区别

秘密并不只存在于文件中。如果 shell 中存有 API 密钥,即使拒绝了文件,也可能从传给子进程的环境变量中被使用。环境变量的继承需通过 shell_environment_policy 另行管理。

环境变量的自动排除:true 与 false

true(默认值)

不会自动排除名称中包含 KEY、SECRET 或 TOKEN 的变量

false

会应用该自动排除

对比的是 ignore_default_excludes 的设置值。这是与文件的 deny 不同的控制项;由于它按变量名排除,因此并不是能够检测出所有秘密的机制。

名称不同的变量,或程序从其他位置获取的值,无法受到保护。set 在排除处理之后应用,可能会恢复被排除的变量。OpenAI:环境变量的继承与优先级。

Windows:也需确认沙箱的方式

本地的 Permission profiles 在 macOS、Linux、WSL 和原生 Windows 上都有说明,但实现方式并不相同。Windows 有以下三种方式。

MXC(推荐)

Microsoft Execution Containers。在支持的设备上推荐使用的方式。无需管理员批准的准备工作,也不需要专用的 Windows 账户,支持 Windows 11 24H2 和 25H2 的受支持版本。

elevated(优先的备用方式)

MXC 不可用时优先使用的旧方式。需要管理员批准的准备工作。

unelevated(另一种备用方式)

通信隔离较弱,不支持拒绝读取的路径。本文中用于保护秘密文件的设置对它无效。

出处:OpenAI:Windows 沙箱。无法支持的策略会在执行时被拒绝,这并不意味着出现错误时就可以切换到 Full access。OpenAI:各操作系统的执行方式。

云端:不要直接沿用本地设置

Codex Cloud 会单独检查其云端环境的设置。本地的配置文件不会自动适用于整个云端,也不会自动应用于云端的 dot(ChatGPT 的持续型 AI 代理)。请勿将本文的本地设置示例直接当作云端设置来使用。执行位置的差异,已在Codex 的 Remote、Cloud 与 PC 连接条件中整理。

7. 用虚拟文件进行验证的步骤

“我们告诉过它不要读取”“我们保存了设置”和“它确实被拒绝了”,是不同的证据。无需让真实的秘密实际试读。以下是由使用者或管理员进行确认的步骤。

  1. 记录对象:记录 Codex 的版本、操作系统、执行位置以及所选的权限。在 CLI 中,用 /status 确认工作范围,用 /permissions 确认所选状态。
  2. 检查设置冲突:确认用户设置、受信任的项目设置、所选的配置文件、启动参数以及管理员的限制。为了诊断,不要把整个设置文件或秘密的值粘贴到对话中。
  3. 准备虚拟文件:在不含秘密的独立工作区中,创建需要允许的文件和需要拒绝的文件。内容用作虚拟文件的标记。
  4. 同时确认允许与拒绝:确认允许的对象可以通过同一执行路径读取,并且读取被拒绝的对象会报错。仅仅因为 Codex 自行没有读取,不能作为技术性拒绝的证据。
  5. 检查放置位置的差异:确认直接位于根目录、位于子文件夹、带后缀的,以及启动后创建的虚拟文件。不要授予越过拒绝的批准。如果出现意外可读的情况,请停止在该环境中使用,并查明原因。
  6. 也要确认输出的路径:确认测试或构建是否会把秘密输出到日志中,以及同一信息是否传给了其他 MCP、浏览器或已连接的应用。

由于能够确认的项目因 CLI 的版本和显示方式而异,请查看实际的显示,而不只是命令名。官方 CLI 也提供通过 codex sandbox 按操作系统进行确认的方法。但在依赖辅助命令通过的设置之前,请先确认它与你平时使用的桌面或 IDE 会话中实际生效的设置是一致的。OpenAI:沙箱的检查方法。

已经读取的内容,之后再添加 deny 也无法撤销。请另行确认过去的对话、日志、文件的保存以及训练设置。不要仅因为文件曾被读取,就断定信息已经泄露给第三方。请分别判断:读取了什么、传到了哪里、认证信息是否需要处理。

排除秘密文件的需求,用户已在Codex 的公开 Issue中提出。当前的规格,请以上文介绍的官方 Permissions 为准。

本文的前提:基于 2026 年 10 月 8 日 OpenAI 的 Permissions、Sandbox、审批与安全以及设置相关资料撰写,主要针对本地沙箱内的命令(之后创建的文件的处理于 10 月 19 日,Windows 的方式于 10 月 16 日已在官方资料中重新确认)。设置示例未在实际环境中应用,因此使用前请按上述步骤用虚拟文件确认拒绝是否生效。

相关文章:如果想阻止对源代码的修改,请参阅如何以只读方式使用 Codex 与 Claude Code;如果想在允许的范围内继续工作,请参阅Codex 的 Goal mode 与减少审批等待的方法。

FAQ

如果是只读,.env 还会被发送吗?

有可能。只读只限制修改。若要让可读取的 .env 不进入模型的上下文,请另行确认对目标的读取已被拒绝,并且工作环境中不包含秘密。

只用 .gitignore 和 AGENTS.md 就足够了吗?

它们无法替代技术性的读取拒绝。Git 的忽略设置、作业指示以及操作系统执行的权限,是各自独立的机制。请用虚拟文件确认 deny 在你当前的执行环境中是否有效。

关闭联网后,Codex 会完全在本地设备上运行吗?

不会。命令的联网限制并不是阻止与模型、认证之间通信的设置。浏览器、MCP、已连接的应用和云端的设置也都是各自独立的。

使用这个设置示例,在 Windows 上就能完全保护秘密吗?

仅靠这个设置示例是不够的。请确认测试版功能的支持情况、沙箱的方式(unelevated 不支持拒绝读取)、实际的设置层级、路径以及所运行的工具,并在使用前用虚拟文件确认拒绝是否生效。