必须设置CODEX_SANDBOX_NETWORK_DISABLED=1、CODEX_SANDBOX=seatbelt及OPENAI_API_KEY=""等环境变量,否则测试会触发真实API请求或因网络策略失败;需通过codex env inspect验证变量生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Codex在测试阶段隔离网络、禁用沙箱联网、跳过模型调用验证,必须显式设置专用环境变量,否则测试会意外触发真实API请求或因网络策略失败。
设置测试专用网络控制变量
测试时最常踩的坑是子进程仍尝试联网,导致测试超时或污染线上日志。必须强制禁用沙箱网络访问能力:
在终端中执行:
export CODEX_SANDBOX_NETWORK_DISABLED=1
这一步不可省略——Codex的测试框架(如core/tests)会主动检测该变量,若未设则直接跳过关键网络隔离逻辑,【所有依赖网络禁用的单元测试都会误判为通过】。
声明测试沙箱类型
macOS系统需额外指定沙箱机制,否则seatbelt沙箱不会启用,导致本地测试行为与CI环境不一致:
执行:
export CODEX_SANDBOX=seatbelt
该变量值必须严格为seatbelt,大小写敏感。Linux用户若使用landlock沙箱,此处应填landlock,但当前测试套件默认只识别seatbelt。
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI,等待编码任务完成,并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时,使用此功能。
覆盖模型调用路径(避免真实请求)
方法一:临时屏蔽模型端点
export OPENAI_BASE_URL="http://127.0.0.1:0"
方法二:注入空密钥强制认证失败
export OPENAI_API_KEY=""
【注意】不要同时设置OPENAI_API_KEY为空和OPENAI_BASE_URL为有效地址——Codex会优先校验密钥,空密钥导致后续URL被忽略,无法触发“连接拒绝”这一可预期的错误路径。
验证测试变量是否就位
第一步:检查变量是否已导出
echo $CODEX_SANDBOX_NETWORK_DISABLED $CODEX_SANDBOX $OPENAI_API_KEY
第二步:运行Codex内置环境检测命令
codex env inspect
第三步:确认输出中CODEX_SANDBOX_NETWORK_DISABLED状态为active且来源为profile,CODEX_SANDBOX值为seatbelt,OPENAI_API_KEY显示[hidden]而非[unset]。










