更新时间：2026-03-19
适合人群：第一次安装和使用 Codex 的开发者

一、先说结论：你该怎么选安装方式

先给个直接的建议，如果你是一位普通开发者，安装方式的优先级可以这么排：

1. Windows 用户：优先考虑 Codex App（Microsoft Store）
2. macOS 用户：优先考虑 Codex App（官方 DMG）
3. Linux 用户：当前优先选择 Codex CLI / IDE 扩展

如果你更偏爱命令行工作流，无论哪个系统，都可以直接上 Codex CLI。不过，官方对于 Windows 下 CLI 的态度还是比较谨慎的，明确标注为“实验性支持”，推荐配合 WSL 使用。

二、Windows 下载与安装（Codex App）

在 Windows 上安装 Codex App，走微软商店是最省事的路径，具体步骤如下：

第 1 步：打开 Microsoft Store 页面
直接访问官方链接：

https://apps.microsoft.com/detail/9plm9xgg6vksgl=US&hl=en-US

第 2 步：安装应用
在商店页面点击“获取/安装”，等进度条走完，启动 Codex App 就行了。

第 3 步：首次启动登录
第一次打开会要求登录，推荐直接用 ChatGPT 账号登录，省去额外配置的麻烦。

第 4 步：选择本地项目
进入后，点击 Add project 或者按快捷键 Ctrl + O，指定你的代码目录即可。

第 5 步：检查 Windows 环境设置（建议）
这一步容易被忽略，建议进入 Settings 确认一下：Agent 环境是选 Windows Native 还是 WSL；默认编辑器（VS Code、Visual Studio 等）以及集成终端（PowerShell / CMD / Git Bash / WSL），根据自己的习惯提前设置好。

三、macOS 下载与安装（Codex App）

macOS 用户走官方 DMG 安装，流程同样直接：

第 1 步：下载 DMG
Apple Silicon 机型的官方下载入口在这里：

• https://persistent.oaistatic.com/codex-app-prod/Codex.dmg

第 2 步：安装
下载完成后，双击 Codex.dmg，把 Codex 拖拽到 Applications 文件夹里就行。

第 3 步：首次打开与权限确认
从应用程序目录启动 Codex，如果系统弹窗提示安全风险，按照 macOS 的指引允许打开即可。

第 4 步：登录与选项目
登录 ChatGPT 账号，选好你的项目目录，就可以开始第一条线程了。

四、Linux 现状与推荐路径

截至 2026-03-19，Linux 用户还没等到正式的桌面 App。官方提供了一个通知登记页：

• https://openai.com/form/codex-app/

这意味着，Linux 桌面 App 目前是“待通知”状态。现阶段建议 Linux 用户直接切换到：

1. Codex CLI
2. Codex IDE Extension（适用于 VS Code / Cursor / Windsurf 等）

五、CLI 安装流程（macOS / Linux / Windows-WSL）

CLI 的安装过程对三大系统都大同小异，核心就两步：装 Node.js，然后装 Codex CLI。

第 1 步：安装 Node.js（若未安装）
确认环境是否就位：

node -v
npm -v

第 2 步：安装 Codex CLI

npm i -g @openai/codex

第 3 步：启动 Codex

codex

首次运行会提示登录，可以用 ChatGPT 账号或 API Key。

第 4 步：升级 Codex CLI

npm i -g @openai/codex@latest

Windows CLI 特别说明
再强调一下：官方文档明确表示，CLI 在 Windows 是实验性支持。最佳实践是在 WSL 工作区里运行，直接跑在 Windows 上可能会遇到一些兼容性问题。

六、IDE 扩展安装流程（VS Code / Cursor / Windsurf）

如果你更习惯在编辑器里工作，IDE 扩展是个不错的选择。流程更简单：

第 1 步：打开扩展市场页面
官方 Codex IDE 文档页在这里：

• https://developers.openai.com/codex/ide

根据你用的 IDE（VS Code / Cursor / Windsurf / VS Code Insiders），进入对应的下载入口。

第 2 步：安装扩展并重启 IDE
安装完成后，如果侧边栏没出现 Codex 图标，重启编辑器一次通常就能解决。

第 3 步：登录
扩展启动后会提示登录，同样支持 ChatGPT 账号或 API Key。

下载指导

1. 扩展市场页面
2. IDE 中的 Codex 图标位置
3. 登录提示页
4. 扩展侧栏聊天界面

官方示意图：

七、怎么登录（ChatGPT 账号 vs API Key）

Codex 目前支持两种登录方式：

1. ChatGPT 账号登录（推荐）
2. OpenAI API Key 登录

为什么推荐 ChatGPT 登录？理由很直接：对大多数用户来说更省事，不用手动复制 Key 或者配置环境变量，而且一些面向订阅用户的高级功能（比如 cloud threads）会体验更完整。需要注意的是，官方文档也写明，如果用 API Key 登录，部分能力可能会受限。

八、常见问题

Q1：我在 Windows 上到底用 App 还是 CLI？
新手建议优先走 App 路线；如果你是命令行重度用户，可以在 WSL 里跑 CLI。

Q2：为什么我登录后有些功能看不到？
先排查三个点：是否用 ChatGPT 账号登录；你的套餐是否包含 Codex；是否处于灰度测试或区域差异中。

Q3：额度突然消耗快是不是异常？
不一定。大型仓库、长上下文、多任务并行，都会显著提高消耗速度。

官方参考链接

• Codex with ChatGPT plan（Help Center）
  https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan
• Codex App
  https://developers.openai.com/codex/app
• Codex App for Windows
  https://developers.openai.com/codex/app/windows
• Codex CLI
  https://developers.openai.com/codex/cli
• Codex IDE Extension
  https://developers.openai.com/codex/ide
• ChatGPT Pricing
  https://chatgpt.com/pricing
• Linux App 通知登记
  https://openai.com/form/codex-app/