docs: refresh Claude model facts

yeasy · yeasy · commit 8b103d1ea2f1 · 2026-06-08T16:16:36.000-07:00
diff --git a/01_intro/1.2_model_family.md b/01_intro/1.2_model_family.md
@@ -65,7 +65,7 @@ Claude 的迭代速度令人惊叹。每一次大版本更新都标志着 AI 能
 #### 第四代飞跃
 
 *   **Claude Opus 4 / Sonnet 4 (2025.05)**: Claude 4 代标志着推理能力的重大跃迁。Opus 4 因其强大的自主行动能力被 Anthropic 归类为 Level 3 模型，同时激活了 ASL-3 安全协议。
-*   **Claude Opus 4.1 (2025.08)**: 专注于 Agentic 任务和编程能力的增量升级，SWE-bench 成绩提升 7 个百分点。（注：Claude Opus 4 已于 2026-04-14 在 API 中 deprecated，计划 2026-06-15 retired；Claude Opus 4.1 当前仍为 active，最早退休日期不早于 2026-08-05。）
+*   **Claude Opus 4.1 (2025.08)**: 专注于 Agentic 任务和编程能力的增量升级，SWE-bench 成绩提升 7 个百分点。（注：Claude Opus 4 已于 2026-04-14 在 API 中 deprecated，计划 2026-06-15 retired；Claude Opus 4.1 已于 2026-06-05 deprecated，计划 2026-08-05 retired，推荐迁移到 Opus 4.8。）
 *   **Claude Sonnet 4.5 (2025.09)**: 平衡之王。在能力上匹配 Opus 4.1，但以更低的价格提供服务，迅速成为最广泛部署的模型。
 *   **Claude Haiku 4.5 (2025.10)**: 以 Sonnet 4.5 约 90% 的编码能力、4-5 倍的速度，为中小企业提供了极致性价比的选择。（注：Claude 3 Haiku 已于 2026-02-19 deprecated，并于 2026-04-20 retired；新项目应直接使用 Haiku 4.5。）
 *   **Claude Opus 4.5 (2025.11)**: 被称为“世界上最好的编码、Agent 和 Computer Use 模型”。长对话能力应按上下文窗口、提示缓存、压缩和记忆等官方能力分别核对；不要把“长对话管理”当作独立官方产品名。同时 Opus 系列价格大幅下调。
diff --git a/05_computer_use/5.2_loop.md b/05_computer_use/5.2_loop.md
@@ -46,16 +46,16 @@ graph LR
 
 在 Computer Use 模式下，Claude 通过版本化工具定义操作桌面环境。Computer Use 仍是 beta 能力，API 请求需要按官方文档添加对应的 `anthropic-beta` 头，并使用与模型匹配的工具版本；新项目应直接复制当前官方 quickstart 中的 `computer_*`、`text_editor_*`、`bash_*` 版本字符串。
 
-近期 Claude 4.6/4.7 的 Computer Use 组合通常是 `computer-use-2025-11-24` / `computer_20251124`，并配合 `text_editor_20250728` 与 `bash_20250124`；旧 Claude 4 / 3.7 文档曾使用 `computer-use-2025-01-24` / `computer_20250124`。版本会随模型更新，不能写死成永久规则。
+近期 Claude Opus 4.8/4.7/4.6、Claude Sonnet 4.6 和 Claude Opus 4.5 的 Computer Use 组合通常是 `computer-use-2025-11-24` / `computer_20251124`，并配合 `text_editor_20250728` 与 `bash_20250124`；旧 Claude 4 / 3.7 文档曾使用 `computer-use-2025-01-24` / `computer_20250124`。版本会随模型更新，不能写死成永久规则。
 
 #### `computer`
 
 这是最核心的工具，用于执行键鼠操作。
 *   **输入参数**:
-    *   `action`: 动作类型 (`key`, `type`, `mouse_move`, `left_click`, `left_click_drag`, `right_click`, `middle_click`, `double_click`, `screenshot`, `cursor_position`).
+    *   `action`: 动作类型。基础动作包括 `screenshot`, `left_click`, `type`, `key`, `mouse_move`；较新工具还支持 `scroll`, `left_click_drag`, `right_click`, `middle_click`, `double_click`, `triple_click`, `left_mouse_down`, `left_mouse_up`, `hold_key`, `wait`，`computer_20251124` 可通过 `enable_zoom` 启用 `zoom`。
     *   `coordinate`: `[x, y]` 坐标（可选）。
     *   `text`: 要输入的文本（可选）。
-*   **特性**: Claude 经过特殊训练，能够理解屏幕截图和坐标，但坐标语义取决于模型与工具版本。Opus 4.7 的较新 Computer Use 工具支持更高分辨率与 1:1 坐标；较旧工具仍可能要求缩放到官方限制范围内，生产实现应按当前 quickstart 设置分辨率和坐标转换。
+*   **特性**: Claude 经过特殊训练，能够理解屏幕截图和坐标，但坐标语义取决于模型与工具版本。Opus 4.8 / 4.7 的较新 Computer Use 工具支持更高分辨率与 1:1 坐标；较旧工具仍可能要求缩放到官方限制范围内，生产实现应按当前 quickstart 设置分辨率和坐标转换。
 
 #### `str_replace_based_edit_tool`
 
