疑难排查 · Claude Code

Claude Code API Error 401 authentication_error 解决方法

当没有任何有效密钥到达它所连接的端点时,Claude Code 会打印 API Error: 401 authentication_error。导致它的环境变量规则以及修复方法。

你看到的报错

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key."}}

为什么会发生

  • 启动 claude 的 shell 里没有设置 ANTHROPIC_BASE_URL,所以密钥被发往 api.anthropic.com,而那里从没见过这把密钥。那台服务器返回 invalid x-api-key。
  • 变量设在了与启动 claude 不同的 shell 里——一个终端里的 export 在另一个终端中并不存在,GUI 启动器也不会读取你的 shell 配置文件。
  • ANTHROPIC_AUTH_TOKEN 为空、被截断,或填的是其他提供商的密钥。本端点接受 x-api-key 或 Authorization: Bearer 中的密钥;401 表示它收到的密钥没有一个有效。
  • 密钥已被吊销,或者在签发时设了到期日并已过期。

如何解决

  • 同时设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,并取消 ANTHROPIC_API_KEY,免得其他提供商的旧密钥碍事。
  • 在运行 claude 的同一个 shell 里验证:启动前直接打印变量的前几个字符。
  • 确认密钥在控制台中处于启用状态,然后用 curl 对 https://router.apitoken.sale/v1/models 测试它。

适用于本网关的可用环境

export ANTHROPIC_BASE_URL="https://router.apitoken.sale"
export ANTHROPIC_AUTH_TOKEN="sk-pool-•••"
export ANTHROPIC_MODEL="openai/gpt-6.1-terra"   # or a google/gemini-* model
export ANTHROPIC_DEFAULT_HAIKU_MODEL="openai/gpt-6-luna"   # background tasks
unset ANTHROPIC_API_KEY   # keep one credential
claude

相关搜索

  • API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}
  • claude code 401 custom ANTHROPIC_BASE_URL
  • claude code invalid api key

常见问题

为什么我刚设置了自定义 ANTHROPIC_BASE_URL,Claude Code 就返回 401?+
通常是变量没有进入运行 claude 的那个 shell,或者密钥属于与 base URL 所指不同的端点。检查那个 shell 里的环境,并让密钥与端点对应。
该用 ANTHROPIC_API_KEY 还是 ANTHROPIC_AUTH_TOKEN?+
ANTHROPIC_API_KEY 会变成 x-api-key 头;ANTHROPIC_AUTH_TOKEN 会变成 Authorization: Bearer。本端点两者都接受,但文档推荐 ANTHROPIC_AUTH_TOKEN。只保留其中一个。
同一把密钥在 curl 里能用,在 Claude Code 里不行——为什么?+
运行 claude 的那个 shell 环境状态不同:存在冲突的变量、过期的值,或者根本没有值。就在那个 shell 里检查环境。

跳过折腾坏掉的配置

apiToken.sale 通过 OpenAI 兼容端点、Messages(Anthropic 格式)端点和原生 Gemini 端点提供 GPT 与 Gemini 模型——标准 SDK、一把密钥、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。