Codex CLI 实战指南：5 月连发 6 次更新，把 GPT-5.5 装进终端的完整工作流（含跟 Claude Code 搭配方案）
原文首发于公众号「开发者效率局」，欢迎关注获取更多 AI 编程实战。
5 月份 OpenAI Codex CLI 连发 6 个版本（0.131.0 → 0.135.0），同时 macOS App 也更新至 26.527。这一系列快速迭代，把“在终端里跑 GPT-5.5”从尝鲜阶段彻底推向了日常主力生产力工具。本文将完整拆解 Codex CLI 的实战工作流，以及如何与 Claude Code 高效搭配使用。
你为什么也该装一个 Codex CLI
很多开发者已经是 Claude Code 的重度用户，我自己也是如此。最初安装 Codex 时，只是抱着“试试看”的心态。但仅仅用了一周，我就把它升级为日常主力工具之一。
它不是用来替代 Claude Code，而是和 Claude Code 形成完美互补。
核心差异体现在以下几点：
- 模型能力差异：Codex 运行 GPT-5.5，Claude Code 运行 Opus 4.8。Codex 在修改 UI 代码、样式调整、组件重构上表现更为稳定；Claude Code 在系统架构设计、复杂逻辑推理上则更具深度。
- 桌面感知能力：Codex 的 macOS/Windows App 支持 Appshots 和桌面控制功能，能直接把当前屏幕窗口截图给模型查看，这对调试 GUI 应用几乎是降维打击。
- Goals 模式：默认开启高层目标模式。你只需提出一个宏观目标，它会自动拆解任务、跟踪进度、自我迭代。
- 统一 @ 提及系统：文件、文件夹、插件、自定义 Skill 全部通过一个智能 picker 调用，极大提升操作效率。
结论是：不需要二选一。
我现在的真实工作流是两个工具同时打开，根据任务类型灵活分配给最擅长的 Agent。
30 秒完成安装并跑通第一个任务
推荐安装方式（需要 Node.js 22+）
npm install -g @openai/codex
或者使用官方一键安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh
安装完成后进行认证：
推荐方式：浏览器 OAuth 登录（ChatGPT Plus/Pro 用户可直接使用订阅额度）
codex auth
或者使用 API Key（适合服务器或自动化场景）
export OPENAI_API_KEY="sk-..."
验证安装并进入交互模式：
codex --version
codex
进入项目目录后直接执行：
cd your-project
codex "分析这个代码库的主要功能，然后提出 3 个可立即执行的改进建议"
Codex CLI 核心命令与高效用法
常用命令速览：
进入对话模式
codex
单次执行任务
codex "重构 src/components/Button.tsx，使用新设计规范"
指定模型版本
codex --model gpt-5.5-codex "优化这个算法的性能"
自动执行模式（适合自动化任务）
codex exec --full-auto "修复项目中所有 ESLint 错误并确保测试通过"
极致模式（谨慎使用）
codex exec --yolo "清除所有 TODO 和临时代码"
三个核心执行参数对比：
| 参数 | 功能 | 适用场景 |
|---|---|---|
exec |
单次执行后退出 | 一次性明确任务 |
--full-auto |
自动执行，跳过大部分确认 | 自动化流水线、批量处理 |
--yolo |
无任何沙箱限制 | 快速实验、原型开发（高危） |
如何与 Claude Code 形成高效搭配
经过大量真实项目验证，我把两个工具的分工明确如下：
Claude Code 更适合：
– 项目 0-1 阶段的架构设计
– 复杂业务逻辑梳理
– 新功能从零到一的完整实现
– 需要深度推理和长期上下文理解的任务
Codex CLI 更适合：
– 大量 UI/样式代码的批量修改
– Bug 修复与细节打磨
– 代码审查（PR Review）
– GUI 应用调试（配合 Appshots）
– 需要快速执行、多次迭代的琐碎任务
这种“Claude Code 往前推，Codex 往细抠”的分工模式，极大提升了整体开发效率。
国内开发者稳定使用建议
由于 OpenAI 访问限制，国内用户建议通过稳定代理或第三方兼容服务进行配置：
export OPENAI_BASE_URL="https://你的代理地址/v1"
export OPENAI_API_KEY="sk-..."
推荐在项目根目录创建 .codex.yaml 文件进行个性化配置，定义专属 Agent 和常用 Skill，进一步提升使用体验。
总结：2025 年的开发者标配工作流
目前最推荐的工作流是：
- Claude Code 作为主力架构师和项目推进器
- Codex CLI + macOS App 作为高效执行者和细节优化专家
- 两者通过明确分工实现 1+1＞2 的效果
5 月的 6 次密集更新已经证明，OpenAI 在 Codex 上的投入决心非常坚定。无论是模型能力、工具生态还是自动化程度，Codex 都在快速追赶并在某些垂直场景实现反超。
现在就把 Codex CLI 装上吧。
你会发现，当 GPT-5.5 真正跑在你的终端里之后，很多以前觉得“麻烦”“要改半天”的工作，十分钟就能处理完。
需要完整配置模板、.codex.yaml 示例文件或 Claude Code 与 Codex 的进阶分工策略，欢迎在评论区留言，我会持续更新实战内容。