提示INVALID_API_KEY，Codex 切换供应商后认证不匹配

Quick fix

升级至 v3.20.1 或更高版本；维护者称第三方切换不再写入 auth.json，避免供应商密钥与认证配置错配。

Symptom

报错原文复制

切换模型厂家，提示INVALID_API_KEY

Cause

多份报告描述了 Codex 切换供应商后，`~/.codex/config.toml` 已切到目标供应商，但 `~/.codex/auth.json` 中的 `OPENAI_API_KEY` 仍是上一供应商的 key，或编辑供应商时从 `auth.json` 回填，导致密钥被覆盖。另有报告称 `experimental_bearer_token` 会覆盖 provider 保存的 `auth.OPENAI_API_KEY`，使后续切换可能写回错误的 key。

维护者对早期“无法切换其它供应商”的报告称该问题应已在 v3.16.1 解决，但后续 v3.16.5、v3.17.0 以及评论中的更高版本仍有相关报告。维护者随后说明 v3.20.1 的 config-only 重构后，切换第三方不再写入 `auth.json`，且双位置互写已不存在；若升级后仍复现，应按原帖要求新开 issue 并附日志。

Fix

1. 1

   将 CC Switch 升级到 v3.20.1 或更高版本；维护者称该版本起切换第三方供应商不会再写入 `auth.json`。

2. 2

   若使用多个 Codex 官方 ChatGPT 账号，按维护者说明使用认证中心托管账号并将供应商卡绑定账号；存量托管账号需在账号行点击“重新登录”一次。

3. 3

   若升级后仍出现该错误，按维护者要求新开 issue，并附上日志以及已脱敏的切换前后差异。

Affected Versions

ToolCodex

Versionv3.16.1 - v3.17.0（报告的受影响版本）；v3.20.1（维护者称已修复）

PlatformsWindowsmacOS

Source Issues

本页汇总自 5 个真实 issue

• #2561codex无法切换其它供应商
• #3556Codex 供应商切换时 auth.OPENAI_API_KEY 被 experimental_bearer_token 覆盖
• #4941Codex 官方配置多账号切换时 ~/.codex/auth.json 授权信息被覆盖，导致账号切换失败
• #4944切换 Codex provider 时 auth.json 的 OPENAI_API_KEY 未同步更新
• #5539编辑供应商时 apikey 从 auth.json 回填，而非该供应商自身记录，导致保存会覆盖成当前生效的 key

FAQ

切换 Codex provider 后，为什么 `config.toml` 已更新但 `auth.json` 的 key 还是上一个供应商？

报告称切换时只正确写入了 `config.toml`，而 `auth.json` 的 `OPENAI_API_KEY` 未同步更新，造成 endpoint 与 key 不一致。维护者称 v3.20.1 起切换第三方不会再写入 `auth.json`。

多个 Codex 官方配置的登录授权会互相覆盖吗？

有报告称新增官方配置后会覆盖上一个配置的授权信息。维护者说明应使用认证中心托管账号并绑定供应商卡，且 v3.20.1 起同一 Team workspace 的多个账号可并存。

相关问题

供应商 API Key 被覆盖：Codex 重启或切换后升级到 cc-switch v4.0.0 或更高版本；该版本重写了切换逻辑，避免供应商密钥互相覆盖并恢复官方登录态。6 issues merged[DISCUSS] 支持 pi coding agent这是功能请求，维护者已将其合并至统一追踪 issue #1855，原帖未提供可验证的解法。1 issues merged<thinking> 标签作为正文输出 Claude Code将 provider 的 apiFormat 从 openai_chat 改为 anthropic（若上游支持），可绕过内联 <thinking> 泄露。1 issues merged