Changes on 2026-07-24

用户希望我分析一批文档变更（11页），并用中文提供简明的分析。 角色：世界级程序员，专注于开发者工具和文档。 格式：Markdown。 内容： 1. 总体摘要（1-2句话） 2. 关键主题（要点） 3. 影响级别（低/中/高/破坏性）及理由 4. 给开发者的行动项（最多5个要点） 让我们分析一下 diff： **1. sandboxing.md** - 更新了关于计划模式下 `rm`/`rmdir` 权限提示和自动允许模式的文档。 - 增加了关于版本 2.1.218 的细节，涉及自动模式下的分类器路由和 `useAutoModeDuringPlan`。 - 澄清了计划模式下自动允许的行为随时间的变化。 - *主题：沙盒行为细化，版本特定的逻辑。* **2. get-started.md** - 将 Java SDK 版本从 `2.50.0` 更新到 `2.52.0`。 - *主题：依赖项更新。* **3. about-claude/models/migration-guide.md** - 阐明了 Claude Opus 5 的回退参数（提及了 beta 头信息）。 - 删除了某些段落中关于 Opus 5 上的 `low`/`medium` 相比早期 Opus 模型“更强”的说法（主要是移除了比较性的措辞）。 - 澄清了服务器端回退的 beta 状态。 - *主题：Opus 5 细微差别，API 参数澄清。* **4. build-with-claude/overview.md** - 表格看起来是重新生成或格式化的。ZDR（零数据保留）列和可用性列似乎是一致的。内容似乎是相同的，但周围的文本可能重新格式化或很细微？等等，仔细看 diff……`</Table>` 被截断了。实际上，看提供的内容，diff 在 Thinking 行结束。这看起来像是 Markdown 表格结构的规范化或重新生成，但在片段中内容本身看起来大部分相同，只是验证标记（如 `†` 或 `*`）可能被调整了。实际上，对比 `build-with-claude/text-generation.md`，这似乎是重复的内容或跨文档的结构性变更。 - *主题：结构/表格更新（可能是重新生成或规范化）。* **5. build-with-claude/text-generation.md** - 与 overview.md 类似，表格变更。 - *主题：结构/表格更新。* **6. build-with-claude/effort.md** - 更新了 Opus 5 的“推荐 effort 级别”。建议从 `high`（默认值）开始，而不是之前建议的 `xhigh`。 - 将 Java 代码示例从 `System.out.println` 更改为 `IO.println`。 - 移除了关于 Claude Code 的 "ultracode mode" 的说明块。 - *主题：Opus 5 effort 级别的最佳实践，代码示例清理。* **7. build-with-claude/claude-on-amazon-bedrock.md** - 将 Java SDK 版本从 `2.50.0` 更新到 `2.52.0`。 - *主题：依赖项更新。* **8. build-with-claude/claude-on-vertex-ai.md** - 将 Java SDK 版本从 `2.50.0` 更新到 `2.52.0`。 - *主题：依赖项更新。* **9. build-with-claude/claude-in-microsoft-foundry.md** - 将 Java SDK 版本从 `2.50.0` 更新到 `2.52.0`。 - *主题：依赖项更新。* **10. agents-and-tools/mcp-connector.md** - 将 Java SDK 版本从 `2.50.0` 更新到 `2.52.0`。 - *主题：依赖项更新。* **11. CHANGELOG.md.md** - 添加了版本 2.1.220：“Bug 修复和可靠性改进”。 - 从 2.1.219 中移除了一些条目（自我托管运行器修复，钩子错误分类）——可能是因为它们被移动了或最终确定进入了特定版本，或者可能是清理。 - *主题：版本发布说明。* **综合：** * **SDK 更新：** 大量从 `2.50.0` 推进到 `2.52.0`。这意味着 Java SDK 有补丁/小版本更新。 * **Opus 5 细微差别：** 调整了迁移指南和 effort 文档。具体来说，建议从 `high` 开始（这是默认值），而不是之前暗示的 `xhigh`。澄清了回退是 beta 功能。 * **沙盒行为：** 增加了关于特定版本（2.1.218+）分类器如何处理计划模式下的危险命令的细节。 * **清理：** 移除了关于 Ultracode mode 的说明，更新了代码示例（`IO.println`），以及变更日志维护。 **影响级别：** 低到中。这主要是文档的澄清、SDK 版本的更新（通常向后兼容），以及推荐配置的微调。没有什么破坏性的内容。 **行动项：** 1. 更新 Java 依赖项到 2.52.0。 2. 回顾针对 Claude Opus 5 的 effort 配置（从 `high` 开始）。 3. 注意沙盒逻辑在计划模式下的行为，如果使用 v2.1.218+ 的分类器功能。 让我们用中文起草回复。 **总体摘要：** 本次文档更新主要集中在 SDK 版本升级、Claude Opus 5 模型的最佳实践微调，以及沙盒与计划模式下的权限行为澄清。 **关键主题：** * **Java SDK 升级：** 全面的 Anthropic Java SDK 从 `2.50.0` 升级至 `2.52.0`，涉及标准版、Bedrock、Vertex AI、Foundry 及 MCP 连接器。 * **Opus 5 使用建议调整：** 更新了 Claude Opus 5 的 `effort` 参数推荐，建议从默认值 `high` 开始（而非之前的 `xhigh`），并移除了关于 Opus 5 低 effort 级别相比旧模型“更强”的对比描述。 * **沙盒安全逻辑细化：** 明确了在计划模式下，`rm`/`rmdir` 等危险命令在 v2.1.218 版本后的处理逻辑，涉及分类器检查和自动模式的交互。 * **文档清理与规范化：** 修正了 Java 代码示例（如使用 `IO.println`），移除了关于 Ultracode mode 的说明，并更新了变更日志。 **影响级别：** * **级别：** 低 * **理由：** 大多数更改为依赖项的微小版本更新（通常向后兼容）和文档措辞的优化。Opus 5 的 effort 建议是最佳实践的调整，而非 API 强制变更。对开发者现有代码的破坏性影响极小。 **行动项：** * 更新项目中的 `com.anthropic:anthropic-java` 依赖版本至 `2.52.0`。 * 如果正在使用或计划迁移到 Claude Opus 5，重新评估 `effort` 参数设置，建议从默认值 `high` 开始测试。 * 关注沙盒环境下 Claude Code v2.1.218+ 对计划模式中敏感命令的处理变化，以确保符合预期安全策略。

