Claude Opus 5.5 发布！Claude Code 默认模型更换、价格下调 20% 全解析 - 与 Opus 5 的区别和现在就该改的设置 🚀

大家好！我是 Mojangcam 😎

前天（9 月 22 日），Anthropic 正式发布了 Claude Opus 5.5。它是新 "5.5 家族" 的第一个成员，同一天 Claude Code v2.1.280 也跟着发布，默认模型从 Opus 5 整体换成了 Opus 5.5。我前一天刚整理完模型切换和 effort 设置，第二天阵容就变了，所以今天作为续篇，只讲两件事：到底变了什么，以及你的设置里要改哪些地方。

本文要讲的内容如下。

• Opus 5.5 的核心变化 — 性能·速度·价格（与 Opus 5 表格对比）
• Claude Code v2.1.280 里默认模型是怎么变的 + 如何在自己的会话里确认
• 从 Opus 5 换到 5.5 时，settings.json 和 effort 需要重新检查的地方
• 写给直接调用 API 的朋友：4 个破坏兼容性的变更
• 在 GitHub Copilot 里怎么用，以及 Sonnet 5.5·Haiku 5.5 出来之前该怎么选

先说结论："更聪明了，还更便宜了"。官方的说法是，它能达到 Fable 5.1 级别的性能，同时 token 单价比 Opus 5 低 20%，实际任务成本低 40% 左右。用订阅套餐的朋友，额度也提高了，应该能明显感觉到 🙌

📌 准备工作

• Claude Code v2.1.280 及以上（截至 2026-09-25，npm 最新是 v2.1.281）— Opus 5.5 从 v2.1.280 开始才能识别
• Claude 订阅（Pro·Max·Team·Enterprise）或 Anthropic API 密钥
• 想跟着 API 示例做的朋友：Python 3.10+，pip install anthropic python-dotenv（以 anthropic 1.8.0 / python-dotenv 1.2.3 为准）

先把版本升上去再开始。

claude update
claude --version

💬 低于 v2.1.280 的话，/model 列表里根本看不到 Opus 5.5，输入 claude-opus-5-5 也会提示 "does not support this model"。先更新再说。

🧩 Opus 5.5 到底变了什么？

根据官方公告和模型文档，把它和 Opus 5 放在一起对比是这样的。

我们逐项拆开来看 💡

• 性能：在 Anthropic 自家的基准测试里，智能体编程·计算机使用·知识工作全部排名第一。Terminal-Bench 4.0 达到 66.4%（Opus 5 是 52.3%，Fable 5.1 是 55.8%），FrontierCode 54.4%（Opus 5 是 48.0%），OSWorld 2.0 达到 81.8%（Opus 5 是 74.0%）。不过官方文档自己也写了"到了这个水平，基准分数的差距很难反映实际体验的差距"，所以与其记数字，不如记成 "Opus 的价格，Fable 5.1 的水平" 就行。
• 成本 ↓ 40%：token 单价降了 20%，再加上完成同样的任务用 更少的 token、更少的步骤，所以每个任务的成本大约降了 40%。官方举的例子是：一个 20 万行代码库的审计，Opus 5 花了 20 多个小时、用掉 2.5 倍的 token，而 Opus 5.5 不到 3 小时就完成了。
• 缓存读取 $0.20：这一项其实影响不小。像 Claude Code 这种对话越拉越长的智能体任务，大部分费用都花在缓存读取上。它便宜了 60%，会话越长越划算。
• 写作风格变了：Opus 5 最常被吐槽的就是"话太多、太啰嗦"，而 5.5 会 把重点放在前面，写得更简短。不少早期测试者反馈，提交信息·PR 描述·代码注释都明显简洁了。
• 快速模式：Claude API 还开放了最高 2.5 倍速度 的 fast mode（研究预览）。不过单价是 $8 / $40，贵一倍，属于"赶时间时才开"的选项。
• 订阅额度提高：Pro·Max·Team·（按席位的）Enterprise 的 5 小时用量上限 提高了，还新增了 把一次额度重置存起来、想用时再用 的功能。
• 安全机制：它在网络安全·生物学方面的能力达到 Fable 5.1 级别，所以配了同等级别的安全分类器。被判定为网络安全的请求会转给 Opus 4.8 执行，生物学类则转给 Opus 5。一般开发几乎不受影响，但在 CTF·安全研究类代码库里，你可能会看到模型切换的提示。

