GPT Home

Appearance

作者：GPT Home发布：更新：编辑与更新规范

Codex下载安装教程：国内使用、登录配置与报错解决（2026） ​

最后更新：2026 年 7 月 15 日。本文依据 OpenAI Codex 官方仓库、Codex 官方文档 与官方账号说明整理。安装命令、支持系统、套餐权限和额度可能继续调整，请以官方或平台实时页面为准。

**Codex CLI 的安装并不复杂：Windows 可以使用官方 PowerShell 安装命令，macOS 和 Linux 可以使用官方 Shell 脚本，也可以统一通过 npm 安装。**安装完成后进入项目目录运行 codex，再选择 ChatGPT 账号或 API Key 对应的认证方式。

如果你搜索的是“Codex 国内怎么用”，建议先区分两条路线：能正常使用 OpenAI 官方服务时优先走官方入口；如果需要第三方提供的 ChatGPT Pro 与 Codex 开发额度，再比较支持 Codex 的平台。

国内开发者快速入口

需要 ChatGPT Pro、Codex 连接和可选开发额度，可以查看 zeogpt.com。

zeogpt 适合需要网页版 ChatGPT Pro 与 Codex 开发场景的用户，可按页面提供的方案选择相应额度。zeogpt 是第三方服务，不是 OpenAI 官网；模型、套餐、连接方法、价格和有效期以其实时页面为准。

一、Codex是什么？应该下载哪个版本？ ​

Codex 是 OpenAI 的编程智能体。Codex CLI 在本地项目目录中运行，可以读取代码、修改文件、执行命令、运行测试，并根据结果继续排查问题。

Codex 目前有多种使用入口：

使用方式适合人群官方入口
Codex CLI习惯终端、Git 和本地项目的开发者Codex CLI 文档
Codex IDE 扩展VS Code、Cursor、Windsurf 用户Codex IDE 文档
Codex App想用桌面界面管理任务和代码修改的用户Codex App
Codex Web想在网页中提交或管理开发任务的用户Codex Web

本文重点讲搜索量更集中的 Codex CLI 下载、安装、登录和报错处理。如果你只是想找入口，可先看 OpenAI Codex 官网入口与国内使用教程。

Codex有单独的“官方中文版”吗？ ​

不要把“Codex 中文版”理解成一个单独的中文破解安装包。官方 Codex 可以处理中文指令，但安装包应从 OpenAI 官方脚本、npm、Homebrew 或官方 GitHub Release 获取。来源不明的“Codex 中文破解版”可能夹带旧版本、恶意程序或账号风险。

二、安装Codex CLI前要准备什么？ ​

建议先准备：

  • Windows 11、较新的 macOS 或主流 Linux 环境；
  • Git，方便查看修改并在必要时回退自己的代码；
  • 使用 npm 安装时，需要先安装 Node.js 和 npm；
  • 一个能正常构建或运行的小型测试项目；
  • 可用的 ChatGPT 账号、OpenAI API 方案或第三方 Codex 连接方案；
  • 至少 4 GB 内存，复杂项目建议准备更多可用内存。

先检查基础环境：

bash
git --version
node --version
npm --version

如果你使用官方安装脚本而不是 npm，Node.js 不是启动 Codex CLI 的必选条件；但多数前端项目本身仍然会需要 Node.js。

三、Windows安装Codex CLI ​

方法一：使用官方PowerShell安装命令 ​

OpenAI Codex 官方仓库当前给出的 Windows 安装命令是：

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

安装完成后，重新打开 PowerShell 或 Windows Terminal，再检查版本：

powershell
codex --version

这条命令会从 OpenAI 官方域名获取安装脚本。对远程脚本比较谨慎的用户，可以先查看脚本来源和内容，或改用下面的 npm 安装方式。

方法二：使用npm安装 ​

powershell
npm install -g @openai/codex
codex --version

需要更新 npm 安装的 Codex CLI 时，可以运行：

powershell
npm install -g @openai/codex@latest

