报 401 / 403 怎么办
按顺序检查,大多数情况在前三步就能解决。
- Key 完整吗? 回控制台「API Key」页点「复制」,重新粘一次。手动选中复制很容易少一两个字符。
- Key 是启用状态吗? 同一页看状态,显示「已停用」就点「启用」。
- 余额够吗? 余额为 0 会返回 403
INSUFFICIENT_BALANCE,去「充值」页兑换。 - 认证头写对了吗? 自己写代码时才会遇到:
- OpenAI 格式:
Authorization: Bearer sk-你的Key - Anthropic 格式:
x-api-key: sk-你的Key - Gemini 原生格式:
x-goog-api-key: sk-你的Key
- OpenAI 格式:
- 配置生效了吗? 改完 Claude Code 或 Codex 的配置,要重新打开终端。cc-switch 切换后,已经开着的会话也不会自动换。
还不行,把报错原文发给客服(微信 zhao17337630083)。各种报错的原样返回见 错误码。