1. 从 Claude Code 切到 Codex为什么同一把 Key 还要折腾 AGENTS.md如果你已经在 Claude Code 里跑顺了一套「文档驱动」的工作流最近又想试试 Codex 的执行力那大概率会撞上同一个问题模型换了项目记忆也跟着断了。Claude Code 擅长长上下文能把一段模糊想法慢慢聊成规格Codex 更偏任务执行你给它清晰指令它落地得快。两者定位不同但长期项目里那些 brainstorm.md、project_spec.md、architecture.md、project_status.md、changelog.md、decisions.md、bugs/ 不能因为换工具就重来一遍。我这次迁移的核心目标很明确同一把 TaoToken Key从 Claude Code 切到 Codex 后Codex 仍然按 AGENTS.md 里的长期文档维护规则干活。也就是说Key 不变、Base URL 不变变的只是项目指令文件名从 CLAUDE.md 换成 AGENTS.md以及把原来散落在对话里的维护规则固化进仓库。这篇适合三类人已经在用 Claude Code 做长对话规格梳理、准备切到 Codex 做执行的开发者手里有多个模型供应商、想用一把 Key 统一管理的人以及想把「文档即项目记忆」这套习惯沉淀成可复用 Skill 的团队。下面按「先拿 Key、再配两端、最后验证」的顺序走一遍每一步都能直接复制。2. 迁移前的前置准备同一把 TaoToken Key 怎么拿迁移的第一原则是「Key 不换」。很多人在切换模型时习惯重新申请一套凭证结果 Claude Code 和 Codex 各用各的账单、额度、限流都分散了排查问题也麻烦。正确做法是先去 TaoToken 官网创建一把 Key两个工具共用。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并登录进入控制台后找到 API Keys 页面。创建时建议起一个能看出用途的名字比如claude-codex-shared方便以后在日志里区分。创建完成后立刻复制页面刷新后就看不到完整值了。这里有个容易踩的坑Base URL 到底填什么。官方文档写得很清楚API 地址是 https://taotoken.net/api注意两点——不要在后面加/v1也不要填官网首页地址。加/v1会导致路径拼接成/api/v1/v1/...之类的错误填官网地址则根本不是 API 端点。我试过在 Claude Code 里手滑加了/v1返回的是 404排查了十几分钟才反应过来。Key 拿到后先别急着配建议在终端里用一条 curl 确认它可用curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY能返回模型列表就说明 Key 和 Base URL 都没问题。这一步花三十秒能省掉后面在编辑器里反复试错的半小时。3. 可复制配置Claude Code 与 Codex 两端怎么填3.1 Claude Code 侧的配置Claude Code 读取环境变量来定位 API。在~/.zshrc或~/.bashrc里加上export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的 TaoToken Key保存后source ~/.zshrc生效。注意ANTHROPIC_BASE_URL只写到/api不要带/v1。Claude Code 内部会自己拼接版本路径。3.2 Codex 侧的配置Codex 的配置在~/.codex/config.tomlWindows 是%USERPROFILE%\.codex\config.toml。核心是两段模型供应商和模型选择。model_provider taotoken model gpt-5-codex [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses然后在环境变量里设置TAOTOKEN_API_KEY值就是刚才那把 Key。wire_api按你实际使用的模型接口类型填responses和chat两种都支持具体以接入文档为准。3.3 两端配置对照项目Claude CodeCodexBase URLhttps://taotoken.net/apihttps://taotoken.net/api凭证变量ANTHROPIC_API_KEYTAOTOKEN_API_KEY项目指令文件CLAUDE.mdAGENTS.md配置文件位置shell rc 文件~/.codex/config.toml两端的 Base URL 完全一致这是「同一把 Key 通吃」的关键。凭证变量名不同只是各工具的历史约定值可以是同一把 Key。4. 验证请求让 Codex 初始化 AGENTS.md 并生成 docs 模板配置改完重启 Codex 桌面端或 CLI然后在一个测试仓库里发一条指令初始化 AGENTS.md并创建 docs/project_spec.md、architecture.md、project_status.md、changelog.md、decisions.md 和 docs/bugs/ 目录。如果请求成功你会看到仓库根目录多出 AGENTS.mddocs/ 下按模板生成六个文件和一个 bugs 目录。AGENTS.md 里应该包含一段被!-- BEGIN: codex-long-term-docs --和!-- END: codex-long-term-docs --包裹的托管块里面写清了每个文档的职责。验证成功的三个信号一是 Codex 没有报 401 或 404说明 Key 和 Base URL 都对二是 docs/ 下的文件确实生成了说明它读懂了指令三是 AGENTS.md 的托管块内容完整说明长期维护规则被正确写入。如果想让这套初始化动作可复用可以把它做成用户级 Skill。目录结构如下$HOME/.agents/skills/codex-agents-init/ ├── SKILL.md └── scripts/ └── init-codex-agents.ps1SKILL.md 里用 frontmatter 声明名称和触发描述正文写清「何时使用、期望的仓库结构、必须遵守的行为、安全规则」。脚本负责实际的文件创建和 AGENTS.md 托管块写入核心逻辑是定位仓库根、创建缺失文件、保留已有内容、只替换托管块。这样以后在任何仓库里说一句「初始化 AGENTS.md」Codex 就能按同一套规则执行。5. 本篇常见错排查报 401 Unauthorized九成是 Key 没生效。检查环境变量是否在当前 shell 会话里echo $TAOTOKEN_API_KEY看有没有值。Codex 的env_key名字要和实际环境变量名一致大小写敏感。报 404 Not FoundBase URL 写错了。最常见的是多加了/v1或者填成了官网首页。正确值只有 https://taotoken.net/api 这一个。Codex 不读 AGENTS.md确认文件在仓库根目录且文件名大小写正确。Codex 只认根目录的 AGENTS.md放在子目录里不会自动加载。docs 文件没生成可能是 Codex 把「创建」理解成了「检查」。指令里明确说「创建缺失的文件已存在的保留」并给出完整路径列表成功率会高很多。托管块被覆盖如果 AGENTS.md 里已有!-- BEGIN: codex-long-term-docs --块脚本应该只替换块内内容不动块外。如果发现块外内容丢了检查脚本的正则是否用了非贪婪匹配。Claude Code 和 Codex 抢同一把 Key 的额度这是预期行为同一把 Key 共享额度。如果担心互相影响可以在 TaoToken 控制台按用途创建多把 Key但迁移场景下共用一把反而更方便对账。6. 迁移后的长期维护与 CTA切到 Codex 之后真正省心的地方在于 AGENTS.md 把「什么时候更新哪个文档」写死了。比如复杂 bug 必须先写docs/bugs/issue-xxx-research.md再修行为变更必须同步docs/changelog.md和docs/project_status.md技术选型记进docs/decisions.md。这些规则一旦固化换模型、换供应商都不用重新交代。如果你还在选长期编码方案可以看看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 适合把 Claude Code 和 Codex 都挂在同一套额度下。想先验证模型对话效果去模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。需要管理多把 Key 或查看用量进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。Key 创建入口在 API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 接入细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个实操建议迁移完成后别急着删 CLAUDE.md。把它留在仓库里作为历史参考同时在 AGENTS.md 顶部加一行「本仓库已迁移至 CodexCLAUDE.md 仅作存档」。这样团队里还在用 Claude Code 的同事不会迷路Codex 也不会误读旧规则。等所有人都切完再统一清理。