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.4.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.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / claude_sandbox-4.4.0-py3-none-any.whl
| Download URL | claude_sandbox-4.4.0-py3-none-any.whl |
|---|---|
| Size | 96.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bd6d9efaed4d5de449ef5cdf055a9f9f488ad43116669276062104978a1c1ced
|
|
BLAKE2b-256 checksum How to use checksums |
3da2ddaead945f3c8670b3ac0347ef6e16e5a9116d70541cfb6da2e49200a172
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|