Codex Windows 安装教程：PowerShell、npm、PATH 与登录排查（2026）

如果你条件有限，强烈推荐国内 API 站

这是站主自主搭建纯 GPT API 站，无需梯子，实时更新 GPT 最新模型（仅支持电脑端），价格是官方的 三分之一，操作简单，连接稳定，价格便宜，保证没有任何掺水、收集信息等低劣行为，保证爽用 GPT。

• 考普 AI 官网入口

在 Windows 上安装 Codex，通常不需要先装 WSL2。普通用户可以先用官方 PowerShell 安装器或 npm 安装 Codex CLI；只有源码构建、Linux 工具链或项目本身依赖 Linux 环境时，才考虑 WSL2。这篇文章专门处理 Windows 下载、安装、登录和“找不到命令”问题，不重复主安装页的全部配置内容。

本文核查日期：2026 年 8 月 22 日。安装脚本、客户端、账号权益和命令参数都可能更新；执行命令前请核对 Codex 官方文档 和当前终端输出。

一、Windows 上应该安装哪一种 Codex？

“Codex 下载”可能指不同产品形态，先选对路线可以少走很多弯路：

路线	入口	适合场景	是否建议先用
Codex CLI	PowerShell、Windows Terminal	让代理读取项目、修改文件、运行测试	想学习本地开发的用户
Codex App	独立桌面应用	偏好图形界面、任务列表和对话工作流	不喜欢终端的用户
IDE 扩展	VS Code、Cursor、Windsurf 等	在编辑器里查看代码和 Diff	已有固定编辑器的开发者
Codex Web	浏览器	先体验云端任务，不改本地文件	只想快速试用的用户

如果你的目标是“在本地项目里让 Codex 读代码、改文件并跑测试”，优先安装 CLI。若只是想提问或试用，先打开网页版，不必为了一个问题安装完整开发环境。

二、安装前检查：5 分钟避免后续报错

在 PowerShell 中依次运行：

winget --version
node --version
npm --version
git --version

不要求所有命令都存在，但以下判断很有用：

1. 使用 npm 路线时，需要 Node.js 和 npm；建议使用仍受维护的 Node.js LTS。
2. Git 不是启动 Codex 的硬性条件，但项目分析、查看 Diff 和回滚时非常有帮助。
3. 第一次测试不要放在生产目录，先复制一个无敏感信息的小项目。
4. 公司代码、密钥、客户数据是否允许发送到外部 AI 服务，应先遵守公司制度。
5. 安装源只使用官方 Codex 页面、官方包名和系统包管理器，不要运行群聊里改过的脚本。

三、方法一：使用官方 PowerShell 安装器

打开 PowerShell，运行当前官方文档给出的 Windows 安装命令：

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

安装完成后关闭当前窗口，重新打开 PowerShell，再执行：

codex --version
codex --help

如果系统提示无法执行脚本，可以只对当前 PowerShell 进程临时放开策略：

Set-ExecutionPolicy -Scope Process Bypass

不要为了安装 Codex 长期关闭整台电脑的脚本安全策略。远程脚本会下载并执行内容，执行前应确认域名拼写是 chatgpt.com，企业电脑则应先经过管理员审批。

安装器下载到哪里？

官方独立安装器会从 OpenAI 的 Codex 发布地址获取对应文件，必要时可能回退到官方代码仓库的 Release。不要把某一次下载 URL 当作永久地址；当安装器、版本或下载源变化时，以 Codex 官方文档显示的入口为准。

四、方法二：使用 npm 安装

如果电脑已经安装 Node.js，可以运行：

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

如果出现权限或目录错误，不要马上用管理员身份反复安装。先检查 npm 的全局目录和当前 Node 版本：

npm config get prefix
node --version
npm --version

在多版本 Node 环境中，最常见的问题是“安装时使用了一个 Node，运行时 PATH 指向另一个 Node”。重新打开终端后，再用下面的命令确认实际位置：

where.exe node
where.exe npm
where.exe codex

如果 npm install 成功但 codex 不是命令，通常是 npm 全局 bin 目录没有加入用户 PATH。把 npm config get prefix 显示的可执行目录加入用户环境变量后，重启终端再试。不要把整段 PATH 覆盖掉，只添加缺少的目录。

五、方法三：Codex App 和 WSL2 怎么选？

Codex App

Codex App 是独立桌面入口，安装方式和可用系统取决于当前官方页面。可以先在终端运行：

codex app

如果当前版本支持 Windows App，命令会打开或引导安装桌面应用；也可以从 Codex App 官方说明进入实时下载入口。不要从搜索广告或网盘下载名称相同的安装包。

