### 概览
本次文档更新将 Claude Opus 4 和 Claude Sonnet 4 在官方 API 上的状态从“已弃用”正式更改为“已退役”,同时明确了它们仍保留在 AWS Bedrock 和 Google Vertex AI 平台上。此外,文档还清理了过时的迁移指南引用,并对流式处理文档进行了结构优化。
### 关键主题
* **模型正式退役**:`claude-opus-4` 和 `claude-sonnet-4` 在 Anthropic 官方 API 上已被标记为“已退役”(Retired),生效日期为 2026 年 6 月 15 日。
* **平台可用性差异化**:明确指出上述模型仅在 AWS Bedrock 和 Vertex AI 等合作平台上可用,官方 API 已停止服务。
* **文档清理与一致性**:从模型对比表、定价表、速率限制说明及迁移指南中移除了这两个模型的常规引用,仅在特定上下文中保留其遗留状态说明。
* **文档体验改进**:为流式处理页面添加了更清晰的定义和“下一步”导航卡片,帮助开发者快速查找相关资源(如停止原因、工具流等)。
### 影响等级
**中等**
**理由**:尽管这两个模型的退役已在之前的弃用公告中预警,但此次更新标志着官方 API 上的硬性切断点。如果开发者尚未迁移代码,直接调用将失败。不过,由于它们仍存在于 Bedrock 和 Vertex AI 上,这给依赖特定旧版本模型的应用提供了一定的缓冲期,而非完全强制中断。
### 开发者行动项
1. **检查官方 API 调用**:立即审查代码库,确保没有在生产环境中通过官方 API 调用 `claude-opus-4` 或 `claude-sonnet-4`,否则会面临服务中断。
2. **确认部署平台**:如果必须使用这两个模型,请将流量迁移至 AWS Bedrock 或 Google Vertex AI,它们目前仍支持这些遗留版本。
3. **规划后续迁移**:注意 `claude-opus-4-1` 仍处于“已弃用”状态,计划于 2026 年 8 月 5 日退役,请提前准备迁移至 Opus 4.8 或更新版本。
4. **查阅流式文档**:查看更新后的流式处理文档,利用新增的导航链接了解错误恢复和细粒度工具流等最佳实践。
💭 Model Reasoning
1. **Analyze the Request:**
* **Role:** World-class programmer, deep expertise in developer tools and documentation.
* **Task:** Analyze documentation changes as a single batch.
* **Output Format:** Markdown (concise, insightful).
* **Language:** Chinese.
* **Structure:**
1. Overall Summary (1-2 sentences).
2. Key Themes (bullets).
3. Impact Level (Low/Medium/High/Breaking) + reasoning.
4. Action Items (max 5 bullets).
2. **Analyze the Input Data (The Diffs):**
* **Page 1: `about-claude/models/overview.md`**
* *Changes:* Removed "Claude Sonnet 4" and "Claude Opus 4" columns from the comparison table.
* *Warning:* Updated to remove specific text about Sonnet 4 and Opus 4 retiring on June 15, 2026.
* *Context:* These models are likely fully retired from the standard API view, leaving only Opus 4.1 as deprecated in the list.
* **Page 2: `about-claude/models/migration-guide.md`**
* *Changes:* Removed code examples referencing "Claude Sonnet 4" (`claude-sonnet-4-20250514`) in migration paths.
* *Context:* Cleaning up migration guides to focus on current or recently deprecated models, removing references to models that are gone.
* **Page 3: `about-claude/pricing.md`**
* *Changes:* Status of Claude Opus 4 and Sonnet 4 changed from `[deprecated]` to `[retired, except on Vertex AI]` (for Opus 4) and `[retired, except on Bedrock and Vertex AI]` (for Sonnet 4).
* *Context:* Clarifying that while they might be "retired" on the first-party API, they persist on partner platforms.
* **Page 4: `about-claude/model-deprecations.md`**
* *Changes:* Status changed from "Deprecated" to "Retired" for Opus 4 and Sonnet 4. Date is June 15, 2026.
* *Note:* Added a note stating "These models were retired June 15, 2026."
* *Context:* Official status update marking them as retired.
* **Page 5: `api/rate-limits.md`**
* *Changes:* Removed Opus 4 and Sonnet 4 from the combined rate limit calculations for the main API.
* *Context:* Since they are retired, they no longer count towards the general API rate limits.
* **Page 6: `build-with-claude/extended-thinking.md`**
* *Changes:* Updated references to Opus 4 and Sonnet 4, adding the `[retired, except on Vertex AI]` / `[retired, except on Bedrock and Vertex AI]` caveats.
* **Page 7: `build-with-claude/streaming.md`**
* *Changes:* Added a description at the top of the page and a "Next steps" card group at the bottom.
* *Context:* Documentation improvement/UX enhancement, unrelated to the model deprecations.
* **Page 8, 9, 10, 11, 12, 13: (Prompt Caching, Batch Processing, Context Windows, Search Results, Bedrock, Tool Use Overview, Computer Use, Code Execution)**
* *Common Pattern:* All updated the label/status of "Claude Opus 4" and "Claude Sonnet 4" from `[deprecated]` to `[retired, except on Vertex AI]` (or similar variations depending on the platform).
* *Context:* Consistency update across the docs to reflect the "Retired" status while acknowledging availability on specific partner platforms.
3. **Synthesize Findings:**
* **Main Event:** The retirement of `Claude Opus 4` and `Claude Sonnet 4` models from the main Claude API.
* **Nuance:** They still exist on AWS Bedrock and Google Vertex AI.
* **Minor Event:** Improved documentation for streaming (added nav links).
* **Opus 4.1 Status:** It remains "Deprecated" (not fully retired yet), scheduled for retirement in August 2026.
4. **Draft the Response (Iterative translation to Chinese):**
* *Overall Summary:* The documentation updates primarily focus on officially retiring Claude Opus 4 and Claude Sonnet 4 from the first-party API while keeping them available on partner platforms (Bedrock/Vertex). Additionally, minor improvements were made to the streaming documentation.
* *Draft (CN):* 本次文档更新主要集中在将 Claude Opus 4 和 Claude Sonnet 4 从官方 API 标记为“已退役”,同时确认它们仍保留在 AWS Bedrock 和 Google Vertex AI 等合作平台上。此外,流式处理文档也进行了少量改进。
* *Key Themes:*
* **Model Retirement:** Opus 4 and Sonnet 4 are now "Retired" (not just deprecated).
* **Platform Specificity:** Explicitly stating they are retired *except* on Bedrock and Vertex AI.
* **Clean up:** Removing references to these models from comparison tables and migration guides.
* **Documentation Polish:** Better navigation in the Streaming section.
* *Impact Level:* **Medium**. Why? Because if you were using the deprecated models on the main API, they are likely gone (status changed to Retired). However, since they are still available on major cloud providers, it's not a complete loss for everyone, but it requires immediate attention for direct API users. (Wait, looking at dates in the diff: "June 15, 2026" is in the future relative to "now" if we assume current context, but typically these docs reflect the state *at that time*. Let's assume the docs are updating *to* this state. If the date is June 15, 2026, and the status is "Retired", it implies this is the state effective June 15, 2026).
* *Refined Impact:* **Low to Medium**. The status change from "Deprecated" to "Retired" is a significant milestone, but for developers who heeded earlier warnings, this is just an administrative update. The distinction about platform availability is crucial.
* *Action Items:*
1. Stop using Opus 4/Sonnet 4 on the main API (if you haven't already).
2. If on Bedrock/Vertex, note they are still available but legacy.
3. Check migration guides if you were on these specific versions.
4. Review streaming docs for new best practices.
5. **Final Polish (Chinese):**
* *Summary:* 此次更新将 Claude Opus 4 和 Sonnet 4 正式标记为在官方 API 上“已退役”,但保留在 AWS Bedrock 和 Vertex AI 上。同时清理了相关迁移指南,并优化了流式处理文档结构。
* *Themes:* 模型状态更新(从弃用到退役),平台差异化说明(仅保留在特定云平台),文档清理(移除过时引用),流式文档增强。
* *Impact:* Medium. 主要影响仍停留在旧版模型的直接 API 用户,虽已在合作平台保留,但属于遗留状态。
* *Action Items:*
* 避免在官方 API 中调用 Opus 4 和 Sonnet 4,除非使用 Bedrock/Vertex。
* 查阅新的流式处理文档了解最佳实践。
* 关注 Opus 4.1 的弃用时间表(2026年8月)。
6. **Format Generation:** (Matching the requested markdown structure).
* *Self-Correction during drafting:* Ensure I mention the specific dates found in the text (June 15, 2026) as the effective retirement date. Note that Opus 4.1 is still deprecated until Aug 2026.
Let's refine the Chinese translation for "world-class programmer" tone.
* "Retired" -> "已退役".
* "Deprecated" -> "已弃用".
* "First-party API" -> "官方 API" / "Anthropic 原生 API".
*Action Items refinement:*
1. Verify model usage: Ensure no active production code relies on `claude-opus-4` or `claude-sonnet-4` via the direct Anthropic API.
2. Platform check: If you need these specific models, migrate usage to AWS Bedrock or Vertex AI where they remain available.
3. Migration planning: Start planning for the retirement of Opus 4.1 (set for Aug 5, 2026) if applicable.
4. Docs review: Review the updated streaming documentation for improved error recovery and linking strategies.
*Impact Reasoning:* It's medium because it marks a hard cutoff for specific models on the main API, breaking existing calls if not migrated, but offers a fallback path through major cloud providers.
7. **Final Output Generation.**