主题
EE-12 403 Missing API Key
| 字段 | 内容 |
|---|---|
| 影响组件 | Claude Code 本体 |
| 系统环境 | Linux / macOS / Windows |
问题现象
终端返回：
403 / Missing API Key1
请求到达中转服务但未携带有效的认证信息。
根因分析
Claude Code 配置文件被意外修改，或多个配置源冲突导致认证字段丢失。常见触发：
- 手动编辑
settings.json时误删了env块 - 升级或切换工具后配置格式变化
- OAuth 登录状态覆盖了 API Key 认证，见 401 登录官网后 Key 失效
修复步骤
- 最省事：在控制台 API 密钥 页对当前 key 重新点一次 ⋮ → ★ 一键配置，覆盖
~/.claude/settings.json。想手工核对就确认env里ANTHROPIC_BASE_URL与ANTHROPIC_AUTH_TOKEN都在，且值是控制台当前的。 - 或使用 CC Switch 重新选择供应商并保存，让它重写配置。
- 完全退出并重启终端，重新运行
claude。
如果问题持续，删除 ~/.claude 目录后重新配置。
预防措施
| 做法 | 避免的问题 |
|---|---|
手动编辑前备份 settings.json | 误删字段后无法回溯 |
| 遇到 403 优先用 CC Switch 重写 | 手动修配置引入新错误 |