核心功能
anthropic 是 Anthropic 官方维护的 Python SDK，用于在 Python 应用中访问 Claude API。创建客户端后调用 messages.create()，传入 model、max_tokens 与 messages 即可拿到回复，需要 Python 3.9+。
功能亮点
多平台客户端
基础包内含 Vertex、Bedrock、Foundry 等平台客户端类
Token 计数
count_tokens 能在发请求前先算出输入 token 数量
工具运行器
@beta_tool 装饰器把 Python 函数直接注册为可调用工具
异步与流式
AsyncAnthropic 配合 stream=True 可逐个事件消费响应
自定义模型 / 模型接入
支持自定义网关
官方Claude SDK，默认走Anthropic官方API；可用ANTHROPIC_BASE_URL指向兼容网关，另有Bedrock、Vertex类。
接入方式
- 官方API：读ANTHROPIC_API_KEY构造Anthropic()
- 自定义端点：base_url参数或ANTHROPIC_BASE_URL环境变量
- Bedrock：用AnthropicBedrock类接入
- Vertex AI：用AnthropicVertex类接入
- 模型指定：messages.create()的model参数传模型名
支持模型
claude-opus-4-6claude-opus-5Bedrock上的ClaudeVertex AI上的Claude兼容网关自定义模型
bash
把SDK指向Anthropic兼容网关（自建或聚合网关，可桥接国产模型）
pip install anthropic
export ANTHROPIC_BASE_URL="http://<gateway-host>:<port>"
export ANTHROPIC_API_KEY="<gateway-key>"
代码中直接构造，无需再传参
from anthropic import Anthropic
client = Anthropic()
message = client.messages.create(max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], model="<model-name>")
也可在代码里显式指定端点
client = Anthropic(base_url="http://my.test.server.example.com:8083")
走Amazon Bedrock时改装extras并换客户端类
pip install "anthropic[bedrock]"
from anthropic import AnthropicBedrock适用场景
• 在 Python 服务中接入 Claude
• 通过 Bedrock 或 Vertex 调用模型
• 构建带工具调用的智能体
• 请求前预估 token 控制成本
安装配置
bash
pip install anthropic # Amazon Bedrock 支持 pip install "anthropic[bedrock]" # Google Cloud Vertex 支持 pip install "anthropic[vertex]" # 更好的异步性能 pip install "anthropic[aiohttp]"
使用方法
python
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get("ANTHROPIC_API_KEY"),
)
message = client.messages.create(
max_tokens=1024,
messages=[
{
"role": "user",
"content": "Hello, Claude",
}
],
model="claude-opus-5",
)
for block in message.content:
if block.type == "text":
print(block.text)
优点
- Anthropic 官方维护，新模型与新参数基本随 API 同步可用
- 基础包内置 Vertex、Bedrock、Foundry 客户端，换云平台不必换 SDK
- @beta_tool 与 tool_runner 能自动跑完工具调用循环，省去手写编排
- count_tokens 支持请求前预估输入用量，便于提前做成本控制
缺点
- 只覆盖 Claude 系列模型，要接其他厂商需另配 SDK 或统一网关
- SDK 本身免费，但 Claude API 按 token 计费，需自备付费账号
- 要求 Python 3.9 及以上，较老的运行环境需要先升级解释器
- 工具辅助能力仍标注 beta，接口可能随版本发生变化