2026 年的 Codex 已经不是一个单独的软件，很多 2025 年的教程已经过时。最大的变化：OpenAI 把 Chat、Work、Codex 整合进了新版 ChatGPT Desktop，原来的独立 Codex App 更新后就会变成新版桌面端，对话和项目保留。所以别再看到"Codex.exe""Codex Desktop 安装包"就随便下载。

一、三种使用方式

方式 形态 适合
ChatGPT Desktop 图形界面 新手、临时任务
Codex CLI 命令行 开发者、服务器
IDE 扩展 VS Code / Cursor / Windsurf 日常写代码

Codex Web 是云端使用，不算本地安装。三者不冲突，我自己是桌面版 + CLI 按任务切换。

已经装过旧 Codex App 的：先更新，不要卸载重装。更新后 Chat、Work、Codex 统一进入新版桌面端。桌面上可能同时出现 ChatGPT（新版，含 Codex）和 ChatGPT Classic（旧应用），要用 Codex 就开新版。

二、Windows

桌面版

Microsoft Store 搜 "ChatGPT"（确认开发者 OpenAI）→ 安装 → 登录 → 左上角切到 Codex。系统要求 Windows 10 17763+（x64/arm64），建议 Windows 11。

Store 打不开/一直转圈的处理顺序：

  1. 退出 Store 重新打开、重登微软账号；
  2. Win + R 运行 wsreset.exe 清缓存；
  3. 设置 → Apps → Installed apps → Microsoft Store → Advanced options，先 Repair，不行再 Reset。

CLI（推荐）

OpenAI 现在提供官方 PowerShell 安装脚本，不需要先装 Node.js，也不需要 WSL2：

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

装完运行 codex，选 Sign in with ChatGPT 登录（API Key 是另一套计费，ChatGPT 用户没必要）。

已有 Node.js 环境的也可以：

npm install -g @openai/codex

"装 Codex 必须先装 WSL2"的说法已过时。只有当项目本身部署在 Linux/Docker、依赖 bash 和 apt 时，WSL2 + Ubuntu 才值得。需要时：管理员 PowerShell 运行 wsl --install 重启，然后在 Ubuntu 里执行 Linux 安装脚本即可。

三、macOS / Linux

桌面版：新版 ChatGPT Desktop 同时支持两个平台（macOS 要求 14+，Apple Silicon 和 Intel 均可），登录后左上角进 Codex。

CLI：

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

macOS 也可以 brew install --cask codex。

不想跑脚本的，从 GitHub Releases 直接下载对应平台的二进制（如 codex-aarch64-apple-darwin.tar.gz、codex-x86_64-unknown-linux-musl.tar.gz），解压重命名为 codex。

四、codex 不是命令怎么办

  1. 关掉终端重新打开——PATH 修改只对新终端生效；
  2. npm 安装的用 npm list -g --depth=0 确认 @openai/codex 是否真的装上了；
  3. node -v、npm -v 都不存在的，说明 Node 没装好，直接换官方 PowerShell 脚本更省事。

升级：npm 用 npm install -g @openai/codex@latest，Homebrew 用 brew upgrade --cask codex，脚本安装的重跑一次脚本。

五、安全

只从官方渠道下载：OpenAI 官网、Microsoft Store、官方 GitHub（github.com/openai/codex）、官方安装脚本。网盘、QQ 群、Telegram、"汉化版""特别版"一律不碰——Codex 有读文件、改代码、执行终端命令的权限，被篡改的安装包风险远大于普通软件。

第一次使用建议：

  • 新建 codex-test 目录先测一轮（让它建个 hello-world，观察读目录、建文件、执行命令是否正常），别直接丢科研项目进去；
  • 先从小项目开始，看清权限提示，逐步扩大权限；
  • CLI 从项目目录启动：cd 项目目录 然后 codex，比启动后再描述路径清晰得多；
  • 正式项目先 git add . && git commit 建立基线再让 Codex 动手，改坏了 git diff 一眼看到。

六、一分钟安装速查

环境 命令
Windows CLI powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
macOS / Linux CLI curl -fsSL https://chatgpt.com/codex/install.sh | sh
已有 Node.js npm install -g @openai/codex
macOS Homebrew brew install --cask codex
Windows 桌面版 Microsoft Store 搜 ChatGPT

所有 CLI 装完都是运行 codex，Sign in with ChatGPT，结束。真正要注意的不是安装本身，而是：别用过时教程、别下来源不明的包、别一上来就折腾 WSL2、别第一次使用就给 Codex 过大的项目权限。