Skip to content
← Blog

Run Claude computer use on Orgo

Give Claude a remote desktop with the Orgo Python SDK.

Updated

Claude chooses what to click and type. Orgo provides the remote desktop. The Python SDK connects the two.

This example targets Orgo Python SDK 0.0.46. It uses your Anthropic API key directly and sets the display dimensions from the computer's screenshot.

Set up your environment

You need Python 3.10 or newer, an Orgo account with capacity for a computer, and an Anthropic API key.

Create a virtual environment. These commands are for macOS or Linux:

bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "orgo==0.0.46" anthropic python-dotenv

On Windows PowerShell, activate it with .venv\Scripts\Activate.ps1 instead.

Create a .env file next to your script. Keep it out of version control.

dotenv
ORGO_API_KEY=your_orgo_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key

Run a small task

Save this as computer_use.py. It creates a temporary computer and deletes it when the run ends, including if the agent raises an error. Export anything you want to keep before cleanup.

python
from dotenv import load_dotenv
from orgo import Computer
 
load_dotenv()
computer = Computer()
 
try:
    width, height = computer.screenshot().size
    computer.prompt(
        "Open the browser and visit https://example.com. "
        "Read the heading, then stop.",
        provider="anthropic",
        model="claude-sonnet-4-6",
        display_width=width,
        display_height=height,
        max_iterations=15,
    )
finally:
    computer.destroy()
bash
python computer_use.py

You can watch the desktop in the Orgo dashboard while the task runs. Model usage is billed by Anthropic; the computer uses your Orgo capacity.

The model is explicit because SDK defaults and provider availability change independently. Sonnet 4.6 uses Anthropic's earlier computer tool, which this SDK version implements. For newer toolsets, follow the current tool reference and match the model, tool version, and SDK together.

Know which provider runs the loop

In this SDK version, omitting provider selects Orgo's hosted agent. Setting provider="anthropic" runs the loop through your Anthropic account. Adding an Anthropic key to your environment alone does not switch providers.

To operate an existing desktop, use Computer(computer_id="your_computer_id"). Do not include the destroy() cleanup from the temporary-computer example if you want to keep that desktop.

When a task goes wrong

  • Clicks miss their target: check the screenshot dimensions. If you resize images in a custom loop, translate the returned coordinates back to desktop pixels.
  • The model repeats itself: set a step limit and inspect the last screenshot. More steps do not necessarily resolve a blocked task.
  • A model request fails: check the model ID, account access, and tool compatibility before changing your desktop code.

Start with a result you can check, such as opening a page and reading its heading.

Build your own loop

Use screenshot(), left_click(), type(), key(), and bash() when you want to control how the model plans and executes. You can replace the agent loop without replacing the computer.

Continue with the Orgo integration guide or the published SDK. The original video walkthrough shows an earlier version of the setup.

Keep reading