Codex 国内网络怎么用：安装、登录与下载排错

截至 2026 年 9 月 23 日抓取时，Codex 官方仓库已提供 CLI、IDE、桌面端和 Web 四条入口；下面按“下载—安装—登录—排错”处理。安装路径依据 OpenAI 官方仓库；报错原文与状态记录来自社区整理，不能据此推断中国大陆一定可用。本文只采用官方公布的安装和网络回退方式，不提供绕过地区或服务限制的方法。

开始前：先确认账号与网络条件

先完成下面三项，任何一项不满足都可能卡在登录或下载阶段：

1. 准备可用账号：注册 ChatGPT，并确认账号所在地区符合 OpenAI 当前服务条款。官方仓库推荐使用 Plus、Pro、Business、Edu 或 Enterprise 计划登录 Codex，但未在这些入口中统一公布免费额度，也没有承诺中国大陆所有地区均可直接使用。
2. 打开官方入口：浏览器依次打开 ChatGPT Codex 和 OpenAI Codex 官方仓库。前者用于云端 Codex，后者用于安装 CLI；两者打不开时，先处理当前网络与账号地区问题，不要反复运行安装命令。
3. 确认系统与安装方式：macOS、Linux 可用官方脚本或包管理器；Windows 可用官方 PowerShell 脚本或 npm。已经使用 npm 的用户不必再执行脚本安装，避免同一台电脑出现多份版本。

安装：按系统选择一种方式

macOS 或 Linux 的官方脚本安装命令如下：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows 的官方 PowerShell 安装命令如下：

powershell -ExecutionPolicy ByPass -c " irm https://chatgpt.com/codex/install.ps1 | iex "

这两条命令会调用官方安装脚本。独立安装器默认从 releases.openai.com 下载文件；如果元数据或安装包下载失败，官方脚本会回退到 GitHub Releases。这个回退机制很关键：安装失败不等于必须改用非官方安装器。

macOS 用户也可以使用 Homebrew：

brew install --cask codex

已经配置 Node.js 和 npm 的跨平台用户可以安装 npm 包：

npm install -g @openai/codex

三种方式不要同时使用。官方仓库给出的选择逻辑是：没有包管理器时使用脚本；已有 npm 或 Homebrew 时直接走包管理器；希望明确从 GitHub Releases 获取文件时，可查看仓库中的 Releases 页面。

下载卡住：先分清是哪一段失败

Codex 的下载链路不止一个域名。常见误区是看到 GitHub 页面打不开，就直接认定账号或安装包有问题。实际上，官方安装器可能先访问 OpenAI Releases，只有这一步失败后才回退 GitHub Releases。

如果默认下载链路不稳定，可以明确要求安装器使用 GitHub Releases。macOS 或 Linux 执行：

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 的作用，是关闭 OpenAI Releases 下载路径。官方说明也接受 0 和 no，但为避免不同脚本对布尔值的解释差异，手工操作时统一使用 false。

如果仍然失败，先在浏览器中打开以下两个地址：

• https://releases.openai.com/codex
• https://github.com/openai/codex/releases

两者都打不开，说明问题发生在下载链路；只有 GitHub 能打开、OpenAI Releases 打不开，则更接近默认源与回退源之间的可用性差异。社区教程还记录过 npm 官方源速度慢、GitHub Releases 超时等现象，但这些属于二手经验，不是 OpenAI 对特定地区作出的服务承诺。

登录与使用：入口不同，认证顺序不同

CLI 安装完成后，在终端运行：

codex

首次启动后选择 Sign in with ChatGPT，再按浏览器提示完成账号登录。官方仓库明确推荐通过 ChatGPT 账号使用 Codex，并列出了 Plus、Pro、Business、Edu 和 Enterprise 计划。这里要澄清一个常见误解：API Key 登录也是官方支持的方式，官方 README 写的是”也可用 Codex with an API key，但需要额外配置”—— 只是入口不在网页控制台。具体的配置命令以官方文档为准（README 只给了原则，没列完整步骤），如果你要走 API Key 这条路，先看官方文档的认证章节，再在终端里配，不要凭教程记忆敲命令。

