Codex 权限与沙箱怎么选:确认提示、文件范围与运行失败

Codex 能回答问题,却不能修改文件或运行命令,先看权限与执行环境。沙箱规定命令能访问哪些资源,审批规定什么时候需要停下来确认。 二者一起决定任务可以自动推进到哪一步。

🎯 这篇要完成:权限与沙箱怎么选。 授权与当前任务相匹配。

权限与沙箱怎么选流程示意:看目标范围、读确认内容、验证结果;授权与当前任务相匹配

原创流程示意,帮助记住顺序;具体按钮、字段和条件以当前页面与本次订单为准。

一、按本次任务选择范围

桌面应用在输入区下方提供权限控制。当前官方说明中的菜单可能包括 Ask for approval、Approve for me、Full access 或自定义配置,实际选项取决于版本和管理策略。CLI 可以用 /permissions 打开权限选择。

如果只是理解项目,先要求它只检查和解释;需要修改时,把项目目录和目标文件说明清楚,再使用允许该范围编辑的设置。处理一个项目,通常不需要开放整个电脑。

官方配置中的几个概念如下:

配置概念含义
read-only以检查为主,不能直接编辑文件或运行命令而不经过批准
workspace-write可在工作区边界内编辑并运行常规命令
danger-full-access移除沙箱对文件和网络的限制
on-request越过边界时按需要请求确认
never不弹出审批请求,本身不等于解除全部沙箱限制

不要把“少询问”和“能访问任何文件”理解成同一件事。管理方强制的规则也不会因普通用户改菜单而失效。

二、确认提示先看操作和目标

看到请求时,检查它要读写哪个目录、运行什么命令、访问哪个服务,以及这是否属于你刚才的任务。说明不清楚时,让它补充用途和结果,再决定允许的范围。

需要访问另外一个目录,就授权那个必要位置;需要特定网络请求,就处理那项需求。不要为了消除一次提示,把所有目录与网络长期开放。

自动审批在可用时会评估特定请求,但不会把沙箱边界自动变成无限制。正常允许范围内的操作也不需要每一步都重新审批。

三、卡住时先分三类

在等确认: 查看是否有未处理的请求。模型停在确认点时,继续发“快一点”通常不能替代所需授权。

路径或权限不对: 核对当前项目目录、目标文件和系统用户是否有相应权限。应用看到的是另一个文件夹时,先纠正项目位置;单位管理目录由管理员处理。

执行环境出错: 如果出现 SandboxError、helper_failed 等,记录具体错误。只有错误文字还不能确定根因,更不能直接修改整盘权限。

四、Windows 特别注意

Windows 原生 PowerShell 使用 Windows 沙箱,WSL2 使用 Linux 沙箱。终端选择和代理执行环境是不同设置;官方说明切换应用的代理执行环境到 WSL 后需要重启应用。

如果初始化失败,先收集客户端版本、执行环境、错误代码和日志的脱敏片段,按AI 排错指南定位。需要系统管理权限或单位策略变更时,交给管理员核对,不把“始终以管理员运行”当成每个问题的默认答案。

五、用实际文件验收

让 Codex 在明确允许的练习目录做一个小改动,再检查目标文件、命令结果和差异。如果操作成功但改错了路径,也不能算完成。确定边界后,再继续原任务。

新手首次打开项目的完整步骤见桌面端入门;长任务的需求与检查点见上下文管理。

实际操作中,容易弄错的地方

看到确认框时,先看它要做什么

“读取一个项目文件”和“执行安装命令、访问网络、修改项目外路径”不是同一种操作。确认提示应当能和你刚才要求的任务对应上;看不懂时先让工具说明目标和影响。

如果命令因为权限或沙箱限制失败,先核对工作目录、文件范围、环境配置和实际需要的能力。不要仅为了让错误消失就长期开放全部目录与所有操作。

授权成功后仍要检查任务结果与文件差异。通过了一个确认框,只说明允许那次操作,不代表功能已完成或以后所有命令都应该被允许。

多人项目里的批准策略可能由组织配置决定;与管理员核对,不用个人教程去改写组织的安全规则。

小锅提醒:全放开不是排错捷径

💡 小锅提醒:全放开不是排错捷径。

完成前,再做一次小检查

  • ✅ 当前账号、订单或项目,就是这次要操作的对象。

  • ✅ 操作已经按页面确认,结果符合“授权与当前任务相匹配”。

  • 🔎 如果仍有报错,保留本次完整提示,再去对应排查入口;敏感凭据先遮挡。

参考:官方沙箱与审批说明、Windows 执行环境、CLI 权限命令。