Codex CLI 是什么
Codex CLI 是 OpenAI 的终端编程 Agent，能直接在你本地机器上读取、修改、运行代码。和 Claude Code 定位类似——都是"终端里的 AI 程序员"——但有几个关键区别：
| 维度 | Codex CLI | Claude Code |
|---|---|---|
| 开源 | 是，Apache-2.0，Rust 编写 | 否，闭源 |
| 模型 | GPT-5.5 / GPT-5.4 / GPT-5.3-Codex | Claude Opus 4.7 / Sonnet 4 |
| 认证方式 | ChatGPT 账号或 API Key | Claude 账号或 API Key |
| 多形态 | CLI + App + IDE + Web | CLI + IDE |
| 子代理 | 支持 subagents 并行 | Dynamic Workflows 并行 |
GitHub 仓库 87k+ stars，是目前最热门的开源编程 Agent 之一。
安装与配置
前置条件
- macOS / Linux / Windows（含 WSL2）均可
- 需要一个 ChatGPT 账号（Free / Plus / Pro / Business / Edu / Enterprise 均可）或 OpenAI API Key
安装
macOS / Linux（推荐方式）：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm 安装：
npm install -g @openai/codex
Homebrew 安装：
brew install --cask codex
也可以直接从 GitHub Releases 下载对应平台的二进制文件。
登录
codex
# 首次运行会提示登录
两种认证方式：
- Sign in with ChatGPT——推荐，直接关联你的 ChatGPT 订阅
- API Key——适合自动化场景（CI/CD、脚本），按 token 用量计费
升级
重新运行安装脚本即可：
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm
npm install -g @openai/codex@latest
基本用法
进入项目目录，启动：
cd /path/to/your/project
codex
常用命令
| 命令 | 功能 |
|---|---|
codex |
启动交互式 TUI |
codex "任务描述" |
执行一次性任务 |
codex exec "脚本式任务" |
非交互模式，适合自动化 |
/model |
切换模型 |
/status |
查看当前用量和剩余额度 |
/help |
查看所有命令 |
Approval Modes（权限模式）
Codex 在执行文件修改和命令前会请求确认。你可以选择不同的信任级别：
| 模式 | 行为 |
|---|---|
| Suggest | 只建议，不执行（最安全） |
| Auto Edit | 自动编辑文件，执行命令需确认 |
| Full Auto | 自动编辑和执行（适合可信项目） |
模型选择与成本
可用模型
| 模型 | 特点 | 适合场景 |
|---|---|---|
| GPT-5.5 | 旗舰，最高质量 | 复杂推理、架构设计 |
| GPT-5.4 | 高质量，较平衡 | 日常编码 |
| GPT-5.4-mini | 快速，成本低 | 简单任务、批量操作 |
| GPT-5.3-Codex | Codex 专用模型 | Cloud Tasks、Code Review |
定价结构
ChatGPT 订阅（按消息额度）：
| 套餐 | 月费 | 说明 |
|---|---|---|
| Free | $0 | 体验级别 |
| Plus | $20 | 每周几次深度编码 |
| Pro 5x | $100 | 5 倍 Plus 额度 |
| Pro 20x | $200 | 20 倍 Plus 额度 |
| Business | 按需 | 团队协作 |
API Key（按 token 计费）：
| 模型 | 输入 | 缓存输入 | 输出 |
|---|---|---|---|
| GPT-5.5 | $5/M tokens | $0.50/M | $30/M |
| GPT-5.4 | $2.50/M tokens | $0.25/M | $15/M |
| GPT-5.4-mini | $0.75/M tokens | $0.075/M | $4.50/M |
社区反馈：Simon Willison 同时使用 Codex 和 Claude Code，Codex CLI 在 API 模式下月均花费约 $980。重度用户建议用 ChatGPT Pro 套餐控制成本。
省钱技巧
- 日常任务用
GPT-5.4-mini，复杂任务切GPT-5.5 - 控制
AGENTS.md大小——项目指令越长，每次请求的 token 越多 - 减少 MCP server 数量——每个 MCP 都会注入额外上下文
- 用
/status随时查看剩余额度
Codex CLI vs Claude Code：怎么选
这不是"谁更好"的问题，而是"哪个更适合你当前的任务"。
用 Codex CLI 的场景
- 需要开源和可审计——可以看源码、提 PR、自行编译
- 已在 OpenAI 生态内——团队用 ChatGPT、OpenAI API
- 相对独立的编码任务——写函数、修 bug、生成测试
- 自动化脚本——
codex exec适合 CI/CD 集成 - 多形态需求——同一个工具覆盖 CLI + 桌面 App + IDE + Web
用 Claude Code 的场景
- 复杂多步骤任务——跨 10+ 文件的大型重构、Dynamic Workflows 自动编排
- 需要 worktree 隔离——并行开发时文件系统级隔离
- 深度 Git 集成——Auto mode、Computer use、Monitor 等成熟工作流
- Opus 4.7 级别推理——某些架构决策和复杂调试场景
两个都用
关键代码变更前让两个 Agent 各给一份方案，互相验证。这是目前社区里越来越常见的做法。
常用工作流
工作流 1：Bug 修复
cd my-project
codex
> 查看最近的 git log，找到 commit abc123 引入的问题。
> src/auth.ts 第 42 行的 token 过期检查有 bug，
> 当 refresh token 为空时会 crash。修复它，加上对应的单元测试。
Codex 会读取文件、定位问题、生成修复、运行测试——一个会话完成。
工作流 2：非交互式自动化
# 在 CI 中自动生成 CHANGELOG
codex exec "根据最近的 git commits 生成 CHANGELOG.md 条目，放在 'Unreleased' 段落下"
# 批量代码格式化检查
codex exec "检查 src/ 下所有 .ts 文件，修复不符合 prettier 规范的格式问题"
工作流 3：Code Review
codex
> 审查我当前未提交的改动。关注：安全漏洞、性能问题、
> 缺失的错误处理。输出问题列表和修复建议。
Codex 可以启动独立的 review agent 分析你的 diff。
注意事项
- 它能操作你的文件系统——重要项目建议先用 Suggest 模式，确认行为符合预期后再切换到 Auto Edit 或 Full Auto
- Cloud Tasks 和 Code Review 目前仅限 GPT-5.3-Codex 模型——API Key 模式下不可用
- API Key 模式功能受限——没有 cloud-based 功能（GitHub review、Slack 集成等），且新模型上线有延迟
- 用量和额度共享——Codex 使用量与 ChatGPT 其他 agentic 功能共享额度，重度使用需注意
- AGENTS.md 是项目配置文件——类似 Claude Code 的
CLAUDE.md，Codex 读取项目根目录的AGENTS.md获取项目规则。参见 AGENTS.md 文档 - 中文交互可用——GPT-5.5 中文理解能力足够处理日常编码需求，但技术文档和社区资源以英文为主