另外，Sonnet 5.5·Haiku 5.5 已预告"几周内"发布。目前只有 Opus 升到了 5.5。

📌 第 1 步 - 在 Claude Code 里确认变了什么

v2.1.280 的更新日志里，对我们重要的只有三行。

1. opus 别名指向 Opus 5.5 — 现在输入 /model opus 就会启用 5.5
2. Pro·Team Standard 的默认模型从 Sonnet 改为 Opus — 现在 所有套餐（Pro·Max·Team·Enterprise·API）的 default 都是 Opus 5.5
3. /effort 按模型保存之前存下的等级，不适用于 Opus 5.5 — 新模型从它自己的默认值（medium）开始

打开一个会话，这样确认一下。

/status

如果标题栏或 /status 页面上显示的是 Opus 5.5，就搞定了。想准确查看别名的状态，输入 /model 打开选择器看看就行。

💡 Pro 套餐的朋友请注意。 昨天还在用 Sonnet 5 跑的会话，从今天起换成 Opus 5.5 了。它更聪明，但 额度消耗比 Sonnet 快。 心疼额度的话，可以用 /model sonnet 降下来，或者用设计交给 Opus、实现交给 Sonnet 的 opusplan。反过来，如果你觉得"今天的回答好像有点不一样？"，很可能就是模型换了的缘故。

📌 第 2 步 - 从 Opus 5 切换到 5.5 时重新检查 settings.json

如果原来的设置文件一动不动，有 三个地方 可能对不上。打开用户设置（~/.claude/settings.json，Windows 是 C:\Users\<계정>\.claude\settings.json）一起看看。

可以直接复制 👇（按 Opus 5.5 调整过的版本）

{
  "model": "opus",
  "effortLevel": "high",
  "modelSettings": {
    "claude-opus-5-5": { "effortLevel": "medium" },
    "claude-opus-5": { "effortLevel": "medium" }
  },
  "fallbackModel": ["claude-opus-5", "claude-sonnet-5"]
}

我们逐项拆开来看 💡

• model：保留 opus 别名的话会自动用上 5.5。反过来，如果暂时想留在 Opus 5，就把正式 ID claude-opus-5 写死。因为别名会跟着每次新版本变
• modelSettings：保存的 effort 是 按正式 ID 记录的，所以写给 claude-opus-5 的 medium 对 5.5 不生效。 需要为 5.5 单独加一个 claude-opus-5-5 条目。上面的示例把两者都设成了 medium
• effortLevel：它是给没有单独保存等级的模型用的默认值。但是 用户设置文件里顶层的 effortLevel 对 Opus 5.5 不生效。 这个键是 /effort 按模型保存之前的旧格式，只对 Opus 5·Fable 5.1 这类老模型继续有效。（项目·本地·托管设置，或通过 --settings 传入的顶层 effortLevel 对所有模型都生效。）搞不清的话，写在 modelSettings 里最稳妥
• fallbackModel：主模型过载时改用的模型列表（最多 3 个）。Opus 5.5 刚发布，流量可能会集中，把第一顺位设成 claude-opus-5，质量差距最小

然后 关于 effort 还得再说一点。Opus 5.5 的默认 effort 是 medium，但它 在同一等级下比 Opus 5 想得更深（官方文档的原话）。也就是说，如果你沿用在 Opus 5 上用 high 的习惯，在 5.5 上也设 high，token 可能会用得更多。官方建议是"不要照搬以前的设置，先从 medium 重新用起，需要时再调高"。我打算先用 medium 跑几天再做判断。

/effort medium

💡 在 /model 选择器里，Enter 是保存（下个会话也保留），s 是只对本次会话生效 — 这条规则没变。

也可以用环境变量固定别名。团队需要"验证完之前保持 Opus 5"这类策略时会用到。

# Windows PowerShell — 仅在当前终端窗口有效
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
claude

# macOS / Linux
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
claude

• ANTHROPIC_DEFAULT_OPUS_MODEL：固定（pin）opus 别名所指向的具体版本。设置之后，/model opus·opusplan·default 全都会使用这里写的模型

📌 第 3 步 - 直接调用 API 的朋友：4 个破坏兼容性的变更

