Anthropic Sandbox Runtime

What Anthropic Sandbox Runtime is
Anthropic Sandbox Runtime (srt) applies filesystem and network restrictions to processes at the operating-system level, without requiring a container. It is an open-source Apache-2.0 research preview available as a command-line tool or library for sandboxing agents, local MCP servers, bash commands, and other processes. Filesystem writes and network access are denied by default; users can allow specific paths and configure allowed or denied domains. The project documents macOS, Linux, and Windows support, with different mechanisms for each: sandbox-exec on macOS, bubblewrap on Linux, and a dedicated local sandbox account with Windows Filtering Platform and filesystem ACLs on Windows. The npm installation command is `npm install -g @anthropic-ai/sandbox-runtime`. Linux requires bubblewrap, socat, and ripgrep, while macOS requires ripgrep; Windows requires a one-time elevated setup step and is marked alpha. The preview was developed for Claude Code, and its APIs and configuration formats may evolve. Network filtering limits reachable domains but does not otherwise inspect proxy traffic, so users must allow only trusted domains.
Who it suits
Srt suits developers and teams seeking OS-level restrictions for agents, local MCP servers, shell commands, or other processes. It is a research preview, so users should be prepared for APIs and configuration formats to change.
What it does well
- Filesystem writes are blocked by default.
- Network access is denied by default.
- Available as a CLI tool or library.
- Documents support for macOS, Linux, and Windows.
- Open-source under Apache-2.0.
What to know first
- Windows support is marked alpha.
- Linux requires bubblewrap, socat, and ripgrep.
- Network filtering does not inspect proxy traffic.
- Preview APIs and configuration formats may evolve.
Limits
The runtime is a research preview, so its APIs and configuration formats may evolve. Linux network filtering relies on proxy environment variables, and programs that ignore them may be unable to connect to the internet.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Anthropic Sandbox Runtime | Open source research preview · no paid plans or usage limits stated | Free |
As github.com lists them, read 5 Oct 2026. The maker's own page has the final word.
Getting started
- Open the project website on GitHub.
- Install with `npm install -g @anthropic-ai/sandbox-runtime`.
- On Linux, install bubblewrap, socat, and ripgrep; some configurations need additional system setup.
- On macOS, install ripgrep.
- On Windows, run the one-time elevated `windows-install` step.
- Configure filesystem paths and allowed or denied network domains for the processes you want to sandbox.
Anthropic Sandbox Runtime (srt) is an open-source runtime that applies operating-system restrictions to arbitrary processes without requiring a container. It suits developers securing agents, local services, shell commands, and other tools on infrastructure they control. The zero-cost, self-hosted model is attractive for experimentation, but preview-era APIs and uneven platform behavior make it unsuitable when deployment consistency is the overriding requirement.
Overview
srt is delivered from npm as both a command-line tool and a library, with @anthropic-ai/sandbox-runtime installed globally using npm. Its documented use cases include agent processes, local Model Context Protocol servers, bash commands, arbitrary programs, and a Java agent for JVM tools on macOS and Linux. Apache-2.0 licensing permits open-source use, while Anthropic positions the project as an early research preview for Claude Code and the wider effort to build safer agentic systems.
The design relies on host operating-system controls rather than a container layer. That can reduce deployment overhead where the host is already managed, but it also means configuration, dependencies, and failure modes vary by platform. APIs and configuration formats may evolve, so teams should expect maintenance rather than treat srt as a finished security boundary.
Key features
- Filesystem policy: Read and write access can be configured separately. Writes are denied unless paths are explicitly allowed, giving agents and commands a restrictive starting point; useful work still requires carefully granting the directories a process needs.
- Default-deny networking: Network access starts blocked and can be narrowed with allowed and denied domain lists. HTTP, HTTPS, and other TCP traffic pass through proxies, but the proxy restricts reachable domains rather than inspecting traffic. Operators therefore need to approve only domains they trust.
- OS-native isolation: macOS uses sandbox-exec, Linux uses bubblewrap, and Windows combines a dedicated local sandbox account, filesystem ACLs, and Windows Filtering Platform egress filtering. This makes srt relevant to mixed fleets, while preventing identical behavior across them.
- Violation visibility: macOS can tap the system sandbox violation log store for real-time alerts. Linux bubblewrap has no built-in violation reporting, so Linux operators have less direct feedback when a process hits a restriction.
- Agent and MCP integration: The CLI and library forms support embedding controls into agent workflows and local MCP servers rather than limiting use to one application.
Pricing
The Anthropic Sandbox Runtime plan costs free. It is an open-source research preview with no paid plans or stated usage limits, and there is no free trial because the software is free. Self-hosting shifts responsibility for installation, dependencies, policy design, and operation to the user instead of providing a managed service or subscription support tier.
Platforms
srt documents Linux, macOS, and Windows support, with Windows marked alpha. Linux requires bubblewrap, socat, and ripgrep; some configurations need additional system setup. macOS requires ripgrep. Windows needs a one-time elevated windows-install step, although the helper executable is bundled with the npm package.
Linux networking depends on proxy environment variables, so programs that ignore those variables may be unable to reach the internet. On Windows, per-user tool installations may not be visible to the sandbox account, and schannel clients with certificate revocation checking enabled can fail because revocation requests are blocked. Enabling weaker nested sandboxing on Linux considerably reduces security and is advised only with additional isolation.
Who it's for
srt is a strong fit for developers and security-minded teams building agentic systems, local MCP services, or controlled command runners on self-managed Linux, macOS, or Windows hosts. It is especially practical when default-deny filesystem and network policies are more important than a uniform managed experience.
It is a poor fit for organizations that need stable APIs, consistent cross-platform enforcement, built-in Linux violation reporting, or proxy-level traffic inspection. The alpha Windows path and Linux dependency and networking caveats also raise operational costs for broad, standardized rollouts.
Pros and cons
Pros
- Free and open source: Apache-2.0 licensing and no stated usage limits suit experimentation and self-hosted deployments.
- Restrictive defaults: Writes and network access are denied until explicitly permitted, reducing the chance of unintentionally broad access.
- Multiple interfaces: A CLI and library accommodate standalone commands as well as embedded agent infrastructure.
- Broad process coverage: Agents, MCP servers, bash commands, JVM tools, and arbitrary processes are documented targets.
Cons
- Preview status: Evolving APIs and configuration formats make long-lived integrations harder to plan.
- Uneven platform maturity: Windows is alpha, while Linux and macOS rely on different enforcement mechanisms and dependencies.
- Limited network insight: Domain filtering does not inspect proxied traffic, leaving trust decisions to the operator.
- Operational edge cases: Linux proxy-variable dependence and Windows schannel and account-visibility issues can break otherwise valid tools.
Alternatives
Choose ANY.RUN instead when you want a freemium service with free trials and broad web, mobile, desktop, and API platform coverage; its Community plan is free forever.
Context Agent Sandboxes is the better choice when a hosted, paid agent-sandbox service with a free tier and concurrent-agent plans fits your workflow.
Pick Daytona for a freemium development environment with hosted and self-hosted platform options, including a pay-as-you-go plan with 5 GiB of storage free before storage charges.
Docker Desktop is preferable when you want an established container workflow, with a free Personal plan and a paid Pro tier.
Choose Northflank for managed infrastructure with a free Sandbox plan covering two services, one database, and two cron jobs.
microsandbox fits users seeking a freemium sandbox with explicit compute, memory, disk, and sandbox-count quotas.
CAPE Sandbox is an open-source, self-hosted malware-analysis option with a free online demonstration instance.
crun is a free Linux and self-hosted OCI container runtime when container execution, rather than OS policy mediation for arbitrary processes, is the goal.
Browse Sandbox Software for the wider category.
Verdict
Choose Anthropic Sandbox Runtime if you are building or operating agents and local tools on self-managed hosts and want no-cost, OS-level filesystem and network restrictions with a CLI or library. Look elsewhere if you need a mature, uniform product, managed operations, dependable Linux violation reporting, or inspection of traffic beyond domain reachability.
Verdict
Srt offers configurable filesystem and network restrictions across documented operating systems, with default-deny behavior for writes and network access. Its preview status, platform-specific requirements, and limits on proxy inspection matter when deciding how to deploy it.
Questions
How much does Anthropic Sandbox Runtime cost?
It is free and open source under the Apache-2.0 license. No paid plans or usage limits are stated.
Which operating systems does it support?
The project documents macOS, Linux, and Windows support. Windows is marked alpha.
How do I install it?
The listed npm command is `npm install -g @anthropic-ai/sandbox-runtime`. Linux also requires bubblewrap, socat, and ripgrep; macOS requires ripgrep, and Windows needs a one-time elevated setup step.
Can it restrict network and filesystem access?
Yes. Filesystem settings support read and write restrictions, with writes denied by default unless paths are allowed. Network access is denied by default and can be controlled with domain allow and deny lists.
Who makes it?
Anthropic makes the project. The company describes itself as an AI safety and research company that builds reliable, interpretable, and steerable AI systems.
Is it production software?
The project is described as an early open source research preview developed for Claude Code. Its APIs and configuration formats may change.
Facts from Anthropic Sandbox Runtime's own pages
- Availability
- The project is an open source research preview licensed under Apache-2.0. · github.com, 5 Oct 2026
- Filesystem controls
- Filesystem configuration supports read and write restrictions, with writes denied by default unless paths are explicitly allowed. · github.com, 5 Oct 2026
- How to install
- The README gives `npm install -g @anthropic-ai/sandbox-runtime` as the installation command. · github.com, 5 Oct 2026
- Integrations
- The README shows using srt to sandbox Model Context Protocol servers and documents a Java agent for JVM tools on macOS and Linux. · github.com, 5 Oct 2026
- Intended users
- Anthropic describes the release as an early open source preview for the broader ecosystem to build more secure agentic systems; APIs and configuration formats may evolve. · github.com, 5 Oct 2026
- Interfaces
- It is available as both a command-line tool and a library, installed from npm as @anthropic-ai/sandbox-runtime. · github.com, 5 Oct 2026
- Linux dependency
- Linux requires bubblewrap, socat, and ripgrep; macOS requires ripgrep. · github.com, 5 Oct 2026
- Linux limitation
- Linux network filtering relies on proxy environment variables, so programs that ignore them may be unable to connect to the internet. · github.com, 5 Oct 2026
- Linux requirements
- Linux requires bubblewrap, socat, and ripgrep, and some configurations also require additional system setup. · github.com, 5 Oct 2026
- Maker
- Anthropic describes itself as an AI safety and research company that builds reliable, interpretable, and steerable AI systems. · anthropic.com, 5 Oct 2026
- Monitoring
- The runtime tracks sandbox violations, and on macOS it can tap into the system sandbox violation log store for real-time alerts. · github.com, 5 Oct 2026
- Network controls
- Network access is denied by default and can be restricted with allowed and denied domain lists; HTTP, HTTPS, and other TCP traffic are mediated by proxies. · github.com, 5 Oct 2026
- Operating systems
- The project documents macOS, Linux, and Windows support; Windows is marked alpha. · github.com, 5 Oct 2026
- Platform implementation
- It uses sandbox-exec on macOS, bubblewrap on Linux, and a dedicated local user account with Windows Filtering Platform and filesystem ACLs on Windows. · github.com, 5 Oct 2026
- Platform mechanisms
- The README says macOS uses sandbox-exec, Linux uses bubblewrap, and Windows uses a dedicated local sandbox account with Windows Filtering Platform egress filtering. · github.com, 5 Oct 2026
- Platforms
- The project supports macOS and Linux, and lists Windows support as alpha. · github.com, 5 Oct 2026
- Preview status
- The README describes the runtime as an early research preview developed for Claude Code and warns that APIs and configuration formats may evolve. · github.com, 5 Oct 2026
- Purpose
- Anthropic Sandbox Runtime (srt) enforces filesystem and network restrictions on arbitrary processes at the OS level without requiring a container. · github.com, 5 Oct 2026
- Security caveat
- The project warns that enabling weaker nested sandboxing on Linux considerably weakens security and should be used only with additional isolation. · github.com, 5 Oct 2026
- Security limitation
- The README says network filtering restricts reachable domains but does not otherwise inspect traffic through the proxy, so users are responsible for allowing only trusted domains. · github.com, 5 Oct 2026
- Use cases
- The README says srt can sandbox agents, local MCP servers, bash commands, and arbitrary processes, and can be used as a CLI tool or library. · github.com, 5 Oct 2026
- Violation monitoring
- On macOS, srt can tap the system sandbox violation log store for real-time alerts; Linux bubblewrap does not provide built-in violation reporting. · github.com, 5 Oct 2026
- Windows limitation
- On Windows, tools using schannel with certificate revocation checking enabled by default can fail because revocation requests are blocked by the egress fence. · github.com, 5 Oct 2026
- Windows limitations
- On Windows, per-user tool installations may not be accessible to the sandbox account, and some schannel clients can fail when certificate revocation checks are enabled. · github.com, 5 Oct 2026
Where Anthropic Sandbox Runtime stands on Freedom251
- Sandbox Software#2 of 26