Anthropic 兼容 API

面向 Claude Code 与兼容模型的 Messages API

KeepRouter 为受支持聊天模型提供 Anthropic 兼容的 /v1/messages 路由。Claude Code 与 Anthropic SDK 可指向同一 Base URL,但模型专有能力仍需逐项测试。

最后复核 2026-08-15 · 编辑复核: KeepRouter Editorial

客户端契约

Anthropic 风格请求使用 POST https://keeprouter.com/v1/messagesx-api-key 请求头和必需的 anthropic-version。在 Claude Code 中,把 ANTHROPIC_BASE_URL 设为 https://keeprouter.com,把 ANTHROPIC_AUTH_TOKEN 设为 KeepRouter Key。

Claude Code 指南提供两行配置和当前示例模型 ID。路由可用性与价格仍以实时目录为准。

原生形态,行为依模型而定

客户端看到的是 Messages 请求与响应格式;背后的配置线路可能直接中继 Anthropic 格式,也可能转换到另一种兼容聊天协议。转换可以保留常见消息、流式和受支持工具调用,但无法凭空创造所选模型没有实现的供应商专有能力。

对于 Agent 编码工作负载,请分别测试:

  • system prompt 与长对话历史;
  • content block 与工具结果续轮;
  • 流事件顺序和终止用量;
  • extended thinking 或 reasoning 控制;
  • 工作流发送截图时的图像 block;
  • 模型上下文与输出限制。

在 Claude Code 中切换模型

Claude Code 可以接受模型选择,但兼容性不只是接受一个 ID。替代模型必须支持 Messages 请求和会话使用的工具工作流。请用同一仓库状态与任务开启新会话,比较完成状态、工具序列、token、延迟和费用。

Key 与消费边界

创建只允许已批准编码模型的 Key,为自动循环设置合适的消费上限,并在直接 API 调用中限制输出 token。模型切换不应让应用悄悄获得整个目录的访问权。

何时更适合 OpenAI 格式

如果应用围绕 Chat Completions 或 Responses 构建,又不需要 Messages 原生客户端,就使用 OpenAI 兼容接口。KeepRouter 同时支持两类客户端,让接口选择跟随应用,而不是跟随模型品牌。

常见问题

Claude Code 可以使用 KeepRouter 吗?

可以。把 ANTHROPIC_BASE_URL 指向 KeepRouter,使用 KeepRouter Key,再选择兼容 Messages 的目录模型。

Messages 端点可以调用非 Anthropic 模型吗?

可以调用配置为兼容 Messages 路由的模型,但不代表能力完全一致;工具、视觉和推理都需测试。

协议转换会暴露给客户端吗?

客户端保持 Messages 形态,但错误或不支持的专有能力仍可能表现出差异,应显式处理。

所有编码 Agent 都应复用一个 Key 吗?

建议使用独立限定 Key 或明确的应用级控制,以便归因并限制消费与模型访问。

参考的一手资料

  1. [1] Anthropic Messages API
  2. [2] Claude Code settings

继续阅读

用两个环境变量连接 Claude Code

创建限定 Key,开启新会话,并实测一个代表性仓库任务。

创建免费 Key · 查看实时模型与价格 · 阅读 Markdown 版本