Claude Code Invalid API Key 怎么办

排查 Claude Code invalid API key、token 过期、组织不匹配,以及订阅登录和 API 凭证混用。

如果 Claude Code 提示 Invalid API keyNot logged in、token expired,或者切换凭证后出现权限错误,问题通常不在项目代码,而在当前实际生效的认证路径。先确认 Claude Code 用的是 Claude 订阅登录,还是 API 类型凭证。

先检查这些

  1. 运行 /status 查看当前生效的凭证路径。
  2. 如果你想用订阅登录,检查 Shell 或项目环境里是否设置了 ANTHROPIC_API_KEY
  3. 如果你想用 API,去 Claude Console 或对应 provider 控制台确认 key 是否有效。
  4. 确认 key 属于预期组织、工作区和账单账号。
  5. 修改环境变量后,重启终端再测试。

常见原因

最常见的问题是凭证混用:Shell 里残留旧 API key、项目加载了意外的 .env,或团队环境指向了另一个组织。OAuth token 也可能过期或被撤销,这时需要重新登录。

安全处理方式

不要把 API key 粘贴进提示词或文档。先在本地检查环境,必要时在控制台轮换可疑 key,并且只在 CLAUDE.md 里记录凭证来源,例如“使用订阅登录”或“使用团队 API workspace”。

相关页面

官方来源