跳转到内容
CC Switch WikiUnofficial Community Wiki

401 Unauthorized: Incorrect API key provided - CC Switch Codex DeepSeek

Quick fix

Codex 通过 CC Switch 接入 DeepSeek 时报 401，需在配置文件中手动补上 http_headers 认证头（如 Authorization: Bearer 或 x-api-key）。

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

Cause

Section titled “Cause”

在 CC Switch 中配置 DeepSeek 供应商并切换到 Codex 后，Codex 发出的请求仍然指向 https://api.openai.com/v1/responses，但请求里没有携带有效的认证头（API Key），OpenAI 接口因此返回 401 Unauthorized。即 CC Switch 切换时只写入了一半配置，关键认证字段没有完整落到 Codex 的配置文件中（issue #4491 称之为“配置只写半套”），#5571 中多位用户也复现了同样的 401 报错。社区验证过的绕过方式是在 Codex 配置中手动添加 http_headers 认证头。另有用户（#6068）反馈关闭路由切回官方时模型列表也不刷新，说明该时期版本的切换/回写逻辑整体存在缺陷，维护者在 #6068 中表示 4.0 起改为只改关键字段、并在关闭路由时按直连供应商重写配置。

Fix

Section titled “Fix”

  1. 打开 Codex 的配置文件（Codex 的 TOML 配置文件），在对应供应商段落中手动添加认证头，将 sk-123 替换为你自己的 DeepSeek API Key：http_headers = { "Authorization" = "Bearer sk-" }，或按供应商要求使用 http_headers = { "x-api-key" = "sk-123" }。两位用户分别用这两种写法确认恢复可用。

  2. 如果手动补头后仍异常，尝试完全卸载并重新安装 Codex、清空 Codex 的所有配置后重新接入（issue #5571 中有用户以此解决“只显示登录界面”的接入失败）。

  3. 改用 CC Switch 内置的 DeepSeek Codex 模板来创建供应商配置，而不是完全自建配置（issue #4491 的解决建议），减少字段漏写。

  4. 升级到 CC Switch 4.0 及以上版本：维护者在 #6068 中说明 4.0 起切换只改关键字段、关闭路由时会按直连供应商重新写回配置，可改善切换后配置不完整的问题。升级后仍复现请附版本号与日志重新反馈。

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version在 CC Switch 3.16.3 - 3.17.0 上有报告；维护者称 4.0 起改进了配置写回逻辑
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

本页汇总自 3 个真实 issue

FAQ

Section titled “FAQ”
本地 CC Switch 配置 DeepSeek 测速正常，但 Codex 通过 API Key 登录显示 401，怎么解决？
在 Codex 配置文件中手动添加 http_headers = { "x-api-key" = "sk-123" } 或 http_headers = { "Authorization" = "Bearer sk-" }（把 sk- 换成你的真实 Key），两位用户分别用这两种写法确认恢复。
不想每次手动补配置，有没有更省事的办法？
采用 CC Switch 内置的 DeepSeek Codex 模板的配置文件来替代自建供应商配置（#4491 评论建议）；另外维护者建议升级到 4.0 及以上版本，切换逻辑改为只写关键字段。
正常接入 Codex 配置 DeepSeek 后打开只显示登录界面，怎么办？
有用户通过重新安装 Codex 并清空 Codex 所有配置后恢复（#5571 评论）。
关闭路由切回 OpenAI 官方后，/model 里还显示 DeepSeek 模型，怎么办？
这是切换工具留下的旧模型目录所致。维护者在 #6068 中表示 4.0.2 起模型目录指针会跟随当前供应商，关闭路由时按直连供应商重写配置、官方登录自动还原，建议升级到最新版后只用 CC Switch 重试。

相关问题

Section titled “相关问题”
Codex无法使用，重连5次失败。 Codex切换供应商后核对并重新填写当前供应商的 API Key；该 Key 覆盖问题在 v3.16.3 仍有报告。4 issues merged供应商 API Key 被覆盖：Codex 重启或切换后升级到 cc-switch v4.0.0 或更高版本；该版本重写了切换逻辑，避免供应商密钥互相覆盖并恢复官方登录态。6 issues merged[DISCUSS] 支持 pi coding agent这是功能请求，维护者已将其合并至统一追踪 issue #1855，原帖未提供可验证的解法。1 issues merged

这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。