第 1 篇 Codex 安装与基础使用

安装、认证与环境验证

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

用途

指导用户完成 OpenAI Codex CLI 的安装、认证和环境验证，并提供基础命令用法。

安装路径（按优先级推荐）

1. npm（跨平台最常用，需 Node.js 22+）

npm install -g @openai/codex

codex --version

1. 官方一键脚本

# macOS / Linux

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

# Windows (PowerShell)

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

1. Homebrew（macOS）：brew install --cask codex
2. 独立二进制：从 github.com/openai/codex Releases 下载对应平台 tar.gz（无 Node 依赖，适合服务器/CI）
3. 桌面 App：Windows 从 Microsoft Store 搜 "OpenAI Codex"，或终端运行 codex app

环境要求

• Node.js 22+（npm 方式）、Git 2.23+、内存 4GB（推荐 8GB）
• Windows：官方已有原生 PowerShell 安装路径，WSL2 体验仍最稳定（wsl --install 后在 WSL 内装 Node 22+）

认证（二选一）

• 方式 A（推荐）：ChatGPT 账号登录——首次运行 codex 弹浏览器授权；需 Plus/Pro/Team/Edu/Enterprise 付费订阅（Plus 约每 5 小时 30-150 次交互）
• 方式 B：API Key——适合脚本/CI：

export OPENAI_API_KEY="sk-..." # macOS/Linux

$env:OPENAI_API_KEY="sk-..." # Windows PowerShell

警告：不要把 Key 写进 shell 配置文件并提交 Git。

基础命令速查

codex # 交互模式(建议在 git 仓库内)

codex "解释这个代码库" # 单条任务

codex --full-auto "..." # 全自动(先开 git 分支!)

codex exec "..." # 无界面模式(CI)

codex resume --last # 恢复上次会话

git diff | codex "总结改动" # 管道输入

会话内：/model 换模型、/review 审查、/init 生成 AGENTS.md、/permissions 调权限。

审批模式（安全旋钮）

Suggest（默认，改动需批准）→ Auto Edit（自动改文件、命令需批准）→ Full Auto（全自主，受 OS 级沙箱约束）。新手先用 Suggest 跑熟。

验证安装成功

codex --version # 有版本号输出

codex # 能进入交互界面并完成登录

若报错，转用 codex-troubleshooting 技能排查。