Skip to main content

Beta Headers & Ephemeral Geometry — Computer Use API (Beta)

[ ABORT TO HUD ]
SEQ. 1

Beta Headers & Ephemeral Geometry

🖱️ Computer Use API (Beta)⏱ 15 min⭐ 700 BASE XP⌨ HANDS-ON LAB

Autonomous Desktop Agency

Computer Use enables Claude to operate graphical desktop environments (Linux, macOS, Windows) via screenshots, mouse clicks, keyboard input, and high-resolution region zooming. Originally launched under beta headers (computer-use-2025-01-24 / computer-use-2025-11-24), Computer Use on Claude 5.5 (claude-opus-5-5, claude-sonnet-5-5) uses the GA bundled client toolset {"type": "computer_toolset_20260801"} with no beta header required.

Toolset Migration & Coordinate Geometry

On Claude 5.5, passing legacy fields like display_width_px, display_height_px, or name inside computer_toolset_20260801 triggers a 400 invalid_request_error (optional zoom toggling uses configs: { zoom: false }). Instead, Claude inspects your screenshot dimensions directly and emits member actions (screenshot, left_click, type, zoom) tagged with toolset_name: "computer". Your local container harness must map screenshot coordinates 1:1 to virtual display pixels to avoid click drift.

⌨ HANDS-ON LABInitialize Computer Use Toolset on Claude 5.5
⭐ +250 XP

Empower Claude Sonnet 5.5 to interact with an isolated desktop container using the GA computer_toolset_20260801 bundled client toolset.

1POST to /v1/messages on claude-sonnet-5-5 declaring the computer_toolset_20260801 toolset in tools.
lab-sandbox — simulated environment
INFINITY LAB SANDBOX v2.6 — simulated shell
Type the command for the current objective. Helpers: "hint", "solution", "clear".
$
OBJECTIVE 1 / 1 — type "hint" if stuck
SYNAPSE VERIFICATION
QUERY 1 // 3
Which tool declaration is required for Computer Use on Claude 5.5 models (Sonnet 5.5 / Opus 5.5)?
X-Agent-Enabled header
{"type": "computer_toolset_20260801"} in the tools array (no beta header required)
Legacy /v1/complete
experimental-os: true