macOS/Linux 使用官方安装器，Windows 使用 PowerShell 安装器；安装完成后进入项目目录运行 codex，再选择 Sign in with ChatGPT。也可以用 npm 或 Homebrew 安装。命令以官方 Codex 仓库和 CLI 文档为准。
官方参考：OpenAI Codex GitHub · Codex CLI 官方指南 · Codex 登录排查
安装前先选适合你的方式
| 系统/习惯 | 推荐方式 | 适合谁 |
|---|---|---|
| macOS 或 Linux | 官方 shell 安装器 | 希望快速安装并按官方方式更新 |
| Windows | 官方 PowerShell 安装器 | Windows 原生终端用户 |
| Node.js/npm | npm install -g @openai/codex | 已经用 npm 管理全局 CLI |
| macOS Homebrew | brew install --cask codex | 用 Homebrew 管理桌面/命令行工具 |
| 不想执行安装脚本 | GitHub Releases 二进制 | 希望手动下载对应平台版本 |
macOS 和 Linux 安装 Codex
打开 Terminal，在终端运行官方安装器：
curl -fsSL https://chatgpt.com/codex/install.sh | sh安装结束后，重新打开一个终端窗口，或按安装器提示刷新当前 Shell。然后检查命令是否可用：
codex --version
codex官方安装器默认从 OpenAI 的 Codex releases 下载，必要时会回退到 GitHub Releases。不要从不明镜像复制所谓“破解版”安装命令。
Windows 安装 Codex
在 PowerShell 中运行官方安装命令：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"安装完成后关闭并重新打开 PowerShell，再运行：
codex --version
codex如果公司设备限制脚本执行，先确认组织安全策略允许该安装方式；不要为了安装随意关闭系统防护。遇到 PowerShell、PATH 或权限问题，保存完整错误文本后再继续排查。
用 npm 安装 Codex CLI
如果本机已有 Node.js 和 npm，可以使用官方仓库列出的全局安装方式：
npm install -g @openai/codex
codex --version
codex如果安装成功但提示 codex: command not found，通常是 npm 全局 bin 目录不在 PATH。先查看 npm 的全局目录，再把对应目录加入当前用户 PATH，重新打开终端后测试。不要在同一台电脑同时混用多个旧版本，避免 PATH 指向错误版本。
用 Homebrew 安装 Codex
macOS 用户如果使用 Homebrew，可以运行：
brew install --cask codex
codex --version
codex后续更新通过 Homebrew 管理。若 Homebrew 报错，先运行 brew update 并确认 cask 可用；不要把 Homebrew 的失败误判成账号登录失败。
安装后如何登录？
- 进入你的项目目录，例如
cd ~/code/my-project。 - 运行
codex。 - 首次启动按提示选择 Sign in with ChatGPT 或其他可用方式。
- 浏览器授权完成后回到原终端，输入一个简单任务确认会话可用。
需要重新授权时可以运行：
codex --loginSign in with ChatGPT 和 API Key 是两条不同路径。使用 ChatGPT 计划登录时，不要把密码、验证码或 Session 发给第三方；如果使用 API Key，则要单独准备 API 组织、密钥和预算。
安装成功但 Codex 不能使用怎么办？
| 现象 | 优先检查 | 继续阅读 |
|---|---|---|
| command not found | PATH、npm 全局目录、终端是否重启 | 本页安装检查 |
| 浏览器授权后仍未登录 | 账号、客户端版本、授权是否回到原终端 | Codex 登录不上 |
| token invalid / unauthorized | 认证路径、API Key、工作区权限 | Codex 授权失败 |
| 能运行但很快限流 | Usage、模型、窗口和 Credits | Codex 限流排查 |
| 想在编辑器使用 | IDE 扩展与 CLI 版本 | Codex IDE 扩展 |
更新和卸载时的注意事项
用哪种方式安装，就优先用哪种方式更新：官方安装器重新运行安装命令，npm 用 npm 更新，Homebrew 用 brew 更新。更新前记下当前版本和配置位置，避免多个安装来源互相覆盖。
卸载前确认是否需要保留本地配置、项目指令和会话数据。Codex CLI、IDE 扩展、桌面端和 Cloud 是不同入口；删除 CLI 不会自动删除 ChatGPT 账号、API 组织或云端仓库权限。
常见问题
Codex macOS 和 Linux 怎么安装？
按 OpenAI 官方 CLI 指南运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh，安装后在项目目录运行 codex。
Codex Windows 怎么安装？
在 PowerShell 中运行官方安装命令 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"，完成后运行 codex。
可以用 npm 安装 Codex 吗？
可以。官方 Codex 仓库列出 npm install -g @openai/codex，也列出 Homebrew cask 安装方式。
安装 Codex 后怎么登录？
进入项目目录运行 codex，首次启动按提示选择 Sign in with ChatGPT 或其他可用登录方式；需要重新授权时可运行 codex --login。
Codex 安装后提示 command not found 怎么办？
先确认安装命令成功，再重新打开终端并检查 PATH；如果用 npm 安装，确认全局 npm bin 目录在 PATH 中；也可以运行官方安装器或使用 Homebrew。
需要 Codex 套餐或安装协助？
GPT Pro AI 提供 Codex、ChatGPT Plus/Pro 相关的第三方采购与额度咨询，不代表 OpenAI 官方授权；安装、登录和实际可用性以官方文档与账号页面为准。