Claude 模型：读懂 Messages 的内容块

1. 打开 API 文档，而不是桌面设置

在 Claude 官方开发文档中找到 Messages API。确认模型标识、消息结构和输出预算等参数。Claude Desktop 的扩展设置并不是创建模型请求的地方。

Claude 应用订阅和 API 服务的计费、额度分别核对。不要因为桌面能对话，就把同一登录状态理解为程序已经有 API 认证。

2. 按类型读取 content 内容块

Messages 响应的 content 是内容块列表。阅读官方示例中的 type 字段，理解文本块与工具相关块的用途；不能把整个对象强制转成字符串交给用户。

用“从通知中提取时间”作为练习，先只取文本结果，再检查它是否来自原始通知。以后接工具时，应按块类型分支处理。

3. 检查停止原因与完整性

官方 Python SDK 的 Message 类型定义确认：content 是带 type 的内容块列表；stop_reason 中 end_turn 表示自然结束、max_tokens 表示达到输出限制、tool_use 表示调用工具。这不是完整枚举，其他类型需要按当前 SDK 分支处理。

若结果因输出预算被截断，不要把半段 JSON 写入数据库。先报告未完成，再根据业务设计续写或重新请求。

练习与核对

• 找到 Messages 的请求和返回示例
• 指出文本内容块的类型与正文
• 说明截断结果为什么不能直接入库

按实际操作自查，完成标记与成果草稿请在互动版保存。

带走这一点

读懂内容块和停止状态，比只看到模型返回了文字更接近可靠接入。

资料与核对记录

已通过官方 SDK 核对 Messages、content 内容块和停止原因。

本次核对公开官方资料，未登录产品账号、运行练习或发起付费调用。

• Claude Python SDK 使用示例

  已核对资料 · 获取：2026年9月14日 · 来源更新：未披露

  Messages 调用与 content 读取

• Claude SDK：Message 响应类型

  已核对资料 · 获取：2026年9月14日 · 来源更新：未披露

  content 内容块及 stop_reason 字段