## 文档变更分析
### 1. 总体摘要
本次文档更新标志着 **Claude Opus 4.8** 的正式发布及其成为新标准,同时引入了 Fable 5 和 Mythos 5 模型。主要变化包括强制推行“自适应思考”,在新一代模型中废弃手动配置思考预算,并显著提高了部分模型的输出上限。
### 2. 关键主题
* **模型迭代与标准化**:文档全面更新以推崇 `claude-opus-4-8`,替换了此前的 4.7 版本引用,特别是在工具调用和 Web 抓取场景中。
* **思考模式的重大变更**:针对新模型(Claude Opus 4.8, Fable 5, Mythos 5),手动扩展思考 (`budget_tokens`) 已不再支持并会返回 **400 错误**。必须改用“自适应思考”。
* **输出能力提升**:在模型概览表中,“Fast” 级别模型的最大输出 tokens 从 64k 翻倍至 **128k tokens**。
* **文档体验优化**:新增了大量多语言(C#, Go, Java, PHP, Ruby)代码示例,并在多个页面底部增加了“Next Steps”导航卡片,改善了开发者体验。
### 3. 影响级别:**中/高**
**理由**:虽然大部分为文档优化,但 `extended thinking` 参数的变更具有破坏性。若开发者直接将现有代码迁移到 Claude Opus 4.8 或其他新模型而不修改 API 参数,应用程序将直接报错。同时,输出 Token 的翻倍为长文本生成应用带来了显著的功能增强。
### 4. 开发者行动项
* **更新模型引用**:将复杂任务(特别是工具调用)的模型 ID 更新为 `claude-opus-4-8` 以利用最新性能。
* **迁移思考参数**:针对新模型,将代码中的 `thinking: {type: "enabled", budget_tokens: N}` 替换为 `thinking: {type: "adaptive"}`,并配合 `effort` 参数使用,以避免 400 错误。
* **利用新输出上限**:检查“Fast”层级模型(推测为 Sonnet 4.8)的应用场景,利用新增的 128k 输出能力处理更长内容的生成任务。
* **参考多语言示例**:如果您使用 C#、Go、Java、PHP 或 Ruby,可查阅新更新的文档代码块,获取关于 `tool_choice` 和 Web 搜索/抓取工具的最新用法。
💭 Model Reasoning
1. **Analyze the Request:**
* **Role:** World-class programmer analyzing documentation changes.
* **Input:** A batch of 7 pages showing diffs (documentation changes).
* **Output Format:** Markdown, concise, insightful, focusing on what matters to developers.
* **Language:** Chinese (as requested by "请用中文回复").
* **Specifics:**
1. Overall Summary (1-2 sentences).
2. Key Themes (bullets).
3. Impact Level (Low/Medium/High/Breaking) + Reasoning.
4. Action Items (max 5).
2. **Analyze the Input Diffs (Page by Page):**
* **Page 1: `about-claude/models/overview.md`**
* Change: Claude 4.8 (presumably "Claude Opus 4.8" based on context elsewhere, but actually looking at the table row "Max output"):
* *Correction*: Let's look at the row labeled "Max output".
* Old: `128k tokens | 64k tokens | 64k tokens`
* New: `128k tokens | 128k tokens | 64k tokens`
* Context: The columns correspond to models. Based on "Comparative latency" (Moderate | Fast | Fastest), these are likely the high-end models.
* Observation: The "Fast" model (likely Claude Sonnet 4.8 or similar mid-tier) has doubled its max output from 64k to 128k tokens.
* Context clues from other files: "Claude Opus 4.8" is mentioned often. Let's assume the "Fast" column is a specific model receiving an upgrade.
* *Actually*, looking at the context of "Comparative latency": Moderate (Opus), Fast (Sonnet?), Fastest (Haiku?).
* Change: The second column (Fast) increased Max Output from 64k to 128k.
* **Page 2: `build-with-claude/extended-thinking.md`**
* Massive restructuring of the "Supported models" section.
* Removed long text warnings about specific model behaviors.
* Replaced with a clear table.
* Key info:
* Claude Fable 5 & Mythos 5: Manual extended thinking NOT supported. Use Adaptive thinking.
* Claude Opus 4.8: Manual extended thinking NOT supported (400 error). Use Adaptive thinking.
* Claude Opus 4.7: Manual extended thinking NOT supported. Use Adaptive thinking.
* Claude Opus 4.6 & Sonnet 4.6: Manual mode *deprecated*.
* Title changed from "Building with extended thinking" to "Extended thinking".
* Intro changed: "Give Claude enhanced reasoning... control how thinking content is returned."
* Added a specific model list in a table format.
* Removed verbose `<Note>` blocks about specific versions, moved to table.
* **Page 3: `build-with-claude/streaming.md`**
* Card titled "Building with extended thinking" renamed to "Extended thinking".
* Added a new card: "Batch processing".
* **Page 4: `build-with-claude/batch-processing.md`**
* Removed horizontal rules (`----`).
* Added "Next steps" section with cards linking to "Search results" and "Prompt caching".
* **Page 5: `build-with-claude/search-results.md`**
* Added "Next steps" section with cards (Citations, Web search tool, Messages API reference, Prompt caching).
* **Page 6: `agents-and-tools/tool-use/implement-tool-use.md`**
* Updated "Choosing a model": Changed "Claude Opus (4.7)" to "Claude Opus (4.8)".
* Expanded "Forcing tool use" section significantly.
* Added detailed code examples (cURL, CLI, Python, TypeScript, C#, Go, Java) showing `tool_choice` usage.
* Updated model references in examples to `claude-opus-4-8`.
* **Page 7: `agents-and-tools/tool-use/web-fetch-tool.md`**
* Added extensive code examples for using Web Search + Web Fetch together.
* Includes cURL, CLI, Python, TypeScript, C#, Go, Java, PHP, Ruby examples.
* Updated model references to `claude-opus-4-8`.
* Added a "Code execution tool" card to "Related topics".
3. **Synthesize Findings:**
* **Model Update:** `claude-opus-4-8` is the new star. Documentation is shifting to reference it as the latest standard for complex tasks (tools, web fetch). `claude-opus-4-7` references are being replaced or removed.
* **Extended Thinking Shift:** There is a hard push towards "Adaptive Thinking" and away from "Manual Extended Thinking" (`budget_tokens`). Newer models (Fable 5, Mythos 5, Opus 4.8) do *not* support manual budget tokens and will throw a 400 error.
* **Capability Upgrade:** One model (likely the "Fast" tier, presumably Sonnet or similar) doubled its output capacity to 128k tokens.
* **Documentation Structure:** Cleaning up warnings into tables, adding "Next steps" navigation cards, and adding more multi-language code examples (C#, Go, Java, PHP, Ruby were added to the examples).
4. **Draft the Content (Internal Draft - English first, then Chinese):**
* *Summary*: Documentation updates focus on the release of Claude Opus 4.8 and new model versions (Fable 5, Mythos 5). Key changes include the deprecation/elimination of manual extended thinking (`budget_tokens`) in favor of adaptive thinking, and expanded code examples across multiple languages.
* *Themes*:
* Opus 4.8 Promotion.
* Adaptive Thinking Mandate (Manual thinking is now error/future removal on new models).
* Increased Output Token Limit (Fast model now 128k).
* Documentation Expansion (More languages, better navigation).
* *Impact*: Medium/High. The deprecation of manual extended thinking is a code change requirement for anyone upgrading to new models. 128k output is a significant feature unlock.
* *Actions*:
* Switch to `adaptive` thinking for new models.
* Update model strings to `claude-opus-4-8`.
* Review output limits for the "Fast" model.
5. **Translate and Refine into Chinese:**
* *Summary*: 文档更新重点突出了 Claude Opus 4.8 的发布及新模型版本(Fable 5, Mythos 5)。主要变更包括强制推行“自适应思考”,取代手动思考模式(`budget_tokens`),并大幅扩展了多语言代码示例。
* *Themes*:
* **模型更新与推广**: 文档全面更新至 Claude Opus 4.8,作为复杂任务的首选模型。
* **思考模式变革**: 新一代模型(Opus 4.8, Fable 5 等)不再支持手动配置思考预算,必须使用“自适应思考”,旧版模型的手动模式标记为废弃。
* **能力提升**: "Fast" 层级模型的最大输出 token 数翻倍至 128k。
* **文档体验优化**: 新增了 C#、Go、Java、PHP、Ruby 的代码示例,改进了导航结构。
* *Impact*: **Medium/High** (中/高). 主要影响在于针对新模型的 API 调用方式变化(特别是 Extended Thinking),这会导致旧代码在 4.8 等模型上报错。
* *Action Items*:
* 切换模型: 在复杂任务工具调用示例中,将模型 ID 更新为 `claude-opus-4-8`。
* 修改思考参数: 针对新模型,将 `thinking: {type: "enabled", budget_tokens: N}` 迁移至 `thinking: {type: "adaptive"}` 并使用 `effort` 参数,否则会收到 400 错误。
* 利用新上限: "Fast" 模型现在支持 128k 输出,可生成更长的内容。
6. **Final Polish (Self-Correction):**
* Make sure to mention the specific error (400) for manual thinking on new models, as that's critical for developers debugging.
* The output token change is from the `overview.md` table. The "Fast" column likely refers to Claude Sonnet 4.8 (inferred, but stick to what the diff says: the second column, "Fast", changed).
* Ensure tone is professional and "world-class".
7. **Final Output Generation** (matches the provided "Output" block).