Windows提示“codex不是内部或外部命令” ​

先运行：

powershell
npm config get prefix
where.exe codex
Get-Command codex -ErrorAction SilentlyContinue

常见原因是 npm 全局可执行目录尚未进入 PATH，或者安装后没有重新打开终端。建议按这个顺序处理：

  1. 关闭并重新打开终端；
  2. 确认 npm install -g @openai/codex 没有报错；
  3. 检查 npm config get prefix 对应的可执行目录是否在 PATH 中；
  4. 避免同时保留脚本、npm 和旧二进制等多个安装版本；
  5. 仍然失败时，在 WSL2 环境中按 Linux 方法安装。

Windows原生安装和WSL2怎么选？ ​

OpenAI 官方仓库已经提供 Windows PowerShell 安装脚本；其安装与构建说明同时把 Windows 11 + WSL2 列为重要支持环境。可以按场景选择：

  • 普通 Windows 项目：先尝试官方 PowerShell 安装；
  • 主要使用 Linux 工具链、Docker 或服务器环境：优先考虑 WSL2；
  • 原生环境反复遇到路径、权限或依赖问题：在 WSL2 中重新测试；
  • 使用 WSL2 时，尽量让项目和 Codex 运行在同一套文件系统与终端环境中。

四、macOS和Linux安装Codex CLI ​

方法一：使用官方Shell脚本 ​

OpenAI 官方仓库给出的 macOS / Linux 安装命令是：

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

安装完成后检查：

bash
codex --version

方法二：使用npm ​

bash
npm install -g @openai/codex
codex --version

方法三：macOS使用Homebrew ​

bash
brew install --cask codex
codex --version

三种方法选择一种即可。多种来源同时安装，容易出现终端调用旧版本的问题。可以使用下面的命令确认当前执行文件来自哪里：

bash
which codex
codex --version

如果需要手动下载二进制文件，可以前往 OpenAI Codex 最新 GitHub Release，根据 macOS 或 Linux 的处理器架构选择对应文件。

五、Codex CLI安装后怎么登录？ ​

进入一个测试项目目录，再启动 Codex：

bash
cd /path/to/your-project
codex

首次启动时，按照终端提示选择认证方式。

方式一：使用ChatGPT账号登录 ​

OpenAI 官方仓库推荐运行 codex 后选择 Sign in with ChatGPT。目前官方说明覆盖 ChatGPT Plus、Pro、Business、Edu 和 Enterprise 等计划，但实际可用功能、模型和额度取决于账号、工作区政策与实时套餐规则。

这种方式适合已经在 ChatGPT 计划中使用 Codex 的用户。浏览器完成授权后，回到原来的终端继续操作。

方式二：使用OpenAI API Key ​

API Key 适合需要开发者 API 计费或自动化配置的用户，但需要按照 Codex 官方认证文档 单独设置。

需要特别注意：

  • ChatGPT Plus / Pro 订阅不等于 OpenAI API 余额；
  • API Token 费用和 ChatGPT 会员费用不是同一套计费；
  • 不要把 API Key 写进公开仓库、聊天截图或前端代码；
  • 不要同时混用多套认证方式后再判断额度问题。

方式三：使用zeogpt的Codex方案 ​

如果你需要第三方提供的 ChatGPT Pro 和 Codex 额度，可以查看 zeogpt.com。连接步骤、可选额度和支持模型以平台实时说明为准。

使用第三方服务前，应确认账号归属、连接方式、额度有效期、隐私说明和售后规则，不要向非登录页面提交密码、验证码、私钥或项目机密。

六、Codex CLI怎么配置项目？ ​

安装和登录只是第一步。Codex 是否好用，更多取决于项目是否有清楚的边界与验证命令。

1. 从正确的项目目录启动 ​

bash
cd /path/to/your-project
git status
codex

先确认当前分支、未提交改动和项目状态。不要默认让 Codex 覆盖已有修改，也不要一开始就在生产服务器目录中测试。

