Codex OAuth切换API Key无效 - CC Switch

Quick fix

升级至 v3.17.0+，并在设置中关闭「保留官方插件」选项。

Symptom

报错原文复制

切了oauth登录之后，apikey的形式就切换不过去了，必须手动去～/.codex/auth.json里面做修改才行

Cause

在 cc-switch v3.16.x 版本中，当用户在 Codex 的 OAuth（官方登录）和 API Key 模式之间切换时，存在配置写入冲突。具体表现为：从 OAuth 切换到 API Key 后，界面或底层配置仍残留 OAuth 状态，导致 API Key 无法生效。根据 Issue #5345 的讨论，这是 Codex 应用增强功能中「保留官方插件」等能力导致的副作用。虽然 Issue #3620 提到了保存后显示旧 Key 的问题（已在 v3.16.1 修复），但 OAuth/API 混合切换的核心问题需通过更高版本的逻辑调整解决。

Fix

1. 1

   将 cc-switch 升级到 v3.17.0 或更高版本，该版本加入了 Codex 官方登录接管并完善了切换逻辑。

2. 2

   如果升级后问题仍存在，进入 cc-switch 设置，找到「Codex 应用增强」部分，关闭「保留官方插件」等相关选项，然后重试切换。

   在 cc-switch 设置界面操作

   # 路径: 设置 -> Codex 应用增强
   # 操作: 关闭 '保留官方插件' (Keep Official Plugins)

Affected Versions

ToolCodex

Version3.16.0 - 3.16.5

PlatformsmacOSWindows

Source Issues

本页汇总自 6 个真实 issue

• #1416JsonEditor 在长行横向滚动时会出现正文与行号列重叠
• #3620修改API key保存后重新进入依旧显示为旧的sk-xxxxxxxxxxxxxxxxx
• #4071你用 cc-switch 切换模型时，实际上是修改了 config.toml 里的 model_provider 和 model 字段（比如从 openai / gpt-5.5 切到 custom / qwen3.7-max）。Codex 客户端重启后，侧边栏只展示与当前 model_provider 匹配的线程，所以你之前用 GPT 创建的对话就被"隐藏"了——数据还在磁盘上，只是界面上看不到了。
• #5345codex的oauth和api的切换不能用
• #5891重启ccswitch后启动codex，里面插件技能状态被重置
• #5910Issue: web_search = "disabled" 配置被意外删除，导致依赖该配置的功能失效

FAQ

为什么切换回 OAuth 又变回去了？

这是 v3.16.x 版本的已知行为，OAuth 和 API Key 的切换状态在应用增强功能的干预下未能正确持久化。升级到 v3.17.0 并调整应用增强设置可解决。

Issue #3620 提到的 API Key 不保存是同一个问题吗？

相关但不完全相同。#3620 是写入路径 bug，已在 v3.16.1 修复；而 OAuth/API 切换失败是更底层的状态管理冲突，主要影响 v3.16.5 及更早版本，需升级至 v3.17.0+。

我必须手动修改 auth.json 吗？

不需要。这是临时 workaround。通过升级软件并关闭冲突的应用增强选项，即可通过 UI 正常切换。

相关问题

原子替换失败 os error 50将 Claude Code 配置目录从 WSL 路径改回 Windows 本地路径，或回退至 v3.19.0。1 issues mergedauth.json会自动复用上一个供应商的 - Codex在设置中关闭“切换第三方时保留官方登录”选项即可解决。2 issues merged没有任何效果,无法登录官方渠道 - Codex升级 cc-switch 至 v3.16.2 或更高版本，并彻底删除用户目录下的 .codex 和 .cc switch 文件夹以修复 auth.json 被错误覆盖的问题。3 issues merged