如果你只用 Claude Code，可以跳过这一步。用 Python 直接调用 API 的朋友，有四个地方 只改模型 ID 就可能报 400 错误。

1. thinking 无法关闭 — thinking: {"type": "disabled"} 或直接给 budget_tokens 的 enabled 会返回 400。要么干脆去掉 thinking 字段，要么设成 {"type": "adaptive"}，深度用 effort 来调
2. 不能强制调用工具 — tool_choice 的 any·tool 类型会返回 400。改成 auto（默认）+ strict: true，如果一定要让它用工具，就在提示词里写明
3. thinking 块与模型·对话绑定 — 把对话从 Opus 5 迁到 5.5，推理会保留；但像 5.5 → Sonnet 5 这样往下换，之前的推理会被丢弃（请求仍然成功）。2026-08-31 之后创建的账户，如果修改 thinking 块之前的系统提示词·工具后重新发送，会返回 400
4. 不支持旧版计算机使用工具 computer_20251124（Claude API·Google Cloud）— 迁移到 computer_toolset_20260801

另外，虽然不会报错，但 工具调用之间的简短文字会以 thinking 块而不是 text 返回。如果你的应用原本会把进度实时显示在界面上，可能会突然变安静，请检查 thinking.display 设置。

下面是最小迁移示例。密钥和模型名都从 .env 读取。可以直接复制 👇

# anthropic 1.8.0 / python-dotenv 1.2.3 / Python 3.10+
from dotenv import load_dotenv
import os
from anthropic import Anthropic

load_dotenv()
api_key = os.getenv("ANTHROPIC_API_KEY")
model = os.getenv("CLAUDE_MODEL", "claude-opus-5-5")  # .env: CLAUDE_MODEL=claude-opus-5-5

client = Anthropic(api_key=api_key)

response = client.messages.create(
    model=model,
    max_tokens=4096,
    # 省略 thinking 字段（Opus 5.5 的 adaptive 始终开启）
    # 省略 tool_choice = auto
    messages=[{"role": "user", "content": "用 Python 写一个统计文件夹里 .txt 文件数量的函数"}],
)

# 响应块要按 type 挑选，而不是按位置（前面可能有 thinking 块）
for block in response.content:
    if block.type == "text":
        print(block.text)

.env 文件这样写。一定要把 .env 加进 .gitignore！

ANTHROPIC_API_KEY=여기에_키
CLAUDE_MODEL=claude-opus-5-5

我们逐项拆开来看 💡

• load_dotenv()：读取同一文件夹里的 .env，把内容加载成环境变量。不把密钥·模型名写死在代码里，是这个博客的基本习惯
• CLAUDE_MODEL：把模型名也放进环境变量，Opus 5 ↔ 5.5 的切换只要改 .env 里的一行，不用改代码
• 检查 block.type：Opus 5.5 的响应最前面可能带一个 thinking 块（默认设置下内容为空），所以像 content[0].text 这样 按位置取值会出错。 请按 type 过滤
• effort：需要时可以像 output_config={"effort": "high"} 这样调高。默认是 medium

💬 这个博客的 LLM 集成系列（Discord 机器人 #9、办公自动化 #5）是以 本地 LLM（LM Studio） 为准的，和上面的变更无关。只有用付费 API 的朋友才需要注意。

🛠️ 在 GitHub Copilot·云平台上使用

Claude Code 之外的地方也在同一天开放了。

• GitHub Copilot：从 9 月 22 日起，Copilot Pro+·Max·Business·Enterprise 的模型选择器里加入了 Opus 5.5。按用量计费时，按模型提供商的原价收费。据 GitHub 方面的早期测试，它用比 Opus 5 少一半以上的步骤 解决了更多终端任务
• AWS·Google Cloud·Microsoft Foundry：发布当天同步上线。模型 ID 只有 Bedrock 是 anthropic.claude-opus-5-5，其余都是 claude-opus-5-5
• Claude Code 别名注意：在 Bedrock·Google Cloud 上 opus 也指向 5.5，但 Microsoft Foundry 上目前 opus = Opus 4.6。在 Foundry 上必须直接指定正式 ID

💡 现在该选哪个？（在 Sonnet 5.5 出来之前）

按任务类型整理如下。