2. 用AGENTS.md写清项目规则 ​

可以在仓库根目录建立 AGENTS.md，告诉 Codex 项目的持久规则。例如：

markdown
# AGENTS.md

- 使用 npm 管理依赖。
- 修改完成后运行 npm run build。
- 不要覆盖与当前任务无关的已有改动。
- 不要提交 .env、密钥或生产配置。
- 修改范围不明确时，先阅读代码并说明计划。

这样比每次重复输入相同要求更稳定。项目级规则应写具体命令和边界，不要塞入与仓库无关的长篇提示词。

3. 高级配置再使用config.toml ​

Codex 的用户级设置可通过 .codex/config.toml 管理。不同版本支持的字段可能变化，新手不必先复制网上的大段配置；需要调整模型、审批、安全或工具行为时，再以 Codex 配置文档 和 配置参考 为准。

七、第一次使用Codex的正确步骤 ​

第一步：只让Codex阅读项目 ​

text
先阅读项目结构，不要修改文件。
告诉我技术栈、启动命令、构建命令、测试命令和主要目录。

第二步：给出一个小而明确的任务 ​

text
只修改 README，补充本地启动步骤。
不要修改 package.json 和源代码。

第三步：要求运行验证 ​

text
完成修改后运行项目的构建命令。
如果构建失败，先解释原因，不要扩大修改范围。

第四步：自己检查差异 ​

bash
git status
git diff

确认修改内容、测试结果和敏感信息后，再决定是否提交代码。Codex 可以提高开发效率，但最终的代码审查和上线责任仍然属于项目维护者。

八、Codex怎么在VS Code、Cursor和Windsurf中使用？ ​

OpenAI 官方仓库明确提供 Codex IDE 入口，适用于 VS Code、Cursor 和 Windsurf。IDE 扩展更适合这些任务：

  • 围绕当前文件解释代码；
  • 小范围修改组件或函数；
  • 查看差异后再接受修改；
  • 生成与当前代码相邻的测试；
  • 在编辑器上下文中持续提问。

如果你习惯终端，也可以直接在 VS Code 集成终端中运行 codex。CLI 与 IDE 扩展不必同时使用；先选择更符合当前工作流的一种即可。

九、Codex常见报错怎么解决？ ​

报错或现象常见原因建议处理
codex 命令找不到安装失败、PATH 未刷新或存在多个版本重开终端，检查 codex --version、where.exe codex 或 which codex
npm 出现 EACCES / EPERM全局目录权限或文件被占用关闭占用程序，检查 npm 全局目录，避免盲目用管理员权限覆盖文件
PowerShell 拒绝执行脚本执行策略或安全软件限制核对脚本域名，使用官方命令，必要时改用 npm 或 WSL2
浏览器登录后终端没有继续回调、默认浏览器或会话失效保留原终端，重新启动 codex 并再次授权，检查系统时间和默认浏览器
401 Unauthorized登录会话失效、API Key 无效或认证方式混乱重新认证，只保留当前需要的认证方式，并检查密钥是否过期
403 Forbidden账号权限、组织策略、套餐权限或服务可用性限制检查账号计划、组织管理员策略和官方服务状态，不要反复重装 CLI
429 Too Many Requests临时速率限制、套餐用量或 API 配额不足等待后重试、降低并发任务，并检查 ChatGPT、API 或第三方额度来源
网络超时或连接中断npm 下载、浏览器认证或服务请求链路异常先判断卡在安装、登录还是模型请求，再分别检查官方状态和本地网络
Codex 读不到项目文件当前目录错误、权限不足或文件在另一套环境中从项目根目录启动，确认路径权限；WSL2 用户避免混用不同终端环境

为什么不要一报错就重新安装？ ​

安装、登录和额度是三层不同问题：

  1. codex --version 失败，才优先检查安装与 PATH；
  2. 能启动但无法认证，检查登录和账号；
  3. 能登录但请求报 429，检查速率或额度；
  4. 只有特定仓库失败，检查项目权限、配置和命令。

