Codex codex sandbox 本地沙箱演练命令教程:在 macOS Seatbelt / Linux Bubblewrap 里测试权限放行

担心 Codex 自动执行命令误删仓库外文件,或构建脚本莫名报 Operation not permitted?本文讲清 codex sandbox macos/linux 本地沙箱演练命令,手把手在 Seatbelt 与 Bubblewrap 中验证写权限、外网拦截与配置放行。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. codex sandbox 是无需调用模型的本地沙箱演练入口。你可以直接用 codex sandbox macos -- <命令> 或 codex sandbox linux -- <命令>,把任意 Shell 命令套进与 Codex 运行时完全一致的系统沙箱里验证放行与拦截结果。
  2. 两大桌面与服务器平台均走操作系统原生隔离,不依赖重型 Docker。macOS 底层调用 Apple Seatbelt(sandbox-exec),Linux 底层调用 Bubblewrap(bwrap)与 seccomp 规则,启动开销极低且由内核强制执行。
  3. 默认工作区模式下,项目内可写但关键目录与外网仍受保护。即便启用 workspace-write,仓库里的 .git、.codex 以及家目录里的凭证目录仍默认受保护,且直接外网连接默认阻断。
  4. 先演练命令再调配置,能快速分清「规则拦的」还是「宿主环境不兼容」。比如 macOS 无法在已有 Seatbelt 内再嵌套沙箱,Linux 宿主机若禁用了非特权用户命名空间也会导致 bwrap 启动失败。
  5. 在沙箱边界调试稳定后放手让 Codex 批量跑测试与重构会显著提升使用频率。国内无外币卡的用户可在本站开通 ChatGPT Plus 或高配额的 ChatGPT Pro,团队多人研发可了解 ChatGPT Business 团队定制。

macOS Seatbelt 与 Linux Bubblewrap 沙箱机制对比

图:本站根据 OpenAI Codex 官方文档:Sandboxing 整理的示意图

本文根据 OpenAI Codex 官方文档《Sandboxing》《Approvals & security》《Command line options》整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。

适用于谁

  • 在给 Codex 放开工作区写权限前,想先亲自验证沙箱边界是否真能拦住越界写入与外网请求的开发者;
  • 遇到构建、单测或包管理器在 Codex 里报 Operation not permitted、Read-only file system,想脱离开会话直接复现定位的人;
  • 在 macOS 或 Linux(含 Ubuntu、WSL2、CI 容器)上维护团队 config.toml 安全策略的研发负责人。

一、为什么要先用 codex sandbox 做本地演练

平时在 Codex 会话里跑构建报错时,往往很难一眼分辨到底是模型命令写错了、代码本身有问题,还是被 Codex 沙箱挡住了。codex sandbox 把隔离层单独拆出来供人工直接测试,既不消耗任何模型额度,也能在几秒内验证 config.toml 里的权限改动是否生效(完整权限层级说明见 /guides/codex-permissions-sandbox)。

两大平台的底层机制与典型约束如下:

维度macOS(Seatbelt)Linux(Bubblewrap + seccomp)
演练子命令codex sandbox macos -- <cmd>codex sandbox linux -- <cmd>
底层实现系统原生 Apple Seatbelt(sandbox-exec)非特权命名空间 bwrap + seccomp 过滤
默认写入范围当前工作区及临时目录,.git/.codex 受保护当前工作区及临时目录,.git/.codex 受保护
默认网络策略禁止直接发起外网连接禁止直接发起外网连接
常见宿主限制不支持在已有 Seatbelt 沙箱内再次嵌套宿主机或容器禁用非特权 userns 时会失败

如果你使用 Windows 本地终端而非 WSL2,沙箱底层会走 Windows 限制令牌机制,常见初始化报错可直接参阅 /guides/codex-windows-sandbox-setup-failed。

二、三组安全演练命令:逐项测清文件与网络边界

运行前可先执行 codex sandbox --help 核对当前版本支持的参数(旧版本里曾使用过 --full-auto 快捷项,较新版本推荐配合 -c sandbox_mode=... 显式指定)。下面三组命令均在普通测试项目根目录运行即可。

演练 1:验证只读模式与工作区写入边界