Opus 5 和 5.5 之间没什么好纠结的。 同样的价格 5.5 更好，甚至还更便宜。非要留在 Opus 5 的理由，大概只有"团队还没验证完"。真正需要纠结的是 要不要继续用 Fable 5.1。既然官方公告明确说了"大多数任务上达到 Fable 5.1 水平"，那么把 Fable 留给连 Opus 5.5 的 xhigh 都解决不了的问题，对钱包更友好。

📌 常见错误和失误

1. /model 列表里没有 Opus 5.5 / 输入 claude-opus-5-5 提示 "does not support this model"

• 原因：Claude Code 低于 v2.1.280
• 解决：claude update 后重启。如果用的是公司内部网关，需要把网关配置成能提供 claude-opus-5-5

2. 更新之后，明明是 Pro 套餐，额度却很快用完

• 原因：从 v2.1.280 起，Pro 的默认模型从 Sonnet 5 换成了 Opus 5.5
• 解决：轻量任务用 /model sonnet 降下来，或者用 opusplan。想干脆把 Sonnet 设为默认，就在 settings.json 里写 "model": "sonnet"

3. 明明保存了 /effort medium，到了 5.5 却显示别的等级

• 原因：effort 是 按正式 ID 保存的。存在 claude-opus-5 上的值不会带到 5.5
• 解决：在启用 Opus 5.5 的状态下重新保存一次 /effort medium，或者在 modelSettings 里添加 claude-opus-5-5 条目

4. API 报 "thinking.type.disabled" is not supported for this model（400）

• 原因：Opus 5.5 无法关闭 thinking
• 解决：删掉 thinking 参数 → 改为把 output_config.effort 调低到 low

5. API 报 tool_choice: type "tool" and "any" are not supported for this model（400）

• 原因：不支持强制调用工具
• 解决：把 tool_choice 改成 auto，需要强制遵守 schema 时用 strict: true 或 structured outputs

6. 响应里的 response.content[0].text 报 AttributeError

• 原因：最前面的块可能是 thinking（内容为空）
• 解决：像 for block in response.content: if block.type == "text" 这样按 type 过滤

7. 在安全研究代码库里，会话突然换成了 Opus 4.8

• 原因：Opus 5.5 的安全分类器判定为网络安全 → 回退到 Opus 4.8（生物学类回退到 Opus 5）
• 解决：这是正常行为。如果想每次都先征求你的确认，就在 /config 里关闭 Switch models when a message is flagged

🙌 总结

把今天的内容整理一下。

• Opus 5.5 = 用 $4 / $20 拿到 Fable 5.1 级别的性能。 比 Opus 5 单价 ↓ 20%、缓存读取 ↓ 60%、实际任务成本 ↓ 40%、输出速度 ↑ 30%
• 从 Claude Code v2.1.280 起，opus·default 全部指向 Opus 5.5。Pro 现在默认也是 Opus，请重新把握额度消耗的节奏
• 必须在 settings.json 的 modelSettings 里新加 claude-opus-5-5 条目，effort 才会生效。默认 effort 是 medium，不要照搬以前用 high 的习惯
• 直接调用 API 时，关闭 thinking·强制 tool_choice·旧版 computer 工具 这三项会报 400 错误。响应块要按 type 挑选
• Sonnet 5.5·Haiku 5.5 预告几周内发布。等它们出来，我会再写续篇整理

下一篇会回到 Discord 机器人开发系列 #32，另外还在准备配合 10 月 1 日 Python 3.15 正式发布 的新功能全解析，敬请期待 🙌

已经换到 Opus 5.5 的朋友，用起来感觉怎么样？特别是 medium effort 好不好用，欢迎在评论里告诉我，我会写进下一篇！

📚 推荐阅读

• Claude Code 模型切换·effort 设置完全指南 - Opus 5 / Sonnet 5 / Fable 5.1 怎么选着用
• Claude Opus 5 发布！Claude Code 默认模型更换 - /model·/effort 用法全解析
• Claude Sonnet 5 发布 - Claude Code 默认模型更换，变化与用法
• Claude Code 入门 - 从安装到第一次运行！终端 AI 编程智能体完全指南
• AI 编程提示词怎么写 - Vibe Coding 实战指南
• 2026 免费 AI 编程工具对比 - Claude Code vs Cursor vs Copilot