先判断故障层级，通常比连续卸载重装更快。

十、国内使用Codex怎么选择账号和额度？ ​

国内用户常把三类费用混在一起：

类型主要用途需要注意
ChatGPT Plus / Pro 等计划ChatGPT 与计划内 Codex 功能权限和额度按官方套餐实时规则执行
OpenAI API按 API 使用量计费与 ChatGPT 会员不是同一笔余额
第三方 Pro / Codex 方案平台提供的连接和额度以平台的套餐、有效期和隐私规则为准

选择额度时，不要只看“能不能登录”，还要看任务强度：

  • 偶尔解释代码、改文档：先用较小额度验证工作流；
  • 经常改前端、修 Bug、运行构建：关注持续可用的 Codex 额度；
  • 跨模块开发、长时间排错：预留更多任务额度，并控制单次任务范围；
  • 团队或商业项目：优先确认账号权限、数据边界、组织政策和费用管理。

需要第三方 ChatGPT Pro 与 Codex 方案时，可以比较 zeogpt.com 页面当前提供的额度。本站不代替平台作出额度或可用性承诺。

十一、Codex安全使用清单 ​

  • 开始前运行 git status，确认已有改动；
  • 不把 .env、私钥、数据库密码和生产凭据交给 Codex；
  • 第一次先在小项目或测试分支中使用；
  • 给出明确的修改范围、禁止项和验证命令；
  • 对依赖安装、删除文件、数据库变更和部署操作保持谨慎；
  • 完成后检查 git diff，再运行测试与构建；
  • 第三方平台只按其公开说明使用，不提交超出任务所需的敏感信息。

十二、Codex下载安装常见问题 ​

Codex CLI官方安装命令是什么？ ​

Windows 可使用官方 PowerShell 安装命令；macOS 和 Linux 可使用官方 Shell 脚本。三类系统也可以使用 npm install -g @openai/codex，macOS 还可以使用 Homebrew。

Windows一定要用WSL2吗？ ​

不一定。OpenAI 官方仓库当前提供 Windows PowerShell 安装脚本；如果原生环境出现兼容问题，或者项目主要依赖 Linux 工具链，可以改用 Windows 11 + WSL2。

Codex登录必须购买ChatGPT Pro吗？ ​

不应简单理解为“只有 Pro 才能登录”。OpenAI 官方说明涵盖 Plus、Pro、Business、Edu 和 Enterprise 等计划，具体权限和额度以账号实时页面为准。API Key 则属于另一套开发者计费方式。

ChatGPT会员额度可以当API余额使用吗？ ​

不可以直接等同。ChatGPT 订阅、OpenAI API 计费和第三方平台额度是三套不同规则，应分别核对。

Codex报401、403、429分别是什么意思？ ​

通常可以按认证失败、权限或策略限制、速率或额度限制三个方向排查。但最终原因要结合终端完整错误、账号状态和使用入口判断。

zeogpt是OpenAI官网吗？ ​

不是。zeogpt 是第三方服务，当前面向需要 ChatGPT Pro 与 Codex 额度的用户提供相关方案。使用前请核对实时套餐、连接方式、额度和隐私说明。

十三、总结 ​

Codex 下载和安装可以按这条最短路径完成：

  1. 从 OpenAI 官方脚本、npm、Homebrew 或 GitHub Release 安装；
  2. 用 codex --version 确认终端调用的是正确版本；
  3. 在测试项目目录运行 codex，选择 ChatGPT 登录或 API Key 方案；
  4. 用 AGENTS.md、明确任务边界和验证命令配置项目；
  5. 遇到问题时分清安装、认证、权限、额度和项目环境；
  6. 国内用户需要第三方 Pro / Codex 额度时，再比较 zeogpt.com 的实时方案。

真正影响 Codex 开发效率的，不是安装命令有多复杂，而是能否给出清楚任务、保护现有代码，并用测试和构建验证结果。

相关阅读 ​

资料来源 ​