Skip to main content

claude-sandbox

Run Claude Code, Codex or Pi in a container with a bubblewrap sandbox that isolates host credentials and limits access to internal networks.

On a Linux host with uv and rootless Podman:

uv tool install claude-sandbox
cd ~/src/my-project
claude-sandbox

Log in when prompted. Use claude-sandbox codex or claude-sandbox pi to choose another agent. The host needs /dev/net/tun and unprivileged user namespaces; no devcontainer setup is required.

Update with uv tool upgrade claude-sandbox, then claude-sandbox --recreate in each project. Recreation removes container-local packages and forge logins, but retains project files and shared agent settings.

Already inside a Debian/Ubuntu devcontainer? As root, run uvx claude-sandbox install, then claude. That container must expose /dev/net/tun.

The package is the sandbox itself: the host launcher, the installer and the in-container wrapper, in Python with no dependencies beyond the standard library. Its version selects the matching container image. Documentation · Source

Metadata

Release files for claude-sandbox 5.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for claude-sandbox 5.0.0
File Interpreter ABI Platform
claude_sandbox-5.0.0-py3-none-any.whl Python 3 none any Details

Release files / claude_sandbox-5.0.0-py3-none-any.whl

Download URL claude_sandbox-5.0.0-py3-none-any.whl
Size 156.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e247ba7d008a6752463ea1d04a046dd5a8a523524a020fcf6a21d1a42f5d1c7a
BLAKE2b-256 checksum
How to use checksums
5254c15f93406f4ca85fcab034b13745bd7622ba7c828af918c421381b04a879
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page