Claude Sonnet 5 于 2026 年 6 月 30 日正式上线 Anthropic API。本文提供完整的接入教程。
基本信息
| 参数 | 值 |
|---|---|
| 模型 ID | claude-sonnet-5 |
| 输入价格（优惠期至 8/31） | $2 / 百万 tokens |
| 输出价格（优惠期至 8/31） | $10 / 百万 tokens |
| 输入价格（9 月起） | $3 / 百万 tokens |
| 输出价格（9 月起） | $15 / 百万 tokens |
Python 接入
bash
pip install anthropicpython
import anthropic
client = anthropic.Anthropic(api_key="YOUR_API_KEY")
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "帮我审查这段 Python 代码并找出性能瓶颈"}
]
)
print(message.content[0].text)Node.js 接入
bash
npm install @anthropic-ai/sdkjavascript
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
const message = await client.messages.create({
model: 'claude-sonnet-5',
max_tokens: 1024,
messages: [{ role: 'user', content: '分析这段代码的安全漏洞' }],
});
console.log(message.content[0].text);流式输出
python
import anthropic
client = anthropic.Anthropic()
with client.messages.stream(
model="claude-sonnet-5",
max_tokens=2048,
messages=[{"role": "user", "content": "写一个完整的 FastAPI 用户认证模块"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)Agentic 工具调用
Sonnet 5 的核心优势在于工具调用：
python
import anthropic, json
client = anthropic.Anthropic()
tools = [
{
"name": "run_code",
"description": "在沙箱中执行 Python 代码并返回结果",
"input_schema": {
"type": "object",
"properties": {
"code": {"type": "string", "description": "Python 代码"}
},
"required": ["code"]
}
}
]
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
tools=tools,
messages=[{"role": "user", "content": "分析这段代码的时间复杂度并优化"}]
)
if response.stop_reason == "tool_use":
for content in response.content:
if content.type == "tool_use":
print(f"调用工具: {content.name}")
print(f"参数: {content.input}")Prompt Caching（节省成本）
对于长上下文应用，启用缓存可降低约 90% 的输入成本：
python
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
system=[
{
"type": "text",
"text": "你是一个专业的代码审查助手，熟悉 Python、TypeScript 和 Go...",
"cache_control": {"type": "ephemeral"}
}
],
messages=[{"role": "user", "content": "审查以下代码：..."}]
)从 Sonnet 4.6 迁移
python
# 迁移前
model = "claude-sonnet-4-6"
# 迁移后（无其他改动）
model = "claude-sonnet-5"API 接口完全向后兼容，一行代码完成迁移。
最佳实践
- 优惠期把握：在 2026 年 8 月 31 日前迁移，享受 $2/$10 定价
- max_tokens 设置：简单问答 1024，编程任务 4096，复杂 Agent 8192
- 错误重试：遇到速率限制（429）使用指数退避重试
- Prompt Caching：长系统提示加
cache_control可大幅节省成本
总结
Claude Sonnet 5 是目前性价比最高的 Claude 模型，将 claude-sonnet-4-6 替换为 claude-sonnet-5 即可无缝升级，享受更强性能和优惠期折扣。
参考：Claude API Models Overview — Anthropic Platform