龙虾AI 接 Claude Opus 5:配置、effort 调法与成本账

现在新装该填 Opus 5 还是 Opus 5.5

新装、没有历史配置要兼容的,按官方现在的建议填 anthropic/claude-opus-5-5。OpenClaw 的 Anthropic 接入文档也写明,新装时默认选的就是 Opus 5.5,已经固定了版本的旧配置不会被改。手上的 Opus 5 配置跑得好好的,不用急着动:它还在服务期内,只是单价比 5.5 高。真要换,下表最后三行的旧写法到了 5.5 上会直接报 400(computer use 那行在 Amazon Bedrock 上例外;依据官方 Opus 5.5 变更说明):

「关掉 thinking」和「effort 从 high 起步」这两条只对 Opus 5 成立,别带到 5.5 上。官方对 5.5 的说法是:同一档 effort 下它每轮想得比 Opus 5 多,旧的 effort 设置要重新试一遍,不要照搬。逐步的改法在官方迁移指南里。

Opus 5 和 Fable 5、Sonnet 5、Haiku 4.5 怎么分工

8 月时官方模型总览页开篇那句话写得很直白:不确定用哪个,就从 Claude Opus 5 起步,它面向复杂的智能体编码和企业级工作;要更高上限,才去用 Claude Fable 5。龙虾干的正是这类活:读任务、调工具、看返回、决定下一步,循环到完成。

2026 年 8 月的四款模型摆一起,在龙虾场景里的位置大致如此:

上表是 2026 年 8 月的阵容。到 2026-10-07,官方模型总览里 Opus 5、Sonnet 5、Fable 5 都在 Legacy 列表(仍可调用),对应的新款是 Opus 5.5、Sonnet 5.5、Fable 5.1,Sonnet 5.5 与 Sonnet 5 同价;Haiku 4.5 的退役承诺写的是不早于 2026-10-15,写进长期流程前先看弃用页。要换 Fable 5.1 的,先看 Fable 5.1 换之前要改的配置。

Opus 5 的可靠知识截止是 2026 年 5 月,是这四款里最新的。让它写脚本、调库、查某个工具的用法时,用到过时 API 的机会少一些。

另一个方向的区别是思考模式。Opus 5 是 adaptive thinking,而且默认就开着。Opus 4.8 和 4.7 也支持 adaptive,但默认是关的;你不写 thinking 字段,它就不思考。同样一段代码从 4.8 换成 Opus 5,什么都不改,行为已经变了:模型开始思考,思考的 token 算进 max_tokens,响应变慢、单次变贵。原因是默认值换了。

价格:和 4.8 同价,比 Opus 5.5 贵

每百万 token 的价格(见官方定价页):

Sonnet 5 的 $2 / $10 发布时是 introductory 价,原定 2026-09-01 涨到 $3 / $15;官方定价页现在的脚注写明这次涨价不会发生,$2 / $10 就是标准价。表里没列的两款:Fable 5.1 与 Fable 5 同价,Sonnet 5.5 与 Sonnet 5 同价。

在 Opus 5.5 出来之前,Opus 5 和 Opus 4.8 同价这件事,基本决定了迁移的性价比:一样的钱,换更新的模型和更新的知识截止。要花工夫的是下面那几个会报错的老写法。现在才动手迁的,先看上面的对照表。

接到龙虾上,改的其实就一行

OpenClaw 本体不挑大脑,它只要一个能对话、能调工具的接口。所以接 Opus 5 的动作很小,分两处:密钥放环境变量,模型名写配置文件。

先在 .env 里放密钥。OpenClaw 的密钥按服务商分开命名,Anthropic 的这一个叫:

ANTHROPIC_API_KEY=sk-ant-你的密钥

再到 ~/.openclaw/openclaw.json 里指定模型。模型引用是 服务商/模型名 的格式:

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-5"
      }
    }
  }
}

写在 agents.defaults.model.primary 下面。同级还有 fallbacks,可以填备用模型,主模型不可用时自动顶上——跑长任务的话建议配一个。

有一种写法照抄不会生效:MODEL_PROVIDER=anthropic / MODEL_NAME=...,当前版本的 OpenClaw 里没有这两个字段。以 官方仓库的 .env.example 和配置文档为准。

填完跑一条最小任务确认通了。effort、task budget、fast mode 留到这之后一项一项加,出错时才知道是哪一层的问题。

从 Opus 4.8 搬过来,这三种写法会直接 400

龙虾配置是从 Opus 4.7 / 4.8 时代抄来的,先查下面几条,出处是官方迁移指南。

1. budget_tokens 那套老写法

