Claude Messages API 推出消息线程测试版:后续轮次只发新消息,线程在最后一次请求 5 分钟后过期
长智能体循环可以让 API 在服务端暂存对话,每轮上传更少、首 token 延迟更稳;完整历史仍要应用自己保存。
// 要点
- 通过 message-threads-2026-08-12 测试版请求头启用:第一次请求带上完整对话、系统提示词和工具创建线程,之后每次只发新消息和上一条响应的 id
- 线程是尽力而为的:最后一次请求 5 分钟后过期,最后使用后不超过 1 小时删除;线程丢失时继续请求返回 404,需要重发完整对话
- system 和 tools 只在创建时发送;model、thinking、tool_choice、mcp_servers 等字段每轮必须与创建时一致,否则报 thread_fingerprint_mismatch;线程本身不缓存提示词
- 支持 Claude API、Claude Platform on AWS、Google Cloud 上的 Claude(Anthropic 托管)和 Microsoft Foundry;不适用于 ZDR 和 HIPAA
开发者视角PandaClaws 后台跑的正是这种每轮重发长历史的智能体循环。我会通过 SDK 的线程助手接入,重放由它处理;对话仍以我们自己保存的那份为准,再加上顶层 cache_control,因为线程本身不省 token 钱。签了 ZDR 或 HIPAA 协议的业务先不要用。