OpenAI

Codex

OpenAI 的编程代理：终端中的 Codex CLI 与云端任务

Codex 是 OpenAI 面向开发者的编程代理产品，包含运行在本地终端的 Codex CLI、ChatGPT 中的云端 Codex 任务以及 IDE 扩展。它可以读取代码仓库、修改文件、运行测试并提交变更。本专题整理 Codex CLI 的安装与登录、开发环境中的代理配置、网络环境要求，以及「stream disconnected」「unable to connect」等常见错误的排查方法。

Codex 官网常见错误排查 Codex 机场推荐

专题更新于 2026年11月3日

Codex 是什么

Codex 是 OpenAI 推出的编程代理产品系列。Codex CLI 是一个开源的命令行工具，在本地终端中运行，可以读取当前目录下的代码，根据自然语言指令生成与修改文件、执行命令，并按照不同的审批模式决定哪些操作需要用户确认。

除了 CLI，Codex 还以云端形式集成在 ChatGPT 中：用户把任务交给云端 Codex，它会在隔离的沙箱里克隆仓库、执行任务并产出可审阅的变更。另有 IDE 扩展把类似能力带到编辑器中。使用 Codex 通常需要 ChatGPT 付费订阅或 API Key。

Codex CLI 对网络的要求与 Claude Code 类似：长时间的流式连接必须保持稳定，节点抖动会直接导致任务中断。相关测试见 Codex 机场推荐与 Codex 的网络环境要求。

开发者：OpenAI
形态：Codex CLI（终端）、ChatGPT 内的云端 Codex、IDE 扩展
登录方式：ChatGPT 账号或 OpenAI API Key

快速开始

1
准备 Node.js 与代理
安装 Node.js LTS，在终端设置 HTTPS_PROXY 指向客户端本地端口，或开启 TUN 模式，并用 curl 验证 api.openai.com 可达。
2
安装 Codex CLI
执行 npm install -g @openai/codex，完成后用 codex --version 确认。
3
登录
在项目目录运行 codex，按提示用 ChatGPT 账号登录或输入 API Key。
4
发起第一个任务
描述一个小改动，查看 Codex 展示的计划与 diff，确认后让它执行并运行测试。
5
固定网络环境
记录当前表现稳定的节点，后续长任务固定使用，避免中途切换。

开发环境

Codex CLI 依赖 Node.js 与 npm。安装前建议先用 node -v 与 npm -v 确认版本，Windows 用户推荐在 WSL 中安装以获得更接近 Linux 的体验。

代理方面，推荐把 HTTPS_PROXY 写入 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc），或者使用客户端的 TUN 模式。使用 API Key 登录时，把 OPENAI_API_KEY 设置为环境变量即可，不要写入仓库文件。

若使用 Docker 或 CI 环境运行 Codex，需要在容器内同样设置代理环境变量，并确认容器能访问宿主机的代理端口。更多命令行细节见 Codex CLI 入门。

安装：npm install -g @openai/codex
登录：运行 codex 后选择 ChatGPT 账号登录，或设置 OPENAI_API_KEY
验证代理：curl -I https://api.openai.com
配置目录：~/.codex，项目说明文件：AGENTS.md

Codex 使用指南

Codex CLI 基础

Codex CLI 通过 npm 安装：npm install -g @openai/codex。安装完成后在项目目录运行 codex 即可进入交互模式，首次运行会提示使用 ChatGPT 账号登录或输入 API Key。

交互模式下直接输入任务描述，Codex 会展示它计划执行的修改与命令。审批模式决定了它的自主程度：默认模式下写文件与执行命令需要确认，可以按需调整为更宽松或更严格的模式。

常用用法包括：codex 进入交互模式；codex "描述任务" 直接执行一次性任务；在会话中用斜杠命令查看帮助、切换模型或管理会话。

在 Git 仓库根目录启动，便于 Codex 理解项目结构并产生可审阅的 diff
用 AGENTS.md 记录项目约定与测试命令，Codex 会在执行前读取
首次使用建议保持默认审批模式，熟悉后再放宽

开发环境配置

Codex CLI 需要 Node.js 环境（建议使用最新的 LTS 版本），支持 macOS、Linux 与 Windows（Windows 下推荐在 WSL 中使用）。安装后用 codex --version 确认版本。

终端发起的请求不会自动使用浏览器代理，需要在 shell 中设置 HTTPS_PROXY 与 HTTP_PROXY 指向客户端的本地端口，或者在客户端中开启 TUN 模式。设置完成后可以用 curl -I https://api.openai.com 验证连通性。

Codex 的配置文件位于用户目录下的 .codex 文件夹，可以在其中设置默认模型、审批模式与其他参数；项目级别的说明放在仓库中的 AGENTS.md。

macOS / Linux：export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890
Windows PowerShell：$env:HTTPS_PROXY = "http://127.0.0.1:7890"
WSL 中的代理地址需指向 Windows 主机，而不是 127.0.0.1，除非客户端开启了允许局域网连接并使用镜像网络
验证：curl -I https://api.openai.com 返回 HTTP 状态码即表示代理生效

