> For the complete documentation index, see [llms.txt](https://yeasy.gitbook.io/claude_guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yeasy.gitbook.io/claude_guide/fu-lu/12_appendix/12.7_volatile_facts.md). # 附录 G：快变事实核验表 > `verified_at`: 2026-11-06 · `expires_at`: 2026-12-06 · `ttl_days`: 30 本表是 Claude 模型、API、价格、迁移和安全行为的唯一快变事实入口。超过 30 天未复核时，项目检查失败；正文与本表冲突时，必须先按官方来源更新本表。 | 类别 | 当前维护口径 | 权威入口 | 编辑要求 | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude 模型与可用性 | 官方模型总览当前列出 **Fable 5.1、Opus 5.5、Sonnet 5.5 与 Haiku 5.5**。**Claude Opus 5.5**（`claude-opus-5-5`，2026-09-22 发布）是官方“不确定选哪个时的起点”，1M 上下文、128K 最大输出；**Claude Sonnet 5.5**（`claude-sonnet-5-5`，2026-09-28 发布）1M 上下文、128K 最大输出；**Fable 5.1**（`claude-fable-5-1`，2026-09-01 发布，官方定位“demanding reasoning and long-horizon agentic work”）是需要最高能力上限时的选择；**Claude Haiku 5.5**（`claude-haiku-5-5`，2026-10-07 发布）面向大批量、低延迟任务，1M 上下文、128K 最大输出。**Fable 5、Opus 5（`claude-opus-5`）、Sonnet 5（`claude-sonnet-5`）与 Opus 4.8/4.7/4.6/4.5、Sonnet 4.6、Haiku 4.5 都在 Legacy models 区**（仍可调用，但官方建议迁移）；Sonnet 4.5 已于 2026-09-30 宣布弃用，2026-11-30 在 Claude API 上退役。Fable 5 已于 2026-07-01 恢复全球访问。缓存命中价：Fable 5.1 与 Mythos 5.1 为基础输入的 2.5%，Opus 5.5 与 Sonnet 5.5 为 5%（Sonnet 5.5 于 2026-10-07 由 10% 下调），其余型号为 10%。Mythos 5 非普遍可用，Mythos 5.1 同样只向 Project Glasswing 获批客户有限开放，采用邀请制且无自助注册。本书教程代码统一使用 `claude-sonnet-5-5` 与 `claude-opus-5-5`，低成本与低延迟示例使用 `claude-haiku-5-5`，按块类型读取回复，不使用强制工具调用；`claude-sonnet-5` 与 `claude-opus-5` 只出现在 Legacy 与历史条目中。 | [Claude Models](https://platform.claude.com/docs/en/models/overview), [Release notes](https://platform.claude.com/docs/en/release-notes/overview), [What's new in Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5), [What's new in Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5), [Model deprecations](https://platform.claude.com/docs/en/about-claude/model-deprecations) | 模型 ID、平台范围和生命周期必须按用途复核；不使用无日期“最新/最强”表述。 | | Claude 定价 | Opus 5.5 为 $4 / $20 每百万输入/输出 token，低于 Opus 5 与 Opus 4.8 的 $5 / $25；Opus 5.5 的 5m / 1h 缓存写入为 $5 / $8，缓存读取 $0.20。Fast mode 按 $8 / $40（Opus 5.5）与 $10 / $50（Opus 5、Opus 4.8）计价。**Opus 5.5 的 fast mode 于 2026-10-15 结束研究预览**，不再需要 beta 头，可在 Claude API、Claude Models on Google Cloud（Anthropic managed）与 Microsoft Foundry（Azure 托管）上使用；Opus 5 与 Opus 4.8 的 fast mode 仍是研究预览、仅限 Claude API，且 Opus 4.8 的 fast mode 将于 2026-11-30 移除。Sonnet 5.5 与 Sonnet 5 同为 $2 / $10，缓存写入与 batch 价相同，缓存读取 Sonnet 5.5 为 $0.10、Sonnet 5 为 $0.20；Haiku 5.5 按提示长度分档：不超过 100,000 token 时 $0.10 / $0.50，超过时 $0.50 / $2.50；Sonnet 5 发布时公布的介绍期原定到 2026-08-31 为止，但官方已取消原定 2026-09-01 上调至 $3/$15 的计划，该价现为标准价。其他输入、输出、缓存、batch 与长上下文价格以官方 pricing 页为准。 | [Claude Pricing](https://platform.claude.com/docs/en/about-claude/pricing), [What's new in Opus 5.5](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5) | 任何成本表必须写核验日期与币种；官方撤销过的涨价预告不得继续作为未来情景保留。 | | Thinking 与迁移 | **Opus 5.5 的 thinking 常开、不可关闭**：`thinking: {type: "disabled"}` 与手动 `type: "enabled"` 都返回 400，思考深度只用 `effort` 控制，且**默认 `effort` 为 `medium`**（Opus 5 及之前为 `high`）。**Sonnet 5.5 的 adaptive thinking 默认开启**，`disabled` 返回 400，关闭动手前的思考改用 `thinking: {type: "between_tools"}`（只在 `effort` 为 `high` 及以下时接受）；它的 tokenizer 与 Sonnet 5 相同。Fable 5.1、Opus 5.5 与 Sonnet 5.5 都不支持强制工具调用（`tool_choice` 为 `any` 或 `tool` 返回 400），需要符合 schema 的工具参数时改用 strict tool use；在 Claude API 与 Google Cloud 上，Opus 5.5 与 Sonnet 5.5 的 computer use 只接受 `computer_toolset_20260801`。Legacy 的 **Opus 5 thinking 默认开启**，`disabled` 只在 `effort` 为 `high` 及以下时接受；Sonnet 5 的 adaptive thinking 默认开启，可显式关闭。从 Sonnet 4.6 或 Opus 4.8 迁移时，手动 `type: "enabled"` 与非默认 sampling 参数返回 400，新 tokenizer 对同一文本约增加 30% token，必须重新计数并检查 `max_tokens`。**Haiku 5.5** 的 adaptive thinking 默认开启，`disabled` 只在 `effort` 为 `high` 及以下时接受；从 Haiku 4.5 迁移时，手动 `budget_tokens`、非默认 `temperature`/`top_p`/`top_k`、assistant 预填充与 `computer_20250124` 都会返回 400。 | [Migration guide](https://platform.claude.com/docs/en/about-claude/models/migration-guide), [Effort](https://platform.claude.com/docs/en/build-with-claude/effort), [Adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/thinking-steering-and-cost) | 从 Sonnet 5 / Opus 5 迁到 5.5 时审计所有关闭 thinking、强制工具调用与 computer use 的调用点，并重新做 effort 与成本回归；从 Sonnet 4.6 或 Opus 4.8 迁移时另需移除手动 budget 与非默认 sampling 参数。 | | Prompt Caching | 默认 TTL 为 5 分钟；1 小时缓存需显式 `"ttl": "1h"`。混合 TTL 时，1 小时断点必须位于 5 分钟断点之前。最小可缓存前缀按模型不同：Fable 5.1、Mythos 5.1、Opus 5.5、Opus 5、Sonnet 5.5、Fable 5、Mythos 5 与 Haiku 5.5 为 512 token，Opus 4.8、Sonnet 5 与 Sonnet 4.6 为 1,024 token，Opus 4.7 为 2,048 token，Opus 4.6、Opus 4.5 与 Haiku 4.5 为 4,096 token。 | [Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) | 缓存写入、读取、最小前缀和平台差异都按模型页/价格页复核。 | | Refusal | 带安全分类器的模型（Fable 5.1、Opus 5.5、Sonnet 5.5 等）拒绝时返回 HTTP 200 正常响应，应用必须按 `stop_reason: "refusal"` 分支；`stop_details` 会给出类别，但 `category` 与 `explanation` 可以为 `null`，不得靠错误码或解释文本识别。2026-09-24 起，在任何输出之前发生、类别为 `bio`、`frontier_llm` 或 `reasoning_extraction` 的拒绝重新计费。 | [Refusals and fallback](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback) | 丢弃拒绝前的不完整输出；记录拒绝指标，必要时按官方回退机制切到不同模型。 | | Claude Code / Agent SDK | CLI、hooks、output styles、permissions、Agent SDK 以 Claude Code docs 为准。 | [Claude Code Docs](https://code.claude.com/docs/), [Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview) | beta / preview 功能必须说明平台和可用范围。 | | 伙伴与认证 | Claude Partner Network、Partner Hub、伙伴层级、认证人数和服务伙伴状态以官方伙伴页为准。 | [Claude Partners](https://claude.com/partners) | 不把 tier 门槛、折扣、晋降级周期或认证数量写成永久事实。 | | 数据隐私 | API 数据留存、训练使用、enterprise policy 以官方隐私和数据留存文档为准。 | [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention) | 不用单一数字概括所有产品线留存策略。 | | 竞品对比 | OpenAI、Gemini、Mistral、DeepSeek 等只作为 dated snapshot。 | 各厂商官方模型和价格页 | benchmark 与价格不得无来源横向硬比。 |