1. 为什么 Codex 和 Claude Code 接第三方 API 总在报错Codex 和 Claude Code 这两个命令行 AI 工具一个走 OpenAI 兼容协议一个走 Anthropic 兼容协议配置项长得像但完全不能混用。很多人第一次接第三方 API 地址时把 Claude Code 的ANTHROPIC_BASE_URL填成带/v1的地址或者把 Codex 的base_url漏掉/v1结果就是 404 或者一直转圈。这篇教程聚焦一件事把 Codex 和 Claude Code 的 Base URL、API Key、模型名这三项核心参数配好并且每一步都能自己验证通不通。我会用 TaoToken 作为统一 Key/API 通道来演示因为它同时提供 OpenAI 兼容和 Claude 兼容两种接入方式一个 Key 就能覆盖两个工具。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后拿到 Key 就能跟着下面的步骤走。适合谁看已经在本地装了 Codex CLI 或 Claude Code想换成自己的 API 通道或者刚接触这两个工具想一次性把配置骨架搭对。全文的配置都可以直接复制改掉域名和 Key 就能用。先说结论避免你配到一半才发现方向错了Codex 走 OpenAI 兼容接口base_url通常要带/v1Key 放在env_key指向的环境变量里模型名写在config.toml的 profile 中。Claude Code 走 Anthropic 兼容接口ANTHROPIC_BASE_URL填基础域名不要带/v1/messagesKey 放在ANTHROPIC_AUTH_TOKEN模型名放在ANTHROPIC_MODEL。两个工具的配置文件和環境变量互不通用别把 Codex 的 Key 塞给 Claude Code。下面按「先测 API → 再配 Codex → 再配 Claude Code → 排错」的顺序来每一步都有可复制的命令和预期结果。2. 配置前先把 TaoToken 的 Key 和地址准备好在动 Codex 和 Claude Code 之前先确认 API 本身是通的。这一步能帮你排除掉一大半「到底是工具配错了还是 Key 有问题」的纠结。2.1 拿到 API Key 和 Base URL登录 TaoToken 控制台在 API Keys 页面创建一个 Key。地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建后复制那串sk-开头的字符串只显示一次先存到安全的地方。两个 Base URL 记清楚后面会反复用到用途Base URL说明OpenAI 兼容Codexhttps://taotoken.net/api/v1带/v1用于/models、/chat/completionsClaude 兼容Claude Codehttps://taotoken.net/api不带/v1Claude Code 自己拼路径注意这两个地址不要互换。Codex 用不带/v1的地址会 404Claude Code 用带/v1的地址会拼出错误路径。2.2 用 curl 验证 OpenAI 兼容接口先把 Key 和地址写进当前 shell 的环境变量方便后面复用export TAOTOKEN_BASE_URLhttps://taotoken.net/api/v1 export TAOTOKEN_API_KEYsk-你的Key查询模型列表确认 Key 有效、地址可达curl -sS $TAOTOKEN_BASE_URL/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY正常会返回一个 JSON里面有data数组每个元素带id字段那就是可用模型名。如果返回 401说明 Key 错了或没带上返回 404说明 Base URL 写错了。再发一个最小对话请求确认推理链路通curl -sS $TAOTOKEN_BASE_URL/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [ { role: user, content: 你好请回复一句接口已接通 } ] }返回里choices[0].message.content有内容就说明 OpenAI 兼容通道没问题。模型名先用一个你确认存在的后面配 Codex 时再换成实际要用的。2.3 用 curl 验证 Claude 兼容接口Claude 兼容接口的路径和 OpenAI 不一样验证方式也不同export TAOTOKEN_ANTHROPIC_BASE_URLhttps://taotoken.net/api export TAOTOKEN_ANTHROPIC_KEYsk-你的Key curl -sS $TAOTOKEN_ANTHROPIC_BASE_URL/v1/messages \ -H x-api-key: $TAOTOKEN_ANTHROPIC_KEY \ -H anthropic-version: 2023-06-01 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [ { role: user, content: 回复一句Claude 通道已接通 } ] }这里注意两点Claude 兼容接口用x-api-key头不是Authorization: Beareranthropic-version头必须带。返回content[0].text有内容就通了。提示如果你在 TaoToken 控制台看到的模型名和上面示例不同以控制台或/models返回的为准。模型名写错会直接报model not found。3. Codex 配置config.toml 骨架与逐项说明Codex 的配置集中在~/.codex/config.toml核心是定义一个 model provider再在 profile 里引用它。下面这份骨架可以直接复制改掉 Key 环境变量名和模型名即可。3.1 保存 API Key 到环境变量不要把 Key 直接写进config.toml用环境变量引用更安全。先临时设置export TAOTOKEN_API_KEYsk-你的Key确认生效echo $TAOTOKEN_API_KEY要长期保存追加到 shell 配置文件zsh 用~/.zshrcbash 用~/.bashrcecho export TAOTOKEN_API_KEYsk-你的Key ~/.zshrc source ~/.zshrc3.2 写 config.toml创建目录并编辑配置mkdir -p ~/.codex nano ~/.codex/config.toml写入以下内容[model_providers.taotoken] name taotoken base_url https://taotoken.net/api/v1 env_key TAOTOKEN_API_KEY wire_api chat [profiles.taotoken-gpt4o] model_provider taotoken model gpt-4o-mini [profiles.taotoken-gpt4o-mini] model_provider taotoken model gpt-4o-mini逐项说明[model_providers.taotoken]是 provider 的名字随便取但下面 profile 里的model_provider必须和它一致。base_url必须带/v1这是 OpenAI 兼容接口的约定。env_key填的是环境变量的名字不是 Key 本身。Codex 启动时会去读这个环境变量。wire_api chat表示走 chat completions 接口。[profiles.xxx]里model就是模型名以/models返回的为准。3.3 启动 Codex 并验证用 profile 启动codex --profile taotoken-gpt4o如果启动后能正常对话说明配置生效。你也可以在 Codex 里问一句「你现在用的是哪个模型」确认它走的是你配的 provider。注意config.toml的路径必须是~/.codex/config.toml放在别处 Codex 读不到。Windows 下对应%USERPROFILE%\.codex\config.toml。4. Claude Code 配置环境变量与启动验证Claude Code 不用配置文件全靠环境变量。这也是它和 Codex 最大的区别别去 Claude Code 里找config.toml。4.1 设置三个核心环境变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的Key export ANTHROPIC_MODELclaude-sonnet-4-5三个变量的作用ANTHROPIC_BASE_URL基础域名不要带/v1或/v1/messagesClaude Code 会自己拼。ANTHROPIC_AUTH_TOKEN你的 Key。ANTHROPIC_MODEL模型名以服务端支持列表为准。4.2 长期保存追加到 shell 配置cat ~/.zshrc EOF export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的Key export ANTHROPIC_MODELclaude-sonnet-4-5 EOF source ~/.zshrc4.3 检查并启动逐个确认变量生效echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN echo $ANTHROPIC_MODEL三个都有值再启动claude启动后随便问一句能正常返回就说明 Claude Code 已经走 TaoToken 通道了。提示如果你之前配过别的通道先unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL清掉旧值再重新 export避免旧变量残留导致排查困难。5. 常见报错逐项排查配置过程中最容易碰到 401、404、model not found 这三类。排查顺序建议是先 curl 测 API再查环境变量最后看工具配置。不要一上来就反复改工具配置。5.1 401 未授权Codex 侧echo $TAOTOKEN_API_KEY为空说明环境变量没生效检查是否写进了正确的 shell 配置文件、是否source过。Claude Code 侧同理echo $ANTHROPIC_AUTH_TOKEN如果变量有值但还 401多半是 Key 本身失效或复制时带了空格重新在控制台生成一个。5.2 404 找不到路径Codex 的 404 几乎都是base_url少了/v1base_url https://taotoken.net/api/v1Claude Code 的 404 几乎都是ANTHROPIC_BASE_URL多写了路径# 正确 export ANTHROPIC_BASE_URLhttps://taotoken.net/api # 错误会拼出 /v1/messages/v1/messages export ANTHROPIC_BASE_URLhttps://taotoken.net/api/v1/messages5.3 model not found模型名写错或该模型不在你的可用列表里。先查列表curl -sS $TAOTOKEN_BASE_URL/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY把返回里的id复制到 Codex 的model或 Claude Code 的ANTHROPIC_MODEL。注意 Codex 和 Claude Code 用的模型名可能不同别把 Claude 的模型名填进 Codex。5.4 配置不生效Codex 检查config.toml路径和 provider 名称是否对应Claude Code 检查是否在同一个 shell 会话里 export 的变量。开新终端后变量丢失说明没写进~/.zshrc或没source。报错最可能原因快速验证401Key 错或环境变量为空echo $TAOTOKEN_API_KEY404Base URL 多了或少了/v1对照第 2 节地址表model not found模型名不在可用列表curl .../models配置不生效文件路径错或变量未持久化重开终端再 echo6. 配好之后怎么继续用Codex 和 Claude Code 都接通后日常使用就是启动时带上对应 profile 或直接claude。如果你要长期跑编码任务、Agent 工作流建议把 Key 和地址固定到 shell 配置里避免每次开终端重新 export。需要管理多个 Key 或查看用量去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先在线验证模型是否可用可以用模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息试试。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例。如果你打算把 Codex 或 Claude Code 用在长期编码和 Agent 场景Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有对应的套餐说明。最后留一个我踩过的坑改完config.toml或环境变量后一定要开一个新终端或者source一次再启动工具否则你改的是新配置跑的还是旧进程里的旧值会误以为配置没生效。
)