云端 Codex 与 IDE 扩展

在 ChatGPT 中打开 Codex 后，可以连接 GitHub 仓库并发起任务。云端 Codex 在沙箱中执行，不依赖本地网络的稳定性，适合在本地线路不佳时使用；任务完成后可以查看 diff 并创建 PR。

IDE 扩展提供与 CLI 相近的能力，登录方式相同，代理设置通常跟随 IDE 或系统代理。

进阶技巧

复杂任务先让 Codex 输出计划并确认，再逐步执行；每完成一个阶段就提交一次 Git，便于回退。长任务前切换到延迟低、丢包为零的节点，并避免中途切换。

如果本地线路经常断流，可以把耗时长的任务交给云端 Codex，把本地 CLI 用于需要快速反馈的小改动。

使用教程Codex 教程

Codex CLI 代理设置：终端环境变量、TUN 模式与常见坑

Codex 使用教程之代理篇：浏览器能开 ChatGPT 但 Codex CLI 连接失败，多半是终端没有走代理。本文给出 Windows PowerShell 与 macOS/Linux 两组环境变量写法、TUN 模式开启步骤、验证命令与常见坑对照表，并说明选 Codex 稳定机场时要看什么。

2026年10月23日5 分钟

使用教程Codex 教程

Codex 云端版与 Codex CLI 有什么区别？该用哪个

Codex 有云端版与 CLI 两种形态：云端版在 OpenAI 托管的沙箱中运行、通过网页或 ChatGPT 分配任务，CLI 在本地终端运行、直接操作本机代码。本文从运行位置、网络要求、适用场景与机场配置四个维度对比，帮你选对入口。

2026年10月21日4 分钟

网络环境说明

Codex CLI 对网络的核心要求是连接的持续性。每次任务都会建立一个流式响应连接，持续数十秒到数十分钟，期间任何一次 TCP 重置都会表现为「stream disconnected」或任务中断。因此延迟并不是最关键的指标，丢包率与节点稳定性才是。

此外，出口 IP 仍需在 OpenAI 的支持范围内，且质量不能太差，否则登录阶段就会失败。站内测试中 IEPL / IPLC 专线在长任务上的完成率明显高于普通中转，详细数据见 AI 稳定机场的评估指标。

优先选择丢包为零、晚高峰稳定的专线节点，延迟 100ms 以内即可
终端必须走代理：设置环境变量或开启 TUN 模式
运行期间不要切换节点或更新订阅
校园网、公司网络等弱网环境可尝试 Hysteria 2 等基于 UDP 的协议

品牌	Codex 兼容性	说明
宇宙云	稳定可用	美国节点长连接稳定，CLI 任务未出现中断
极连云	稳定可用	长会话稳定，偶有日本节点延迟上升
灯塔加速	稳定可用	美国 IPLC 长连接稳定

延伸阅读：AI 工具网络延迟与连接稳定性分析 · Codex 稳定机场与网络环境分析 · AI 稳定机场推荐：需要关注哪些网络指标

Codex 常见错误与处理

错误信息	通常含义	处理方法	详细
`stream disconnected before completion`	流式响应在完成前被中断，几乎都是节点抖动或代理连接被重置导致。	切换到丢包更低的专线节点后重新运行任务；检查客户端是否在任务期间更新了订阅。	查看
`unable to connect`	Codex CLI 无法建立到 api.openai.com 的连接，通常是终端未走代理。	设置 HTTPS_PROXY 环境变量或开启 TUN 模式，用 curl -I https://api.openai.com 验证。	查看
`ECONNRESET`	连接被对端重置，常见于节点不稳定或代理端口异常。	重试任务；反复出现时更换节点，并确认客户端没有同时运行多个代理程序。	查看
`ETIMEDOUT`	连接超时，可能是代理地址错误、DNS 解析失败或节点离线。	检查代理地址与端口，确认节点在客户端中可用，必要时更换 DNS。	查看
`401 Unauthorized`	登录状态失效或 API Key 无效。	重新运行 codex 登录，或检查 OPENAI_API_KEY 是否正确设置。	—
`429`	请求频率或用量超过限制，也可能是出口 IP 请求过多。	等待一段时间后重试；降低并行任务数，必要时更换共享人数少的节点。	—
`Something went wrong`	云端 Codex 或 ChatGPT 界面的通用错误，多数是请求传输中断。	刷新页面重试，若反复出现则切换节点并清除 Cookie。	查看

使用场景

本地仓库改造

在终端中让 Codex 读取项目、实现功能、修复 Bug 并运行测试。

云端并行任务

在 ChatGPT 中把多个任务分配给云端 Codex，各自在独立沙箱中执行并生成 PR。

代码审查与解释

让 Codex 审查变更、解释陌生代码库的结构与调用关系。

脚本与自动化

快速生成数据处理脚本、CI 配置与命令行工具。

