claude-opus-5-5 和带点的 ID 不要混用

Claude API 与 Bedrock 的 Opus 5.5 ID 是 claude-opus-5-5,连字符。llm-anthropic 0.29 的命令是 llm -m claude-opus-5.5,中间是点。Cursor 文档里的 Fast ID 是 claude-opus-5-5-fast。

claude-opus-5-5 和带点的 ID 不要混用

同一款模型在三处文档里用了三种字符串。API 要的是 claude-opus-5-5,中间是连字符。把点号那一版贴进 Messages API,或把连字符那一版交给只认点号的命令行插件,请求对不上目录里的名字。

作者CodePass 技术编辑

三处文档各写各的

平台文档的 Claude API、Google Cloud、Microsoft Foundry、Claude Platform on AWS 都是 claude-opus-5-5。Amazon Bedrock 多一个前缀:anthropic.claude-opus-5-5。退役不早于 2027 年 9 月 22 日。

Simon Willison 在 2026 年 9 月 22 日发布 llm-anthropic 0.29,说明里的命令是:

llm -m claude-opus-5.5 "prompt goes here"

这里是 claude-opus-5.5,5 和 5 之间是点。这是该插件注册的模型名,不是 Messages API 的 ID。插件内部会不会再映射成连字符,发布说明没有写。从插件命令复制到 SDK 的 model 字段之前,对一下平台文档。

Cursor 的 Models 页在标准价那一行写的是产品名 Claude Opus 5.5,没有把 API ID 印在价格列里。Fast 的备注 ID 是 claude-opus-5-5-fast,连字符,末尾多 -fast。旧的按次计划要开 Max Mode。这个 Fast 字符串也不等于 Anthropic 发布页上的产品名。

混用时先改哪一个字符

从 Opus 5 迁过来的客户端,常见的是整段复制旧请求,只改版本号。Opus 5 的 Cursor 备注里出现过 claude-opus-5-fast。Opus 5.5 对应的是 claude-opus-5-5claude-opus-5-5-fast,中间多了一段 -5。少抄这一段,目录里仍然是上一款模型。

点号只出现在 llm 插件那条命令里。Bedrock 还要保留 anthropic. 前缀。三处都改完,再用一条不带工具的短请求确认账号已开通,然后再处理思考块和 tool_choice 的不兼容。那些不兼容见平台文档的 what's new,和 ID 拼写是先后两步。

各写一份时应该出现的字符串

Messages API 的 model 字段:

claude-opus-5-5

Bedrock 的模型 ID:

anthropic.claude-opus-5-5

只在本机装了 llm-anthropic 0.29 时,终端里是:

llm -m claude-opus-5.5

Cursor 备注里的 Fast:

claude-opus-5-5-fast

四行不要互相粘贴。知识截止日期是 2026 年 6 月,模型自己的回答里不一定带得对 9 月 22 日才公布的这些字符串。ID 对照你正在调用的那份文档,不要用模型复述出来的字符串。

等 Sonnet 5.5、Haiku 5.5 发布时,大概率又会各有一套 API 名和插件名。今天只有 Opus 5.5 这一款能对上上面的四行。上一款 Opus 5 的 Fast 在 Cursor 备注里是 claude-opus-5-fast,少了中间的 -5。升级脚本如果只做字符串替换 opus-5opus-5-5,会把 claude-opus-5-fast 变成 claude-opus-5-5-fast,这一条碰巧是对的;把已经是 claude-opus-5-5 的再替换一次,就会多出一段。替换前先按整段 ID 匹配,不要按子串替换。

参考资料