Preview edition Sourced working drafts. Editorial review pending.
Library/Capabilities

Capabilities / Reference entry 12

Agent sandboxing

How an execution environment restricts code and tools, and why filesystem, network, resource and application boundaries need separate examination.

Working draftEditorial review pending

Agent sandboxing restricts the environment in which an agent’s requested code or tools execute. The boundary is implemented by surrounding software and operating-system mechanisms, rather than by asking the model to behave cautiously. gVisor illustrates one design: an application kernel called the Sentry handles application system calls, while a separate Gofer mediates filesystem access. This is a particular isolation architecture, not the definition of every sandbox. 1

The boundary needs a threat model

The gVisor security model aims to reduce exposure to host system interfaces through layered restrictions. It also describes limits: hardware side channels, host resource controls and other reachable services require separate consideration. Its documentation explicitly treats a sandbox as one part of a secure architecture. These statements concern gVisor’s design and assumptions; they do not prove that any environment labeled “sandboxed” provides equivalent isolation. 2

For an illustrative research assistant, the threat model could include a tool accidentally overwriting an unrelated file, untrusted downloaded code running a subprocess, or a generated command attempting an unauthorized connection. A proposed sandbox would need to state which of those actions it constrains and what remains reachable. Listing the threats would be more informative than simply displaying a sandbox badge.

Files and network are separate surfaces

Anthropic’s 2025 engineering announcement describes filesystem and network isolation for its agent coding tools. It explains directory restrictions and an external proxy enforcing allowed network destinations, including restrictions applying to subprocesses. This is vendor architecture guidance for the described implementation. It should not be generalized into a claim about current defaults, all coding agents, or a measured security guarantee for this website. 3

In the research-assistant example, a writable scratch directory would not answer whether the process can also contact arbitrary servers. Conversely, blocking external connections would not answer whether it can modify an unrelated local project. A useful boundary description would separately identify permitted reads, writes and destinations, along with how exceptions are handled.

The relevant unit is the actual executing process and its descendants. Naming the assistant’s top-level tool is insufficient if the command starts other programs with different access. The cited vendor example discusses subprocess coverage; 3 a different implementation would need its own evidence of what inherits the restrictions.

Isolation is not unlimited compatibility

gVisor’s overview notes that its Linux-compatible environment does not implement every system call or interface, so some applications may be incompatible. Restricting exposed behavior has practical consequences for what software can run. 1 A failure inside a sandbox could therefore reflect an intentional boundary or a compatibility gap, rather than evidence that a task needs unrestricted access.

For the example, a denied write would be recorded as denied. A recovery step could choose another permitted way to produce a reviewable artifact, or stop with the boundary stated. It would not silently interpret a failed operation as successful. This is a proposed recovery criterion, not a claim about a deployed assistant here.

Permissions and content still matter

The gVisor security model allows applications to use resources exposed inside their environment and relies on additional controls for resource exhaustion and network policy. 2 Isolation consequently does not settle whether a reachable application operation is appropriate. Tool permissions address that action-level boundary; prompt injection addresses attempts to redirect the agent through untrusted material.

A sandboxed assistant could still produce an unsupported statement in a permitted output file. Factual review needs different evidence. An observability record could show that a command was denied or completed, while human oversight could decide how to respond. Tests of the example would inspect the actual filesystem, connection policy and action outcome, including subprocess behavior and interruption. Sandboxing can limit consequences within a stated model; it does not certify the whole agent.

Suggest a correction or primary source · Public intake remains on hold; the local synthetic form covers only the original three entries.

Follow the evidence

Sources & context

Primary sources checked on . A source check is not independent editorial approval.

  1. What is gVisor? gVisor authors

    Living project documentation checked 17 October 2026; Sentry and Gofer describe an application-kernel isolation design and compatibility boundaries.

  2. gVisor security model gVisor authors

    Living security design documentation checked 17 October 2026; goals, host interactions, resource controls and hardware-side-channel limitations. No blanket sandbox or virtual-machine ranking follows.

  3. Beyond permission prompts: making Claude Code more secure and autonomous Anthropic

    Engineering announcement published 20 October 2025, checked 17 October 2026; filesystem/network isolation in that product’s described runtime. Vendor-reported statistics and present product defaults are not reproduced here.

Revision record

Authorship
AI-assisted project draft
Editorial review
Pending · no reviewer assigned
This revision
Sourced working draft; consult file history for revisions.
View file history on GitHub