OpenAI Codex沙箱是画在智能体周围的一道围栏,它决定Codex能改哪些文件、能不能联网,而不是它什么时候停下来问你。OpenAI在2026年11月详解Codex沙箱的文章中说明,新版沙箱不再依赖容器,改用操作系统原生机制隔离,默认只允许在当前工作区内读写,网络默认关闭,越界操作要先经过你的批准。
沙箱三档各能做什么
沙箱一共有三档。read-only是只读档,Codex只能看文件、做规划,改不了任何东西,适合先看一圈再决定。workspace-write是默认档,可以在当前工作区内读写文件、跑本地命令,是日常写代码的主力。danger-full-access等于把围栏整个拆掉,文件系统与网络都不再设限,只适合隔离好的CI环境或一次性容器。想中途换档不用退出重进,在会话里输入/permissions就能改,启动时也可以用--sandbox参数指定。--yolo会同时关掉沙箱与审批,官方明确不推荐,别拿它当日常配置。
审批与网络是另外两个开关
沙箱管的是"能不能",审批管的是"要不要先问你",两个开关要分开配。审批策略有on-request、never和更细的granular三档,默认的Auto预设就是workspace-write配on-request,工作区内直接动手,写到工作区外或要用网络时先问你。网络默认是关的,需要联网的任务要在[sandbox_workspace_write]下面把network_access打开,最好只对当次任务开,用完就关。如果只想多放开一两个目录,用writable_roots单独加白名单,比直接放开整档安全。官方文档还写明,.git、.codex这类目录即使在可写工作区里也保持只读。
给新手的一套默认配置
刚上手建议直接用默认的Auto预设,在~/.codex/config.toml里写上sandbox_mode = "workspace-write"和approval_policy = "on-request",再确认网络保持关闭。先在有git的仓库里用,改坏了能回滚。拿到陌生仓库先切read-only看一圈,确认没问题再放开写权限。跑CI这类无人值守任务,用read-only配never最稳妥。想对照官方的完整机制说明,可以看看本站的OpenAI详解Codex沙箱,写代码时如果还要拉队友一起做,也可以看看Cursor Projects多人协作的邀请方法。