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 bundles the project's Bash launcher and installer; its version selects the matching container image. Documentation · Source
Metadata
Release files for claude-sandbox 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_sandbox-4.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / claude_sandbox-4.0.0-py3-none-any.whl
| Download URL | claude_sandbox-4.0.0-py3-none-any.whl |
|---|---|
| Size | 76.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2124f500412b5062afb3602c8c9d97209dd416bb68f942f2ce5abb2b1160505d
|
|
BLAKE2b-256 checksum How to use checksums |
bcca9d60af7a78fa183e55a4a4f390d8ad12550ab9decca4cc8587bc43885a51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|