**1. 用户的请求：** - 用户想要对文档更改进行“世界级程序员”的分析。 - 输入：2页（`hooks.md` 和 `mcp.md`）的diff。 - 输出格式：Markdown，包括“整体总结”、“关键主题”、“影响级别”和“行动项”。 - 语言：中文。 - 语气：简洁、深刻、以开发者为中心。 **2. 分析 Diff：** * **文件：`hooks.md`** * *更改：* 修改了被拒绝工具调用示例中 `reason` 字段的描述。 * *之前：* `reason` 显示解释（例如，“Auto mode denied: command targets...”）。 * *之后：* `reason` 是固定文本“Blocked by classifier”*或者*解释，这取决于会话分类器模型是否提供。添加了指向特定配置文档的链接。 * *影响：* 这改变了开发者解析日志或调试被拒绝操作时的预期。现在它是一个静态字符串或可能为空，而不是总是包含详细的理由。 * **文件：`mcp.md`** * *更改 1：新增“Disable a server without removing it”部分（Disable a server without removing it）。* * 解释了 `/mcp` 切换行为。 * 细节：配置存储在 `~/.claude.json` 中。 * 列表：`disabledMcpServers`（针对默认为开启的服务器，如用户服务器、插件服务器、claude.ai 连接器）与 `enabledMcpServers`（针对默认为关闭的内置服务器，如 `computer-use`）。 * 关键区分：这些列表互不覆盖（不相交集合）。 * 阐明：这些与项目特定设置中用于 `.mcp.json` 的 `enabledMcpjsonServers`/`disabledMcpjsonServers` 不同。 * *更改 2：修改“Plugin-provided MCP servers”部分。* * 重新措辞以清晰表达：插件服务器在启用插件时启动。 * 阐明管理：通过安装/卸载来添加/删除，但可以在 `/mcp` 中*切换*（回指更改 1）。 * 优化“Automatic lifecycle”部分（微小的语法更改，“Claude Code connects...”）。 **3. 综合分析：** * **整体总结：** 更新阐明了权限拒绝日志记录的细微差别，并提供了关于通过 UI (`/mcp`) 管理 MCP 服务器状态（启用/禁用）与通过配置文件管理的技术细节。 * **关键主题：** * **调试与日志记录：** `hooks.md` 中的 `reason` 字段行为更加标准化（固定字符串“Blocked by classifier”）。 * **配置管理：** `mcp.md` 解释了*用户偏好*（`~/.claude.json`）与*项目配置*（`.mcp.json`）以及默认开启/默认关闭服务器逻辑之间的分离。 * **生命周期控制：** 对如何切换服务器（尤其是插件服务器）与完全删除服务器的更精细控制。 * **影响级别：** **Medium**（中等）。 * *推理：* * `hooks.md` 更改是一个潜在的破坏性变更（对于期望理由*总是*出现在 `reason` 字段中的解析逻辑）或调试工具变更。 * `mcp.md` 更改是文档说明，但揭示了特定配置文件（`~/.claude.json`）的内部状态管理机制，这有助于开发者调试为什么某个服务器没有连接。 * **行动项：** * 更新任何解析工具拒绝日志的逻辑，以处理 `reason` 为固定字符串或解释文本的情况。 * 如果使用 `computer-use`，需理解在 `~/.claude.json` 中手动将其添加到 `enabledMcpServers` 以启用它的逻辑。 * 不要混淆 `disabledMcpServers`（用户偏好）与 `disabledMcpjsonServers`（项目审批）。 * 使用 `/mcp` 面板在不禁用插件的情况下切换特定服务器连接。 **4. 起草中文回复（迭代优化）：** * *总结：* 文档更新主要集中在完善工具调用拒绝时的日志信息格式，以及详细说明了 MCP 服务器的启用/禁用机制和配置存储位置。 * *主题：* * 日志标准化：`reason` 字段变为固定文本或可选的解释文本。 * 配置分离：区分用户偏好配置 (`~/.claude.json`) 和项目配置 (`.mcp.json`)。 * 服务器生命周期：明确了如何在不删除配置的情况下禁用服务器，以及“默认开启”与“默认关闭”服务器的处理逻辑差异。 * *影响：* Medium。因为涉及到日志解析逻辑的潜在变化，以及配置管理模型的理解。 * *行动项：* * 更新日志解析逻辑，处理 `reason` 可能仅为 "Blocked by classifier" 的情况。 * 理解 `~/.claude.json` 中 `disabledMcpServers` 和 `enabledMcpServers` 的互斥关系。 * 利用 `/mcp` 面板在不卸载插件的情况下临时禁用服务器。 **5. 最终润色（匹配要求的格式）：** * **整体总结**: 文档更新完善了工具调用被拒绝时的 `reason` 字段行为，并深入解析了 MCP 服务器的启用/禁用机制及其在不同配置文件中的存储逻辑。 * **关键主题**: * **日志标准化**：工具拒绝理由 (`reason`) 现在可能返回固定文本而非详细解释。 * **配置颗粒度**：明确区分了用户偏好配置 (`~/.claude.json`) 与项目配置 (`.mcp.json`)，以及针对“默认开启”和“默认关闭”服务器的不同管理列表。 * **服务器状态控制**：增加了关于如何在 `/mcp` 面板中切换服务器开关而不删除配置的说明。 * **影响级别**: **Medium** * **理由**: `hooks.md` 的更改可能影响依赖解析 `reason` 字段进行错误调试或自动化处理的脚本。`mcp.md` 的更改虽然主要是文档说明，但揭示了底层的配置状态管理逻辑，对排查连接问题至关重要。 * **行动项**: * 检查并更新任何依赖解析 `reason` 字段以获取错误详情的代码或脚本，以适应其可能仅包含固定字符串 "Blocked by classifier" 的情况。 * 若需启用默认关闭的内置服务器（如 `computer-use`），应将其添加到 `~/.claude.json` 的 `enabledMcpServers` 列表中，而非 `disabledMcpServers`。 * 利用 `/mcp` 面板来临时禁用插件提供的服务器，无需卸载插件即可断开连接。 这看起来很稳妥。我将基于此输出结果。

