同一个模型,吃的是两套不同的「电脑操作」工具

问 Claude Opus 5.5 支持哪套「电脑操作」工具,文档给的是两个答案:在 Claude API 上它只接受 `computer_toolset_20260801`,更早的版本一律报错;而在 Amazon Bedrock 上它接受更早的 `computer_20251124`。两者在形状与截图上限上都不同——2,576 像素长边下的 4,784 个视觉 token,对约 115 万像素——于是同一个模型字符串跑出的是两个智能体:定位精度不同,每步成本也不同;而在 Claude API 上,没有任何一个模型同时接受这两套。

作者 智能体 AI 维基 19 分钟读完

问 Claude Opus 5.5 支持哪套「电脑操作」工具,Anthropic 的文档会按你在哪里跑它给出两个答案——而这两套工具的截图上限并不相同,于是同一个模型字符串买到的是两个智能体:定位精度不同,每步成本也不同。对一个 GUI 智能体来说,可移植性的单位不是模型名,而是(模型,工具版本)这一对;而你的配置里没有任何东西让这一对显形。

一眼概览

两代工具同时在线,而分界线是沿着平台、而不是沿着模型划的。下表每一行都出自电脑操作工具参考文档。

属性computer_toolset_20260801computer_20251124
在请求里的形状一个 toolset 条目,展开成 17 个具名成员一个单独的工具版本
beta 请求头不需要必需
截图上限长边 2,576px,共 4,784 个视觉 token(约 375 万像素)长边 1,568px,约 115 万像素
状态:Claude API、Google 托管的 Google Cloud 版 ClaudeGA,且是 Claude 5.5 及更新模型上唯一的选项在 Claude 5.5 及更新模型上报错
状态:Bedrock、Claude Platform on AWS、Microsoft Foundry不可用beta,且是唯一的选项
只支持这一套的模型—Claude Opus 4.7、Opus 4.6、Sonnet 4.6、Opus 4.5

真正造成伤害的那句话

那份参考文档里有两句话,单看都不起眼,合起来就是一个可移植性问题。第一句:「在 Claude API 与 Claude Models on Google Cloud(Google 托管)上,Claude 5.5 及更新的模型只通过 computer_toolset_20260801 toolset 支持电脑操作,对更早的 computer_20251124 与 computer_20250124 工具版本返回错误。」第二句:「在 Amazon Bedrock 上,Claude Opus 5.5、Claude Sonnet 5.5 与 Claude Haiku 5.5 接受更早的 computer_20251124 工具版本,正如 Claude Opus 5 与 Claude Sonnet 5 一样。」

把两句放在一起,「Claude Opus 5.5 用哪套电脑操作工具」这个问题就没有答案了。它有两个答案,由托管平台挑选;而在一边能跑通的那个请求,在另一边是一个 400。这不是新旧并存、你自己掌握节奏去迁移的那种弃用窗口。这是一次分叉:Claude API 已经整体搬到了 toolset 上并拒收旧版本,而三个合作平台只带着旧版本、接不了新的。

One model string, two computer-tool contracts A single model box at the top branches into two platform paths. The Claude API path accepts only the computer_toolset_20260801 toolset, with a screenshot ceiling of 2,576 pixels on the long edge and 4,784 visual tokens, and 17 named members including zoom. The Amazon Bedrock path accepts only the earlier computer_20251124 tool version behind a beta header, with a ceiling of 1,568 pixels and about 1.15 megapixels. Neither platform accepts the other's tool version. claude-opus-5-5 Claude API Amazon Bedrock computer_toolset_20260801 computer_20251124 2,576px, 4,784 tokens 1,568px, 1.15 MP 17 named members, zoom among them beta header required Neither platform accepts the other's tool version, and no model on the Claude API accepts both.
同一个模型名、两份工具契约、两个截图上限。分岔点是平台,不是模型。

更早的那批模型则是朝反方向分叉的,而这就把后路也堵上了。Claude Opus 4.7、Opus 4.6、Sonnet 4.6 与 Opus 4.5「只通过更早的 computer_20251124 工具版本支持电脑操作,而该版本需要一个 beta 请求头」。所以在 Claude API 上,没有任何一个模型同时接受两个工具版本。没有可供你做 A/B 的交集。

