Claude Agent Memory API 获得独立 Beta 通道：7 月 22 日 Header 迁移对 Operator 意味着什么

Anthropic Python SDK v0.116.0 于 7 月 2 日发布，其中一条功能提交对所有使用 Claude Managed Agents Memory Stores 的 operator 影响重大：Memory Stores API 正在迁移到专属的 agent-memory-2026-07-22 beta header，取代自 2026 年 4 月以来负责所有记忆操作的 managed-agents-2026-04-01 header。

这不是一次废弃警告，而是一次有明确截止日期的 header 迁移——截止日期已内嵌在版本字符串中。

发生了什么

该 SDK commit 更新了 client.beta.memory_stores.memories 中每个方法（create、retrieve、update、list）注入的 anthropic-beta header，从 managed-agents-2026-04-01 改为 agent-memory-2026-07-22。影响范围是 Memory Stores CRUD 路径（/v1/memory_stores/{memory_store_id}/memories）；会话创建和会话操作仍使用 managed-agents-2026-04-01。

同一次变更还移除了 list endpoint 的两个查询参数：order 和 order_by。在 header 门控生效后，发送这两个参数的集成将收到 400 错误。

如果你使用官方 Python SDK，升级到 v0.116.0 或更高版本后 SDK 会自动注入新 header，无需修改代码——只需升级包并检查依赖 pin 版本即可。

如果你通过 HTTP 直接调用 Memory Stores API（curl、自定义客户端、非 Python SDK），则需要在 7 月 22 日激活日期前手动更新 anthropic-beta header。

为什么对 AI 工程团队重要

Memory Stores 功能于 2026 年 4 月在通用的 managed-agents-2026-04-01 umbrella 下发布，该 flag 一直是多个 in-beta agent API 面的便捷聚合标志。将 Memory Stores 升级到独立 header 通道，标志着 Anthropic 将其视为稳定、可独立版本化的 API 面——这对 operator 而言是重大信号。

对于运行生产 agent 的团队，实际影响包括：

跨会话持久化成为一等 API 面。 Memory Stores 获得独立 beta header，是 Anthropic 表明这不是临时实验的方式。Memory stores 是工作区级别的文本文档集合，在 agent 会话的 sandbox 中以目录形式挂载，让 agent 可以在会话间携带用户偏好、项目约定、历史错误和领域上下文。Operator 现在可以更有信心地在此基础上构建依赖记忆的工作流。

Header 管理变得更细粒度。 你现在可以独立于通用 managed-agents 面来选择加入记忆操作。对于希望控制 beta 暴露范围的团队来说，这很重要：如果你只使用 Memory Stores 而不依赖所有 managed-agents 特性，可以通过仅发送 agent-memory-2026-07-22 来限制 beta 面。

list endpoint 简化移除了排序灵活性。 记忆列表的 order 和 order_by 参数被删除，意味着 7 月 22 日后你将按存储的自然顺序获取记忆。如果你的 agent 工具或记忆管理界面按自定义字段排序，需要在客户端进行排序。

Router/Operator 视角

对于通过 gateway 路由 agent 流量或构建多 agent 系统的团队，Memory Stores 迁移揭示了一个将反复出现的模式：Anthropic beta header 本质上是变相的 API 版本控制。每个 anthropic-beta flag 实际上是一个版本化的面约定，当某个面升级到独立 header 时，旧的共享 flag 不再对该路径具有权威性。

Operator 应构建 SDK wrapper 和 gateway 配置，以明确处理 header 路由，而不是依赖 SDK 默认值。正确的模式：

• 会话创建和操作：managed-agents-2026-04-01
• Memory Stores CRUD（7 月 22 日后）：agent-memory-2026-07-22
• Dreams 研究预览：dreaming-2026-04-21（作为附加项，与 managed-agents header 并列）

如果你的 gateway 在请求级别代理 Claude API 调用并注入 beta header，而不是让 SDK 管理它们，现在就是审查 header 注入逻辑的时机。在所有 /v1/memory_stores/ 路径上注入 managed-agents-2026-04-01 的代理，在新 header 要求生效后很可能收到 4xx 错误。

对于使用 Python 或 TypeScript SDK 自动管理 header 的团队，唯一的操作风险是 pin 了旧版本的 SDK。如果你停留在 anthropic<0.116.0 且 7 月 22 日截止到来，memory store 操作将发送旧 header 并失败。请明确 pin 到 >=0.116.0。

Operator 在 7 月 22 日前应审查的内容

三步定向审查，在截止日期前完成：

1. 在代码库中搜索 managed-agents-2026-04-01，检查请求 header、配置文件、gateway 中间件和 API wrapper 代码。任何控制 /v1/memory_stores/ 调用的引用都需要更新为 agent-memory-2026-07-22。

2. 检查 SDK 版本 pin。如果使用官方 Python SDK，升级到 >=0.116.0，并验证你的 anthropic-beta 参数没有手动覆盖记忆调用的 header（否则 SDK 合并逻辑会同时发送新旧 flag）。

3. 审查 list endpoint 的使用方。从 GET /v1/memory_stores/{id}/memories 的调用中移除所有 order 或 order_by 参数——这些参数正在从服务端删除，截止日期后发送会导致参数验证错误。

在 Anthropic Memory Stores 上构建有状态多 agent 工作流的团队（其中每个 agent 会话继承预填充的上下文、用户偏好或项目约定）有 19 天的窗口来测试和验证。不要等到 7 月 22 日。

TheRouter 用户应关注的事项

如果你通过 TheRouter 路由 Anthropic 兼容请求，且你的 agent 使用 Managed Agents Memory Stores API，请检查路由层是否注入或剥离自定义 anthropic-beta header。TheRouter 会透传直接 Anthropic endpoint 的 provider 特定 header；如果你的集成依赖此透传，请在升级依赖后验证更新后的 header 能正确到达 Anthropic API。查看 TheRouter 文档 了解 Anthropic provider 配置和 header 转发行为。