先在默认或只读模式下试着在项目内与家目录创建空文件,观察内核返回是否符合预期:

bash
# macOS 示例:只读沙箱下写入当前目录应被拒绝
codex sandbox macos -c sandbox_mode="read-only" -- touch ./probe-ro.tmp

# macOS 示例:切到 workspace-write 后,当前目录可写,但家目录仍应被拦
codex sandbox macos -c sandbox_mode="workspace-write" -- sh -c 'touch ./probe-ok.tmp && touch ~/.codex/probe-block.tmp'

Linux(含 WSL2)把子命令里的 macos 换成 linux 即可:

bash
codex sandbox linux -c sandbox_mode="workspace-write" -- sh -c 'touch ./probe-ok.tmp && touch ~/.codex/probe-block.tmp'

理想结果是 ./probe-ok.tmp 创建成功,而试图写入 ~/.codex/ 或仓库内 .git/ 时立刻报 Operation not permitted 或 Read-only file system。演练完记得删掉测试产生的 probe-ok.tmp。

演练 2:验证默认断网与按需放行网络

默认沙箱会拦截外网请求以降低数据外泄风险,用一次轻量请求即可验证:

bash
# 默认断网状态下,外网探测应失败
codex sandbox linux -c sandbox_mode="workspace-write" -- curl -I --max-time 5 https://example.com

# 若确需放行构建依赖下载,可演练开启工作区网络配置项
codex sandbox linux -c sandbox_mode="workspace-write" -c sandbox_workspace_write.network_access=true -- curl -I --max-time 5 https://example.com

有关为何默认关闭网络以及在什么条件下才建议放开,可进一步阅读 /guides/codex-sandbox-network-access-disabled-fix。

演练 3:提前预检项目构建与单测工具链

很多前端或后端项目在沙箱里跑测试失败,并非需要外网,而是工具链试图把缓存写进工作区外的 ~/.cache、~/.npm 或系统目录。直接把你项目的真实命令塞进演练入口跑一遍就能瞬间暴露路径依赖:

bash
codex sandbox macos -c sandbox_mode="workspace-write" -- npm test
codex sandbox linux -c sandbox_mode="workspace-write" -- pytest -q

若发现某个工具只是缓存目录不可写,通过环境变量(如 NPM_CONFIG_CACHE=./.tmp-npm-cache)把缓存重定向到当前工作区或 /tmp,即可在不放宽全局安全边界的前提下顺畅运行。

订阅与账号准备提示:把沙箱策略和工具链缓存一次调顺后,日常用 Codex 自动跑单测、修编译错误会非常流畅,同时也更容易用满基础档配额。重度开发者可在本站升级 ChatGPT Pro 充值 或选用 ChatGPT Pro 5x iOS 可覆盖档;若新注册账号遇到短信验证码收不到,可先查看 Codex 注册手机验证服务。

三、演练报错分诊:规则拦截 vs 宿主环境受限

沙箱演练常见报错分诊与处理

图:本站根据 OpenAI Codex 官方文档:Approvals & security 整理的示意图

在演练阶段看到报错时,不要急着切到 danger-full-access 关闭全部保护,先对照以下情形做最小调整:

  • 写入项目外目录或 .git 被拒:这正是沙箱正常工作的表现。若业务确实需要跨目录改动,应把额外目录显式加入工作区或重定向缓存路径,而不是关闭整个沙箱。
  • Linux 容器或精简发行版里 bwrap 报命名空间权限错误:多因 Docker 默认禁用了非特权 userns 或宿主机 AppArmor 策略收紧。若运行在一次性可销毁容器内,由容器本身承担隔离边界后再评估策略;宿主机开发则应检查是否安装了 bubblewrap 及内核 userns 开关。
  • macOS 终端嵌套在其他沙箱工具中启动失败:Apple Seatbelt 不支持沙箱套沙箱。把外层多余的沙箱包装移除,或在标准终端里直接运行 codex sandbox macos 即可恢复正常。
  • 需要把验证好的参数长期固化:确认演练通过后,将对应的 sandbox_mode 与 [sandbox_workspace_write] 片段写入 ~/.codex/config.toml(写法见 /guides/codex-config-toml-complete-guide)。

