Claude Code · LLM Gateway · 实测边界

Claude Code API Gateway 配置：先核对协议，再填参数

Claude Code 支持 LLM Gateway，但只有 OpenAI 兼容地址还不够。Anthropic 当前协议使用 ANTHROPIC_BASE_URL 选择 Messages 格式，并向 /v1/messages 发起推理请求。配置前要确认路由、认证头和模型发现都匹配。

Claude Code 对 Gateway 有什么要求？

在 Anthropic Messages 模式下，官方文档使用 ANTHROPIC_BASE_URL 指向 Gateway。Claude Code 会调用 /v1/messages；/v1/messages/count_tokens 是可选接口。Gateway 还要按上游要求保留 anthropic-version 和 anthropic-beta。

Claude Code 也支持 Amazon Bedrock 和 Google Cloud 格式，但它们使用不同的环境变量与请求结构。“LLM Gateway”不等于“OpenAI 兼容 /v1”。

MonkeyAI 现场验证到了哪一步？

2026-08-02 对生产接口做了脱敏探测：使用无效测试凭据请求 POST https://monkeytheme.com/v1/messages，服务器返回 HTTP 401 和结构化 JSON，错误码为 INVALID_API_KEY。不带凭据请求 /v1/models 时返回 HTTP 401 和 API_KEY_REQUIRED。

检查项	现场结果	可以确认的事实
`GET /v1/models`，无 Key	401 JSON	路由可达，并执行认证检查
`POST /v1/messages`，无效 `x-api-key`	401 JSON	Messages 路径与 Key 校验边界可达
有效 Key 的 Claude Code 会话	本轮未执行	不能据此承诺工具调用、流式输出等完整能力

401 探测不是端到端兼容性测试。它不能证明有效账号一定支持流式输出、工具调用、token 计数、beta 功能或模型发现。

明确区分 Base URL 与凭据

Anthropic 把路由与认证分开处理。ANTHROPIC_BASE_URL 负责把 Claude Code 指向 Gateway；Gateway 凭据变量或 apiKeyHelper 才会在当前会话中替换已经保存的 claude.ai 订阅凭据。只设置 Base URL，不会替换原登录状态。

export ANTHROPIC_BASE_URL="https://monkeytheme.com"
export ANTHROPIC_AUTH_TOKEN="***"
claude

上面展示的是官方环境变量形态，不代表每个 MonkeyAI 账号或模型分组都已支持 Claude Code。请使用自己后台生成的真实 Key，并在正式使用前核对可见模型。

检查认证头与模型发现

项目	Gateway 要求
`Authorization` / `x-api-key`	接受当前凭据方式对应的请求头
`anthropic-version`	保留上游格式要求的 API 版本
`anthropic-beta`	原样转发；官方不建议固定白名单 beta 值
`/v1/models`	使用模型发现时应直接响应；重定向或响应过慢可能导致静默失败

官方协议说明：设置 ANTHROPIC_AUTH_TOKEN 时，模型发现使用 Bearer Token；否则会把解析出的 API Key 放在 x-api-key 中。支持 helper 模式的 Gateway 必须接受 x-api-key。

按有限步骤验证

调用 /v1/models，确认账号能看到 Claude 系列模型。
确认 Gateway 支持 Anthropic Messages，而不只是 OpenAI Chat Completions 或 Responses。
在新终端中设置 Base URL 与凭据，再启动 Claude Code。
先运行一个短 prompt，然后再测试工具调用、流式输出和长上下文。
失败时记录 HTTP 状态、UTC 时间、模型、Request ID，以及是否收到过流事件。

如果 Gateway 只支持 OpenAI 兼容请求，应改用明确支持 OpenAI Compatible Provider 的客户端，例如 Cline 或 Roo Code。

官方资料

常见问题

Claude Code 可以接入任意 OpenAI 兼容 Gateway 吗？

不能直接这样判断。Claude Code 官方 Gateway 模式使用 Anthropic Messages、Bedrock 或 Google Cloud 格式，只有 OpenAI 兼容地址不足以证明兼容。

哪个变量负责把 Claude Code 指向 Anthropic 格式 Gateway？

ANTHROPIC_BASE_URL。认证由单独的 Gateway 凭据或 apiKeyHelper 负责。

设置 ANTHROPIC_BASE_URL 会替换 claude.ai 登录吗？

不会。官方说明，只设置 Base URL 会改变路由，但不会替换已经保存的订阅凭据。

MonkeyAI 的 /v1/messages 是否可用？

无认证生产探测已到达该路由，并返回结构化 401 JSON；本轮没有使用有效 Key 跑完整 Claude Code 会话，因此不承诺完整兼容。

Gateway 只支持 OpenAI 兼容请求时怎么办？

改用明确支持 OpenAI Compatible Provider 的客户端，例如 Cline 或 Roo Code。