Missing API key · Run /login - Claude Code
Quick fix
清除冲突的 ANTHROPIC_BASE_URL 环境变量,或升级 CC Switch 使用内置的环境变量冲突检测功能。
Symptom
Section titled “Symptom”Missing API key · Run /login当系统中存在 ANTHROPIC_BASE_URL 环境变量(例如由 CCR 代理工具设置,或在 WSL 中手动配置)时,其优先级高于 ~/.claude/settings.json 中的配置。这会导致 Claude Code 忽略 CC Switch 写入的供应商配置,从而引发 API Key 缺失或要求重新登录的问题。新版 CC Switch 已增加冲突环境变量检测功能来解决此问题。
升级 CC Switch 到最新版本,使用新增的冲突环境变量检测功能自动修复配置冲突。
检查并清除系统中由其他工具(如 CCR)强制设置的 ANTHROPIC_BASE_URL 环境变量,确保 Claude Code 能够正常读取 ~/.claude/settings.json。
如果在 WSL 环境中使用,建议在 Windows 端运行 CC Switch,并在 WSL 中手动配置环境变量指向宿主机代理。
Affected Versions
Section titled “Affected Versions”ToolClaude Code
Version未知
PlatformsLinuxWindows
Source Issues
Section titled “Source Issues”本页汇总自 2 个真实 issue
- CCR 和 CC Switch 冲突导致一直要求登录怎么办?
- CCR 会设置 ANTHROPIC_BASE_URL 环境变量,其优先级高于 CC Switch 写入的 ~/.claude/settings.json。请清除该环境变量或升级 CC Switch 使用冲突检测功能。
- 在 WSL Ubuntu 中如何让 CC Switch 代理在后台运行?
- CC Switch 目前不原生支持纯后台服务模式。建议在 Windows 端运行 CC Switch,然后在 WSL 中配置 ANTHROPIC_BASE_URL 指向 Windows 宿主机 IP 的代理端口。
- 通用配置提取功能会自动过滤 ANTHROPIC_BASE_URL 吗?
- 是的,代码层面已自动过滤 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 等供应商特有变量,不会将其错误存入通用配置中。
cc-switch 本地代理常见问题:502 Bad Gateway、超时、无法删除配置代理相关问题多由官方供应商不被支持、配置未生效或 UI 状态不同步引起;需按场景检查代理模式、供应商类型与接管状态。Unsupported parameter: 'max_tokens'报错来自路由转发时携带了模型不支持的 max_tokens 参数;issue 中未给出已确认的修复步骤,请核对模型参数支持或等待 cc-switch 修复。settings.json被全量重写导致插件失效多数相关 issue 仍未解决;升级至v3.20.1+,该版本已修复切换配置时清空enabledPlugins等字段的Bug。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。