不同使用方式对应不同入口：

使用场景	操作入口	成功标志
终端编程	运行 codex	出现交互式界面，可选择登录方式
VS Code、Cursor、Windsurf	在编辑器扩展中安装 Codex	编辑器扩展列表出现 Codex
桌面端	运行 codex app，或进入官方 Codex App 页面	桌面应用启动并进入登录流程
云端 Codex	打开 https://chatgpt.com/codex	页面出现 Codex 会话界面

这里的“成功”只代表程序安装并进入认证流程，不代表账号一定具备可用资格。账号地区、套餐状态以及服务端可用性需要分别判断。

常见报错：容量满载与登录失败要分开

社区故障速查页记录过一句英文原文：

Selected model is at capacity

对应会话日志中还出现过：

server_overloaded

这不是下载失败，而是模型服务当时容量不足。社区记录显示，切换模型不一定有效；同一时期桌面版、CLI 和网页版都可能遇到。可执行的处理顺序是：先停止连续重试，查看 OpenAI Codex 官方仓库的 Issues 是否已有相同现象，再新建一个会话测试。只有当状态页显示对应事件已经解决，或新会话不再返回原报错，才算恢复。

另一个容易混淆的卡点是“下载成功但登录页打不开”。此时无需重新安装 CLI，先在浏览器打开 https://chatgpt.com/codex 测试：页面无法打开属于网络或服务入口问题；页面能打开但终端认证失败，则重新运行 codex 并再次选择 Sign in with ChatGPT。官方仓库没有给出可覆盖所有地区情况的统一代理配置，因此不要把某个来历不明的配置文件直接写进 Codex。

国内最容易卡的三个点（安装之外）

装得上不等于登得进。下面三个是国内环境下最常见的”卡在最后一步”，按出现频率排：

1. 登录回调打不开。Sign in with ChatGPT 会跳浏览器授权，回调地址是 chatgpt.com 域下的本地端口。如果浏览器和终端不在同一台机器、或代理只配了终端没配浏览器，回调就会超时。常见解法是让浏览器和终端走同一个代理，或改用 API Key 登录绕开浏览器回调。
2. 手机号验证收不到码。部分国内号段在 ChatGPT 注册/绑定环节收不到短信，这一步和 Codex 本身无关，是账号侧的验证问题。
3. 地区不支持。官方支持的地区列表里如果没有你当前出口 IP 所在地，登录会被直接拒绝。这类问题换网络出口比改配置更有效。

这三条都不是 Codex 的 bug，而是账号与网络环境的边界 —— 排错时先把它们和”安装失败”分开，能省掉大量无效重试。

怎么算真的装好了

CLI 的判断标准很简单：终端执行 codex 后出现 Codex 交互界面，并在首次运行时看到 Sign in with ChatGPT。完成浏览器授权后，能够进入聊天输入界面，才算安装和登录均成功。

若使用 IDE、桌面端或 Web，则分别检查扩展是否出现、应用是否启动、https://chatgpt.com/codex 是否进入会话界面。只看到安装脚本执行结束，或只下载到压缩包，都不能证明 Codex 已经可用。

官方入口与排错资料

• OpenAI Codex 官方仓库：安装命令、IDE 与桌面端入口、ChatGPT 登录方式。
• releases.openai.com/codex：官方安装器默认下载源（默认源打不开时脚本自动回退到 GitHub Releases）。
• Codex Web 入口：云端 Codex 会话。
• Codex Issues：安装、模型容量和服务异常的官方仓库问题记录。
• Codex 国内使用与报错速查：社区整理的登录、代理、断线与容量报错记录；其中涉及版本和地区的内容应回到官方页面复核。

参考来源

• Codex App（ChatGPT 桌面版）国内安装教程（Windows，2026） — 阿里云开发者社区，作为国内网络环境的参考