Claude API 基础用法 (Messages API)

Anthropic 官方 API overview 现在写得很直接：Messages API 仍然是 Claude API 的 primary API。也就是说，如果你要和 Claude 做最基础、最标准的交互，还是从 POST /v1/messages 开始。

#最小调用长什么样

python复制
from anthropic import Anthropic

client = Anthropic()

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(message.content[0].text)

#先理解 4 个核心字段

• model
• max_tokens
• messages
• system

其中 messages 仍然是主线交互结构，而 system 用来额外定义角色、规则和边界。

#多轮对话不是自动记忆

Messages API 不会替你保留会话历史。你如果要做多轮交互，还是得自己把历史消息继续带回去。

python复制
messages = [
    {"role": "user", "content": "你好，我是小明。"},
    {"role": "assistant", "content": "你好小明！很高兴见到你。"},
    {"role": "user", "content": "我刚才说我叫什么名字？"},
]

这点很普通，但很关键。很多“Claude 怎么不记得前文”的问题，最后就是没把 assistant 回复一并放回去。

#一个很实用的 Claude 特点

Anthropic 官方长期都强调 Claude 对结构化输入更敏感，所以 XML 风格标签在复杂任务里依然很值得用。它不是硬性要求，但在长上下文、抽取和多约束场景里确实常常更稳。

#下一步

如果你已经把 Messages 基础请求打通，下一页更值得看的通常是：

• 流式响应
• Tool Use