# 模型 ID 和版本控制

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

---

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

## 模型 ID 格式

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

### 4.6 代及之后

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

```text
claude-{name}-{major}-{minor}
```

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

在 Amazon Bedrock 上，对应格式为：

```text
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 代之前

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

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

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

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

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

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

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

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

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

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

## 无日期 ID 是固定快照

一个常见的误解是，无日期模型 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

有关当前模型 ID 的完整列表及其 Amazon Bedrock 和 Google Cloud Vertex AI 等效项，请参见[模型概述](/docs/en/about-claude/models/overview)。
