unexpected status 401 Unauthorized Codex
Quick fix
使用内置 DeepSeek 模板替代自建配置，或在配置文件中手动添加 http_headers 传递 API Key 以解决 401 报错。
Symptom
Section titled “Symptom”unexpected status 401 Unauthorized: Incorrect API key provided: 123456. You can find your API key at https://platform.openai.com/account/api-keys., url: https://api.openai.com/v1/responses, cf-ray: a1ffe910ba36683c-NRT, request id: f56e5cc5-be53-4a44-aa57-efacc1869ac0在 cc-switch 中为 Codex 切换 DeepSeek 等第三方供应商时，若使用自建配置，可能会因为关键配置未完全写入或路由覆盖不完整，导致 Codex 依然向 OpenAI 官方地址发送请求并携带错误的鉴权信息，从而触发 401 错误。此外，Codex 更新后对配置格式要求更严格，自建配置容易缺失必要字段。
采用 cc-switch 内置的 DeepSeek Codex 模板配置文件，替代手动自建的供应商配置，以确保关键参数完整。
若问题依旧，请在配置文件中手动添加 http_headers 字段，强制指定正确的 API Key 格式。
Affected Versions
Section titled “Affected Versions”ToolCodex
Version3.16.3 - 3.17.0
PlatformsmacOSWindows
Source Issues
Section titled “Source Issues”本页汇总自 2 个真实 issue
- 为什么在 cc-switch 里测速正常，但打开 Codex 却显示 401？
- 测速正常仅代表 cc-switch 到供应商的网络和 Key 有效，但 Codex 客户端可能未正确读取 cc-switch 注入的鉴权头，或仍向 OpenAI 官方地址发请求，需手动在配置中补充 http_headers。
- 切换供应商后，Codex 侧栏的历史聊天记录消失了怎么办？
- 这是启用 model_provider="cc-switch" 后的已知现象，旧历史在侧栏隐藏但搜索可见。若去掉 provider 配置历史会恢复，但会导致 DeepSeek 再次 401，建议优先保证模型正常使用。
DeepSeek API Key 被覆盖导致 401升级 cc-switch 到 v3.16.2+，并重新填写 DeepSeek API Key，避免切换供应商时被其他 Key 覆盖。CC Switch local proxy failed while handling升级 CC Switch 到最新版并重开 Codex 对话；旧会话历史中残留的非法 schema 或图片块会持续触发 400。没有任何效果,无法登录官方渠道 - Codex升级 cc-switch 至 v3.16.2 或更高版本，并彻底删除用户目录下的 .codex 和 .cc switch 文件夹以修复 auth.json 被错误覆盖的问题。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。