GPT Home

Appearance

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

Codex Windows 安装教程：下载、CLI 配置、登录失败与国内使用完整指南（2026） ​

最后更新：2026 年 6 月 28 日。本文面向 Windows 用户，重点解决 Codex 下载、Codex CLI 安装、PowerShell 配置、PATH 环境变量、登录失败、国内使用和 Codex 额度选择。

Codex 是 OpenAI 面向软件开发的 AI 编程助手，可以帮助你阅读项目、修改文件、运行命令、修复报错、编写测试和做代码审查。对 Windows 用户来说，真正容易卡住的不是“Codex 会不会写代码”，而是安装和登录这几步：

  • Codex Windows 版从哪里下载？
  • Codex CLI 怎么安装？
  • npm install -g @openai/codex 后为什么找不到命令？
  • PowerShell 脚本为什么执行失败？
  • Codex 登录后为什么跳不回终端？
  • 国内使用 Codex，ChatGPT Pro 和 Codex 额度怎么选？

如果你主要在国内使用，并且想减少 ChatGPT Pro、Codex 额度和连接配置上的折腾，可以先了解支持 Codex 的入口：

zeogpt

如果你是在搜索“Codex下载”“Codex中文版下载”进入本站，也可以先看这篇入口页： Codex下载：国内Codex中文版使用指南（Windows/Mac/CLI安装与zeogpt入口）

说明

zeogpt 是第三方服务，不是 OpenAI 官方官网。它当前支持 Codex，适合需要 ChatGPT Pro 和 Codex 额度的国内用户。具体套餐、额度、价格和连接方式请以 zeogpt 页面实时说明为准。不要上传密码、验证码、私钥、数据库连接串、客户数据或公司机密。

一、Windows 用户安装 Codex 前先准备什么？ ​

先准备这些环境：

项目作用建议
Windows Terminal / PowerShell运行安装命令优先用 Windows Terminal
Node.js 和 npmnpm 安装 Codex CLI安装较新的 LTS 版本
Git管理代码改动使用 Codex 前先提交当前代码
浏览器完成登录授权Chrome 或 Edge 更稳
测试项目先跑通 Codex不要直接用生产项目测试

第一次安装建议用一个简单项目测试：

powershell
mkdir D:\codex-test
cd D:\codex-test
git init

这样就算配置出错，也不会影响真实项目。

二、Codex Windows 有哪些安装方式？ ​

Windows 用户常见有三种路线。

方法一：npm 安装 Codex CLI ​

这是开发者最熟悉的方式。

powershell
npm install -g @openai/codex

安装后检查：

powershell
codex --version

进入项目目录：

powershell
cd D:\your-project
codex

如果能看到 Codex 的交互提示，说明 CLI 已经可以运行。

方法二：PowerShell 官方安装脚本 ​

OpenAI Codex 官方仓库提供过 Windows PowerShell 安装脚本。使用脚本前，请确认页面来源是 OpenAI 官方 GitHub 或官方文档，不要复制陌生网站里的脚本直接运行。

脚本方式适合想快速安装二进制版本的用户，但如果你不熟悉 PowerShell，建议先用 npm 安装，排查更直观。

方法三：Codex App / 桌面端 ​

如果你不喜欢命令行，可以关注 Codex App 或桌面端入口。桌面端更适合想用图形界面管理任务的人；CLI 更适合已经习惯终端和 Git 的开发者。

三、npm 安装后找不到 codex 怎么办？ ​

这是 Windows 最常见问题。

1. 重新打开终端 ​

npm 全局命令安装后，旧终端可能没有刷新环境变量。先关闭 PowerShell / Windows Terminal，再重新打开。

2. 检查 npm 全局目录 ​

powershell
npm config get prefix

你会看到类似：

text
C:\Users\你的用户名\AppData\Roaming\npm

这个目录需要加入 Windows 的 PATH 环境变量。

3. 检查命令是否存在 ​

powershell
Get-Command codex

如果找不到，说明 PATH 没配好，或者安装没有成功。

4. 重新安装 ​

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

安装完成后重新打开终端，再运行：

powershell
codex --version

四、PowerShell 执行脚本失败怎么办？ ​

如果你使用安装脚本，可能遇到执行策略限制。

常见提示包括：

  • running scripts is disabled on this system
  • cannot be loaded because running scripts is disabled
  • ExecutionPolicy 相关错误

可以先查看当前策略：

powershell
Get-ExecutionPolicy

如果你明确知道脚本来源可靠，可以临时用当前进程执行策略运行。不要为了安装一个工具就长期放宽系统安全策略。

更稳的方式是：

  1. 确认脚本来源。
  2. 优先使用官方文档或 GitHub 仓库提供的命令。
  3. 不运行陌生第三方页面里的 PowerShell 脚本。
  4. 不在管理员终端里执行不明命令。

如果你不想处理脚本权限，直接走 npm 安装通常更简单。

五、Codex CLI 怎么登录？ ​

安装完成后，在项目目录运行：

powershell
codex

常见登录方式有两类。

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

适合已经有 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 等计划的用户。官方仓库也推荐使用 ChatGPT 账号登录，以便把 Codex 纳入对应计划中使用。

常见流程：

  1. 运行 codex
  2. 选择使用 ChatGPT 登录
  3. 浏览器打开授权页面
  4. 完成登录
  5. 返回终端继续使用

方式二：使用 API Key ​

API Key 更适合开发者、自动化任务或团队环境。需要注意：API 计费和 ChatGPT 订阅不是同一套账单，使用前要分别确认。

