先确认是认证错误

如果 Claude Code 能启动，但第一轮请求返回 401、authentication_error、invalid x-api-key、API key missing 或 invalid bearer token，先查 Key 和入口是否配套。

这类错误通常不是模型名问题。先不要改模型、代理和 settings。先确认当前终端读到了 Key，并且这个 Key 属于当前 ANTHROPIC_BASE_URL 指向的服务。

HTTP 401
error.type: authentication_error
message: invalid x-api-key
message: API key missing
message: invalid bearer token

检查当前终端有没有读到 Key

先在启动 Claude Code 的同一个终端里检查 Key。不要把真实 Key 打印出来，只看变量是否有值、长度是否合理。

如果这里读不到值，Claude Code 从这个窗口启动时也读不到。先把 Key 放进当前终端，再继续查其它配置。

$env:ANTHROPIC_AUTH_TOKEN.Length
$env:ANTHROPIC_API_KEY.Length

确认入口和 Key 来自同一家

再看 ANTHROPIC_BASE_URL。它决定请求发到哪里。入口和 Key 不属于同一家时，常见结果就是 401 或 invalid x-api-key。

DeepSeek 入口要配 DeepSeek Key。Anthropic 官方入口要配 Anthropic Console API Key。公司网关或 LiteLLM 入口要配网关要求的 Token，不要直接猜。

$env:ANTHROPIC_BASE_URL

用最小配置重试

如果你改过很多轮配置，先开一个新的 PowerShell，只放入口和对应 Key。不要同时改模型名、代理、子任务模型和 settings 文件。

下面的写法适合第三方 Anthropic-compatible 入口。把入口和 Token 换成同一家供应商或网关文档里的值。变量值里只放 Key 本身，不要手动加 Bearer。

$env:ANTHROPIC_BASE_URL="<供应商的 Anthropic-compatible 入口>"
$env:ANTHROPIC_AUTH_TOKEN="<同一家供应商或网关要求的 Token>"

在同一个窗口启动验证

最小配置放进当前 PowerShell 后，在同一个窗口启动 Claude Code。不要切到旧 VS Code 终端、桌面快捷方式或另一个管理员窗口验证。

成功标准是第一轮请求不再返回 401、invalid x-api-key、API key missing 或 invalid bearer token。如果认证通过后变成 404、model not found 或 unsupported parameter，说明已经进入其它配置层。

claude

清掉冲突变量后重试

如果你不确定 Claude Code 正在用哪条认证链路，先清掉当前窗口里的认证变量，再重新放入最小配置。这个操作只影响当前 PowerShell 窗口。

如果你之前写过用户环境变量、终端 profile 或项目 settings，新开的终端仍可能加载旧值。当前窗口清掉后还会复现时，再检查这些持久配置。

Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue

仍然 401：只检查 Key 来源

如果最小配置仍然返回 401，不要继续改模型名。先确认你现在连的是哪家服务，再确认 Key 是不是从同一家后台复制出来的。

只按当前使用方式检查一项：

• 直连 Anthropic 官方 API：使用 Anthropic Console 里的 API Key。
• 接 DeepSeek、GLM 或 MiniMax：使用对应供应商后台生成的 API Key。
• 接公司网关或 LiteLLM：使用网关文档要求的 Token。
• 使用 Claude 订阅登录：清掉当前终端里的 ANTHROPIC_API_KEY，避免误走 API Key 链路。

参考来源

相关文章