Claude Code API 怎么配置：Base URL、Token 与 /status 验证

适合谁，不适合谁

开始前准备

1. Claude Code 已安装，claude --version 和 claude doctor 可以运行。
2. 控制台明确给出 Claude Code 或 Anthropic 格式 Base URL。
3. 确认凭证应放在 Authorization: Bearer 还是 x-api-key 请求头。
4. 准备一个无敏感信息的测试项目和测试消息。

完整步骤

PowerShell 临时配置示例

把占位符替换为控制台明确提供的 Claude Code 字段。下面以 Bearer token 为例；x-api-key 时改用 ANTHROPIC_API_KEY。

$env:ANTHROPIC_BASE_URL = "BASE_URL_FROM_CONSOLE"
$env:ANTHROPIC_AUTH_TOKEN = "TOKEN_FROM_CONSOLE"
claude

# 在 Claude Code 中发送测试消息，然后运行：
/status

# 测试完成后关闭会话并清理当前终端变量：
Remove-Item Env:ANTHROPIC_BASE_URL
Remove-Item Env:ANTHROPIC_AUTH_TOKEN

怎样判断结果是否可用？

配置成功至少需要地址、凭证来源和真实消息都正确。只有环境变量存在不代表网关已经接受请求。

常见问题与报错

401 或 token 无效

确认凭证属于当前网关；Bearer token 与 x-api-key 使用不同变量和请求头，设置错误时切换到控制台指定类型。

Claude Code 仍要求登录

环境变量可能没有进入进程。确保从设置变量的同一个 PowerShell 启动，或使用用户级 settings.json。

/status 没有显示目标 Base URL

变量没有被当前会话读取，或被更高优先级配置覆盖；检查 settings 来源和启动方式。

地址可达但消息返回格式错误

网关可能不是 Anthropic 格式或路径不正确；确认 /v1/messages 协议支持，不要套用 Codex Responses 配置。

完成后的检查方法

• 控制台明确说明支持 Claude Code 或 Anthropic 格式网关。
• ANTHROPIC_BASE_URL 来自当前控制台。
• 凭证变量与 Bearer 或 x-api-key 请求头一致。
• Claude Code 从设置变量的同一终端启动。
• /status 显示目标 Base URL 和正确凭证来源。
• 测试消息得到正常结果，且 Key 未进入仓库或截图。

资料来源与版本说明

• Claude Code official: Connect to an LLM gateway

  说明 Base URL、凭证变量、PowerShell、settings.json、/status 和错误排查。

• Claude Code official: Environment variables

  说明 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_BASE_URL 的作用。

• Claude Code official: Settings

  Windows 用户目录下 ~/.claude 对应 %USERPROFILE%\.claude。

下一步