Codex 现在有五个入口：终端 CLI、IDE 插件（VS Code / JetBrains）、桌面 App、网页版（chatgpt.com/codex）、Chrome 扩展。大部分教程只讲其中一个，而且各平台的装法和坑不一样。这篇把全平台的安装、登录、验证一次讲清，最后附国内用户的前置条件。
先说结论：日常写代码建议装 CLI + IDE 插件这一对组合（两者共享登录态，会话互通）；Mac/Linux 一行官方脚本最省事；Windows 原生沙箱截至发稿仍标注实验性（experimental），官方推荐跑在 WSL2 里。开始前确认你有能登录的 ChatGPT 付费账号（Plus 起步）或 API Key，二选一。
一、装之前：先搞清鉴权方式
Codex 有两种登录方式，决定了你额度从哪扣：
- ChatGPT 账号登录（推荐个人用户）：用量走订阅额度（Plus/Pro 档），不用管 API 计费。额度机制是 5 小时窗口 + 周上限，细节见Codex 用量上限详解。
- API Key：按 token 计费，适合团队/CI 场景，需要 API 账户有余额。
免费账号能装上 CLI 但基本用不了 Agent 能力，所以第一前置条件是付费订阅。国内用户开通 Plus/Pro 的支付卡点和路径见文末。
二、Mac / Linux 安装
方式 1：官方脚本（推荐，自动选对架构）
curl -fsSL https://chatgpt.com/codex/install.sh | sh
方式 2：npm
npm install -g @openai/codex
两个坑：
- 包名是
@openai/codex，带 scope。npm 上那个不带 scope 的 codex 是 2012 年的无关老包，装错不报错但完全不是这个东西
- 需要 Node.js 22+，版本不够会装失败或运行报错，先
node -v 确认
方式 3：Homebrew（注意是 cask）
brew install --cask codex
实测坑：brew 的 cask 在部分环境下装的是桌面 App 而不是 CLI。如果装完终端里没有 codex 命令，别折腾 brew 了，直接走 npm 或官方脚本装 CLI。
装完验证：
codex --version
codex # 首次运行会引导浏览器登录 ChatGPT 账号
三、Windows 安装
方式 1：官方 PowerShell 脚本
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
方式 2：winget
winget install OpenAI.Codex
Windows 用户必读：Codex 在原生 Windows 上用的是 AppContainer 沙箱，默认限制文件写入和网络访问，OpenAI 官方截至发稿仍把它标为实验性。官方推荐的稳定跑法是 WSL2：
- 装好 WSL2 + Ubuntu
- 在 WSL 里按上面 Mac/Linux 的方式装
- 仓库放在 Linux 家目录（如
~/projects/），不要放 /mnt/c/...——跨文件系统性能差一大截
四、IDE 插件：VS Code / Cursor / JetBrains
- VS Code / Cursor / Windsurf：在扩展市场搜「Codex – OpenAI's coding agent」安装，登录 ChatGPT 账号或填 API Key 即可。默认进入 Agent 模式（可读文件、跑命令、改代码）
- JetBrains 全家桶（IntelliJ / PyCharm / WebStorm / Rider 等）：JetBrains 插件市场装 Codex 插件，支持 ChatGPT 登录、API Key、JetBrains AI 订阅三种鉴权
- Cursor 用户注意：Cursor 的活动栏默认横向排列，装完可能看不到 Codex 图标——去折叠项里找，或把它 pin 出来
一个省心的设计：CLI 和 IDE 插件共享登录态和会话，终端里开的任务可以在 IDE 里接着看，不用登录两次。
五、桌面 App：注意 7 月 9 日起的大变化
这里有个刚发生的时效信息：OpenAI 在 2026 年 7 月 9 日发布了整合 Chat / Work / Codex 三合一的新版 ChatGPT 桌面 App（Windows / Mac，全档位含免费版可下载），独立的 Codex App 将并入这个新 App，旧版桌面应用更名 ChatGPT Classic。
所以如果你现在搜「Codex 桌面版下载」，注意别装到即将淘汰的旧独立 App——直接装新版 ChatGPT 桌面 App 就包含 Codex 了。当天同场发布的 ChatGPT Work 智能体与 Codex 共享同一个用量池，重度用户要留意额度，详见我们的快反：ChatGPT Work + GPT-5.6 全量开放解读。
六、装好之后：三分钟验证清单
codex --version # 有版本号 = CLI 装对了
codex login status # 确认登录态（截至发稿的 CLI 版本，如命令有变以 codex --help 为准）
cd 你的项目 && codex # 进项目目录发起一个小任务试跑
IDE 插件验证：侧边栏点开 Codex 图标 → 能看到和 CLI 相同的会话列表 = 登录态互通正常。
七、国内用户的前置条件
Codex 好用的前提是有 Plus 或 Pro 订阅，国内用户的卡点通常在支付：OpenAI 走 Stripe 风控，国内发行的信用卡大概率被拒，挂梯子没用（风控看发卡行不是 IP）。可行路径：海外实体卡、App Store 内购（有苹果抽成加价）、或通过代充平台在你自己的账号上完成升级——完整对比见 ChatGPT Plus 充值指南。
如果你是重度 Codex 用户，Plus 的额度大概率不够跑，值不值得直接上 Pro 看这篇：Codex 重度用户值不值得上 Pro。用 PayForChat 代充 Plus/Pro 支持微信/支付宝，订阅落在你自己的账号上，价格和到账时效见套餐页，Codex 场景的专属说明见 Codex 充值页。
FAQ
Q: 装 Codex CLI 需要付费账号吗？
A: 安装本身免费，但实际使用 Agent 能力需要 ChatGPT 付费订阅（Plus 起步）或按量计费的 API Key。免费账号装上也基本用不了。
Q: npm 装 Codex 用哪个包名？
A: @openai/codex（带 scope），需要 Node.js 22+。npm 上不带 scope 的 codex 是 2012 年的无关老包，别装错。
Q: Windows 上 Codex 为什么官方推荐 WSL2？
A: 原生 Windows 的 AppContainer 沙箱截至发稿仍是实验性，默认限制文件写入和网络。WSL2 下体验等同 Linux，注意仓库要放在 Linux 家目录而不是 /mnt/c 路径，性能差距明显。
Q: brew install --cask codex 装完终端里没有 codex 命令怎么办？
A: cask 在部分环境装的是桌面 App 而非 CLI。改用 npm install -g @openai/codex 或官方 install.sh 脚本装 CLI 即可，两者可共存。
Q: CLI 和 VS Code 插件要分别登录吗？
A: 不用。CLI 和 IDE 插件共享登录态和会话，登录一次两边都能用，任务进度也互通。
Q: 国内怎么开通 Plus/Pro 来用 Codex？
A: 国内银行卡直接支付大概率被 Stripe 风控拒绝。可行路径包括海外卡、App Store 内购（有加价）、或通过 PayForChat 在你自己的账号上代充（支持微信/支付宝），价格和到账时效见套餐页 /plans。
更新记录
- 2026-07-10：首次发布。安装命令、包名、Node 版本要求、Windows 沙箱状态、IDE 插件渠道均按 OpenAI 开发者文档与 GitHub 仓库（openai/codex）核实；新版桌面 App 并入 Codex 独立 App 为 2026-07-09 官方公告信息。CLI 子命令随版本迭代较快，以
codex --help 实际输出为准，本文随大版本更新。