Anthropic 为长时运行智能体推出消息线程 Beta

Anthropic 于 2026 年 11 月 2 日推出消息线程公开 Beta，允许 Claude 平台上的 Messages API 应用在首次发送完整对话请求后，后续仅发送新消息。

该功能面向对延迟敏感的活跃会话，包括长时间运行的编码智能体、截图保留在线程中的计算机使用智能体，以及文档和图像密集型工作流。Anthropic 报告称，在大多数 Claude Code 用户默认开启消息线程的情况下，包含 50 万至 100 万 token 的请求首 token 中位时间下降约 35%。

请求生命周期与恢复

不使用线程时，每一轮都会重新上传整个对话，API 也会重新验证并分词全部内容。使用线程时，大部分此类工作仅应用于新一轮，之后 API 再为模型重建对话。Claude 在每一轮仍会读取完整对话，因此 token 用量保持不变。标准 token 费率和现有速率限制仍然适用。

官方文档将生命周期分为创建请求和继续请求。创建请求会携带完整对话、系统提示和工具以及 thread 参数；API 将对话和 Claude 的回复存储在响应 ID 下。继续请求仅发送自上一响应以来的消息以及该响应的 ID，省略系统和工具。每个新的响应 ID 随后用于下一轮。

线程为尽力而为，并在最后一次请求五分钟后过期；API 存储的每个响应都会重新计时。应用仍是事实来源，必须保留每条消息的自身副本。如果 API 无法继续某个线程，客户端需在新的创建请求中再次发送完整对话。SDK 线程辅助工具负责创建和继续线程、添加所需的 beta 标头、在内存中保留对话，并针对指定的继续错误自动重放一次完整对话。

保留与缓存

线程内容在服务器管理的加密下保存在内存中，绝不写入持久存储，并在最后一次使用后不超过一小时删除。线程包含发送给模型的对话、创建请求的系统提示和工具，以及用于校验后续请求的固定字段指纹。文件按引用保留，因此应用必须在线程活跃期间保持对话所用每个文件可用。消息线程不符合零数据保留或 HIPAA 使用条件，尽管该功能不影响其他零数据保留功能的资格。

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

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

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

该 Beta 在原生 Claude 平台、AWS 上的 Claude 平台、Microsoft Foundry 中的 Claude 以及 Anthropic 管理下的 Google Cloud 上的 Claude 模型上可用，所有模型均支持 Beta。没有用于列出、读取或删除线程的 API。线程不支持 Message Batches、token 计数、按需压缩或大多数上下文编辑，并且对启用了 Inference hooks 的组织不可用。

由于线程会过期且无法通过 API 检索，使用该 Beta 的应用仍必须保留自己的对话历史，并维护完整对话重放路径，即使常规轮次仅包含新消息。