Codex 的 7 个实用功能：从 Worktree 到 Automations 的配置骨架

1. 为什么我要把 Codex 当成工程协作台而不是补全插件Codex 在真实项目里能做什么简单说它不只是帮你补全一行代码而是能读整个仓库、改文件、生成 diff、跑终端命令、看报错再修复甚至把结果发布成可访问的页面。适合谁适合正在做开发、产品原型、前端页面和自动化任务的团队与个人。我把它当成一个本地 AI 工程协作台来用核心原因只有一个它把「改代码」和「验证代码」这两件事串起来了。但真正落地时问题往往不在模型能力而在配置骨架。Worktree 怎么隔离并行任务、Automations 怎么触发、Sites 怎么发布、模型 provider 怎么统一接入这些才是决定你能不能稳定用起来的关键。这篇就围绕 Worktree 隔离、Automations 触发、Sites 发布三条主线给出可复制的config.toml与settings.json骨架并演示一次从本地到发布的验证动作。TaoToken 作为统一 Key/API 通道在配置里一次性接入后面换模型、加任务都不用再动业务代码。2. TaoToken 前置把 Key 和 API 通道一次性接好在写 Codex 配置之前先把模型通道准备好。TaoToken 的作用是提供统一的 Key 和 API 入口这样 Codex 里配置 provider 时只需要填一个 base URL 和一个 Key不用为每个模型单独维护一套凭证。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。操作顺序建议这样先注册并登录进入控制台创建 API Key然后确认你要用的模型名称。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 管理页是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你只是想先验证模型能不能通可以直接用模型对话页试一条请求https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意Key 只放在本地环境变量或本地配置文件里不要提交到 Git 仓库。后面所有配置示例都用TAOTOKEN_API_KEY这个环境变量名。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面会说明请求格式和可用模型。如果你后面要做长期编码或 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。ClaudeCodeAnthropic 相关入口在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. 可复制配置config.toml 与 settings.json 骨架Codex 的配置分两层config.toml管模型 provider 和运行参数settings.json管项目级行为和自动化触发。下面这份骨架可以直接改路径和模型名使用。3.1 config.tomlprovider 与 Worktree 基础参数# ~/.codex/config.toml model gpt-4.1 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat [worktree] enabled true root .codex/worktrees cleanup_on_exit false max_parallel 3 [terminal] auto_run_tests true timeout_seconds 300这里几个参数值得说明。base_url指向 TaoToken 的 API 入口env_key指定从环境变量读 Key避免明文写进文件。worktree.enabled打开后Codex 每次并行任务会在.codex/worktrees下创建独立工作树互不污染。max_parallel 3是我实测比较稳的并发数机器配置好可以调到 5。3.2 settings.jsonAutomations 与 Sites 触发骨架{ project: { name: demo-app, worktree: { baseBranch: main, autoMerge: false } }, automations: [ { name: on-push-test, trigger: git.push, branch: feature/*, steps: [ install, test, lint ], model: gpt-4.1 }, { name: nightly-build, trigger: schedule, cron: 0 2 * * *, steps: [ build, sites.deploy ] } ], sites: { outputDir: dist, publishBranch: gh-pages, preview: true } }automations里第一条是推送触发只要推到feature/*分支就自动跑安装、测试、lint。第二条是定时触发每天凌晨两点构建并发布到 Sites。sites.preview true会先生成预览地址确认没问题再正式发布。3.3 环境变量与目录准备export TAOTOKEN_API_KEY你的Key mkdir -p .codex/worktrees如果你用的是 Windows PowerShell对应写法是$env:TAOTOKEN_API_KEY你的Key New-Item -ItemType Directory -Force -Path .codex/worktrees4. 验证请求从本地 Worktree 到 Sites 发布配置写完必须验证否则你不知道是配置错了还是模型不通。下面按顺序走一遍。4.1 先验证模型通道curl -s https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4.1, messages: [{role: user, content: reply with ok}] }返回里能看到choices字段和内容说明 Key 和通道都正常。如果返回 401先检查 Key 是否复制完整返回 404检查base_url是否写成了https://taotoken.net/api。4.2 验证 Worktree 隔离在项目里开两个并行任务观察目录变化codex task --worktree feature-a 给登录页加表单校验 codex task --worktree feature-b 给列表页加分页 ls .codex/worktrees你应该看到feature-a和feature-b两个独立目录。两个任务改的文件不会互相覆盖这就是 Worktree 的价值。实测下来并行任务最容易踩的坑是两个任务改了同一个文件合并时冲突。所以autoMerge我建议先设false人工确认后再合。4.3 验证 Automations 触发手动模拟一次推送触发git checkout -b feature/test-automation git commit --allow-empty -m trigger automation git push origin feature/test-automation如果配置生效Codex 会按on-push-test的步骤依次跑 install、test、lint。你可以在终端看到每一步的输出。如果没触发检查trigger字段是否写成了git.push以及分支匹配是否用了feature/*。4.4 验证 Sites 发布codex sites build codex sites deploy --preview第一条命令生成dist目录第二条发布预览。返回里会给出预览地址打开能看到页面就说明 Sites 链路通了。确认无误后去掉--preview正式发布。5. 本篇常见错排查5.1 报错provider not found现象是 Codex 启动时报model_provider taotoken not found。原因是config.toml里model_provider的值和[model_providers.xxx]的段名不一致。检查两处是否都写成taotoken大小写敏感。5.2 报错401 UnauthorizedKey 没读到或失效。先确认echo $TAOTOKEN_API_KEY有输出再确认env_key写的是TAOTOKEN_API_KEY而不是别的名字。如果 Key 刚创建等几秒再试。5.3 Worktree 目录冲突如果.codex/worktrees下已有同名目录新任务会失败。清理方式rm -rf .codex/worktrees/feature-a或者把cleanup_on_exit设为true任务结束自动清理。但调试阶段建议保留方便回看。5.4 Automations 不触发三个检查点trigger拼写、branch匹配规则、以及 Codex 后台进程是否在运行。定时触发依赖后台常驻如果机器休眠schedule不会补跑。5.5 Sites 发布后页面空白多半是outputDir和实际构建目录不一致。比如构建产物在build而不是dist就要改sites.outputDir。另外publishBranch如果和现有分支冲突发布会被拒绝换一个分支名即可。6. 把三条主线串成日常流程我现在的工作流是这样的新任务先在 Worktree 里开独立分支改完跑测试推送后 Automations 自动跑 lint 和 test通过后 Sites 出预览确认页面没问题再正式发布。TaoToken 的 Key 只在config.toml里配一次后面换模型只改model字段不用动 Automations 和 Sites 的配置。如果你还没接 Key从 API Keys 页面拿一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先验证模型通不通用模型对话页最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。长期做编码和 Agent 任务的话Coding Plan 更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个实用技巧max_parallel不要一上来就调高先用 2 到 3 跑一周观察机器负载和合并冲突频率再决定要不要加。Worktree 隔离解决的是文件冲突但解决不了逻辑冲突合并前的人工 review 还是省不掉。