模型 ID 和版本控制

Claude 模型 ID 的结构和版本控制方式，包括 Claude 4.6 代引入的无日期格式及其对稳定性的意义。

每个 Claude 模型 ID 标识模型的一个固定版本。当您在 API 请求中使用模型 ID 时，底层模型在该 ID 的生命周期内保持不变。此保证涵盖模型 ID，而不涵盖 Claude API 为某些早期模型接受的便捷别名（参见 4.6 代之前）。

模型 ID 格式

Claude 模型 ID 遵循版本化命名方案。

从 Claude 4.6 代开始，模型 ID 使用无日期格式：

claude-{name}-{major}-{minor}

例如：claude-sonnet-4-6、claude-opus-4-6 和 claude-opus-4-7

在 Amazon Bedrock 上，对应格式为：

anthropic.claude-{name}-{major}-{minor}

例如：anthropic.claude-sonnet-4-6、anthropic.claude-opus-4-7

Claude Opus 4.6 是最后一个包含 -v1 后缀的 Bedrock 模型 ID（anthropic.claude-opus-4-6-v1）。Anthropic 从 Claude Sonnet 4.6 开始去掉了此后缀。

在 Google Cloud Vertex AI 上，格式与 Claude API 相同。

4.6 代之前的模型在 ID 中包含快照日期：

claude-{name}-{major}-{minor}-{YYYYMMDD}

例如：claude-sonnet-4-5-20250929、claude-haiku-4-5-20251001

在 Amazon Bedrock 上，这些使用以下格式：

anthropic.claude-{name}-{major}-{minor}-{YYYYMMDD}-v1:0

例如：anthropic.claude-sonnet-4-5-20250929-v1:0

在 Google Cloud Vertex AI 上，日期用 @ 分隔：

claude-{name}-{major}-{minor}@{YYYYMMDD}

例如：claude-haiku-4-5@20251001

在 Claude API 上，这些模型还有较短的别名（例如，claude-sonnet-4-5），指向该次版本的最新带日期快照。

一个常见的误解是，无日期模型 ID（如 claude-sonnet-4-6）表现得像常青指针，路由到最新或性能最佳的版本。事实并非如此。

对于 4.6 代及之后的模型，无日期 ID 是该版本的规范模型 ID。它映射到单一、固定的模型快照。Anthropic 不会更新现有模型 ID 的权重或配置。当有更新版本可用时，它会以新的模型 ID 发布。

这与 Claude API 上存在的早期模型的无日期别名不同。别名如 claude-sonnet-4-5 是一个便捷指针，解析为该次版本的最新带日期快照。4.6 代 ID 如 claude-sonnet-4-6 不是别名。它就是快照本身。

每个模型 ID，无论是带日期还是无日期的，都有自己独特的弃用和退役时间表。

模型权重对于给定 ID 是固定的，但围绕模型的服务基础设施可能会随时间变化。此基础设施包括请求路由器、安全分类器和采样逻辑等组件。

有时，即使模型 ID 和权重没有变化，基础设施更新也会产生可观察行为的微小差异。如果您注意到先前稳定的模型 ID 上出现意外的行为差异，基础设施更新是最可能的原因。

有关当前模型 ID 的完整列表及其 Amazon Bedrock 和 Google Cloud Vertex AI 等效项，请参见模型概述。