Codex config.toml 网络代理(HTTP_PROXY / NO_PROXY)与企业内网跳过局域网域名完整排障

在企业内网配置 Codex 时,经常遇到主程序连不上外部接口、子命令拉不到依赖,或者私有 GitLab 与内网源被误转发到出口代理导致超时。本文拆解环境变量、config.toml 子进程透传与 NO_PROXY 局域网直连排障方案。

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

结论先说

  1. 先分清「Codex 自身联网」与「子进程联网」两层配置。Codex 主进程连向 OpenAI 接口读取的是宿主机终端或系统的 HTTP_PROXY / HTTPS_PROXY / NO_PROXY 环境变量;而 Codex 内部启动的 git、npm、curl 等子命令是否拿到代理变量,由 config.toml 的 [shell_environment_policy] 决定。
  2. 沙箱内子命令连不上代理,先查 network_access。在 workspace-write 模式下,沙箱默认关闭子进程网络访问;即使宿主机配好了代理,没有开启 [sandbox_workspace_write] 里的 network_access = true(或在交互时审批放行),子命令依然无法连接本地或公司代理端口。
  3. 大小写变量建议成对设置,减少不同语言客户端的兼容差异。底层 Rust、Node.js、Go 与 curl 对大小写变量的优先级并不完全一致,同时声明 HTTP_PROXY、HTTPS_PROXY、NO_PROXY 及其小写形式最稳妥。
  4. NO_PROXY 必须显式包含环回地址与企业内部后缀。至少把 localhost,127.0.0.1,::1 以及公司内部域名后缀(如 .corp.internal)写进 NO_PROXY,避免本地调试端口和私有仓库被强行转发到出口代理触发 502 或握手挂死。
  5. 在企业环境长期稳定跑 Codex 排障与自动化构建需选好合适订阅档位。国内若无外币信用卡,可在本站自助开通 ChatGPT Plus 或高配额 ChatGPT Pro,团队多人统一部署也可查看 ChatGPT Business 团队定制。

Codex 代理生效的三层配置分工对比

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

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

适用于谁

  • 在公司办公网、研发专网或必须经过企业 HTTP/HTTPS 出口网关的电脑上运行 Codex CLI 与扩展的开发者;
  • 配完 HTTP_PROXY / HTTPS_PROXY 后发现 Codex 能对话,但沙箱里执行 npm、pip、git 拉内网源报错或超时,或者访问 localhost 本地服务被代理劫持的工程师;
  • 需要在不泄露其他敏感环境变量的前提下,通过 config.toml 把企业代理和 NO_PROXY 稳定注入子命令的研发团队。

一、三层链路拆解:为什么配了代理还是时好时坏

在企业内网排查 Codex 代理故障时,最常见的误区是「以为只要写进 config.toml 就能管所有流量」。实际请求分三层流转:

  1. 宿主机启动环境层(管 Codex 主进程):你在终端或 IDE 启动 Codex 之前导出的 HTTP_PROXY、HTTPS_PROXY、NO_PROXY 决定 Codex 本体如何访问外部模型接口,以及是否绕过局域网认证服务。
  2. [shell_environment_policy] 透传层(管子命令环境):如果为了安全你在 config.toml 里把 inherit 设成了 "core" 或 "none"(环境变量防泄露配置见 /guides/codex-shell-environment-policy-filter-secrets),代理变量会被顺手过滤掉,导致 Codex 本体能聊,但让它跑 git fetch 或 pip install 立刻超时。
  3. 沙箱网络层(管能否发包):即便子命令拿到了代理变量,默认 workspace-write 沙箱为了防外泄会拦截子进程出站连接(沙箱规则见 /guides/codex-permissions-sandbox),必须按需开启 network_access = true 或在策略里允许代理访问。

二、标准配置模板:宿主机环境变量 + config.toml

第 1 步:在宿主机终端配置出口代理与内网直连清单

macOS / Linux(写入 ~/.zshrc 或 ~/.bashrc):

bash
export HTTP_PROXY="http://proxy.corp.internal:8080"
export HTTPS_PROXY="http://proxy.corp.internal:8080"
export NO_PROXY="localhost,127.0.0.1,::1,.corp.internal,.local"

# 同步小写形式,避免部分工具只读小写变量
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export no_proxy="$NO_PROXY"

Windows PowerShell(当前会话生效,长期生效可写入 $PROFILE 或系统环境变量):

powershell
$env:HTTP_PROXY  = "http://proxy.corp.internal:8080"
$env:HTTPS_PROXY = "http://proxy.corp.internal:8080"
$env:NO_PROXY    = "localhost,127.0.0.1,::1,.corp.internal,.local"
$env:http_proxy  = $env:HTTP_PROXY
$env:https_proxy = $env:HTTPS_PROXY
$env:no_proxy    = $env:NO_PROXY

第 2 步:在 ~/.codex/config.toml 中精确透传或注入代理变量

如果环境策略收紧了变量继承,可以通过 [shell_environment_policy.set] 明确把代理与内网跳过名单注入子进程,同时按需打开工作区沙箱网络开关(配置文件总览见 /guides/codex-config-toml-complete-guide):

