Codex安装教程2026：CLI下载、Windows WSL2、macOS/Linux与VS Code登录

更新时间：2026年8月31日。本文聚焦“Codex下载”“Codex安装”“Codex CLI安装”“Windows安装Codex”“Codex登录失败”和“Codex VS Code”等实操问题。命令来自 OpenAI 官方 openai/codex 仓库当前说明，执行前请再次核对官方页面。

最快路径：macOS 或 Linux 使用官方 shell 安装脚本，Windows 11 按官方说明优先准备 WSL2，再运行对应安装命令；安装后执行 codex --version 和 codex 完成验证与登录。 不要从网盘、下载站或所谓“Codex 中文破解版”获取二进制文件。

国内 Codex 类开发任务入口

如果官方安装或账号路径暂时不适合你的环境，又只处理公开、测试或已脱敏代码，可了解下面的第三方服务：

• apibest： apibest.org当前提供 Codex 国内版相关能力，并有高额度 GPT-5.5 Pro 可选，适合代码解释、脚本生成和项目问答。它不是 OpenAI 官方安装包或官方客户端，实际功能以站内显示为准。

Codex官网、CLI、App和VS Code入口怎么区分？

搜索“Codex官网”时，先确认自己要找的是哪一种形态：

入口	适合做什么	官方核验入口
Codex Web	在网页中使用云端编程工作流	chatgpt.com/codex
Codex CLI	在终端读取项目、解释代码、修改文件并运行测试	openai/codex GitHub仓库
Codex App	使用桌面应用形态管理编程任务	在官方仓库 README 中核对 codex app 与最新入口
Codex IDE	在 VS Code、Cursor 或 Windsurf 中结合编辑器使用	OpenAI Codex IDE文档

这些入口并不是同一个下载页面。CLI是终端工具，IDE入口由编辑器扩展或官方文档说明，Web和App也有各自的账号、权限和功能边界。看到“Codex中文官网”“Codex国内版”或下载按钮时，应先核对最终域名、服务主体和是否要求提交API Key。

Codex下载前要准备什么？

官方安装文档当前给出的环境基线包括 macOS 12 或更高版本、Ubuntu 20.04 或 Debian 10 及以上版本，并提示 Windows 11 用户关注 WSL2。Git 推荐 2.23 及以上；内存最低 4GB，8GB 更适合实际项目。不同安装方式还可能需要 PowerShell、Node.js/npm 或 Homebrew。

检查项	建议命令或动作	目的
系统版本	在系统设置中查看	排除系统过旧
Git	git --version	便于在仓库中审查和回退改动
Node.js	node --version	npm 安装方式需要
npm	npm --version	确认包管理器可用
项目备份	新建 Git 分支或复制测试项目	防止误改重要文件
敏感文件	检查 .env、证书、Token	避免被工具读取或提交

只想使用官方安装脚本时，不一定需要 npm；选择 npm 安装才需要 Node.js 环境。

Windows安装Codex CLI

方法一：官方PowerShell安装脚本

打开 PowerShell，执行官方仓库当前提供的命令：

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

安装完成后关闭并重新打开终端，再检查：

codex --version
codex --help

如果公司设备禁止执行远程脚本，不要私自关闭安全策略，应联系管理员或选择组织允许的安装方式。

方法二：npm安装

已经配置 Node.js 和 npm 的用户可以执行：

npm install -g @openai/codex

然后验证：

codex --version

Windows是否一定要WSL2？

官方仓库同时提供 Windows 安装命令和 WSL2 相关说明。实际选择取决于你的项目：依赖 Linux 工具链、容器或 shell 脚本时，WSL2通常更容易复现服务器环境；仅做基础验证时，可以按官方当前命令测试。遇到 PowerShell、PATH 或权限问题，不要直接下载第三方替代包，先回到官方安装文档核对版本。

macOS安装Codex CLI

方法一：官方安装脚本

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

方法二：Homebrew

brew install --cask codex

方法三：npm

npm install -g @openai/codex

安装后新开一个 Terminal 窗口，再执行：

codex --version
which codex

如果 macOS 出现安全或权限提示，先确认安装来源，再按系统提示处理，不要为了安装工具关闭整台电脑的安全保护。

Linux安装Codex CLI

Ubuntu、Debian 或其他兼容环境可以优先核对官方脚本：

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

或者使用 npm：

npm install -g @openai/codex

验证命令：

codex --version
command -v codex

不建议为了省事直接用 root 身份在真实项目中运行 Codex。更稳妥的做法是使用普通用户、明确项目目录，并限制它可执行的命令。

Codex怎么登录？ChatGPT账号和API Key有什么区别？

安装完成后，在准备好的测试目录中运行：

codex