新手建议先用 ChatGPT 账号路线，不要一开始就同时混用 API Key、第三方代理和多个终端环境。

六、登录失败、跳转失败怎么排查？ ​

1. 浏览器没有打开 ​

可以手动复制终端里的登录链接到 Chrome 或 Edge。

2. 登录后回不到终端 ​

尝试：

  • 关闭 Codex 进程后重新运行
  • 更换默认浏览器
  • 使用无痕窗口登录
  • 清理 ChatGPT / OpenAI 相关 Cookie
  • 确认终端没有被管理员权限或安全软件拦截

3. 提示 Access Denied / 403 ​

可能和账号状态、网络环境、地区限制、浏览器安全验证有关。先确认官方网页能否正常打开，再尝试重新登录。

4. 提示 token 或 auth 相关错误 ​

可以尝试退出登录、清理本地授权状态后重新登录。不要把授权 token 复制到不明网站，也不要把账号密码交给第三方页面。

5. 公司电脑无法登录 ​

公司网络可能限制浏览器跳转、脚本执行、终端访问或代理设置。建议先在个人电脑或测试环境跑通。

七、Codex 国内使用怎么选？ ​

国内用户使用 Codex，通常有三类需求。

只想跑通官方 CLI ​

适合能稳定访问官方服务、能处理登录和账号计划的用户。优先按官方文档和 GitHub 仓库安装。

想使用 ChatGPT Pro 和 Codex 额度 ​

适合高频开发者、独立站站长、内容站运营者、前端和全栈工程师。可以了解：

zeogpt

它当前支持 Codex，并提供 ChatGPT Pro 和 Codex 额度相关方案，适合想把 Codex 用在真实开发里的国内用户。

想先学习 Codex 工作流 ​

可以先用小项目练习，不要急着让 Codex 改大项目。

推荐第一条指令：

text
请先阅读这个项目，不要修改文件。
总结技术栈、目录结构、启动命令、构建命令和测试命令。

等你确认 Codex 理解项目后，再给它小任务。

八、Codex Windows 常见安装问题速查表 ​

问题可能原因建议处理
codex 命令不存在npm 全局目录未进 PATH检查 npm config get prefix
安装后版本查不到终端未刷新重启 PowerShell / Windows Terminal
PowerShell 脚本不能执行执行策略限制用 npm 安装或临时策略
登录页面打不开默认浏览器或网络问题换 Chrome / Edge
登录后终端没反应授权回调失败重新运行 codex，换浏览器
项目目录读不到权限或路径问题用英文路径测试项目
npm install 报权限错Node/npm 环境异常重装 Node.js LTS
Codex 修改太多文件任务边界不清楚明确“只改哪个文件/模块”

九、第一次让 Codex 做什么任务最稳？ ​

1. 只读项目 ​

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

2. 修改 README ​

text
请只修改 README，补充 Windows 本地启动步骤。
不要修改源代码。

3. 修复一个明确报错 ​

text
这是 npm run build 的报错。
请定位原因，只做最小修改，并说明改了哪些文件。

4. 做代码审查 ​

text
请以 code review 方式检查刚才的改动。
优先指出 bug、回归风险和缺少的测试。

这种小步使用方式，比“一次让 Codex 重构整个项目”稳定得多，也更省额度。

十、ChatGPT Pro 和 Codex 额度怎么考虑？ ​

Codex 的使用强度和普通聊天不同。它可能会读取多个文件、生成补丁、运行构建、分析错误并继续修改，所以真实开发任务会更消耗额度。

可以按使用频率判断：

使用强度典型场景建议
轻度偶尔解释代码、改文档先低成本试用
中度每周改页面、修 bug、跑构建关注 Codex 可用额度
重度每天让 Codex 参与开发优先看 Pro 和更高额度
站长 / 独立开发者经常改页面、写文章、修站点关注稳定入口和持续额度

如果你需要 ChatGPT Pro、GPT Image 2 和 Codex 额度放在一起使用，可以了解 zeogpt。

十一、常见问题 FAQ ​

Codex Windows 可以用吗？ ​

可以。Windows 用户可以通过 Codex CLI、安装脚本或 Codex App / 桌面端等方式使用，具体以官方文档和当前版本为准。

Codex CLI 推荐 npm 安装吗？ ​

对熟悉 Node.js 的开发者来说，npm 安装最直观。安装后重点检查 codex --version 和 PATH。

Codex 安装后打不开怎么办？ ​

先确认命令是否存在、PATH 是否正确、终端是否重启、Node.js 是否正常。再检查登录和网络环境。

Codex 登录失败怎么办？ ​

换浏览器、清理 Cookie、重新运行 codex、确认账号状态和网络环境。不要把账号密码交给来源不明的页面。

国内使用 Codex 推荐什么方案？ ​

如果你能顺利使用官方服务，可以走官方路线。如果需要 ChatGPT Pro 和 Codex 额度，可以了解支持 Codex 的 zeogpt。

Codex 会不会乱改代码？ ​

如果任务边界不清楚，会有风险。使用前先提交 Git，并明确要求“只修改某个文件或模块”。

十二、总结 ​

Windows 用户安装 Codex，重点不是背命令，而是把这几件事跑通：

  1. Node.js / npm 环境正常。
  2. codex 命令能在 PowerShell 中执行。
  3. ChatGPT 登录或授权能成功。
  4. 项目目录能被正确读取。
  5. 每次任务边界清楚，改完能验证。

如果你只是测试，先用小项目跑通。
如果你准备把 Codex 放进日常开发，并且需要 ChatGPT Pro 和 Codex 额度，可以查看 zeogpt。

官方参考 ​