Sandboksy dla agentów: container-use, E2B, Daytona, microVM i Docker
ENSandboks agenta to jednorazowa maszyna, w której działa agent kodujący, na przykład Claude Code albo Codex, dzięki czemu uruchomienie bez nadzoru może zrobić cokolwiek, nie sięgając do twojego laptopa, poświadczeń ani produkcji. Opcje różnią się izolacją: opakowanie na poziomie systemu (sandbox runtime Claude Code), kontenery (container-use, Modal), microVM (E2B, Docker Sandboxes) oraz platformy zarządzane albo hostowane u siebie (Daytona, Coder).
Ta strona jest dla developera, który chce, żeby agent pracował godzinę bez pytań o zgodę, i dla tech leada, który musi zdecydować, gdzie wolno to robić. Wypróbowałeś tryb auto, a potem ktoś w zespole puścił claude -p --dangerously-skip-permissions na laptopie, z produkcyjnym .env w repozytorium. Pytanie brzmi teraz: który sandboks sprawi, że następne uruchomienie będzie bezpieczne z definicji, i jak jego wynik wróci do review.
Co daje ci ten katalog sandboksów
Dział zatytułowany „Co daje ci ten katalog sandboksów”- Tabelę decyzyjną i datowane porównanie siedmiu sandboksów: izolacja, start, czas życia, kontrola sieci i cena.
- Działający przykład: Claude Code w trybie headless w E2B, z cookbooka E2B, oraz Codex.
- Workflow: pętla bez nadzoru w jednorazowej maszynie, której gałąź wraca jako git bundle do review.
- Trzy prompty do skopiowania, pułapki i typowe awarie.
Wzorzec stojący za tym wszystkim (osobny stos dla każdego zadania, z danymi startowymi, własnymi portami i poświadczeniami) opisuje strona o efemerycznych środowiskach. Tryby zatwierdzania i sandboksy systemowe wbudowane w każdego agenta opisuje strona o uprawnieniach i sandboksach.
Jaki sandboks dla agenta wybrać?
Dział zatytułowany „Jaki sandboks dla agenta wybrać?”Zacznij od tego, gdzie działa uruchomienie i kto jest właścicielem maszyny.
| Twoja sytuacja | Wybierz | Dlaczego |
|---|---|---|
| Jeden developer, kilku agentów, laptop | Docker Sandboxes (sbx) albo container-use | microVM (Docker) albo kontener (container-use) na agenta, każdy na własnym klonie lub gałęzi; lokalnie za darmo |
| Uruchomienia bez nadzoru tylko Claude Code, bez Dockera | Sandbox runtime Claude Code (@anthropic-ai/sandbox-runtime) | Zamyka cały proces Claude Code, razem z hookami i serwerami MCP, w Seatbelt albo bubblewrap |
| Uruchomienia agentów startowane przez CI, kolejkę albo twój produkt | E2B, Modal albo Daytona | Sandboksy tworzone z SDK, z kontrolą ruchu wychodzącego na sandboks i czasem życia ustawianym w kodzie |
| Kod i poświadczenia do modeli muszą zostać na twojej infrastrukturze | Coder | Własne workspace’y w Terraformie; Coder Agents działa „bez kluczy API w workspace’ach” |
| Interfejs webowy albo mobilny nad agentami w sandboksach | CloudCLI sandbox (eksperymentalne) | Opakowuje Docker Sandboxes w interfejs CloudCLI |
| Zadania w tle startowane ze zgłoszenia albo czatu, bez własnej infrastruktury | Środowiska chmurowe samych dostawców | Opisane w efemerycznych środowiskach, nie tutaj |
Worktree celowo nie ma na tej liście. Izoluje tylko pliki; porty, bazy danych, nazwy kontenerów Dockera i każde poświadczenie w twojej powłoce pozostają wspólne (zobacz stronę o równoległych agentach).
Jak sandboksy wypadają pod względem izolacji, startu, czasu życia i ceny?
Dział zatytułowany „Jak sandboksy wypadają pod względem izolacji, startu, czasu życia i ceny?”Poniższe fakty sprawdziliśmy 2026-09-26 w README każdego projektu, w definicjach typów SDK albo w źródłach dokumentacji na GitHubie. Strony E2B, Modala i Daytony były tego dnia nieosiągalne z naszego środowiska, więc nie ma tu ani jednej ceny ani czasu startu z tych stron.
| Sandboks | Model izolacji | Gdzie działa | Co wpływa na start | Domyślny czas życia | Kontrola sieci | Cena |
|---|---|---|---|---|---|---|
Sandbox runtime Claude Code (npm @anthropic-ai/sandbox-runtime 0.0.77, beta research preview) | Mechanizmy systemu operacyjnego obejmujące cały proces: sandbox-exec (Seatbelt) na macOS, bubblewrap na Linuksie i Windows w wersji alfa (konto srt-sandbox plus filtr ruchu wychodzącego WFP) w wersji 0.0.77 | Twoja maszyna | Nie ma czego uruchamiać; opakowuje istniejący proces | Czas życia procesu | Domyślnie blokuje sieć; domeny dopuszczasz w ~/.srt-settings.json | Darmowa paczka npm |
| container-use (Dagger, Apache-2.0, „experimental”) | Świeży kontener na agenta, każdy na własnej gałęzi gita | Twoja maszyna, przez Daggera | Budowa obrazu przy pierwszym użyciu | Do merge, apply albo odrzucenia środowiska | README tego nie opisuje | Darmowe, open source |
Docker Sandboxes (CLI sbx) | microVM na sandboks z własnym demonem Dockera, systemem plików i siecią | Twoja maszyna albo chmura Dockera | Pierwsze uruchomienie pobiera obraz agenta; według Dockera kolejne „startują w kilka sekund” | Zostaje po wyjściu agenta, aż do sbx rm | Globalne presety Open, Balanced albo Locked Down oraz sbx policy allow network <host> | CLI i lokalne zasoby za darmo, także komercyjnie; chmura płatna za faktyczne zużycie (pay-as-you-go) |
E2B (npm e2b 2.51.0) | Jedna microVM Firecracker na sandboks, z własną cgroup i przestrzenią nazw sieci | E2B Cloud albo własny hosting z e2b-dev/infra | Start albo wznowienie ze snapshotu szablonu, który budujesz raz | 300 s, chyba że ustawisz timeoutMs; maksymalnie 1 godzina w planie Hobby i 24 godziny w Pro (dokumentacja SDK) | network.allowOut i denyOut (hosty, adresy IP, CIDR) albo allowInternetAccess: false | Plany (Hobby, Pro); ceny niesprawdzone |
Modal Sandboxes (PyPI modal 1.5.5) | Kontener tworzony na żądanie przez modal.Sandbox.create | Chmura Modala | Budowa zdefiniowanego przez ciebie modal.Image | Domyślnie timeout=300 sekund | block_network=True, outbound_domain_allowlist, outbound_cidr_allowlist | Niesprawdzona |
Daytona (PyPI daytona, npm @daytona/sdk 0.218.0) | Hostowane sandboksy tworzone przez SDK | Usługa hostowana Daytony | Tworzenie ze snapshotu | Zatrzymuje się po 15 minutach bezczynności; automatyczne usuwanie jest wyłączone, dopóki go nie ustawisz | network_block_all, domain_allow_list, network_allow_list | Niesprawdzona |
| Coder (AGPL-3.0; płatny plan Premium) | Workspace’y definiowane w Terraformie | Twoja infrastruktura | Twój szablon Terraform | Ustalany przez twoje szablony | Konfigurujesz sam | Rdzeń open source; Premium płatny |
Repozytorium open source Daytony mówi: „This repository is no longer maintained. As of June 2026, Daytona’s core development has moved to a private codebase.” Usługa hostowana i SDK działają dalej (obie paczki wydały wersję 0.218.0 2026-09-25). Sandboks CloudCLI jest oznaczony jako eksperymentalny i wymaga CLI sbx Dockera; zarządzana chmura CloudCLI zaczyna się od 7 € miesięcznie, niezależnie od subskrypcji modelu.
Popularność na 2026-09-26 (gwiazdki na GitHubie odczytane tego dnia przez API GitHuba): Daytona 71 717 (repozytorium zamrożone), Coder 16 696, E2B 13 971, CloudCLI 13 811, container-use 4046 i modal-labs/modal-client 518 (tylko repozytorium SDK). Gwiazdki mierzą zainteresowanie, a nie dopasowanie do twojego modelu zagrożeń.
Uruchom Claude Code w trybie headless w sandboksie E2B
Dział zatytułowany „Uruchom Claude Code w trybie headless w sandboksie E2B”To przykład z cookbooka E2B (e2b-dev/e2b-cookbook, examples/anthropic-claude-code-in-sandbox-js), sprawdzony 2026-09-26. Buduje szablon raz, potem wykonuje jeden prompt Claude Code w sandboksie i go niszczy.
-
Zainstaluj SDK i narzędzie do uruchamiania, a oba klucze wyeksportuj z menedżera sekretów (nigdy nie wklejaj ich do pliku):
Okno terminala npm install e2b dotenvnpm install -D tsxexport E2B_API_KEY ANTHROPIC_API_KEY # values come from your secret manager -
Zdefiniuj szablon. Cookbook nazywa go
anthropic-claude-code; nazwę wybierasz sam i nie jest to gotowy szablon E2B:src/template.ts import { Template } from "e2b";export const templateName = "anthropic-claude-code";export const template = Template().fromNodeImage("24").npmInstall(["@anthropic-ai/claude-code"], { g: true }); -
Zbuduj go raz. Cookbook używa jednego vCPU i 1024 MB pamięci:
src/build.prod.ts import "dotenv/config";import { Template, defaultBuildLogger } from "e2b";import { template, templateName } from "./template";await Template.build(template, {alias: templateName,cpuCount: 1,memoryMB: 1024,onBuildLogs: defaultBuildLogger(),});Okno terminala npx tsx src/build.prod.ts -
Wykonaj prompt.
timeoutMs: 0przy poleceniu wyłącza limit czasu tego polecenia, bo uruchomienie Claude Code może trwać długo:src/index.ts import "dotenv/config";import { Sandbox } from "e2b";import { templateName } from "./template";const sbx = await Sandbox.create(templateName, {envs: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! },// Not in the cookbook: deny all egress except the model API.network: { allowOut: ["api.anthropic.com"], denyOut: ["0.0.0.0/0"] },});console.log("Sandbox created", sbx.sandboxId);const result = await sbx.commands.run(`echo 'Create a hello world index.html' | claude -p --dangerously-skip-permissions`,{ timeoutMs: 0 },);console.log(result.stdout);await sbx.kill();Okno terminala npx tsx src/index.ts
Zobaczysz Sandbox created z identyfikatorem, a potem końcową wiadomość Claude Code opisującą zapisany index.html. Plik istnieje tylko wewnątrz microVM, sbx.kill() ją niszczy i nic do ciebie nie wraca. Następna sekcja zamienia go w pętlę, której wynik możesz przejrzeć.
Jak bezpiecznie puścić —dangerously-skip-permissions i nadal przejrzeć wynik?
Dział zatytułowany „Jak bezpiecznie puścić —dangerously-skip-permissions i nadal przejrzeć wynik?”Pętla ma pięć etapów, a sandboks jest tylko jednym z nich: specyfikacja → praca w jednorazowej maszynie → weryfikacja przez harness, nie przez agenta → zwrot gałęzi → review i merge. Agent nigdy nie dostaje tokenu GitHuba i nigdy nie robi pusha. Twój harness przenosi kod do środka i na zewnątrz jako git bundle, więc jedyne połączenia wychodzące sandboksa to API modelu i rejestr paczek.
-
Specyfikacja. Zapisz zadanie jako plik z kryteriami akceptacji, które harness potrafi sprawdzić (polecenie testowe, które musi przejść). Agent, któremu powiesz „zrób, żeby działało”, ogłosi sukces; agenta, któremu powiesz „
npm test -- src/billingmusi przejść i żaden plik pozasrc/billing/nie może się zmienić”, da się z tego rozliczyć. Zobacz, jak pisać kryteria akceptacji, z których da się rozliczyć agenta. -
Praca w jednorazowej maszynie. Utwórz sandboks z zablokowanym ruchem wychodzącym poza hostami potrzebnymi do uruchomienia, wgraj repozytorium jako bundle i puść agenta bez nadzoru.
-
Weryfikacja przez harness. Po zakończeniu pracy agenta harness sam uruchamia polecenie akceptacyjne i zapisuje kod wyjścia. „Wszystkie testy przechodzą” z ust agenta nie jest dowodem.
-
Zwrot gałęzi. Harness pakuje commity agenta w bundle i go pobiera. Z wnętrza sandboksa nic nie jest pushowane.
-
Review i merge. Pobierasz bundle do lokalnej gałęzi, pushujesz ją i otwierasz pull request. CI, bot do code review i człowiek widzą go jak każdą inną zmianę.
Ten harness realizuje etapy od 2 do 4 dla Claude Code na E2B i korzysta z szablonu z cookbooka. Uruchamiasz go z katalogu głównego repozytorium:
import { execFileSync } from "node:child_process";import { readFileSync, writeFileSync } from "node:fs";import { Sandbox } from "e2b";
const [taskFile, branch, acceptance] = process.argv.slice(2); // e.g. task.md agent/billing "npm test -- src/billing"const git = (...args: string[]) => execFileSync("git", args, { encoding: "utf8" }).trim();
const base = git("rev-parse", "HEAD");git("bundle", "create", "/tmp/in.bundle", "HEAD");
const sbx = await Sandbox.create("anthropic-claude-code", { timeoutMs: 60 * 60 * 1000, // one hour, the Hobby-tier maximum envs: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! }, network: { allowOut: ["api.anthropic.com", "registry.npmjs.org"], denyOut: ["0.0.0.0/0"], },});
try { const sh = (cmd: string) => sbx.commands.run(cmd, { cwd: "/tmp/work", timeoutMs: 0 }); await sbx.commands.run("git --version && mkdir -p /tmp/work"); await sbx.files.write("/tmp/in.bundle", new Blob([readFileSync("/tmp/in.bundle")])); await sbx.files.write("/tmp/task.md", readFileSync(taskFile, "utf8")); await sh(`git clone -q /tmp/in.bundle . && git checkout -q -b ${branch}`); await sh(`git config user.email agent@sandbox.invalid && git config user.name sandbox-agent`); await sh("npm ci");
// Stage 2: the unattended loop. Safe only because of the egress rules above. const run = await sh("claude -p --dangerously-skip-permissions --max-budget-usd 5 < /tmp/task.md").catch((e) => e); console.log(`agent exit code: ${run.exitCode}`);
// Stage 3: the harness runs the acceptance check, not the agent. const check = await sh(acceptance).catch((e) => e); console.log(`acceptance exit code: ${check.exitCode}`);
// Stage 4: commit anything left uncommitted and bundle only the new commits. await sh(`git add -A && (git diff --cached --quiet || git commit -qm "agent: ${branch}")`); await sh(`git bundle create /tmp/out.bundle ${branch} ^${base}`); writeFileSync("/tmp/out.bundle", await sbx.files.read("/tmp/out.bundle", { format: "bytes" }));} finally { await sbx.kill();}Potem na swojej maszynie:
npx tsx scripts/sandbox-task.ts task.md agent/billing "npm test -- src/billing"git fetch /tmp/out.bundle agent/billing:agent/billinggit diff --stat HEAD...agent/billing # scope check before anything elsegit push -u origin agent/billing # CI and review take over from herecommands.run rzuca wyjątek, gdy polecenie kończy się kodem różnym od zera, dlatego krok akceptacyjny łapie błąd i czyta z niego exitCode. Nieudany test akceptacyjny i tak zwraca gałąź, więc widzisz, co agent próbował zrobić; kod wyjścia mówi recenzentowi, żeby tego nie mergować. Przenoszenie bundli w obie strony przetestowaliśmy gitem 2026-09-26, a wywołania E2B są zgodne z definicjami typów SDK 2.51.0; zanim zaufasz harnessowi, puść go raz na zadaniu do wyrzucenia.
Ta sama pętla z Codeksem albo Cursorem
Dział zatytułowany „Ta sama pętla z Codeksem albo Cursorem”Zmienia się tylko instalacja agenta i polecenie uruchomienia bez nadzoru.
Szablon: .npmInstall(["@anthropic-ai/claude-code"], { g: true }). Dopuść api.anthropic.com. Polecenie:
claude -p --dangerously-skip-permissions --max-budget-usd 5 < /tmp/task.md--max-budget-usd ogranicza wydatki na API w tym uruchomieniu (--help Claude Code v2.1.283).
Szablon: .npmInstall(["@openai/codex"], { g: true }). Przekaż OPENAI_API_KEY w envs i dopuść api.openai.com (host domyślnego dostawcy OpenAI przy logowaniu kluczem API; własny dostawca wymaga hosta z base_url w jego wpisie model_providers). Polecenie (flagi sprawdzone w codex exec --help, codex-cli 0.157.1):
printenv OPENAI_API_KEY | codex login --with-api-keycodex exec --dangerously-bypass-approvals-and-sandbox - < /tmp/task.mdPomoc mówi, że flaga obejścia jest „intended solely for running in environments that are externally sandboxed”, a tym właśnie jest microVM. Z - polecenie codex exec czyta prompt ze standardowego wejścia.
Strona Dockera o agencie Cursora podaje, że plik wykonywalny agenta CLI to cursor-agent (sbx run cursor uruchamia cursor-agent --yolo). Dokumentacja samego Cursora nazywa komendę CLI agent i instaluje ją przez curl https://cursor.com/install -fsS | bash (strona instalacji Cursor CLI, sprawdzone 2026-10-12), więc zanim oskryptujesz jedną z nazw, sprawdź, którą nazwę pliku wykonywalnego daje twoja instalacja. Ta strona nie uruchamiała agenta Cursora w sandboksie E2B, więc nie pokazuje szablonu. W chmurze Cloud Agents Cursora działają w maszynie wirtualnej dostawcy, co opisują efemeryczne środowiska. Od 2026-09-02 Cursor oferuje też maszyny self-hosted (My Machines i Team pools), które zostawiają wykonywanie narzędzi w twojej sieci (changelog Cursora, sprawdzone 2026-10-12).
Skonfiguruj każdy sandboks z Claude Code, Codeksem i Cursorem
Dział zatytułowany „Skonfiguruj każdy sandboks z Claude Code, Codeksem i Cursorem”container-use: kontener i gałąź na agenta
Dział zatytułowany „container-use: kontener i gałąź na agenta”container-use to serwer MCP, więc to agent tworzy środowiska i z nich korzysta przez swoje narzędzia. Najpierw zainstaluj binarkę (nie ma jej w npm ani PyPI):
brew install dagger/tap/container-use# or, on any platformcurl -fsSL https://raw.githubusercontent.com/dagger/container-use/main/install.sh | bashcd /path/to/repositoryclaude mcp add container-use -- container-use stdiocurl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md >> CLAUDE.mdcodex mcp add container-use -- container-use stdiomkdir -p ~/.codexcurl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md >> ~/.codex/AGENTS.mdPrzewodnik container-use pokazuje równoważny blok [mcp_servers.container-use] w ~/.codex/config.toml z command = "container-use" i args = ["stdio"].
Dodaj serwer do .cursor/mcp.json, a potem plik reguł dla Cursora:
{ "mcpServers": { "container-use": { "command": "container-use", "args": ["stdio"] } }}curl --create-dirs -o .cursor/rules/container-use.mdc https://raw.githubusercontent.com/dagger/container-use/main/rules/cursor.mdcDaj agentowi prawdziwe zadanie, na przykład „Create a Flask hello-world app in Python.”. Twoje drzewo robocze się nie zmienia; agent zwraca adres aplikacji i identyfikator środowiska, na przykład fancy-mallard. Przegląd i decyzję robisz w terminalu:
container-use list # every environmentcontainer-use diff fancy-mallard # what the agent changedcontainer-use log fancy-mallard # every command it rancontainer-use merge fancy-mallard # keep its commits, or: container-use apply fancy-mallard to stage themKoszt kontekstu. container-use dodaje narzędzia MCP do każdej sesji; lista --allowedTools w jego quickstarcie wymienia ich dziesięć. Uruchom /context w Claude Code przed rejestracją serwera i po niej, żeby zobaczyć, ile kosztuje cię to okna kontekstu.
Docker Sandboxes: microVM na agenta na twojej maszynie
Dział zatytułowany „Docker Sandboxes: microVM na agenta na twojej maszynie”Zainstaluj sbx (macOS 14+ na Apple silicon, Windows 11 z Hypervisor Platform albo Linux z KVM), a potem się zaloguj:
brew trust docker/tap && brew install docker/tap/sbx # Windows: winget install -h Docker.sbxsbx loginsbx secret set anthropic # or use /login inside the sandbox with a Claude subscriptionsbx run --clone claude .Strona Dockera o tym agencie mówi, że Claude Code domyślnie startuje z --dangerously-skip-permissions. To dopuszczalne tylko dlatego, że microVM jest jednorazowa: przed pierwszym uruchomieniem wybierz preset sieci Balanced albo Locked Down (niżej), nigdy Open.
sbx secret set openai # or: sbx secret set openai --oauthsbx run --clone codex .Docker uruchamia Codeksa z --dangerously-bypass-approvals-and-sandbox. To dopuszczalne tylko dlatego, że microVM jest jednorazowa: przed pierwszym uruchomieniem wybierz preset sieci Balanced albo Locked Down (niżej), nigdy Open.
sbx run --clone cursor .Docker uruchamia agenta CLI Cursora z --yolo; obsługuje klucz API zapisany jako sekret albo OAuth. To dopuszczalne tylko dlatego, że microVM jest jednorazowa: przed pierwszym uruchomieniem wybierz preset sieci Balanced albo Locked Down (niżej), nigdy Open.
Używaj --clone. Bez tej flagi sbx run montuje bieżący katalog do odczytu i zapisu, a zmiany agenta trafiają do twojego drzewa roboczego w chwili zapisu. W trybie klonowania agent edytuje prywatny klon, twoje repozytorium jest widoczne tylko do odczytu w /run/sandbox/source, a sbx rm usuwa klon, więc najpierw pobierz commity, które chcesz zachować. Tryb klonowania nie działa z dołączonego worktree gita, tylko z głównego. Przy pierwszym uruchomieniu wybierz preset sieci Balanced albo Locked Down zamiast Open i sprawdź go poleceniem sbx policy ls. Przy Locked Down najpierw dopuść host modelu: sbx policy allow network api.anthropic.com (albo host swojego dostawcy). Strona startowa Dockera mówi, że w tym presecie zablokowane jest nawet API dostawcy modelu, dopóki go wprost nie dopuścisz.
Modal, Daytona, Coder i sandbox runtime
Dział zatytułowany „Modal, Daytona, Coder i sandbox runtime”-
Modal. Przykład Modala (
modal-labs/modal-examples,13_sandboxes/sandbox_agent.py) instaluje Claude Code wmodal.Image, klonuje repozytorium i wykonuje poniższe wywołanie. Zostawpty=True: przykład mówi, że Claude tego wymaga. Działa jako root i zadaje pytanie tylko do odczytu, więc pomija--dangerously-skip-permissions.sandbox.exec("claude", "-p", "What is in this repository?",pty=True,secrets=[modal.Secret.from_name("anthropic-secret", required_keys=["ANTHROPIC_API_KEY"])],workdir="/repo",) -
Daytona.
pip install daytonaalbonpm install @daytona/sdk. Twórz sandboks przezdaytona.create(), a polecenia uruchamiaj przezsandbox.process.exec(...). Jawnie ustawauto_delete_interval(alboephemeral),ttl_minutesjako twardy limit czasu zegarowego oraznetwork_block_alllubdomain_allow_list, bo zatrzymany sandboks jest domyślnie zachowywany. ParametrsecretsDaytony montuje sekret organizacji jako placeholder i podstawia prawdziwą wartość dopiero w żądaniach wychodzących do hostów dozwolonych dla tego sekretu. -
Coder.
curl -fsSL https://coder.com/install.sh | sh, potemcoder server. Jego moduły z rejestru uruchamiają Claude Code, Codex i OpenCode w izolowanych workspace’ach, a AI Gateway centralizuje uwierzytelnianie, audyt i koszty. Coder i CloudCLI mają licencję AGPL, więc zanim je wbudujesz albo zaczniesz hostować, uzgodnij to z działem prawnym. -
Sandbox runtime Claude Code. Dopuść zapis do projektu,
~/.claude,~/.claude.jsoni/tmporaz domenęapi.anthropic.comw~/.srt-settings.json. Klucze tofilesystem.allowWriteinetwork.allowedDomains(README sandbox-runtime, 0.0.77):{"filesystem": { "allowWrite": [".", "~/.claude", "~/.claude.json", "/tmp"] },"network": { "allowedDomains": ["api.anthropic.com"] }}Potem uruchom
npx @anthropic-ai/sandbox-runtime claude. Gdy~/.srt-settings.jsonw ogóle nie ma,srti tak startuje na wbudowanych ustawieniach domyślnych (bez sieci, z ograniczonym zapisem), więc czysty start nie dowodzi, że plik został znaleziony; plik, który istnieje, ale nie przechodzi walidacji, sprawia, żesrtkończy działanie z błędem (README, 0.0.77).
Jak udowodnić, że granica sandboksa trzyma?
Dział zatytułowany „Jak udowodnić, że granica sandboksa trzyma?”Sandboks, którego nie przetestowałeś, to tylko przekonanie. Wykonaj te cztery testy, gdy wdrażasz sandboks, i ponownie po każdej zmianie szablonu. Tech lead odpowiada za politykę sandboksa i zatwierdza wyniki testów; recenzent pull requestu zatwierdza samą zmianę.
| Test | Jak | Warunek zaliczenia |
|---|---|---|
| Kanarek ruchu wychodzącego | W sandboksie curl -sS -m 5 https://example.com | Kończy się błędem; curl -sS -m 5 https://api.anthropic.com się łączy |
| Kanarek poświadczeń | W sandboksie env | grep -i -E 'token|secret|key' | Widać tylko klucz modelu (albo placeholder Daytony); żadnych wartości GitHuba, chmury ani produkcji |
| Test zakresu | Na twojej maszynie git diff --stat HEAD...agent/<branch> | Zmieniły się tylko ścieżki dozwolone przez zadanie |
| Test sprzątania | E2B Sandbox.list(), sbx ls, container-use list | Po zakończonych uruchomieniach nie został żaden sandboks |
Jakość samego kodu udowadniasz jak zwykle: kodem wyjścia testu akceptacyjnego z harnessu, CI na wypchniętej gałęzi i agentem albo botem do review, zanim zatwierdzi człowiek. Sandboks sprawia, że uruchomienie jest bezpieczne; nie sprawia, że wynik jest poprawny.
Prompty do skopiowania dla sandboksów agentów
Dział zatytułowany „Prompty do skopiowania dla sandboksów agentów”Co psuje się, gdy agenci pracują w sandboksach, i jak z tego wyjść
Dział zatytułowany „Co psuje się, gdy agenci pracują w sandboksach, i jak z tego wyjść”- Agent melduje sukces, a test akceptacyjny nie przechodzi. Wyjście: zachowaj gałąź, przeczytaj
BLOCKED.md, jeśli powstał, doprecyzuj plik zadania i uruchom ponownie; nie merguj na podstawie podsumowania agenta. - Uruchomienie ginie na limicie czasu sandboksa. Wyjście: ustaw czas życia jawnie (
timeoutMsw E2B,timeoutw Modalu), podziel zadanie i pakuj pracę w bundle w punktach kontrolnych, żeby limit czasu zabierał minuty, a nie całe uruchomienie. - Instalacja zależności pada przy ścisłej liście dozwolonych hostów. Rejestr albo host pobierany w postinstall jest zablokowany. Wyjście: instaluj zależności w szablonie przy budowie, żeby w czasie uruchomienia potrzebne było tylko API modelu, albo dopisz dokładne hosty, nigdy
0.0.0.0/0. - Sandboksy się mnożą i generują rachunki. Harness, który się wysypał, pomija
kill(); Daytona domyślnie zachowuje zatrzymane sandboksy; Docker Sandboxes żyją dosbx rm. Wyjście:try/finallywokół każdego uruchomienia, jawne ustawienie automatycznego usuwania oraz limitttl_minutesw Daytonie i cykliczne zadanie, które listuje i usuwa sandboksy starsze niż twój maksymalny czas uruchomienia. - Zmiany agenta pojawiają się w twoim drzewie roboczym. Docker Sandboxes bez
--clonemontuje katalog do odczytu i zapisu. Wyjście:git stashalbo odrzuć zmiany, a potem zawsze twórz sandboksy z--clone. git bundle createkończy się błędem pustego bundla. Agent nie zrobił żadnego commita i niczego nie zmienił. Wyjście: potraktuj to jako nieudane uruchomienie, przeczytaj końcową wiadomość agenta i wynik testu akceptacyjnego i popraw plik zadania.- Claude Code wisi albo nic nie wypisuje w Modalu. Proces nie ma PTY. Wyjście: przekaż
pty=Truedosandbox.exec. - Claude Code odrzuca
--dangerously-skip-permissions. Proces działa jako root. Wyjście: uruchamiaj agenta jako zwykłego użytkownika w obrazie albo użyj Docker Sandboxes, które same startują agenta w trybie obejścia. - Wstrzyknięty prompt wyprowadza dane. Każdy sandboks z otwartym ruchem wychodzącym może wynieść to, co agent potrafi przeczytać. Wyjście: blokuj cały ruch wychodzący poza wymienionymi hostami, trzymaj produkcyjne poświadczenia poza sandboksem i rotuj każdy klucz, który był obecny w podejrzanym uruchomieniu.
Dokąd dalej z sandboksami dla agentów
Dział zatytułowany „Dokąd dalej z sandboksami dla agentów”- Uprawnienia i sandboksy: tryby zatwierdzania i sandboksy systemowe wewnątrz Claude Code, Codeksa i Cursora, które narzędzia z tej strony opakowują z zewnątrz.
- Efemeryczne środowiska: daj każdemu uruchomieniu w sandboksie własną bazę z danymi, zaślepki i blok portów.
- Agenci headless w CI: uruchamiaj tę samą pętlę z pipeline’u zamiast z terminala.
- Pętle autonomiczne: długie pętle, które potrzebują dokładnie takiego ograniczenia skutków.
- Porównanie botów do AI code review: bramka review, przez którą przechodzi zwrócona gałąź.
- Przegląd narzędzi agentowych: pozostałe półki, od multiplekserów po boty do review.
Czy ten artykuł Ci pomógł?
Jedno kliknięcie, bez logowania.
Co z tym zrobisz?
Jak się czytało?
Co przeszkadzało? Możesz zaznaczyć kilka
Twoja rola?
Dzięki. Czytam każdą odpowiedź. Michał Jaskólski
Pomógł Ci ten artykuł?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania
Najczęstsze pytania
Jakiego sandboksa użyć, żeby puścić Claude Code albo Codex bez nadzoru?
Lokalnie Docker Sandboxes (microVM na agenta) albo container-use (kontener i gałąź gita na agenta). Dla uruchomień z produktu albo CI chmurowe SDK: E2B, Modal lub Daytona. Gdy kod musi zostać na twojej infrastrukturze, Coder.
Czy --dangerously-skip-permissions jest bezpieczne w sandboksie?
Tylko w jednorazowym sandboksie z ograniczonym ruchem wychodzącym, bez produkcyjnych poświadczeń i z agentem uruchomionym jako użytkownik inny niż root. Pomoc Claude Code zaleca tę flagę wyłącznie dla sandboksów bez dostępu do internetu.
Czy mogę sam hostować Daytonę z GitHuba?
Nie jako utrzymywaną opcję. Repozytorium Daytony nie jest utrzymywane od czerwca 2026, bo główny rozwój przeszedł do prywatnego kodu; usługa hostowana oraz paczki daytona i @daytona/sdk działają dalej.
Czy container-use jest w npm?
Nie. container-use to binarka w Go instalowana przez Homebrew albo skrypt instalacyjny i rejestrowana jako serwer MCP poleceniem container-use stdio. Konfiguracja z npx container-use nie działa.