toml
#:schema https://developers.openai.com/codex/config-schema.json

sandbox_mode = "workspace-write"
approval_policy = "on-request"

[sandbox_workspace_write]
# 若沙箱内命令需要通过企业代理拉取依赖,须显式开启
network_access = true

[shell_environment_policy]
inherit = "core"

[shell_environment_policy.set]
HTTP_PROXY = "http://proxy.corp.internal:8080"
HTTPS_PROXY = "http://proxy.corp.internal:8080"
NO_PROXY = "localhost,127.0.0.1,::1,.corp.internal,.local"
http_proxy = "http://proxy.corp.internal:8080"
https_proxy = "http://proxy.corp.internal:8080"
no_proxy = "localhost,127.0.0.1,::1,.corp.internal,.local"

注意:[shell_environment_policy.set] 是键值对表,用于给 Codex 启动的子进程注入明确变量;不要在里面写入代理账号的明文高危口令,带鉴权的企业代理更推荐借助本机认证代理服务转发。

订阅与账号准备提示:在企业内网调试多仓依赖、反复重跑联调脚本时,高频率长上下文对话更容易触发周期额度上限(额度规则见 /guides/codex-usage-limits)。若团队或重度开发者需要更高配额,可在本站开通 ChatGPT Pro 充值 或 ChatGPT Pro 20x 高额度档;新注册 OpenAI 账号在手机号环节受阻时,可参考 Codex 注册手机验证服务。

三、常见企业代理与 NO_PROXY 故障分流排查

配完后若仍报错、卡死或私有源无法直连,请按下面分流图逐项定位:

企业代理与内网跳过域名排障分流图

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

  1. 访问内网 GitLab、私服 npm 或本地 127.0.0.1 返回 502 / 403。这是典型的 NO_PROXY 漏配或语法不兼容:切忌在逗号后加空格(写成 localhost, 127.0.0.1 会导致第二项失效),也不要滥用 *.corp.internal 星号通配符,优先使用前置点号 .corp.internal 与精确主机名;如果用到局域网 IP 段(如 10.x.x.x),部分工具不支持 CIDR 网段匹配,需补齐关键服务器具体 IP 或内网域名(本站建议)。
  2. 报错 UNABLE_TO_VERIFY_LEAF_SIGNATURE 或 self-signed certificate in certificate chain。这说明企业出口网关启用了 TLS 流量解密重签(如 Zscaler、Netskope 或公司自建代理),代理链路本身已通,但 Codex 尚未信任公司根证书。请导入企业 CA 证书并配置 NODE_EXTRA_CA_CERTS / CODEX_CA_CERTIFICATE(完整步骤参考 /guides/codex-corporate-proxy-tls-self-signed-cert-ca-fix)。
  3. 终端里 codex 正常,但 VS Code 里的 Codex 扩展卡住超时。图形界面直接点击图标启动的 VS Code 往往不会读取 ~/.zshrc 里的 export 代理变量,导致后台扩展卡在代理握手。可尝试从已导出变量的终端执行 code . 启动,或在 VS Code 设置中同步检查 http.proxy 与 http.noProxy(更多错误汇总见 /guides/codex-common-errors-summary)。
  4. 本地测试命令一键验证是否命中预期路由。排查 NO_PROXY 时,可直接在同终端运行 curl -v https://你的内网域名 观察输出里是否出现 Uses proxy env variable no_proxy,确认路由正确后再启动 Codex,能省掉大量盲猜时间。

常见问题

问:只在 config.toml 的 [shell_environment_policy.set] 里写了 HTTPS_PROXY,为什么启动 Codex 自己还是连不上网?

答:[shell_environment_policy] 控制的是 Codex 启动「下级子命令」时的环境变量,不作用于 Codex 主进程自身发起的模型接口连接。Codex 本身需要走企业代理时,必须在启动它的终端或操作系统环境变量里配置 HTTP_PROXY / HTTPS_PROXY / NO_PROXY。

问:开启 [sandbox_workspace_write] 的 network_access = true 会带来什么风险?

答:打开后,沙箱内执行的命令就能对外发起网络连接。如果仓库本身不可信或包含陌生构建脚本,可能存在外传数据的风险;本站建议仅在受信任的企业内部项目里开启,同时配合 [shell_environment_policy] 过滤掉无关云密钥与 Token 变量。

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

答:可在本站 AI 会员充值总览 按需选购 ChatGPT Plus、ChatGPT Plus 官网直充 或高配额的 ChatGPT Pro,团队多人统一部署可直接查看 ChatGPT Business 团队定制。支持支付宝、微信支付与 AlipayHK,自助兑换无需交出账号密码,并可开具增值税发票;实时价格以商品页展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围的政策。

相关教程

参考资料

  • OpenAI Developers 文档:Codex Configuration Reference — https://developers.openai.com/codex/config-reference
  • OpenAI Codex 官方文档:Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
  • OpenAI Codex 官方文档:Sandboxing — https://learn.chatgpt.com/docs/sandboxing
  • OpenAI Codex GitHub 仓库 — https://github.com/openai/codex

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 条评论

登录 后参与评论

还没有评论,来抢沙发~