Sandbox Environment

When Claude works on your tasks, it runs inside an isolated sandbox environment. This provides security, consistency, and a fully-equipped development environment.

Default Configuration

Each sandbox environment starts with:

Resource	Specification
CPU	1 vCPU
RAM	2 GB
OS	Ubuntu 24.04.3 LTS
Architecture	AMD64 (x86_64)

Need more resources? You can customize CPU and RAM from the Sandbox Environment settings section when creating a task.

Pre-installed Tools

The sandbox comes with a comprehensive set of development tools pre-installed. You don't need to install these manually — they're ready to use out of the box.

Operating System

Tool	Version
Ubuntu	24.04.3 LTS

Programming Languages

Language	Version	Notes
Node.js	v22.x	Default runtime
Go	1.22.x	linux/amd64
PHP	8.4.x	Default (`php` command)
PHP	8.2.x	Available via `php82` command
Rust	Latest stable	Installed via rustup

Package Managers

Tool	Version	For
Bun	Latest	JavaScript runtime & package manager
pnpm	Latest	Node.js package manager
Yarn	Latest	Node.js package manager
Cargo	Latest	Rust package manager
uv	Latest	Python package manager

Developer Tools

Tool	Description
Claude Code	AI coding assistant CLI
GitHub CLI (`gh`)	GitHub from the command line
Git	Version control
curl	HTTP client
wget	File downloader

Other Utilities

build-essential — C/C++ compiler and tools
zip / unzip — Archive tools
net-tools — Network utilities

Using Different PHP Versions

The sandbox has two PHP versions installed. You can switch between them:

# Use PHP 8.4 (default)
php --version

# Use PHP 8.2 explicitly
php82 --version

# Or use full path
/usr/bin/php8.2 script.php
/usr/bin/php8.4 script.php

Installing Additional Software

If your task requires additional tools or packages that are not pre-installed, Claude can install them during task execution.

Installing additional software will increase task execution time. The sandbox starts fresh for each task, so installed software is not persisted between tasks.

Examples

Python packages:

uv pip install requests pandas

Node.js packages:

bun add express
# or
pnpm add express

System packages:

sudo apt update && sudo apt install -y <package-name>

Rust crates:

cargo add serde

Resource Limits

The default sandbox configuration (1 CPU, 2GB RAM) is suitable for most development tasks. However, for resource-intensive operations like:

Large codebase compilations
Running multiple services simultaneously
Memory-intensive data processing

You may want to increase the resources from the Sandbox Environment section in the task creation form.

Version Policy

The sandbox uses the latest stable versions of all tools at the time of image creation. Major versions are pinned (e.g., Node.js 22, PHP 8.4), but patch versions may vary.

If you need a specific tool version for your project, Claude can install it during task execution using version managers like nvm for Node.js or rustup for Rust.

Sandbox Environment

On this page