IDE 内协作

通过 IDE 扩展在编辑器中直接发起任务与查看变更。

使用技巧

长任务前切换到专线节点，并在任务结束前不要切换
用 AGENTS.md 告诉 Codex 测试命令与代码规范，减少反复沟通
每完成一个阶段就提交 Git，断流后可以从提交点继续
本地线路不稳定时把耗时任务交给云端 Codex
把代理环境变量写入 shell 配置文件，避免每次手动设置
遇到网络错误先用 curl 验证 api.openai.com 是否可达，再排查客户端规则

Codex 常见问题

QCodex CLI 是免费的吗？

Codex CLI 本身开源，但调用模型需要 ChatGPT 付费订阅或 OpenAI API Key，用量按订阅额度或 API 计费，具体以 OpenAI 官方说明为准。

QCodex CLI 和 Claude Code 有什么区别？

两者都是终端中的编程代理，工作方式相似，分别使用 OpenAI 与 Anthropic 的模型。对网络的要求也相似，都需要稳定的长连接。

Q为什么任务总是中途断开？

最常见的原因是节点抖动导致流式连接被重置。更换为丢包为零的专线节点并在任务期间不切换节点，通常可以解决，详见 [Codex 的网络环境要求](/blog/codex-network-environment/)。

Q终端设置了代理但仍然连不上？

先用 curl -I https://api.openai.com 验证代理是否生效；WSL 用户要注意代理地址应指向 Windows 主机；也可以改用客户端的 TUN 模式。

Q哪些机场适合 Codex？

站内测试中 IEPL / IPLC 专线与提供长连接节点组的品牌表现最好，可参考 [Codex 机场推荐](/ai-airports/codex/) 的连接测试记录。

QWindows 上怎么用 Codex CLI？

推荐在 WSL 中安装 Node.js 与 Codex CLI；直接在 PowerShell 中也可以使用，设置代理时使用 $env:HTTPS_PROXY 语法。

Codex 相关文章

行业资讯AI 工具更新

2026 年 11 月 AI 工具与客户端更新汇总

整理 2026 年 10 月下旬至 11 月初 ChatGPT、Claude、Codex、Gemini 以及 Clash Verge Rev、Mihomo Party、sing-box 等客户端的公开更新方向。本汇总整理自各产品公开更新说明，具体以官方为准，并附每项更新对网络环境的影响提示。

2026年11月5日 5 分钟入门

网络诊断连接超时

AI 流式输出中断怎么办：SSE 与 WebSocket 长连接超时排查

ChatGPT、Claude、Gemini 的回答输出到一半停住，Codex 或 Claude Code 跑长任务时报 Network error，本质是 SSE 或 WebSocket 长连接被中途切断。本文解释长连接为什么比普通网页脆弱，给出五个常见断点的判断方法，以及固定节点、调策略组、排除代理缓冲的处理步骤。

2026年10月28日 5 分钟进阶

AI 机场推荐AI 工具兼容性评测精选

AI 工具网络延迟与连接稳定性分析

分析 ChatGPT、Claude、Codex、Gemini 为什么对丢包与抖动格外敏感：流式输出依赖 SSE 与 WebSocket 长连接，延迟本身不是主因，稳定性才是。附各工具连接模式对比表与 ping、mtr、curl 计时测试方法，帮助定位 AI 工具连接超时与网络异常。

2026年10月28日 3 分钟进阶

使用教程Codex 教程

Codex CLI 代理设置：终端环境变量、TUN 模式与常见坑

2026年10月23日 5 分钟进阶

使用教程Codex 教程

Codex 云端版与 Codex CLI 有什么区别？该用哪个

2026年10月21日 4 分钟入门

使用教程Codex 教程

Codex 常见错误汇总：unable to connect、429、超时怎么处理

Codex 连接失败怎么办？本文汇总 Codex CLI 与云端版最常见的错误：unable to connect、fetch failed、ETIMEDOUT、401、429、stream disconnected 等，按网络、账号、本地环境三类给出原因与处理步骤，附可直接复制的验证命令与节点更换建议。

2026年10月19日 5 分钟进阶

AI 机场推荐Codex 机场推荐

Codex 稳定机场与网络环境分析

Codex CLI 运行在终端里，网络要求和浏览器完全不同：终端代理变量、TUN 模式、长连接保持与流式输出缺一不可。本文分析 Codex 稳定机场的判断标准，并给出可直接复制的代理配置。

2026年10月13日 4 分钟进阶

网络诊断AI 服务访问异常

Codex 连接失败怎么办？终端代理、长连接与 API 域名排查

Codex 连接失败分三种：CLI 启动就报 unable to connect、登录授权卡住、任务跑到一半 stream disconnected。本文把一次 Codex 请求拆成代理变量、DNS、TLS、API 域名、长连接五个环节，每个环节给一条可验证的命令，并说明 CLI、IDE 扩展与网页版的差别。

2026年10月12日 4 分钟进阶