Anthropic 为长时间运行的智能体推出消息线程测试版

Anthropic 于2026年11月2日以公开测试版形式推出了消息线程，使 Claude Platform 上的 Messages API 应用在首次发送完整对话请求后，只需发送新消息。

这项功能面向对延迟敏感的活跃会话，包括长时间运行的编程智能体、截图会保留在线程中的计算机操作智能体，以及大量处理文档和图像的工作流。Anthropic 表示，对于大多数默认启用消息线程的 Claude Code 用户，包含50万至100万个令牌的请求，其首令牌生成时间中位数可缩短约35%。

请求生命周期与故障恢复

不使用线程时，每轮都要重新上传整个对话，API 也会再次验证并分词处理全部内容。使用线程后，在 API 为模型重建对话之前，大部分处理只需针对新一轮内容进行。Claude 仍会在每一轮读取完整对话，因此令牌用量保持不变。标准令牌费率和现有速率限制仍然适用。

官方文档将生命周期分为创建请求和继续请求。创建请求会连同 thread 参数一起发送完整对话、系统提示和工具；API 会将对话以及 Claude 的回复存储在响应 ID 下。继续请求只发送自上次响应以来的新消息，并附上该响应的 ID，不再包含 system 以及 tools。之后，每个新的响应 ID 都用于发起下一轮请求。

线程按尽力而为的方式提供服务，并会在最后一次请求后五分钟过期；API 存储的每个响应都会重新开始计算这段时间。应用仍是事实来源，必须保留每条消息的副本。如果 API 无法继续某个线程，客户端就要在新的创建请求中重新发送完整对话。SDK 线程辅助工具可以创建和继续线程、添加所需的测试版标头、在内存中保留对话，并在遇到指定的继续请求错误时自动重放一次完整对话。

保留与缓存

线程内容在服务器管理的加密保护下保存在内存中，不会写入持久存储，并会在最后一次使用后不超过一小时内删除。线程包含发送给模型的对话、创建请求中的系统提示和工具，以及用于核对后续请求的固定字段指纹。文件通过引用方式保留，因此在线程处于活动状态期间，应用必须确保对话中使用的所有文件都可用。消息线程不适用于零数据保留或 HIPAA 场景，但这项功能不会影响其他零数据保留功能的适用资格。

线程不会自动缓存提示；开发者必须提供缓存断点或顶层 cache_control带线程的请求最多可以包含四个缓存控制断点。线程也只能追加内容，且每个响应 ID 只能继续一次。更改仅适用于创建请求的字段（例如 system 或 tools），或更改固定字段，都需要新建一个包含完整对话的线程。

流式传输、可用性与功能限制

对于流式响应，客户端必须等待 message_stop 事件，然后才能从响应 ID 继续请求，因为过早发出的继续请求可能会返回404错误。流中断后，SDK 辅助工具不会自动重试继续请求。API 不会存储由备用模型生成的轮次，因此在线程继续之前，必须在新的创建请求中发送完整对话。

该测试版可在原生 Claude Platform、AWS 上的 Claude Platform、Microsoft Foundry 中的 Claude，以及由 Anthropic 管理的 Google Cloud 上的 Claude Models 中使用，所有模型均支持测试版。目前没有用于列出、读取或删除线程的 API。线程不支持 Message Batches、令牌计数、按需压缩或大多数上下文编辑功能；启用了 Inference hooks 的组织也无法使用线程。

由于线程会过期，且无法通过 API 检索，使用该测试版的应用仍必须保留自己的对话历史，并维持完整对话重放路径，即使日常请求轮次只包含新消息也不例外。