← Volver a las guías

Codex 与 Claude Code 并排运行：从双终端到分支合并的实战流程

先分工：并行开发不等于同时改同一份代码

同时运行 Codex 和 Claude Code，最有价值的用法不是让它们重复回答问题，而是把一个功能拆成可独立交付的任务。下面以“给任务列表增加 CSV 导出”为例：Codex 实现导出函数，Claude Code 根据约定编写测试和使用说明。

开始前，提交当前修改，运行一次项目现有测试，并记录基线。提前约定函数签名、输入字段、输出顺序，以及逗号、双引号和换行的转义规则。共享接口，不共享正在修改的文件。

第一步：检查 CLI 与中转接口是否匹配

分别运行 codex --version 和 claude --version，确认两个工具已安装。59API 提供低价、按量计费的模型访问，适合双终端这种调用量容易波动的工作方式；但接入前仍需核对具体接口。

OpenAI SDK 兼容不代表所有编程代理都能直接使用。Claude Code 通常需要 Anthropic Messages 接口；当前 Codex 的自定义提供商配置需要 Responses 接口。先确认 59API 对所选模型支持相应协议，而不只是 Chat Completions。

可以从平台列出的 Claude Sonnet 5.5 与 GPT-6.1 Sol 开始选择。展示名称与 API 模型 ID 不一定相同，配置时应复制控制台给出的实际 ID，并确认它支持对应工具。

第二步：分别配置两个终端

为两个工具分别创建 API 密钥，方便独立查看用量和撤销权限。Claude Code 所在终端可设置以下环境变量，再启动 claude；实际认证方式以平台接入说明为准：

export ANTHROPIC_BASE_URL=https://api.59api.com

export ANTHROPIC_AUTH_TOKEN='替换为专用密钥'

Codex 所在终端设置 export API59_KEY='替换为另一把专用密钥'。在现有 ~/.codex/config.toml 中合并以下配置，每段对应一行；前两行属于顶层配置，必须放在提供商表之前：

model_provider = "fiftynine"

model = "替换为控制台实际模型ID"

[model_providers.fiftynine]

name = "59API"

base_url = "https://api.59api.com/v1"

env_key = "API59_KEY"

wire_api = "responses"

以上地址以平台实际公布的路由为准。不要覆盖已有配置，也不要把密钥写进仓库、截图或共享终端记录。先各发一次简短请求，在控制台确认模型、计费和错误信息，再开始正式任务。

第三步：用 Git worktree 隔离文件修改

在仓库根目录执行以下命令，创建两个基于当前提交的独立工作目录：

git worktree add ../project-codex -b ai/codex

git worktree add ../project-claude -b ai/claude

终端 A 进入 ../project-codex 后启动 codex；终端 B 进入 ../project-claude 后启动 claude。分别按项目说明安装依赖。若两边都启动开发服务器，需要分配不同端口；worktree 不会自动隔离端口、数据库或外部服务。

第四步：用文件边界约束任务

• 给 Codex：只修改 src/export.ts，实现已约定的 CSV 导出函数；不新增依赖，不调整测试，完成后说明边界处理并提交。
• 给 Claude Code：只修改 tests/export.test.ts 和相关说明文档；覆盖空列表、中文、逗号、双引号和换行，不修改实现文件。
• 共同要求：先读项目规范；需要改动约定之外的文件时先停下说明原因，不自行扩大任务。

测试分支暂时没有新实现，出现预期失败并不奇怪。要求 Claude Code 区分“实现尚未合入”和“测试本身有问题”，不要为了让结果变绿而修改业务代码。

第五步：人工审查，再合并验证

两边完成后分别查看 git diff，并要求提供提交哈希和实际执行过的检查命令。在主工作目录依次 cherry-pick 实现提交与测试提交，再运行项目完整测试、类型检查和构建。

重点检查双方是否遵守同一接口约定、是否意外修改锁文件，以及测试是否真正断言转义结果。让两个代理互相评审可以补充线索，但不能替代人工检查和可重复的测试。

让双代理工作流保持低成本

给每边设置有限任务和检查点，避免同时扫描整个仓库、反复粘贴完整日志。结合平台用量记录比较每个任务的实际花费，而不是只看单次调用价格。

59API 主打低价按量计费，并标注采用原生官方质量模型、不降级；实际效果仍应以你的项目验证为准。若准备试用，可以注册后先用小任务跑通这套流程，再扩大并行范围；推荐返利规则则以平台当前说明为准。

Precios · Docs