安装 Codex CLI 最重要的不是把一条命令粘进终端，而是确认命令来自官方、安装后系统能找到 codex，并且版本与帮助信息都能正常输出。
当前官方同时提供独立安装脚本，也保留 npm / Homebrew 等安装入口。
macOS / Linux：优先看官方独立安装脚本
当前 OpenAI Codex CLI 文档给出的独立安装方式是：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
安装后重新打开终端，检查：
command -v codexcodex --versioncodex --help
成功标准不是“安装器没有报错”，而是系统能找到命令，版本和帮助信息都能正常输出。
Windows：使用当前官方 Windows 安装入口
OpenAI 当前 Codex CLI 页面已经提供 Windows 安装标签页。
如果你在 Windows 上安装，建议先打开官方页面确认当前 Windows 命令，再执行，不要长期照搬旧博客里的 PowerShell 命令。
安装后检查：
Get-Command codexcodex --versioncodex --help
npm 路线
如果你已经有 Node.js / npm，也可以使用 npm 安装：
npm install -g @openai/codex
这时先检查：
node --versionnpm --version
如果 npm 本身不存在，先解决 Node.js 运行时问题。
不要把“npm 没装”和“Codex 安装失败”当成同一个问题。
Homebrew 路线
OpenAI 当前 CLI 页面也提供 Homebrew 安装入口。
因为安装方式可能随着版本更新，发布文章时建议保留“官方 Homebrew 标签页”这一入口，而不是把第三方博客里的旧命令长期写死。
安装完但找不到 codex
macOS / Linux：
command -v codexprintf '%s\n' "$PATH"
Windows：
Get-Command codex -ErrorAction SilentlyContinue$env:Path -split ';'
先确认可执行文件安装到了哪里，再做最小 PATH 调整。
不要把一个来源不明的目录整个加入系统 PATH。
第一次启动
进入一个测试项目：
cd /你的/测试项目codex
首次启动后，按当前 Codex 提示选择登录方式。
AI Code With 不应该出现在安装第一步
AI Code With 不是 Codex 官方安装源。
它更适合在 Codex 已经安装成功、用户准备配置 API Key / Provider 的下一步出现。
AI Code With 当前 Codex 文档提供了自己的安装与配置教程，但其中部分配置字段会受到 Codex CLI 版本变化影响，所以更稳的方式是：
- 先按 OpenAI 官方方式把 CLI 装好；
- 确认
codex --version正常； - 再打开 AI Code With 当前 Codex 配置页；
- 使用页面当天给出的最新参数完成 Provider 配置。
这样即使 Codex 配置 schema 更新，也不会让“安装”和“第三方 Provider 配置”互相干扰。
相关阅读
- Codex 怎么用
- Codex 从哪里下载
- Codex API Key 怎么配置
资料来源
- OpenAI Codex CLI：https://developers.openai.com/codex/cli
- AI Code With Codex：https://docs.aicodewith.com/zh/docs/codex-cli
