疑难排查 · 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_URLclaude 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 里检查环境。