diff --git a/10_optimization/10.2_caching.md b/10_optimization/10.2_caching.md
@@ -555,7 +555,7 @@ Claude Code 实现了分层的成本追踪系统，每个模型都有精确的
 | Haiku 4.5 | $1.00 | $5.00 | $0.10 | $1.25 |
 | Sonnet 4.6 | $3.00 | $15.00 | $0.30 | $3.75 |
 | Opus 4 / 4.1 | $15.00 | $75.00 | $1.50 | $18.75 |
-| Opus 4.5 / 4.6 / 4.7 | $5.00 | $25.00 | $0.50 | $6.25 |
+| Opus 4.5 / 4.6 / 4.7 / 4.8 | $5.00 | $25.00 | $0.50 | $6.25 |
 
 **核心成本对比**（针对 Sonnet）：
 - 缓存写入 vs 正常输入：$3.75 / MTok vs $3.00 / MTok = **+25%**
diff --git a/13_advanced/13.1_claude5_preview.md b/13_advanced/13.1_claude5_preview.md
@@ -36,7 +36,7 @@ Claude 系列的演进，正在从“更会聊天的模型”走向“可规划
 | **Claude Sonnet 4.6** | 通用主力 | 1M | 适合编程、分析、日常生产任务 |
 | **Claude Haiku 4.5** | 轻量快速 | 200K | 适合分类、提取、实时场景 |
 
-截至 2026-05-22，**Opus 4.6** 和 **Sonnet 4.6** 的 1M 上下文能力应按官方文档中的 beta / public beta、账号权限和计费条款核验；不要默认所有模型、所有账号都具备同样可用性。Anthropic 迁移指南明确称 **Opus 4.7** 提供 1M 上下文且采用标准 API 定价、无 long-context premium。2026 年 4 月发布的 **Opus 4.7** 在高难度软件工程、终端操作、科学推理和金融代理等 Anthropic 发布口径基准上进一步突破，视觉分辨率和复杂多步任务一致性也有明显改进。精确 benchmark、tokenizer 影响和价格应以 Anthropic release note / pricing page 为准。
+Anthropic 模型页与价格页显示，**Opus 4.8 / Opus 4.7 / Opus 4.6 / Sonnet 4.6** 的 Claude API 长上下文能力已扩展到 1M token，且按标准 API token 价格计费；Microsoft Foundry 等平台可能仍有独立上下文上限。2026 年 4 月发布的 **Opus 4.7** 在高难度软件工程、终端操作、科学推理和金融代理等 Anthropic 发布口径基准上进一步突破，视觉分辨率和复杂多步任务一致性也有明显改进。精确 benchmark、tokenizer 影响、平台差异和价格应以 Anthropic release note / pricing page 为准。
 
 > 📌 **更新（2026-05-28）**：**Opus 4.8** 已发布并成为当前最强的通用可用（GA）模型，沿用 4.7 的 $5/$25 定价、1M 上下文与“仅 Adaptive Thinking”策略，`effort` 默认 `high`；本节其余针对 Opus 4.7 的具体数字仍适用于 4.7 型号本身。
 
@@ -45,6 +45,7 @@ Claude 系列的演进，正在从“更会聊天的模型”走向“可规划
 模型能力的讨论，必须区分不同型号，而不能简单说成“Claude 4.6 的知识截止日期是多少”。
 按当前公开规格：
 
+*   **Claude Opus 4.8**：可靠知识截止日期为 **2026 年 1 月**（训练数据截止 2026 年 1 月）。
 *   **Claude Opus 4.7**：可靠知识截止日期为 **2026 年 1 月**（训练数据截止 2026 年 1 月）。
 *   **Claude Opus 4.6**：可靠知识截止日期为 **2025 年 5 月**（训练数据截止 2025 年 8 月）。
 *   **Claude Sonnet 4.6**：可靠知识截止日期为 **2025 年 8 月**（训练数据截止 2026 年 1 月）。
diff --git a/13_advanced/13.2_infinite_chats.md b/13_advanced/13.2_infinite_chats.md
@@ -939,7 +939,7 @@ graph TD
 
 ### 13.2.10 1M Token 窗口的现实
 
-从 2024 年中期开始，Claude 的上下文窗口已升至 200K token。到 Claude 4.6/4.7/4.8 与 Sonnet 4.6，长上下文能力已扩展到 1M token 档位，但具体是否为 beta / public beta、账号是否可用、是否采用标准 API 定价，都要按官方模型页、迁移指南和价格页核验；上下文管理的重点也从“能不能塞进去”逐步转向“如何高质量地利用超长上下文”。
+从 2024 年中期开始，Claude 的上下文窗口已升至 200K token。到 Claude Opus 4.6/4.7/4.8 与 Sonnet 4.6，Claude API 长上下文能力已扩展到 1M token 档位，并按标准 API token 价格计费；但 Microsoft Foundry 等平台可能仍有独立上限，账号、平台和区域可用性仍要按官方模型页与价格页核验。上下文管理的重点也从“能不能塞进去”逐步转向“如何高质量地利用超长上下文”。
 
 **1M Token 等价于（现实估算）**
 
