Codex 安装配置全平台指南：Mac/Windows/Linux 与 IDE 插件（2026）
梳理 Codex 五个入口的区别，覆盖 Mac、Windows 与 Linux 的 CLI 安装方法，以及 VS Code、JetBrains 插件和桌面 App 的配置要点，并说明国内订阅的前置条件。
一、装之前：先搞清鉴权方式
Codex 有五种入口，包括终端 CLI、IDE 插件（VS Code 与 JetBrains）、桌面 App、网页版（chatgpt.com/codex）以及 Chrome 扩展。本文集中说明全平台的安装、登录与验证，并补充国内用户的前置条件。
日常写代码建议使用 CLI 与 IDE 插件组合，两者共享登录态和会话，配置一次即可在两端继续任务。Mac 和 Linux 用户可用一条官方脚本完成安装；Windows 原生沙箱截至发稿仍标注为实验性，官方推荐在 WSL2 中运行。开始前需要具备可登录的 ChatGPT 付费账号（Plus 起步）或 API Key，二选一。
Codex 的登录方式有两种。第一种是 ChatGPT 账号登录，适合个人用户，用量走订阅额度，Plus 或 Pro 档分别对应不同配额，额度机制为 5 小时窗口加周上限，不需要单独管理 API 计费。第二种是 API Key，按 token 计费，适合团队或持续集成场景，API 账户需要保有余额。免费账号可以安装 CLI，但基本无法使用 Agent 能力，因此实际使用前需要先解决付费订阅。
二、Mac / Linux 安装
在 Mac 或 Linux 上，推荐优先使用官方脚本，脚本会自动选择对应架构并完成安装。其次可以使用 npm，包名必须是 @openai/codex，带有 scope。npm 上不带 scope 的 codex 是 2012 年的无关旧包，安装后不会报错，但完全不是同一个工具。使用 npm 前需要确认 Node.js 版本为 22 及以上，版本过低会导致安装失败或运行报错。
Homebrew 也可以安装，但需要注意使用 cask。部分环境中，Homebrew 的 cask 安装的是桌面 App 而不是 CLI；如果安装完成后终端里没有 codex 命令，建议放弃 Homebrew，改用 npm 或官方脚本重新安装 CLI。安装完成后，在终端执行 codex --version 或 codex --help，能正常输出版本或帮助信息即表示安装成功。
三、Windows 安装
Windows 下可以通过官方 PowerShell 脚本或 winget 安装。需要特别注意的是，Codex 在原生 Windows 上使用 AppContainer 沙箱，默认限制文件写入和网络访问，OpenAI 截至发稿仍将其标注为实验性，官方推荐的稳定用法是 WSL2。
具体步骤是：先安装 WSL2 和 Ubuntu，再在 WSL 中按照 Mac/Linux 的方式安装 Codex。项目仓库建议放在 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 等）在插件市场安装 Codex 插件后，支持 ChatGPT 登录、API Key 以及 JetBrains AI 订阅三种鉴权方式。Cursor 用户需要留意，Cursor 的活动栏默认横向排列，安装后可能看不到 Codex 图标，需要从折叠项中查找或将其固定出来。
CLI 与 IDE 插件共享登录态和会话，终端里开始的任务可以在 IDE 中继续查看，不需要重复登录。
五、桌面 App：注意 7 月 9 日起的变化
2026 年 7 月 9 日，OpenAI 发布了整合 Chat、Work 与 Codex 三合一的新版 ChatGPT 桌面 App，覆盖 Windows 和 Mac，全档位包括免费版都可下载。独立的 Codex App 将并入这个新 App，旧的桌面应用更名为 ChatGPT Classic。
如果现在搜索 Codex 桌面版下载，需要注意不要安装即将淘汰的旧独立 App，直接安装新版 ChatGPT 桌面 App 即可包含 Codex。同场发布的 ChatGPT Work 智能体与 Codex 共享同一个用量池，重度用户需要留意额度消耗。
六、装好之后：三分钟验证清单
安装完成后可以在终端执行 codex --version 确认 CLI 可用，再执行登录命令完成账号绑定。IDE 插件验证可以打开侧边栏的 Codex 图标，能看到与 CLI 相同的会话列表，说明登录态互通正常。如果会话列表为空或登录失败，可以重新登录同一账号检查。
七、国内用户的前置条件
Codex 发挥作用的前提是拥有 Plus 或 Pro 订阅。国内用户的主要卡点在支付环节：OpenAI 使用 Stripe 风控，国内发行的信用卡大概率被拒绝，仅靠切换网络节点无法解决，因为风控依据是发卡行而不是 IP。
可行的路径包括使用海外实体卡、通过 App Store 内购（会有苹果抽成带来的加价），或通过第三方平台在自己的账号上完成升级。具体差异可以参考站内 ChatGPT Plus 充值指南。重度 Codex 用户如果觉得 Plus 额度不够，需要评估是否升级到 Pro。