Failed to authenticate: Claude Desktop gateway token 无效 — Claude
Quick fix
退出 Claude Desktop 中残留的官方账号登录态并重启应用；若仍报错，按 issue 中确认有效的切换默认供应商再切回步骤操作。
Symptom
Section titled “Symptom”Failed to authenticate. API Error: 401 认证失败: Claude Desktop gateway token 无效这些 issue 报告 Claude Code CLI 或 CC Switch 的连接测试正常，但 Claude Desktop / Cowork Gateway 请求仍可能失败。#2865 的评论将一种情况归因于 Desktop 使用的 host-managed bearer token 与 CC Switch 配置的网关 token 不一致；评论建议执行 `claude auth logout` 并完全退出、重启 Desktop。#3196 中也有用户确认 logout 后恢复，但另一位用户报告无效，说明该方法并非对所有情况都有效。
#3196 的维护者关闭说明指出，cc-switch v4.0 的界面和配置写入方式已有较大变化。#5008 讨论的是另一种可能的认证冲突：曾用 `claude login` 登录后残留 `ANTHROPIC_AUTH_TOKEN`，同时设置了 `ANTHROPIC_API_KEY`；该 issue 说明这仍是用户侧规避方法，相关讨论在 #3162。不同 issue 给出的处理方式不同，且未证明有适用于所有情形的统一修复。
完全退出 Claude Desktop，然后在终端执行 `claude auth logout`，再重新启动 Desktop。#2865 和 #3196 中有用户反馈此方法恢复正常；也有用户报告无效。
如果仍报错，在 CC Switch 中先切换到 Claude Desktop Official，重启 Claude Desktop；再切回原供应商并再次重启。#3196 的用户反馈此操作有效。
若使用 Windows 且曾通过 `claude login` 登录官方账号、之后又设置代理 API key，可检查 `C:\Users\{用户名}\.claude.json` 是否包含 `"hasCompletedOnboarding": true`，并确认供应商认证字段使用 `ANTHROPIC_API_KEY`。这是 #5008 转述的排查方法；该 issue 未确认它能解决所有网关 token 错误。
C:\Users\{用户名}\.claude.json {"hasCompletedOnboarding": true}
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 3 个真实 issue
- 执行 `claude auth logout` 后还是报错怎么办？
- #3196 有用户反馈该命令无效。可尝试在 CC Switch 中先切换到 Claude Desktop Official，重启 Desktop，再切回原供应商并重启；该 issue 中有用户确认此方法有效。
- 为什么 Claude Code CLI 能正常使用，Claude Desktop / Cowork Gateway 却报 401？
- #2865 的评论指出，Desktop Gateway 可能使用与 CLI 或 CC Switch 配置不同的认证 token；CLI 和 Desktop 的调用路径表现不一致。
- 曾经登录过 Claude Pro 账号并设置代理 API key，应该检查什么？
- #5008 提到检查 Windows 的 `C:\Users\{用户名}\.claude.json` 中是否有 `"hasCompletedOnboarding": true`，并将供应商认证字段设为 `ANTHROPIC_API_KEY`；维护者说明这只是用户侧规避方法。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。