thinking: {"type": "enabled", "budget_tokens": N} 是 extended thinking 的手动写法。Claude 4.7 及之后的模型不再支持它,请求直接 400,错误信息大意是「这个模型不支持 thinking.type.enabled,请改用 adaptive 加 output_config.effort」。Opus 4.8 也一样拒绝这种写法,从更老的版本一路抄配置过来的才会在这一步遇到。

2. assistant prefill

给助手消息预填一个开头来逼它按格式输出,这招在 Opus 5 上返回 400,和 Opus 4.8 一样。想控制输出格式,改用系统提示,或者用 structured outputs 让它吐结构化结果。

3. 关掉 thinking 再配高 effort

这条是 Opus 5 新增的。thinking: {"type": "disabled"} 在 Opus 5 上只有在 effort 为 high 或更低时才被接受,配上 xhigh 或 max 就是 400。也就是说:

# Opus 4.8 上能跑
client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "disabled"},
    output_config={"effort": "xhigh"},   # 4.8 接受
    messages=[...],
)

# 同样的参数换成 Opus 5 → 400
# 两条出路:要么把 thinking 交回默认(开着),要么把 effort 降到 high 及以下

就算 effort 停在 high、关 thinking 合法,想省 token 也建议先降 effort,别先动这个开关:到了 Opus 5.5 上思考关不掉,这份配置迁不过去。

effort 五档:别把 4.7/4.8 的设置照搬过来

Opus 5 的思考深度靠 output_config.effort 控制,五档:low / medium / high / xhigh / max,API 默认 high。写法很朴素:

{
  "model": "claude-opus-5",
  "max_tokens": 4096,
  "output_config": { "effort": "medium" },
  "messages": [ ... ]
}

Opus 4.7 和 4.8 的官方建议是「编码和智能体场景从 xhigh 起步」,照当时的建议写的配置里就是 xhigh。但官方对 Opus 5 的建议不一样:从默认的 high 起步,跑你自己的任务看效果,难的编码和智能体活再升 xhigh,值得砸钱的才上 max;质量扛得住的地方,放心用 low 和 medium,主要靠它控制成本。文档里还专门提醒:从旧模型带过来的 effort 设置,应该重新扫一遍,别直接复用。

调 effort 时要注意:

• effort 管的是思考量,不是回复长度。官方明说,在 Opus 5 上调 effort 并不能稳定地把回复变短。嫌它啰嗦就在提示词里要求长度,别指望降档解决。
• 一个会话里别来回改 effort——除非你带上那个 beta 头。默认情况下 effort 的值参与渲染提示词,改了就对不上之前缓存的前缀,prompt 缓存直接失效,所以要分层就按任务类型分。但 2026-09-01 起有了例外:带上 mid-conversation-output-config-2026-07-01 这个 beta 头之后,Opus 5(以及 Fable 5.1)支持在会话中途改 effort 且不会让缓存失效——难的步骤调高、日常步骤调低。细节见 Fable 5.1 的发布变化。thinking 配置改动仍然照旧,会失效。
• 开 xhigh 或 max 时把 max_tokens 开大,官方给的起点是 64K。因为思考 token 也算进 max_tokens,开小了会出现思考还没完就被砍断、stop_reason 返回 max_tokens 的情况。另外 max_tokens 开得很大时用 streaming,否则容易撞 HTTP 超时。

在龙虾日志里看到 thinking 块是空的、只剩签名,是因为新模型上 thinking 的 display 默认就是 omitted,想看摘要得显式设成 summarized。

成本心算:一个假设算例

单次任务成本 ≈ 输入 token × 输入单价 + 输出 token × 输出单价。难的是估 token 数:智能体每一步都要把之前的历史和工具返回重新发给模型,任务越长,单步的输入越多。

假设一次中等任务累计输入 20 万 token、输出 2 万 token:

• Haiku 4.5:0.2M × $1 + 0.02M × $5 = 约 $0.30
• Sonnet 5.5($2 / $10):0.2M × $2 + 0.02M × $10 = 约 $0.60
• Opus 5.5($4 / $20):0.2M × $4 + 0.02M × $20 = 约 $1.20
• Opus 5:0.2M × $5 + 0.02M × $25 = 约 $1.50
• Fable 5:0.2M × $10 + 0.02M × $50 = 约 $3.00

上面是单次的数,月账单还要乘每天的任务数和天数;token 数以控制台用量页显示的为准。Opus 5.5 那一行只按单价算;官方说它在同一档 effort 下每轮想得更多,思考 token 记在输出里,同样的任务实际输出量未必还是 2 万。要注意 Opus 5 默认开思考,思考 token 算在输出里——同一条任务从 4.8 换过来,输出那一栏会比你记忆中的数字大。

