结论先说
- 报错根因是 Codex 沙箱默认阻断子进程网络访问。官方并未单独收录每一种包管理器的
ENOTFOUND文案,但沙箱文档明确说明:read-only与默认的workspace-write沙箱均关闭外部网络,防止被注入的提示词外传源码或密钥。 - 临时单次放行最安全。只在确实要装依赖的那次会话加上
-c sandbox_workspace_write.network_access=true参数,装完即回到默认断网状态。 - 长期放行可改
~/.codex/config.toml。在[sandbox_workspace_write]段落显式写入network_access = true,并搭配审批策略(approval_policy = "on-request")守住人工确认关口。 - 只查文档不装包时,用
--search而非开沙箱网络。codex --search让模型调用受控网页搜索工具查 API 用法,无需给本地 Shell 放开公网套接字。 - 排查环境故障的同时需确保订阅状态正常。国内无外币卡的用户可在本站自助开通 ChatGPT Plus 或高配额 ChatGPT Pro,研发团队统一管理可了解 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方仓库与配置文档 整理的示意图
本文根据 OpenAI Codex 官方文档《Codex CLI》《Command line options》与官方 GitHub 仓库沙箱说明整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 让 Codex 执行
npm install、pnpm add、pip install、cargo build或curl时遇到Network access is disabled、getaddrinfo ENOTFOUND、Temporary failure in name resolution报错的开发者; - 想知道怎么在保留目录写入保护的前提下,安全放开 Codex 沙箱联网权限的人;
- 分不清「沙箱 Shell 网络开关」与「Codex
--search网页搜索工具」区别的用户。
一、三种沙箱模式的默认网络行为对比
Codex 在操作系统层面对其派生的 Shell 命令实施隔离(Windows 沙箱初始化故障见 /guides/codex-windows-sandbox-setup-failed)。三种模式对比如下:

图:本站根据 OpenAI Codex 官方文档:Codex CLI 整理的示意图
沙箱模式(--sandbox) | 文件系统写入边界 | 默认网络状态 | 推荐场景 |
|---|---|---|---|
read-only | 全部目录只读 | 禁用网络 | 代码走查、架构问答、静态日志排查 |
workspace-write | 仅当前工作区及临时目录可写 | 默认禁用,可配置开启 | 日常编码、跑本地单元测试、按需拉取依赖 |
danger-full-access | 无沙箱文件限制 | 完全放开 | 仅限一次性 Docker 容器或隔离云主机内运行 |
不建议为了装一个 npm 包直接切到 danger-full-access,那会同时失去工作区外系统目录的防误删保护。
二、两种合规放行网络的实操配置
方法 1:命令行单次临时开启(推荐)
需要让 Codex 拉取依赖或请求测试接口时,在启动命令里用 -c 覆盖配置项:
bash
codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true
若在非交互脚本 codex exec 里运行同理:
bash
codex exec --sandbox workspace-write \
-c sandbox_workspace_write.network_access=true \
"升级 package.json 中的 vitest 并重新安装锁文件,跑通单元测试。"
方法 2:写入 ~/.codex/config.toml 持久生效
如果日常项目频繁需要在线拉取模块,可编辑用户目录下的 ~/.codex/config.toml:
toml
sandbox_mode = "workspace-write"
approval_policy = "on-request"
[sandbox_workspace_write]
network_access = true
保存后新开会话,用斜杠命令 /status 或 /debug-config 检查当前生效的沙箱配置。若命令仍被自动审核拦截,可对照 /guides/codex-auto-review-denied-command 处理。
订阅与账号准备提示:放通依赖安装并让 Codex 自动跑多轮构建修复,往往比纯问答消耗更多推理额度。若 Plus 额度吃紧,可在本站升级 ChatGPT Pro 充值 或选购 ChatGPT Pro 5x iOS 可覆盖档;新号首次登录遇到手机验证拦截也可使用 Codex 注册手机验证服务。
三、放开网络后的安全边界与后续排错
- 防范提示词注入外传秘密:一旦开启
network_access = true,子进程就能对外发起 HTTP 请求。切勿在未开启人工审批(approval_policy)的情况下,让开启网络的 Codex 直接分析来源不明的第三方 Issue 或外部网页文本,防止.env中的凭证被外带。 - 开启后仍报证书或环境变量缺失:部分公司内网依赖私有 NPM/PyPI 源及自定义根证书(如
NODE_EXTRA_CA_CERTS)。若子进程读不到对应变量,请按 /guides/codex-missing-environment-variable 配置环境透传。 - 区分 Codex 自身连接中断与子进程断网:若报错是
stream disconnected before completion而非 Shell 命令里的ENOTFOUND,说明是 CLI 到 OpenAI 服务端的会话断连,应按 /guides/codex-common-errors-summary 排查。
常见问题
问:我已经提前在终端外装好了 node_modules,为什么 Codex 跑 npm test 还是报网络错?
答:检查测试代码里是否发起了真实外部 HTTP 请求,或包管理器脚本(如 pretest、Corepack 自动下载指定版本包管理器)尝试联网校验版本。在测试里 Mock 外部接口或预先缓存 Corepack 二进制即可离线跑通。
问:在交互会话中途能用 /permissions 切换权限吗?
答:可以。在 Codex CLI 交互界面输入 /permissions 可调整当前会话允许执行的动作级别;涉及 config.toml 底层的 network_access 变动则建议重开会话并用 /status 核实。
问:国内没有外币信用卡,或者公司需要开具增值税发票,怎么开通 Codex 所需的会员?
答:可通过本站 AI 会员充值总览 选购 ChatGPT Plus 或 ChatGPT Pro,支持支付宝、微信支付及 AlipayHK 付款,提供免交密码的卡密自助兑换与企业定制,支持开具增值税发票。实时价格以页面为准;售后遵循掉订阅按剩余天数折退、封号不在质保范围的规则。
相关教程
参考资料
- OpenAI Codex 官方文档:Codex CLI — https://learn.chatgpt.com/docs/codex/cli
- OpenAI Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands
- OpenAI Codex 官方 GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~