Depot
Log in
Managed agents

Run Claude Code in Depot sandboxes

Run Claude Code cloud sessions in Depot sandboxes through Claude's web, desktop, or mobile interface. Depot starts and manages the runner for you. View run status, timing, and failure details in your Depot dashboard.

How it works

A Claude Code self-hosted environment routes cloud sessions to runners on compute you choose.

Anthropic provides the Claude models and manages your conversation and session queue.

Depot creates a sandbox and starts a Claude Code runner inside it. The runner starts your session, where Claude Code runs the agent loop and tools. Claude Code connects to Anthropic for model responses and session updates.

How Claude Code runs on DepotStart a Claude Code session on the web or in the Claude desktop or mobile app. Anthropic queues the session. Depot checks the Anthropic API for work and starts a sandbox and runner when needed. The runner starts a Claude Code session inside the sandbox to edit files and run commands, builds, and tests. The runner and session connect to Anthropic over outbound HTTPS to check for work, exchange session updates, and send model requests. Responses return over those connections. Each runner handles one session.AnthropicDepotSandbox managementStarts sandboxesClaude CodeWeb, desktop & mobileStarts sessionAnthropic APIClaude modelsChecks queueStarts runnerDepot sandboxClaude Code runnerAgent loop & toolsModel requestsResponses

What's the difference between Claude Code and Claude Managed Agents on Depot?

  • Claude Code: Use Claude's web, desktop, or mobile interface for coding tasks. Depot runs the agent loop and tools.
  • Claude Managed Agents: Build agents for applications or automated workflows. Anthropic runs the agent loop and Depot executes commands and file operations. Follow the Claude Managed Agents guide.

Get started

Prerequisites

Before you start, you need:

Connect Claude Code to Depot

  1. Open Settings > Connections > Agent providers in Depot and select Claude Code.
  2. Paste your Claude Code environment key into Environment secret.
  3. Click Connect.

Depot shows Connected to Claude Code and the Environment pool ID when the connection succeeds.

Depot keeps your environment key outside the sandbox. The sandbox receives a single-use credential to register its runner.

Choose a sandbox size

After connecting, select a Sandbox size for the connection and click Save. The default is 4x16 (4 CPUs, 16 GB memory). See sandbox sizes for available sizes, billing, and when changes take effect.

Authorize GitHub access

Each person who wants to start sessions must connect their own GitHub account to Claude.

Before you connect your account, an organization Owner must enable the GitHub connector for your Claude organization.

  1. Open GitHub Integration in Claude.
  2. Connect your own GitHub account if it isn't already connected. Use an account that has access to the repository you want to work on.
  3. Follow GitHub's prompts to authorize the connection.

Start a Claude Code session

  1. Open Claude Code on the web or the Code section in the Claude desktop or mobile app.
  2. Click the environment name (the first control below the message box) to open the environment selector.
  3. Find the environment you connected to Depot under Self-hosted environments and select it.
  4. Click Repo and choose the repository you want to work on.

Now you can send Claude a task for the selected repository. For example: "Read this repository and explain how to run its tests." Claude's response appears in the same conversation.

Verify your run in Depot

Open Agent runs in your Depot dashboard and select Claude Code to see your runs, newest first.

Agent runs page filtered to Claude Code, showing runs with Succeeded status

Select a run to see its status, timing, duration, and sandbox ID. Use Open in Claude Code to return to the conversation when the link is available.

If a run fails, check Why it failed for details.

Claude Code run details showing Succeeded status, timestamps, duration, sandbox ID, and the Open in Claude Code button

What's next

With the connection working, give Claude Code a larger repository task: implement a feature, investigate failing tests, or prepare a refactor. The work runs on Depot without using your laptop's CPU or memory, and you can return to the conversation with follow-up instructions.

Continue working by sending another message in the same Claude Code conversation. If the session needs a new sandbox, Depot restores the latest available workspace snapshot. See Session continuity for details and limitations.