两套工具真正的差别在哪里

Computer-tool availability by hosting platform Five hosting platforms against the two computer tool versions. The Claude API and Google-managed Claude on Google Cloud carry the 2026 toolset at general availability and return an error for the earlier version on Claude 5.5 and later models. Amazon Bedrock, Claude Platform on AWS and Microsoft Foundry do not carry the toolset at all and offer only the earlier version in beta. No platform carries both. Which computer tool each platform will accept computer_toolset_20260801 computer_20251124 Claude API GA, the only option error on Claude 5.5+ Claude on Google Cloud GA, the only option error on Claude 5.5+ Amazon Bedrock not available beta, the only option Claude Platform on AWS not available beta, the only option Microsoft Foundry not available beta, the only option Accent is generally available, the lighter tint is beta, plain is unavailable or rejected. No row carries both columns, so a multi-platform deployment runs two tool contracts under one model name. The two differ in request shape, in whether a beta header is required, and in the screenshot ceiling.
没有任何一个平台同时带着两套——所以选宿主就是在选智能体。

如果差别只是一串版本号,这就只是文书工作。它不是;而最要紧的那道缺口,恰恰是一次基准测试会捕捉到的。toolset「接受长边最多 2,576 像素、合计最多 4,784 个视觉 token(⌈宽 / 28⌉ × ⌈高 / 28⌉,约 375 万像素)」;而更早的工具版本接受「长边最多 1,568 像素、合计约 115 万像素」。空间定位——给出那个按钮的像素坐标、而不是叫出它的名字——是 GUI 智能体里占主导的错误类别,而它对「模型得以看到多少像素」直接敏感。可用细节上 3.3 倍的差距不是配置层面的细微之处,而是在小目标上两种不同的准确率体制。

新 toolset 还加进了一个读起来就像是针对这类错误的成员。zoom 接受一个 [x0, y0, x1, y1] 形式的 region,并以全分辨率重新捕捉这块区域——这是 API 层面上的一次承认:卡住它的那条约束从来不是屏幕尺寸,而是「将要点下去的那一点上的分辨率」。文档也从另一头说了同样的话,就在它的排障建议里:如果点击打偏了,就启用 zoom、用带位置的提示词、或者把任务切成更小的步骤。而一套写在 computer_20251124 上的外壳,没有这样一次调用可打。

还有两处较小的差别,会在直接移植时咬人。toolset 以单个 {"type": "computer_toolset_20260801"} 条目抵达,它的 tool_use 块携带 "toolset_name": "computer" 加一个成员名;于是按扁平工具名分发结果的代码需要重写,而不是改个名。而旧版本需要一个新版本不需要的 beta 请求头——这意味着一份只是把版本号换掉的配置,会产出一个在两处同时出错的请求。

为什么这先是评测问题、后才是迁移问题

这次分叉的实际代价,是它拿走了你本来唯一拥有的受控对比。升级一个 GUI 智能体通常意味着只改一件事、再跑一遍你的套件:新模型、同样的工具、同样的截图、同样的步数预算。而在这里,模型与工具是一起动的,而工具还带来了一个不同的观测空间。升级之后分数提高了,你也归因不了,因为模型变了、可用分辨率变了、动作集也变了,都在同一个提交里。

这对电脑操作比对文本智能体更要紧,因为 GUI 基准数字本来就在恰好这个维度上脆弱。OSWorld 一类的结果是在不同步数上限、不同屏幕分辨率、不同工具权限下报出来的——这正是第三方榜单会对同一天的同一个系统各说各话的原因。一个没有附上步数上限与截图分辨率的数字,不是对模型的一次度量。而现在,截图分辨率还部分地取决于你是从哪个云买的这个模型。

所以,一份诚实的多平台部署对应的是两次评测运行、而不是一次。如果你在一个区域提供 Claude API、在另一个区域提供 Bedrock,那你运维的是两个共用一个名字的智能体——而跑在旧工具上的那一个,正是你没有量过点击准确率的那一个,因为你的套件是对着另一个拿到的帧尺寸跑的。

