1. 为什么 codex 并行开发总在分支上打架如果你用 codex 同时推进两个需求最常遇到的不是 AI 不会写而是工作区互相污染A 需求改到一半B 需求又动了同一批文件git status一片红切分支还得先 stash切回来再 pop冲突一多心态直接崩。codex 本身能理解上下文但它默认操作的是你当前打开的那个目录两个会话共用一个工作区等于两个人共用一张桌子写作业橡皮擦随时把对方答案擦掉。我试过最省事的解法是git worktree同一个仓库派生多个独立工作目录每个目录绑定自己的分支物理隔离。再配合 TaoToken 的统一 Key 和 API 通道让两路 codex 会话走同一个入口不用来回改配置。这篇就按「开工作树 → 配 config.toml → 两路并行改码 → 合并前 diff 校验」的完整链路走一遍命令都能直接复制。适合谁手上同时压着两个以上需求、又不想反复切分支的开发者已经在用 codex 但被分支冲突折磨过的人想给团队定一套并行开发规范的技术负责人。2. TaoToken 前置统一 Key 与 API 通道codex 这类工具要跑起来核心是两件事模型通道和鉴权。多任务并行时如果每个工作树各配一套 Key改起来容易漏、也容易把配置提交进仓库。TaoToken 的思路是给你一个统一入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM直接填进配置。你需要先拿到自己的 API Key入口在控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。拿到之后不要硬编码进代码用环境变量注入这样多个工作树共享同一份 Key改一处全生效。注意Key 属于敏感凭证别写进config.toml后直接 commit。用环境变量或者本地未跟踪的配置文件承载。配置文档可以参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各客户端的接入参数说明。如果你更想先在网页里验证模型通不通可以直接开模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. 可复制配置worktree 骨架 config.toml3.1 先建两个工作树假设主仓库在~/proj/main当前在main分支。给需求 A 和需求 B 各开一个工作树cd ~/proj/main # 基于当前分支派生两个新分支并绑定独立目录 git worktree add ../feat-a -b feat-a git worktree add ../feat-b -b feat-b # 查看所有工作树确认路径和分支对应关系 git worktree list执行完你会看到类似输出~/proj/main abc1234 [main] ~/proj/feat-a abc1234 [feat-a] ~/proj/feat-b abc1234 [feat-b]三个目录共享同一个.git对象库但工作区文件完全独立。A 目录里改文件B 目录看不到切分支的烦恼直接消失。3.2 config.toml 骨架codex 的配置一般放在用户目录下比如~/.codex/config.toml。下面是一份可复制的骨架把模型通道指向 TaoToken# ~/.codex/config.toml model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses然后在 shell 里注入 Key写进~/.zshrc或~/.bashrc持久化export TAOTOKEN_API_KEY你的Key这样无论你在feat-a还是feat-b目录启动 codex读到的都是同一份配置和同一个 Key。两个工作树不需要各自维护配置减少出错面。3.3 参数对照配置项作用建议值model指定编码模型gpt-5-codexbase_urlAPI 通道地址https://taotoken.net/apienv_key读取 Key 的环境变量名TAOTOKEN_API_KEYwire_api请求协议responses提示env_key填的是变量名不是 Key 本身。这样配置可以安全地放进版本库或团队共享。4. 两路 codex 并行改码与 diff 校验4.1 开两个终端各进一个工作树# 终端 1 cd ~/proj/feat-a codex # 终端 2 cd ~/proj/feat-b codex两个会话互不干扰。在终端 1 里给 codex 提需求 A比如「给用户模块加手机号校验」切到终端 2 提需求 B比如「给订单模块加超时取消」。两边同时跑AI 各自在自己目录里改文件。4.2 验证改动落在正确的工作树在feat-a目录里看状态cd ~/proj/feat-a git status git diff --stat你应该只看到需求 A 相关的文件变化。同理去feat-b检查只看到需求 B 的文件。如果发现 A 的改动出现在 B 目录说明工作树没建对回去用git worktree list核对路径。4.3 合并前 diff 校验两个需求都改完后先各自提交# feat-a cd ~/proj/feat-a git add . git commit -m feat: 手机号校验 # feat-b cd ~/proj/feat-b git add . git commit -m feat: 订单超时取消回到主目录做合并前的差异检查cd ~/proj/main git fetch --all # 看两个分支相对 main 各自改了什么 git diff main..feat-a --stat git diff main..feat-b --stat # 检查两个分支是否动了同一批文件潜在冲突点 git diff main..feat-a --name-only /tmp/a.txt git diff main..feat-b --name-only /tmp/b.txt comm -12 (sort /tmp/a.txt) (sort /tmp/b.txt)最后一条命令输出的是两个分支共同修改的文件。如果为空说明可以干净合并如果有交集先人工看这些文件的冲突风险再决定合并顺序。4.4 合并cd ~/proj/main git merge feat-a git merge feat-b合并完清理工作树git worktree remove ../feat-a git worktree remove ../feat-b git branch -d feat-a feat-b5. 本篇常见错排查报错一fatal: feat-a is already checked out原因同一个分支被两个工作树占用。git 不允许一个分支同时出现在多个工作树。解决给每个工作树用不同分支名或者先git worktree remove掉旧的那个。报错二codex 启动后报鉴权失败先确认环境变量生效echo $TAOTOKEN_API_KEY如果为空说明没写进 shell 配置或没重新加载。执行source ~/.zshrc再试。还要确认config.toml里的env_key和实际变量名一致大小写敏感。报错三两个工作树改了同一文件合并冲突这不是 bug是并行开发的正常现象。用git diff main..feat-a --name-only和git diff main..feat-b --name-only提前找出交集文件合并前先沟通好谁先合、谁 rebase。冲突时用git mergetool或手动解决后git add再git commit。报错四worktree 目录删了但git worktree list还在手动删目录不会自动清理记录。执行git worktree prune报错五codex 在错误的工作树里改代码检查你启动 codex 时所在的目录。codex 操作的是当前工作目录cd错了就会改错地方。养成习惯启动前先pwd确认路径。6. 长期并行开发怎么配如果你只是偶尔并行两个需求上面的 worktree 统一 Key 已经够用。但如果这是常态——比如团队里每个人都要同时推进多个任务或者你在跑 Agent 类的自动化编码流程建议把通道和额度也统一管理避免每个工作树各配一套 Key 导致混乱。Coding Plan 就是为这种长期编码场景准备的https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入过程中如果遇到配置报错优先查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要新建或轮换 Key 就去 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先确认模型响应是否正常用模型对话快速验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我踩过的坑worktree 建多了容易忘记清理git worktree list会越堆越长。建议在合并完成后立刻git worktree remove保持列表干净下次开新任务时不会搞混路径。
