OpenAI Codex CLI 怎么安装？Windows、Mac、Linux 官方流程与登录排错这篇写给第一次安装 C

这篇写给第一次安装 Codex CLI 的开发者。很多人不是不会用 Codex，而是卡在第一步：Windows 终端找不到 codex、Mac/Linux 不确定该用 npm 还是官方脚本、安装完以后不知道 codex login 走的是哪个账号。

下面按官方安装流程整理一遍，并补几个国内用户常见的排错点。

Codex CLI 适合什么场景

如果你主要是在项目目录里让 AI 读代码、改文件、跑测试、排查报错，优先装 Codex CLI。

如果你只是想打开桌面应用，或者希望用图形界面管理项目，可以再考虑 Codex App。CLI 更适合开发者日常工作流，尤其是 VS Code、Cursor、SSH、WSL2、Linux 服务器这些场景。

终端运行：

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

检查版本：

codex --version

进入项目目录：

cd your-project
codex

首次运行如果需要授权，按提示打开浏览器完成登录。

打开 PowerShell，运行：

irm https://chatgpt.com/codex/install.ps1 | iex

安装完成后：

codex --version

如果提示 codex 找不到，不要急着重装，先关闭当前 PowerShell，再重新打开一个新的 PowerShell。很多时候只是 PATH 没刷新。

如果你的项目在 WSL2 Ubuntu 里，建议直接在 WSL2 里装 Linux 版本：

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

这比在 Windows 和 WSL2 两边来回切路径更省心。

已经有 Node.js 环境的同学，也可以用：

npm install -g @openai/codex

Mac 用户如果习惯 Homebrew：

brew install codex

不过新手优先推荐官方 standalone installer，依赖更少，出错面也小。

安装成功后执行：

codex login

它会引导你在浏览器完成登录。登录完成后回到终端，再执行：

codex

如果你用的是 ChatGPT Plus/Pro 账号，并且想走官方 Codex 登录流程，我整理了一篇完整的 Plus/Pro 到 codex login 教程：

先重新打开 PowerShell。
还不行再检查 PATH，不要一上来重复安装。

可以换用官方安装脚本，或者先配置 npm 全局包目录。不要随便改系统目录权限。

确认浏览器能访问 ChatGPT/Codex 页面，再重新执行：

codex login

不是。ChatGPT Plus/Pro 是账号订阅，API Key 是 Platform 计费。使用 codex login 时，不要把 Plus/Pro 额度和 API 余额混在一起理解。

安装只是第一步。不同系统下的配置、cc-switch、官方登录和中转配置，我放在 Alpha 节点：

Windows：https://alphalwb.top/?utm_source=juejin&utm_medium=article&utm_campaign=codex_install_202606#/article/codex-config-windows
Mac：https://alphalwb.top/?utm_source=juejin&utm_medium=article&utm_campaign=codex_install_202606#/article/codex-config-mac
Ubuntu：https://alphalwb.top/?utm_source=juejin&utm_medium=article&utm_campaign=codex_install_202606#/article/codex-config-ubuntu