常见问题

问:运行 codex sandbox 演练命令会消耗我的 Codex 或 ChatGPT 订阅额度吗?

答:不会。codex sandbox 只在本地拉起 Codex 内置的操作系统沙箱包装器并直接执行你传入的 Shell 命令,不发起模型推理请求,因此可以反复免费试错直到权限策略完全合身。

问:为什么我开启了 workspace-write,在仓库里改 .git/config 还是被拦截?

答:按 OpenAI 官方安全设计,即便在工作区可写模式下,.git、.codex 等高敏感元数据目录仍默认设为只读保护,防止代理在未经确认的情况下篡改 Git 钩子、远端地址或 Codex 自身安全配置。

问:国内没有外币信用卡,或研发团队需要开增值税发票报销,怎么开通跑 Codex CLI 的订阅?

答:可通过本站 AI 会员充值总览 办理 ChatGPT Plus 卡密自助兑换 或高配额 ChatGPT Pro,多人研发团队可直接选择 ChatGPT Business 团队定制。支持支付宝、微信支付及 AlipayHK 付款,无需交出账号密码,可开具增值税发票;实时价格以商品页展示为准,售后遵循掉订阅按剩余天数折退、封号不在质保范围的规则。

相关教程

参考资料

  • OpenAI Codex 官方文档:Sandboxing — https://learn.chatgpt.com/docs/sandboxing
  • OpenAI Codex 官方文档:Approvals & security — https://learn.chatgpt.com/docs/agent-approvals-security
  • OpenAI Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 整理家庭装修预算明细、隐蔽工程验收清单与主材优缺点对比表实战

    第一次装修面对几十页施工报价单、密密麻麻的水电防水隐蔽项目与五花八门的主材参数,极易踩坑增项。本文梳理用 ChatGPT 审查装修报价漏项、生成带公式的预算明细表、定制工地隐蔽工程验收单与主材对比表的实战提示词。

    ChatGPT0
  2. 02

    用 ChatGPT 做费曼学习法读书共读:反向追问检验自己是否真读懂专业书籍与整理书单笔记

    读完一本专业硬书常感觉「合上书就忘」,直接让 AI 概括全书又容易产生懂了的错觉。本文介绍用 ChatGPT 结合 Study Mode 与费曼学习法做反向追问共读,通过通俗复述、挑刺盲区到沉淀书单卡片的完整流程与提示词。

    ChatGPT0
  3. 03

    用 ChatGPT 做外贸产品多语种目录、展会邀约与客户跟进节奏表(附脱敏与本地化提示词)

    做外贸展会与海外推广时,手工翻译十几款产品目录费时且容易留下一堆中式英文,展后客户跟进也常缺节奏。本文梳理用 ChatGPT 先脱敏建术语库、再批量产出多语种目录、展前邀约函与展后 21 天跟进节奏表的实战流程与提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写高质量技术专栏文章、开源项目 Release Notes 与版本更新日志实战

    让 AI 直接凭空写技术文章容易满篇空洞套话,直接甩 Git 记录写更新日志又常常漏掉破坏性变更。本文整理用 ChatGPT 结合真实代码片段、压测数据与 PR 摘要,高效产出深度技术专栏、GitHub Release Notes 与 CHANGELOG 的实战工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做产品用户访谈纪要编码、提炼高频痛点需求池与 RICE 优先级打分实战

    手头攒了十几份用户访谈逐字稿,手工贴便利贴归纳痛点耗时又容易带入主观偏见。本文分享用 ChatGPT 完成脱敏检查、逐份开放式编码、跨样本聚类高频痛点并搭建 RICE 优先级打分表的 5 步实战流,附可直接复制的三段核心提示词。

    ChatGPT0
  6. 06

    ChatGPT 网页版上传超过 10 个文件或回形针附件按钮变灰怎么办:打包合并与配额限制排查

    在 ChatGPT 网页版批量分析文档时,常遇到一次选超 10 个文件被拦截或输入框回形针按钮变灰。本文依据 OpenAI 文件上传与存储说明,梳理 6 类常见报错的分流排查法,提供 ZIP 打包、本地合并与 Projects 复用方案及可直接复制的解包提示词。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~