核心前提

• 系统：macOS/Linux/Windows（推荐 WSL）
• 环境：Node.js ≥22（必备）
• 账号：ChatGPT 账号 或 OpenAI API Key

方式一：AI 一键代装（懒人首选）

复制发给 AI（Trae / 豆包等）：

帮我自动检查环境并安装 Codex CLI：

1. 检测系统与 WSL；2. 检查 Node 并指引安装；3. 按系统安装 Codex；4. 验证并告诉我启动方法

方式二：手动极速安装（极客版）

1. 检查 / 安装 Node.js

node -v  # 需≥v22

• Mac：brew install node
• Linux：sudo apt install nodejs npm
• Windows：nodejs.org 下载安装

2. 安装 Codex CLI

# 通用安装
npm i -g @openai/codex

# 国内加速
npm i -g @openai/codex --registry=https://registry.npmmirror.com

# Mac专属（Homebrew）
brew install codex

3. Windows 特殊说明

• 有 WSL：在 WSL 内执行安装，使用先输wsl再输codex
• 无 WSL：npm i -g @openai/codex --force --no-os-check（兼容风险）

4. 验证安装

codex --version

登录与启动

登录（二选一）

1. ChatGPT 账号（推荐）运行codex → 选Sign in with ChatGPT → 浏览器登录
2. API Key

# Mac/Linux临时
export OPENAI_API_KEY="sk-xxx"
# 永久写入zshrc
echo 'export OPENAI_API_KEY="sk-xxx"' >> ~/.zshrc && source ~/.zshrc
# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxx"

启动使用

# 进入项目目录
cd your-project
# 启动
codex

首次选Yes, continue即可开始交互。

三种运行模式

• codex（默认）：仅建议，不改文件
• codex --auto-edit：自动改代码，需确认命令
• codex --full-auto：全自动改码 + 执行（谨慎使用）