401 认证失败: Claude Desktop gateway token 无效 - Claude Desktop

Quick fix

清除 Claude Desktop 的官方 OAuth 登录态，或修改 .claude.json 配置文件以解决 401 网关 token 无效问题。

Symptom

报错原文复制

Failed to authenticate. API Error: 401 认证失败: Claude Desktop gateway token 无效

Cause

此问题的核心在于 Claude Desktop 的 `claude-desktop-3p` 入口使用了不同于 CC Switch 配置的 auth token。CC Switch 在配置中写入了 36 字符的 `inferenceGatewayApiKey`，但 Claude Desktop 实际发送的是 108 字符的 host-managed bearer token，导致校验失败并返回 401 错误。

此外，如果之前使用 `claude login` 登录过 Pro 账号，系统会留下 `ANTHROPIC_AUTH_TOKEN`。这个 first-party OAuth 登录态会覆盖 CC Switch 写入的第三方 token，导致 Claude App / Cowork Gateway 实际调用路径使用了陈旧的凭证或模型路由，从而出现 401 认证失败、API key 无效或模型路由未配置等错误，而此时 Claude Code CLI 却能正常工作。

Fix

1. 1

   清除 first-party OAuth 登录态（推荐）。在命令行执行 `claude auth logout`，然后完全退出（从任务栏或 Dock 退出）并重启 Claude Desktop。

2. 2

   修改配置文件。在 Windows 系统中打开配置文件，添加 `hasCompletedOnboarding` 字段，并在 CC Switch 添加供应商时将认证字段改为 `ANTHROPIC_API_KEY`。

   // C:\Users\{用户名}\.claude.json
   {
     "hasCompletedOnboarding": true
   }

3. 3

   重新切换模型。在 CC Switch 中先将模型切换为默认的 Claude Desktop，重启 Claude Desktop；然后再切换回第三方模型（如 deepseek），再次重启 Claude Desktop。

4. 4

   手动配置本地路由。在 CC Switch 设置中开启本地路由并记下地址（如 `http://127.0.0.1:15721`）。在 Claude Desktop 中启用开发者模式 (Help -> Troubleshooting -> Enable Developer Mode)，进入 Developer -> Configure third-party inference，在 Connection 页面选择 Gateway，并将 Gateway base URL 填写为本地路由地址。

Affected Versions

ToolClaude Desktop

Versionv2.1.143 - v3.17.0

PlatformsWindowsmacOS

Source Issues

本页汇总自 3 个真实 issue

• #2865Claude Code CLI 可正常切换模型，但 Claude App / Cowork Gateway 使用同配置出现 401、route 未配置等错误
• #3196Failed to authenticate. API Error: 401 认证失败: Claude Desktop gateway token 无效
• #5008Failed to authenticate. API Error: 401 认证失败: Claude Desktop gateway token 无效

FAQ

为什么 Claude Code CLI 正常，但 Claude App / Cowork 报错？

因为 Claude Desktop 的 `claude-desktop-3p` 入口实际发送的是 108 字符的 host-managed bearer token，而 CC Switch 校验的是 36 字符的 token。此外，官方 OAuth 登录态可能覆盖了第三方 token，导致 App 端使用了陈旧的凭证。

执行 `claude auth logout` 后仍然无效怎么办？

可以尝试在 CC Switch 中先切换回默认的 Claude Desktop 并重启，再切回第三方模型并重启。或者在 Claude Desktop 的开发者模式中手动配置 Gateway base URL 为本地路由地址。

除了 401 报错，有时还会提示模型路由未配置或 API key 无效？

这同样是因为 Claude App / Cowork Gateway 没有正确同步 CC Switch 的路由配置，实际调用时仍在使用旧的 provider key 或默认模型路由。请按照清除登录态或手动配置本地路由的步骤进行修复。

相关问题

codex升级为ChatGPT后不适配了吗 cc-switch升级到 cc-switch v3.17.0，该版本已适配 Codex 合并到 ChatGPT Desktop 后的供应商切换，避免旧配置被覆盖。5 issues merged切换后配置丢失：Claude Code / Codex / WSL 路径核对切换供应商会重写 settings.json，请把 hooks/statusLine/enabledPlugins 等字段放入“通用配置/共享配置片段”，不要只写在本地文件里。15 issues mergedError running remote compact task在 Codex 设置中关闭远程上下文压缩（Remote Compaction），改用本地压缩即可临时绕过此协议转换缺陷。4 issues merged