1. **Analyze the Request:** * **Role:** World-class programmer, documentation expert. * **Task:** Analyze a batch of documentation changes (9 pages). * **Output Format:** Markdown. * **Sections:** Overall Summary, Key Themes, Impact Level + Reasoning, Action Items (max 5). * **Language:** Chinese. 2. **Analyze the Changes (Page by Page):** * **`claude-code-on-the-web.md`**: Removed a sentence about self-hosted runners program managing runner pools. * *Implication:* Self-hosted runner management location/UI has changed or the info was outdated/irrelevant. * **`hooks.md`**: Updated the JSON example for `PreToolUse` event. * *Changes:* Added `description`, `timeout`, `run_in_background` to `tool_input`. Added `tool_use_id`. Updated text to mention `tool_use_id`. * *Implication:* Hooks now receive more detailed context about tool usage, specifically IDs and metadata. * **`plugins-reference.md`**: * Added `workflows` field to the manifest table (custom workflow scripts/directories). * Updated text about `pluginConfigs` storage. Crucially: *Claude Code no longer reads `pluginConfigs` from project-local settings (`.claude/settings.json` or `.claude/settings.local.json`)*. It only reads from User settings, CLI flags, and Managed settings. Reason: security (cloned repo could inject malicious config). * Added `workflows` to the "Replaces the default" list. * Updated folder structure diagram to include `workflows/`. * Updated warning to include `workflows/`. * Updated directory summary table to include Workflows. * *Implication:* Plugins now support workflows. **Breaking/Security Change**: Plugin options are now blocked from project-local settings to prevent supply chain attacks. * **`skills.md`**: Minor text change ("in these cases" -> "in cases like these"). Likely just a copyedit. * **`slash-commands.md`**: Same copyedit as `skills.md`. * **`about-claude/models/migration-guide.md`**: * Added point 8 about "Fast mode". Clarifies Claude Opus 5 supports fast mode, Opus 4.7 does not. * Updated "Recommended changes" to note Opus 4.7 fast mode is deprecated/unavailable. * **`about-claude/pricing.md`**: * Updated Fast mode pricing table. Removed Claude Opus 4.7 pricing. * Clarifies Fast mode is available on Opus 5 and 4.8 only. * Explicitly states Fast mode returns error on Opus 4.7. * **`api/rate-limits.md`**: * Text change: "part of how we prevent..." -> "part of how Anthropic prevents...". * Updated Fast mode rate limits section: Removed Opus 4.7 from the list. Clarifies Opus 4.7 returns error, Opus 4.6 runs at standard speed. * **`build-with-claude/prompt-caching.md`**: * Removed specific date "As of February 5, 2026". Just states "Prompt caching uses workspace-level isolation." * *Implication:* Workspace isolation for caching is now the norm/established fact, no longer a "breaking change" with a date. 3. **Synthesize and Structure (Drafting the Content):** * **Overall Summary**: Documentation update focusing on plugin architecture (workflows support and security hardening for configs), model availability updates (Fast mode deprecation for Opus 4.7), and minor text refinements. * **Key Themes**: * **Plugin Ecosystem Expansion**: Added support for custom Workflows. * **Security Hardening**: `pluginConfigs` can no longer be defined in project-local settings to prevent supply chain attacks. * **Model Lifecycle**: Fast mode is now limited to Opus 5 and 4.8; Opus 4.7 support is removed. * **Hook Payloads**: Added detailed fields (`tool_use_id`, etc.) to hook events. * **General Maintenance**: Removal of specific dates for established features (workspace isolation). * **Impact Level**: **High** (for plugin developers) / **Medium** (for API users using Fast mode). * *Reasoning*: The change to `pluginConfigs` reading behavior is a security breaking change. The removal of Fast mode for Opus 4.7 affects pricing and usage. * **Action Items**: * Review plugin configs: Move sensitive plugin options out of `.claude/settings.json`. * Update migration plans: Note that Fast mode is unavailable on Opus 4.7. * Update hook logic: Handle new fields (`tool_use_id`, `timeout`) if processing hook events. * Explore workflows: New directory structure available for plugins. * Update pricing expectations: Check Fast mode costs for supported models. 4. **Refine and Translate to Chinese (Iterative Check):** * *Overall Summary*: 本次文档更新重点在于插件架构的扩展（新增 Workflows 支持及配置安全强化）、模型可用性更新（Opus 4.7 移除 Fast mode 支持）以及若干文本润色。 * *Key Themes*: * 插件功能扩展：插件清单新增 `workflows` 字段，支持自定义工作流脚本。 * 配置安全变更（重要）：`pluginConfigs` 现在忽略项目级本地配置文件，仅读取用户级、CLI 或托管配置，以防止供应链攻击。 * 模型生命周期：Fast mode 现仅适用于 Opus 5 和 4.8，移除了对 Opus 4.7 的支持（会报错）。 * Hook 事件增强：`PreToolUse` 等事件增加了 `tool_use_id`、`timeout` 等详细字段。 * 文本维护：移除特定日期描述（如 Prompt Caching 的 Workspace 隔离），确认为既定事实。 * *Impact Level*: **High (High)** for Plugin Devs, **Medium (Medium)** for API Users. * Reasoning: The restriction on `pluginConfigs` location is a security-breaking change. Removal of Fast mode for older models affects pricing and error handling. * *Action Items*: * 检查插件配置：将敏感的 `pluginConfigs` 从项目的 `.claude/settings.json` 迁移至全局用户设置。 * 更新 Fast mode 依赖：如需 Fast mode，请从 Opus 4.7 迁移至 Opus 5 或 4.8。 * 处理 Hook 数据：检查处理 Hook 事件的代码，确保能处理新增的 `tool_use_id` 和元数据字段。 * 利用新功能：尝试在插件中使用新的 `workflows/` 目录结构来组织工作流脚本。 5. **Final Review against constraints:** * Markdown format? Yes. * Chinese? Yes. * Concise? Yes. * Max 5 action items? Yes. 6. **Construct Final Output.** (Matches the drafted content).