在每一条 trace 里,把工具版本记在模型字符串旁边,并让评测结果以这一对为键。一条只写着 claude-opus-5-5 而别无其他的 trace,六周之后没法告诉你点击准确率的回退来自模型、帧尺寸还是宿主——而在这个接口上,这是三件不同的事,你的配置却把它们叫成一件。

这周该做什么

四步,按代价从低到高排列。

  • 查清你实际发出去的是哪套工具。在你的外壳里 grep computer_,再跟你打的那个平台对一遍。搬到 Claude API 之后 beta 请求头还留在那儿,是这个 bug 最常见的形状,而它会大声失败;更安静的那一种,是一套你以为已经跟着别的东西一起升级过的 Bedrock 部署。
  • 把截图分辨率显式钉住,而不要去继承显示器的。文档对桌面任务推荐 1024×768 或 1280×720,对网页应用推荐 1280×800 或 1366×768,并警告不要超过 1920×1080。这些推荐值都明显低于 toolset 自己的上限——这就是那条线索:那个上限是留给 zoom 的余量,不是一个新的默认帧。
  • 按平台、而不是按模型重跑你的定位评测。每个(模型,工具版本)对一次运行。如果只够跑一次,就跑旧工具那套,因为它正是你现有数字没有描述的那个配置。
  • 把平台迁移当成一次外壳改造。结果分发、动作词汇表、你在缩放截图时所做的坐标换算,以及每个动作之后的那次核验,全都触到工具契约。文档对最后这一条为何要紧说得很直白:「Claude 有时会表现得仿佛自己的动作已经成功,而没有显式去检查结果。」

这里的普适教训比电脑操作走得更远。模型名对「你到底部署了什么」的描述正在变得越来越不完整:effort 设置、思考模式、工具版本,现在又加上观测上限,全都在它底下变动,而其中好几样还按宿主变动。解法不是更警惕,而是身份——把那个决定行为的完整元组记下来,并让评测结果与运行时以同一件东西为键。文本接口上的同一种失效见提示词可移植性;一个你从未设置过的值在你底下改变时会发生什么,见未钉住的厂商默认值。

常见问题

同一份电脑操作代码能同时跑在 Claude API 和 Amazon Bedrock 上吗?

不分支的话不能。Claude API 带的是 computer_toolset_20260801,并在 Claude 5.5 及更新的模型上对 computer_20251124 返回错误;而 Bedrock、Claude Platform on AWS 与 Microsoft Foundry 只带更早的 beta 工具版本。请求形状、beta 请求头与截图上限三者都不同。

新 toolset 更高的分辨率上限,是不是该用来发更大的截图?

默认不是。文档里的推荐值仍停在桌面任务 1024×768 或 1280×720;而那个上限是以视觉 token 计价的(⌈宽 / 28⌉ × ⌈高 / 28⌉,最多 4,784),所以更大的帧就是循环里每一步更贵的账。把这截余量花出去的精准方式是 zoom——只对你即将点下去的那块区域。

要点击准确率的话该用哪个模型?

那份参考文档对旧工具的模型做了直接比较:Claude Sonnet 4.6「在机械式点击上比 Claude Opus 4.6 更精准」,而 Claude Opus 4.7「与 Sonnet 4.6 大致相当」。这提醒我们:在这个接口上,推理最强的模型不会自动是最好的执行器;而这也是「按配置去测量、而不要继承一份排名」的又一个理由。

这对驱动浏览器而不是桌面的智能体有影响吗?

它影响任何以截图作为观测的智能体,因为上限与动作集是工具的属性、而不是目标的属性。一个通过 DOM 或无障碍树工作的智能体对帧尺寸差异是绝缘的——这本来就是混合定位的论据之一。

这些平台会收敛吗?

文档说更早的工具版本「对不支持 toolset 的模型与平台仍以 beta 形式可用」,这描述的是现状、不是时间表。请按「这次分叉会持续存在」来构建,并把工具版本当成配置里的一等值、而不是一个常量。

延伸阅读

本站相关:

来源: