Anthropic API 是 Anthropic 提供的模型接口,用来调用 Claude 系列模型。很多人会把“Anthropic API”“Claude API”“Claude Code”混在一起,其实它们是不同层面的东西。

本文讲清楚 Anthropic API 是什么、怎么调用、和 OpenAI 协议有什么区别,以及国内接入的两种方式。

说明:Anthropic、Claude 是其权利人的商标。本文以 2026 年 10 月的常见版本为例,接口和价格以官方/站内为准。

一、三个概念的关系

  • Anthropic:开发 Claude 模型的公司。
  • Anthropic API / Claude API:调用 Claude 模型的接口,通常指 Messages API。
  • Claude Code:Anthropic 的命令行编程工具,内部通过 API 调用模型。

所以你会在不同文档里看到“Anthropic API”和“Claude API”混用,大多数时候指的是同一个模型接口。

二、Anthropic API 的特点

1. Messages API

核心接口是 POST /v1/messages,请求体包含:

  • model
  • max_tokens
  • messages
  • system(可选)
  • temperature、top_p 等(可选)
  • tools(可选)

2. 请求头

原生接口通常需要:

x-api-key: sk-...
anthropic-version: 2023-06-01
content-type: application/json

不同版本/网关可能支持 Bearer Token,具体以文档为准。

3. 模型分档

Claude 常见分档:

档位适合场景
Opus复杂推理、长链路 Agent、难题
Sonnet日常写代码、改 Bug、代码审查
Haiku简单任务、批量处理、低成本

具体模型名和价格以 模型价格 为准。

三、直接调用示例

export ANTHROPIC_API_KEY="sk-你的密钥"

curl "https://api.anthropic.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "用三句话解释 Messages API"}
    ]
  }'

如果你用 SDK,按 Anthropic 官方 SDK 的方式初始化,不要套用 OpenAI SDK 的请求格式。

四、Anthropic API 和 OpenAI API 的区别

维度Anthropic APIOpenAI API
核心路径/v1/messages/v1/chat/completions
认证头x-api-keyAuthorization: Bearer
版本头anthropic-version无
消息格式messages + systemmessages(含 system role)
工具调用toolstools / functions
SDKAnthropic SDKOpenAI SDK

两者不是直接兼容的。很多网关会同时提供两种入口:Anthropic 兼容给 Claude Code,OpenAI 兼容给 OpenAI SDK/工具。

五、国内接入的两种方式

方式 A:官方直连

Base URL:https://api.anthropic.com

适合能稳定访问 Anthropic、已有官方账号和付款方式的团队。

方式 B:中商起航网关

  • Anthropic 兼容入口:https://ai.zhongshangqihang.com(用于 Claude Code 等)
  • OpenAI 兼容入口:https://ai.zhongshangqihang.com/v1(用于 OpenAI SDK/工具)

在 中商起航 AI 网关 注册、创建 Key、充值后即可使用。模型名以 模型价格 为准。

六、用 OpenAI SDK 调 Claude

如果你的工具只支持 OpenAI 协议,可以用网关的 OpenAI 兼容入口:

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "只回复 OK"}],
)
print(resp.choices[0].message.content)

注意:这不是 Anthropic 原生协议,参数和能力可能有差异。需要原生工具调用/缓存时,优先用 Anthropic 兼容入口。

七、计费怎么理解

Anthropic API 通常按输入 Token、输出 Token、缓存等计费。注意:

  • 输出 Token 通常比输入贵。
  • 长上下文会放大输入 Token。
  • 缓存命中可以省钱,但不是所有请求都命中。
  • 不同档位(Opus/Sonnet/Haiku)单价差异大。

具体单价以 模型价格 为准。估算方法看 Claude Code 价格:订阅 vs API。

八、常见问题

Anthropic API 和 Claude API 是同一个吗?

大多数语境下是同一个模型接口,只是叫法不同。

Anthropic API 支持 OpenAI 格式吗?

原生不支持。需要通过网关的 OpenAI 兼容入口,或使用适配层。

国内怎么稳定调用?

可以使用官方直连(如果网络允许),或使用国内可访问的网关。注意数据合规和服务条款。

Claude Code 用的是哪个接口?

Claude Code 走 Anthropic Messages API,具体配置看 Claude Code API 完整教程。

下一步

如果你需要国内稳定访问、统一账单或多模型切换,可以先 注册中商起航 AI 网关,创建测试 Key,跑通一条 Messages 请求。模型和价格以 模型价格 为准。

相关阅读: