Opus + Codex 协作开发工作流(小白版)
核心理念Claude Opus负责规划与编码OpenAI Codex负责补充细节与代码审查两个 AI 各司其职比单独使用效果更好。工具介绍工具说明安装方式Claude CodeAnthropic 出品的 AI 编程 CLIOpus 是其最强模型npm install -g anthropic-ai/claude-codeOpenAI Codex CLIOpenAI 出品的代码 AI CLI擅长代码分析和审查npm install -g openai/codex第一步环境准备只需做一次1. 安装工具npminstall-ganthropic-ai/claude-codenpminstall-gopenai/codex2. 验证安装成功claude--version# 看到版本号说明 OKcodex--version# 看到版本号说明 OK3. 配置 API Key# 把下面的 sk-ant-... 替换成你的真实 KeyexportANTHROPIC_API_KEYsk-ant-...# 把下面的 sk-... 替换成你的真实 KeyexportOPENAI_API_KEYsk-...Key 获取地址Claude Keyhttps://console.anthropic.com/settings/keysOpenAI Keyhttps://platform.openai.com/api-keys永久生效把上面两行加到~/.zshrc或~/.bashrc文件末尾然后运行source ~/.zshrc4. 验证 Key 配置正确claude--print说你好# 应该返回一段回复codex说你好# 应该返回一段回复工作流概览[你的需求] ↓ [阶段一] Opus 规划 ← 想清楚要做什么、怎么做 ↓ plan.md [阶段二] Codex 补细节 ← 填充接口、类型、边界条件 ↓ plan_detailed.md [阶段三] Opus 写代码 ← 生成第一版可运行代码 ↓ 代码文件 [阶段四] Codex 审查 ← 找 bug、安全问题、优化建议 ↓ review.md [完成]阶段工具为什么用这个工具规划Claude Opus长链推理强能把需求拆成清晰的技术方案补细节Codex代码上下文理解好擅长接口和类型设计写代码Claude Opus推理能力强能把规划转成可运行代码代码审查Codex代码专项能力强擅长找 bug 和安全问题阶段一Opus 规划目标把模糊需求变成清晰的技术方案文件推荐方式使用 Plan Mode避免误操作claude--modelclaude-opus-4-6# 启动交互模式进入后输入/plan然后描述你的需求例如实现用户注册功能邮箱密码注册发送验证邮件JWT 鉴权为什么用/planPlan Mode 下 Opus 只会规划不会直接修改你的代码文件更安全。也可以用命令行直接生成规划文件claude--modelclaude-opus-4-6\--output-format text\请为以下需求制定技术规划输出 1. 功能模块拆解 2. 技术选型 3. 文件结构 4. 关键接口定义 5. 实现顺序 需求用户注册功能邮箱密码发送验证邮件JWT 鉴权plan.md验证规划成功catplan.md# 应该看到结构化的技术方案阶段二Codex 补充细节目标基于规划补全接口签名、类型定义、错误处理等细节codex基于以下规划补充细节包括 - 完整的函数签名和参数类型TypeScript - 错误处理方式和错误码 - 边界条件和异常场景 - 数据库表结构定义 规划$(catplan.md)plan_detailed.md只补充某个模块codex为 UserService 设计完整的方法签名包含 TypeScript 类型和 JSDoc 注释验证细节补充成功catplan_detailed.md# 应该看到比 plan.md 更详细的内容包含类型定义阶段三Opus 生成初版代码目标基于详细规划生成第一版可运行代码推荐方式在项目目录中交互操作cdyour-project# 进入你的项目目录claude--modelclaude-opus-4-6# 启动交互模式进入后输入读取 plan_detailed.md按照规划实现初版代码。 先实现核心逻辑边缘情况可用 TODO 标记。小技巧输入/fast开启快速模式Opus 输出速度更快也可以用命令行生成单个文件claude--modelclaude-opus-4-6\实现 src/services/userService.ts参考以下规划$(catplan_detailed.md)\src/services/userService.ts验证代码生成成功# 检查文件是否存在lssrc/services/# 尝试编译TypeScript 项目npx tsc--noEmit阶段四Codex 代码审查目标对生成的代码进行 review找出问题并给出改进建议审查 Git 变更推荐只审查新增代码gitdiffHEAD|codex对这些代码变更进行 code review关注 1. 逻辑错误 2. 安全漏洞SQL 注入、XSS、认证绕过等 3. 性能问题 4. 错误处理是否完整 请给出具体的文件名和行号review.mdcatreview.md审查单个文件codex对以下代码进行 code review$(catsrc/services/userService.ts)输出结构化审查报告gitdiffHEAD|codex以 Markdown 表格输出 code review 结果 | 文件 | 行号 | 问题类型 | 描述 | 建议修改 |review_report.md根据审查意见修改代码claude--modelclaude-opus-4-6\根据以下 review 意见修改代码 Review 意见$(catreview.md)当前代码$(catsrc/services/userService.ts)完整示例从零实现用户注册功能复制下面的命令替换项目路径直接运行# Step 1: Opus 规划约 1-2 分钟claude--modelclaude-opus-4-6\--output-format text\规划用户注册功能邮箱密码注册发送验证邮件JWT 鉴权plan.mdecho 规划完成内容如下 catplan.md# Step 2: Codex 补细节约 1 分钟codex补充以下规划的接口细节和 TypeScript 类型定义$(catplan.md)plan_detailed.mdecho 细节补充完成 # Step 3: 进入项目Opus 实现初版cdmy-project# 替换成你的项目路径echo请在 claude 交互模式中输入读取 plan_detailed.md 并实现用户注册功能claude--modelclaude-opus-4-6# Step 4: Codex Review 变更实现完成后运行gitdiff|codexreview 这些代码变更给出具体改进建议review.mdcatreview.md常用技巧在 Claude Code 中切换模型# 启动时指定 Opusclaude--modelclaude-opus-4-6# 交互模式中切换/model claude-opus-4-6# 切到 Opus最强最慢/model claude-sonnet-4-6# 切到 Sonnet均衡/model# 查看当前模型开启快速模式/fast # 在交互模式中输入让 Opus 输出更快用 Ultraplan 在浏览器中查看规划新功能/ultraplan # 生成可在浏览器中查看和评论的规划草稿回退到上个版本误操作了# 在 claude 交互模式中按两下 Esc 键# 或输入/rewind用文件传递上下文节省 token# 好的方式引用文件claude根据以下规划实现$(catplan_detailed.md)# 在交互模式中更简单读取 plan_detailed.md 并按其实现代码只审查安全问题codex仅审查安全问题包括 OWASP Top 10src/auth/login.ts各场景选哪个模型场景推荐原因系统架构设计Opus长链推理、全局视角接口细节设计Codex代码上下文理解强复杂业务逻辑实现Opus推理能力强代码规范/安全审查Codex代码专项能力强简单功能快速实现Sonnet速度与质量平衡单元测试生成Codex代码模式匹配强常见问题Q:claude: command not found# 检查 npm 全局安装路径npmroot-g# 把路径加到 PATH例如exportPATH$(npmroot-g)/../bin:$PATHQ:ANTHROPIC_API_KEY报错# 检查 Key 是否正确设置echo$ANTHROPIC_API_KEY# 应该显示你的 Key# 如果没显示重新执行 export 命令Q: 生成的代码有很多 TODO正常现象。Opus 默认先实现核心逻辑边缘情况用 TODO 标记。继续在交互模式中说“实现所有 TODO 部分” 即可。Q: 上下文太长Claude 变慢了# 在交互模式中手动压缩上下文/compact命令速查表Claude Code命令说明claude启动交互模式claude --model claude-opus-4-6指定 Opus 模型启动claude --print 你好非交互单次输出/plan进入规划模式不修改代码/fast切换快速模式/ultraplan浏览器规划视图新/model claude-opus-4-6切换模型/rewind回退上一步或按两次 Esc/compact压缩上下文/doctor诊断配置问题Codex命令说明codex prompt单次提问codex review file审查文件codex --model o4-mini prompt指定模型更快更便宜git diffcodex “review 变更”