WSL2

WSL2 不是所有 Windows 用户的必选项。下面情况更适合使用 WSL2：

• 项目脚本依赖 Bash、Linux 命令或 Linux 权限模型；
• 你要按官方源码构建文档编译 Codex；
• Windows 原生路径、依赖或工具链和项目不兼容；
• 团队已经统一使用 Ubuntu 等 Linux 开发环境。

如果只是安装预编译 CLI 并分析普通项目，先走 PowerShell 或 npm 路线更直接。安装 WSL2 可能需要管理员权限和重启，可参考微软官方说明，不要把 WSL2 的源码构建要求误写成普通 CLI 安装要求。

六、第一次登录：ChatGPT 账号与 API Key 不一样

安装完成后运行：

codex

如果浏览器授权后没有回到终端：

1. 确认浏览器地址栏仍是官方域名；
2. 暂时关闭会拦截 localhost 回调的扩展；
3. 检查系统时间、代理和防火墙；
4. 关闭旧的 Codex 进程后重新执行 codex login；
5. 远程或无头机器可查看当前版本是否提供 codex login --device-auth。

查看登录状态和退出当前登录：

codex login status
codex logout

使用 API Key 时的安全写法

API Key 需要独立的 Platform 项目和账单，不会因为 ChatGPT 订阅而自动获得 API 余额。不要把 Key 直接写进文章、脚本或命令历史；可以通过环境变量从标准输入传递：

$env:OPENAI_API_KEY | codex login --with-api-key

这条命令的具体参数可能随版本变化，执行前先运行 codex login --help。如果 Key 曾经出现在公开仓库或截图里，应立即撤销并重新生成。

七、安装成功后先做 4 个低风险检查

进入一个不含密钥的练习项目目录：

cd C:\path\to\demo-project
git status
codex --version
codex doctor

然后先提交只读任务：

只读分析当前项目，不要修改文件、安装依赖或联网。
请说明项目语言、框架、入口文件、测试命令和当前 Git 状态，并把已确认事实与推测分开。

确认输出后，再授权一个小范围修改。完整的项目工作流可阅读 Codex 写代码项目实战，权限和配置细节见 Codex 下载、安装与配置主教程。

八、Windows 常见问题速查

现象	常见原因	排查顺序
codex 不是命令	PATH 未刷新或安装目录不在 PATH	重启终端 → where.exe codex → 检查 npm prefix
PowerShell 脚本被阻止	执行策略限制	仅当前进程 Set-ExecutionPolicy -Scope Process Bypass
npm 权限错误	全局目录属于其他用户或 Node 版本混乱	检查 prefix、Node 路径，避免盲目使用管理员权限
登录后卡在 localhost	回调被扩展、代理或防火墙拦截	换浏览器、检查回调、重试 codex login
出现 401/403	凭据、账号资格、组织或地区策略问题	codex login status → 重新登录 → 查看账号页面
任务很快达到限制	模型、上下文、工具和任务复杂度消耗不同	在 Codex 设置/用量页和 CLI /status 查看实时状态

错误排查不要从网上复制“万能 config.toml”或他人的登录令牌。若同一问题持续出现，记录 Codex 版本、系统版本、脱敏错误文字和发生时间，再查看官方文档或状态页。

九、FAQ

Windows 安装 Codex 必须使用 WSL2 吗？

不必须。官方提供 Windows PowerShell 安装器和 npm 路线；WSL2 更适合源码构建或依赖 Linux 工具链的项目。

PowerShell 和 npm 哪个更好？

没有统一答案。PowerShell 安装器步骤少、无需单独管理 Node；npm 适合已经使用 Node 版本管理器和团队包管理流程的开发者。两者都应从官方包名或官方入口安装。

codex --version 没有输出怎么办？

先重新打开终端，执行 where.exe codex 和 Get-Command codex -All。如果找不到路径，检查安装是否成功和 PATH 是否包含安装目录。

ChatGPT Plus 账号和 API Key 能混用吗？

不能直接混用。ChatGPT 账号路线和 OpenAI API 项目路线有不同的登录、计费和权限边界，具体以官方账号页面和文档为准。

十、总结

Windows 用户可以按“官方 PowerShell 安装器 → codex --version → ChatGPT 登录 → 练习项目只读分析”的顺序上手。遇到问题时，先区分安装、PATH、登录回调和账号用量四个层次；不要把 WSL2 源码构建要求、ChatGPT 订阅和 API Key 账单混为一谈。

继续阅读：

本站是独立第三方教程站，不代表 OpenAI 官方立场。模型、客户端、套餐和限额以官方实时页面或对应平台的实时说明为准。