省钱的顺序建议是这样的:先降 effort,再考虑换模型。分层也照样可用:轻活交给 Sonnet 5.5,做不下来再升到 Opus 重试,在龙虾里换模型只是改配置。各家现在有哪些型号、怎么挑,见 模型选型和当龙虾的大脑：6 个模型选型方向与自测任务;GPT 一侧现在的型号和价格见 GPT-6 Astra 的规格与 272K 加价规则。

还有一个专门给智能体准备的开关叫 task budget(beta,要带 task-budgets-2026-03-13 头)。它给整个循环一个 token 预算,模型能看见剩余额度的倒计时,会自己控制用量,快用完时把手头的事收尾;max_tokens 则是到数就截断。最小值 20000,低于这个数直接 400。两个提醒:它只是提示,不会强制截断,该配的 max_tokens 还得配;预算给太小反而会让模型觉得干不完,干脆缩小范围或者提前收工。

Opus 5 的几个限制和不适合的活

几件用之前最好先知道的事:

• Fast mode 还是 research preview。它只有 Opus 5.5、Opus 5 和 Opus 4.8 才有,输出速度最高 2.5 倍,要联系客户经理或者排队申请才能开。Opus 5 开了之后价格涨到 $10 / $50,和 Fable 5 同价,模型能力不变。官方文档也写明它只在 Claude API 和 Managed Agents 上有,Bedrock、Google Cloud、Microsoft Foundry 都没有,还有独立的限流额度和独立的 429。
• 它跑不了本地。Opus 5 是闭源云端模型,数据必须发到服务商那边。在意隐私、或者想断网也能用的,这条路本来就不通,该看的是本地模型那一支。
• 轻活别拿它跑。归类、改格式、抓个页面这类活给 Sonnet 5.5 或 Haiku 4.5:按上面的单价,同样的 token 量 Haiku 4.5 的费用是 Opus 5 的五分之一。用 Haiku 4.5 之前先看弃用页上它的退役日期。
• 任务失败不一定是模型的问题。先查工具有没有配好、权限够不够、提示词是不是太含糊,这些问题换个更贵的大脑照样失败。排查顺序见工具调用失败排查,过一遍再考虑升档。

task budget 与 Fast mode 的 beta 标记、支持范围是 2026 年 8 月官方文档的状态,价格表和 Opus 5 / 5.5 对照表是 2026 年 10 月的。

常见问题

Opus 5 比 Opus 4.8 贵吗?

不贵,两者同价,都是每百万 token 输入 $5、输出 $25。差别在别处:Opus 5 的知识截止更新(2026 年 5 月),而且思考默认开着,同一条任务的输出 token 会比 4.8 多一些,实际账单可能因此上浮。价格以官方定价页为准。

龙虾接 Opus 5 一个月要花多少钱?

没法给你一个准数,这完全取决于你每天跑多少任务、任务有多长。可以自己心算:单次成本约等于输入 token × $5/百万 + 输出 token × $25/百万。跑几趟真实任务,在控制台用量页看实际 token 数,再乘以你的频次,比任何估算都靠谱。

从 Opus 4.8 换成 Opus 5,配置要改什么?

模型名改成 claude-opus-5 是第一步。然后检查:有没有用 thinking 的 budget_tokens 老写法(400)、有没有给助手消息做 prefill(400)、有没有在关掉 thinking 的同时把 effort 设成 xhigh 或 max(Opus 5 上是 400)。另外 effort 建议重新调一遍,别直接复用 4.8 的档位。

effort 该设成哪一档?

官方对 Opus 5 的建议是从默认的 high 起步,再按自己的任务往上或往下调。难的编码和长程智能体活升到 xhigh,常规杂活降到 medium 甚至 low 省钱。默认情况下别在同一段会话里来回改,那会让 prompt 缓存失效;但带上 mid-conversation-output-config-2026-07-01 这个 beta 头之后就可以中途改而不失效,Opus 5 也在支持之列。

想省钱,能把 thinking 关掉吗?

技术上可以(effort 在 high 及以下时才被接受)。省钱建议先降 effort;另外到了 Opus 5.5 上思考关不掉,这个写法会返回 400。

Fast mode 值得开吗?

它还是 research preview,要申请或排队才能开。开到了价格会涨到 $10 / $50,换来的是输出速度(最高 2.5 倍),模型本身的能力不变。Bedrock、Google Cloud、Microsoft Foundry 上都没有。