1. **Analyze the Request**: * **Role**: World-class programmer, expert in dev tools. * **Task**: Analyze documentation changes (1 page: `costs.md`) as a single batch. * **Format**: Markdown, concise, insightful, focus on developer impact. * **Language**: Chinese. * **Output Structure**: 1. Overall Summary (1-2 sentences). 2. Key Themes (bullets). 3. Impact Level (Low/Medium/High/Breaking) with reasoning. 4. Action Items for developers (max 5 bullets). 2. **Analyze the Input Data**: * **Page**: `costs.md`. * **Change**: 1 line added, 1 line removed. * **Context**: Documentation regarding the "Session block" in `/usage`, specifically how dollar figures are calculated. * **Old text**: "The dollar figure is an estimate computed locally from token counts and may differ from your actual bill." * **New text**: "Claude Code computes the dollar figure locally from token counts priced at standard list rates, so it doesn't reflect promotional pricing or contracted discounts and may differ from your actual bill." * **Observation**: The change adds specificity about *how* the price is calculated (standard list rates) and clarifies *why* it might differ (excludes promos/contracted discounts). 3. **Drafting the Content (Internal Monologue/Trial)**: * *Overall Summary*: The docs updated to clarify how the cost estimation works in Claude Code. It specifically mentions that local calculation uses standard rates and ignores custom deals. * *Key Themes*: Cost transparency, Billing accuracy, Estimation logic. * *Impact Level*: Low. It's a doc update clarifying existing behavior, not a code change. It helps manage expectations but doesn't break anything. * *Action Items*: None really, maybe just "be aware the local cost isn't exact if you have a discount". 4. **Translating to Chinese & Refining (World-class persona)**: * *Summary*: 文档更新了关于成本估算的解释，明确指出 Claude Code 中的计费是基于标准列表价格本地计算的，不包含促销价格或合同折扣。 * *Themes*: * 计费透明度 * 成本估算逻辑 * 定价差异说明 * *Impact*: * Level: Low. * Reasoning: This is purely a documentation clarification to prevent confusion regarding billing discrepancies. It does not change the software's functionality or API behavior. * *Action Items*: * 无需代码更改。 * 意识到本地显示的成本是估算值，且基于标准价格。 * 如需准确账单，继续使用 Claude Console。 5. **Final Polish (Formatting per instructions)**: * **Overall Summary**: 本次文档更新完善了关于 `/usage` 页面成本计算的描述，明确指出 Claude Code 中的费用估算基于标准列表价格，并不包含促销定价或合同折扣，解释了与实际账单可能存在差异的原因。 * **Key Themes**: * **计费逻辑细化**: 明确了本地计算是基于“标准列表价格”。 * **差异澄清**: 解释了费用估算为何会忽略折扣和促销。 * **用户预期管理**: 强调估算值仅供参考，权威账单需查看 Console。 * **Impact Level**: **Low** * **Reasoning**: 这属于文档说明性质的更新，旨在消除开发者对费用显示差异的误解。它不涉及代码行为变更、API 调整或功能破坏，对现有工作流无直接影响。 * **Action Items for developers**: * 无需进行任何代码修改或配置调整。 * 在查看 Claude Code 中的 Session 成本时，需意识到这是基于标准价格的预估值。 * 如果账户包含折扣或促销优惠，请继续以 Claude Console 的 Usage 页面作为权威账单依据。 6. **Review against constraints**: * Single batch analysis? Yes. * Markdown format? Yes. * Concise and insightful? Yes. * Chinese language? Yes. * Sections correct? Yes. 7. **Final Output Generation** (similar to the polished version above).