首次运行通常会显示登录或配置选项。按官方交互选择：

1. Sign in with ChatGPT ：适合希望使用ChatGPT账号和当前计划所提供Codex权益的用户，实际资格以账号页面和官方说明为准。
2. API Key方式 ：适合已经有开发者API配置，并理解密钥管理、用量和权限边界的用户。官方文档对API Key方式可能有额外设置要求。

不要把 API Key 直接写在 Markdown、源码、截图或 Git 提交中。若必须设置环境变量，应使用本机安全配置，并确认 .env 已被 .gitignore 排除。

安装成功后怎么测试？

不要一上来就进入生产仓库。新建或选择一个非敏感的小项目，依次测试：

1. 请只阅读当前目录，不要修改文件。
2. 说明项目使用的语言、入口文件和运行命令。
3. 列出你认为最需要补测试的两个位置，并说明原因。

确认它能正确理解项目后，再给一个小范围任务：

请修复 README 中的一处命令说明，只修改 README.md。
完成后列出修改内容，不要执行发布命令。

这个过程可以验证目录、权限、交互和修改范围是否符合预期。

Codex CLI常见报错解决

1. codex不是内部或外部命令

常见原因是终端尚未重启、安装失败或 PATH 未更新。

处理顺序：

1. 关闭并重新打开终端。
2. 再次执行 codex --version。
3. npm 用户执行 npm config get prefix，确认全局目录是否进入 PATH。
4. 重新核对安装日志，不要重复下载未知安装包。

2. PowerShell脚本被禁止执行

先确认命令来自官方仓库。公司设备应遵守组织策略；个人设备也不要长期全局关闭执行策略。官方命令使用单次 ByPass 参数，但仍需由用户判断是否允许执行远程脚本。

3. npm出现权限错误

不要直接把所有命令都改成管理员或 sudo。先检查 Node 安装方式、npm 全局目录所有权和当前用户权限。使用 Node 版本管理器通常比长期用管理员权限更清晰。

4. npm下载慢或网络超时

检查网络、代理、DNS、npm registry 和证书环境。企业网络可能拦截包下载。包名应为 @openai/codex，不要改装名称相似的陌生包。

5. 登录页面打不开或回调失败

确认默认浏览器、Cookie、时间设置和账号状态；关闭会拦截登录回调的浏览器扩展后重试。仍失败时应查看官方状态与文档，不要把验证码发给第三方客服。

6. Codex读取不到项目或命令失败

先确认终端当前目录：

pwd

Windows PowerShell 可执行：

Get-Location

再检查文件权限、项目依赖和实际运行命令。Codex 不能替代缺失的编译器、数据库或项目环境。

7. 修改范围太大

在提示词中加入：

只允许修改 src/auth.ts 和对应测试文件。
不要升级依赖，不要重构其他模块。
修改前先列出计划，修改后展示 diff 摘要和测试结果。

Codex CLI和VS Code插件怎么选？

需求	更适合CLI	更适合IDE扩展
经常运行脚本和测试	是	可配合使用
喜欢终端工作流	是	否
希望结合当前编辑文件操作	可用	是
需要查看可视化diff	需要配合Git工具	编辑器内更直观
使用Cursor或Windsurf	CLI可独立运行	可查看兼容扩展

编辑器安装、登录、上下文和权限设置请继续看Codex VS Code插件安装与使用教程。

如果你已经在VS Code、Cursor或Windsurf中打开项目，先确认扩展或IDE入口来自官方文档，再决定是否同时安装CLI。CLI和IDE可以配合使用，但它们读取文件、执行命令、显示差异和处理权限的方式可能不同；第一次使用应在测试仓库中验证。

安装安全清单

• 只从 OpenAI 官网、官方 GitHub、npm 官方包或可信包管理器核对入口。
• 不下载“破解版、共享版、汉化增强版、免登录版”。
• 不把 API Key、Cookie、SSH 私钥和数据库密码交给教程站或客服。
• 先在测试项目运行，确认读写范围和命令权限。
• 每次修改后查看 Git diff，并运行测试和构建。
• 删除、迁移、部署和生产命令必须人工确认。

继续阅读

• OpenAI Codex是什么与官网入口
• Codex VS Code插件安装与使用
• Codex国内版使用指南
• Codex vs Cursor vs Claude Code

精选外部教程

• Grok China：Codex下载安装配置保姆级教程：适合继续查看中文安装流程。
• ChatGPT 中文指南：Codex安装教程：适合交叉核对 Windows 与 macOS 步骤。
• GPT Home：Codex Windows CLI安装指南：适合 Windows 用户继续排错。

官方参考

• openai/codex GitHub
• Codex安装文档
• OpenAI Codex开发者文档