anthropic-sdk-python

官方 Python 库，几行代码接入 Claude 模型

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 897 🐛 待处理 219 👀 关注 182

GitHub ↗

GitHub 星标 ★ 4008

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源SDK免费使用，调用API按Anthropic官方计费

项目预览

anthropic-sdk-python 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开发框架

开发团队anthropics

GitHubhttps://github.com/anthropics/anthropic-sdk-python

定价模式🏷️完全免费

价格说明开源SDK免费使用，调用API按Anthropic官方计费

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

GitHub 星标★ 4008

上线时间2023-01-17 00:00:00

代码更新2026-10-23

仓库体积29.6 MB

本站数据更新2026-10-27

维护状态活跃

收录时间2026-10-27

浏览次数0

项目介绍

anthropic-sdk-python 是 Anthropic 官方维护的 Python 客户端库，用于在 Python 应用中调用 Claude 系列模型。它把底层 HTTP 接口封装成类型安全的客户端，开发者无需手写请求与解析逻辑即可完成对话、流式输出、工具调用、批处理等任务。核心能力包括：同步与异步双客户端、自动重试与超时控制、流式响应迭代、结构化工具与函数调用、消息与内容块类型定义、请求参数校验，以及对批处理和文件上传等接口的封装。项目配有较完整的类型标注和示例，可直接接入 FastAPI、Django 或脚本任务，适合构建聊天机器人、文档处理、代码辅助等 AI 应用，是 Python 生态中接入 Claude 的官方首选入口。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-27 · 当前星标 ★ 4008

使用教程

难度：入门约 10 分钟部署方式：库/依赖 6 步

环境要求

已安装 Python 与 pip 的本地环境（README 未标注最低版本）
一个可用的 Anthropic API Key（示例占位：sk-ant-xxxxxxxx）
能执行 pip 安装命令的终端或虚拟环境

安装与启动步骤

1确认 Python 环境

在终端确认 python 与 pip 可用，建议在独立虚拟环境中安装以免污染全局依赖。
```
python --version
pip --version
```
2安装 SDK

README 唯一给出的安装方式是用 pip 安装 anthropic 包，安装后即可在代码中导入。
```
pip install anthropic
```
3配置 API Key

示例代码从环境变量 ANTHROPIC_API_KEY 读取密钥，先把真实密钥写入当前终端会话。
```
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
```
4编写示例脚本

新建 quickstart.py，粘贴 README 的入门代码：创建 Anthropic 客户端并调用 messages.create。
```
python quickstart.py
```
5运行并查看结果

执行脚本，若配置正确会打印模型返回的内容块列表；报鉴权错误则回到上一步检查密钥。
```
python quickstart.py
```
6按需配置 OpenTelemetry

若已注册 tracer provider，SDK 会为每次调用上报 span；可指定其他 provider 或传 False 关闭。

关键配置

配置项	必填	说明	示例
`api_key`	是	客户端鉴权密钥，默认读取环境变量 ANTHROPIC_API_KEY，可省略该参数	`sk-ant-xxxxxxxx`
`max_tokens`	是	本次请求允许生成的最大 token 数，示例中为 1024	`1024`
`model`	是	指定要调用的 Claude 模型名称，示例使用 claude-opus-5-5	`claude-opus-5-5`
`messages`	是	对话消息数组，每条包含 role 与 content 字段	`[{"role": "user", "content": "Hello, Claude"}]`
`open_telemetry`	否	传入 tracer_provider 指定上报方，传 False 可关闭 span 上报	`{"tracer_provider": tracer_provider}`