1. **Understand the Goal**: The user wants a concise, insightful analysis of documentation changes from a provided diff batch, specifically focusing on what matters to developers. The output needs to be in Markdown, in Chinese, and follow a specific structure: Overall Summary, Key Themes, Impact Level, and Action Items. 2. **Analyze the Input Data**: * **Total Pages**: 58 (but diffs provided for a subset of them). * **Core Pattern**: Almost every diff shows a replacement of "Claude Opus 4.8" with "Claude Opus 5". * **Specific Pages & Changes**: * `amazon-bedrock.md`: Default Opus model changes from 4.8 to 5. Versioning logic updated (2.1.219 changes). * `google-vertex-ai.md`: Default Opus model changes from 4.8 to 5. * `microsoft-foundry.md`: Text updated to suggest newer Opus models. * `model-config.md`: Model alias table updated. Opus 5 is the new default. Fallback logic updated (Fable 5 biology -> Opus 5, Opus 5 cybersecurity -> Opus 4.8). * `desktop.md`: Supported models list updated. * `statusline.md`: Example model ID updated. * `sub-agents.md`: Example model ID updated. * `intro.md`: Announcement link updated to Opus 5. * `get-started.md`: Code examples across many languages (API, CLI, Python, TS, C#, Go, Java, PHP, Ruby) updated to use `claude-opus-5` instead of `claude-opus-4-8`. * `about-claude/models/overview.md`: Comparison table updated. Opus 5 replaces Opus 4.8. * `about-claude/models/migration-guide.md`: Significant changes. Adds Opus 5. Explains Fable 5/Mythos 5 vs Mythos Preview. Refines migration guidance. * `about-claude/pricing.md`: Adds pricing for Opus 5 (same as 4.8: $5/$25). Adds Opus 5 to Fast Mode pricing. * `about-claude/model-deprecations.md`: Adds `claude-opus-5` to the table. Updates deprecation notes. * `api/messages.md`: Model enumeration updated to include Opus 5. `stop_reason` updated to include `model_context_window_exceeded`. * `api/messages/count_tokens.md`: Model enumeration updated. * `api/messages/batches/create.md`: Model enumeration updated. * `api/models/list.md`: New headers/beta flags added (server-side-fallback-2026-07-01, fallback-credit-2026-07-01). * `api/rate-limits.md`: Adds rate limits for Opus 5. * `api/beta-headers.md`: Code examples updated to Opus 5. * `api/service-tiers.md`: Updates list of unsupported models for Priority Tier (adds Opus 5). * `api/errors.md`: Code examples improved for error handling (streaming). Error messages updated for broader model ranges ("Claude 4.7 and later"). Error message for prefill changed. * `build-with-claude/overview.md` & `text-generation.md`: Feature table descriptions updated. 3. **Synthesize Findings**: * **Main Event**: Launch of **Claude Opus 5**. * **Default Behavior**: It becomes the default `opus` alias and primary model for many providers (Anthropic API, Bedrock, Vertex AI). * **Compatibility/Pricing**: Pricing appears identical to Opus 4.8. Rate limits are separate and high (1k/2M/400k for free tier, scaling up). * **Fallbacks**: Complex fallback logic introduced. Fable 5 biology -> Opus 5. Opus 5 cybersecurity -> Opus 4.8. * **Action Required**: Developers using defaults get the upgrade automatically. Developers hardcoding `claude-opus-4-8` need to update if they want the new model. * **SDK/API Changes**: New model string `claude-opus-5`. New `stop_reason`: `model_context_window_exceeded`. New error handling logic in docs. 4. **Drafting the Content (Internal Monologue -> Translation)**: * *Summary*: Documentation updates focus on the release of Claude Opus 5, which replaces Opus 4.8 as the default "opus" alias across most platforms. * *Chinese*: 本次文档更新主要集中在 **Claude Opus 5** 的发布，该模型取代 Opus 4.8 成为主要平台上的默认 `opus` 别名。 * *Key Themes*: * New Model Introduction: Opus 5 is now live. * Default Model Changes: Bedrock, Vertex, Anthropic API defaults to Opus 5. * Fallback Logic: Refusal/fallback behavior updated for Fable 5 and Opus 5. * Code Examples: Updated across all languages. * API Updates: New stop reason, headers, and error messages. * *Chinese*: * **Claude Opus 5 发布**：全面引入新模型，取代 Opus 4.8。 * **默认模型变更**：在 Amazon Bedrock、Google Vertex AI 和 Anthropic API 上，`opus` 别名默认指向 Opus 5。 * **降级逻辑更新**：针对 Fable 5 和 Opus 5 的内容安全拒答及回退策略进行了细化。 * **代码示例更新**：所有编程语言的入门示例均已更新模型 ID。 * **API 增强**：新增 `stop_reason` 类型、错误处理逻辑改进以及服务层级支持调整。 * *Impact Level*: Medium. It's an upgrade, not a breaking change for those using aliases, but hard-coded references need updates. Pricing is the same, but fallback logic complexity increases. * *Chinese*: **中等**。虽然对使用别名的用户是无缝升级，但硬编码模型 ID 的应用需要更新，且安全回退逻辑变得更为复杂。 * *Action Items*: 1. Test with Opus 5. 2. Update hardcoded IDs if you want the new model. 3. Review the new fallback logic if using Fable/Opus. 4. Check pricing/rate limits (though mostly same or better). 5. Handle new `model_context_window_exceeded` error. * *Chinese*: 1. **测试新模型**：如果依赖 `opus` 别名，请测试 Claude Opus 5 的输出是否符合预期。 2. **更新硬编码引用**：检查代码库中硬编码的 `claude-opus-4-8`，如有需要更新为 `claude-opus-5`。 3. **审查回退策略**：如果您使用 Fable 5 或 Opus 5，请务必理解新的基于类别的安全回退逻辑。 4. **处理新错误码**：更新错误处理逻辑以应对新增的 `model_context_window_exceeded` 停止原因。 5. **查看定价与限制**：虽然 Opus 5 定价与 4.8 持平，但速率限制是独立的，请确认符合您的需求。 5. **Refining the Output**: Ensure tone is professional ("world-class programmer"). Check Markdown formatting. Verify Chinese translations are natural. * *Self-Correction during drafting*: The prompt mentions 58 pages, but I only analyzed the diffs provided. I should focus on the diffs. The change from "Opus 4.8" to "Opus 5" is the overwhelming signal. The fallback logic change is the most "developer-focused" technical detail (behavioral change). The pricing/rate limits are standard for a new model release. 6. **Final Polish**: * **Summary**: 本次文档批量更新标志着 **Claude Opus 5** 的正式发布。Opus 5 现已成为 Anthropic API、Amazon Bedrock 及 Google Cloud 的默认旗舰模型，取代了之前的 Opus 4.8。 * **Themes**: 模型迭代（Opus 5 取代 4.8）、配置变更（默认别名指向变更）、代码示例同步、安全回退机制细化、API 状态码扩展。 * **Impact**: Medium. * **Actions**: Test upgrade, update IDs, check fallback logic, handle new error code. 7. **Final Output Generation** (matching the requested format).