---
title: "Sandbox do wykonywania kodu dla agentów AI · Pethost"
description: "Uruchamiaj kod pisany przez twój model w sandboxie Firecracker: polecenia czekające na port, wynik na żywo, dokładne edycje plików i terminal w przeglądarce."
---

[Agent Sandboxes](https://pethost.dev/pl/sandboxes/) Polecenia, pliki i terminal

# Sandbox do wykonywania kodu dla agentów AI

Twój model pisze kod, sandbox go uruchamia, a wynik wraca w tym samym wywołaniu. Polecenia, pliki i terminale to jedno API, na które odpowiada serwer, na którym działa sandbox, a nie panel.

Program wywołuje run_command i wynik testów wraca na żywo; edytuje plik na miejscu; uruchamia serwer deweloperski, a wywołanie odpowiada, gdy port 5173 nasłuchuje.

## Wykonanie kodu jednym wywołaniem

Każdy sandbox to microVM Firecracker z własnym jądrem Linuksa i rootem w środku, uruchamiana z naszego szablonu `base` w ok. 0,15 s: to Ubuntu 24.04 z narzędziami do budowania, Pythonem 3, Node.js 22 i Dockerem. `run_command` uruchamia polecenie przez `bash -lc` jako `user`, który ma sudo, albo jako root, w dowolnym wskazanym katalogu. Wywołanie czeka do 45 sekund na koniec polecenia i odpowiada jego kodem wyjścia oraz ostatnimi 32 KiB jego stdout i stderr.

Trzy pola zmieniają to, na co czeka wywołanie:

- `wait_for_port` odpowiada, gdy tylko coś zacznie nasłuchiwać na porcie, a polecenie działa dalej: `npm run dev` i 5173.
- `wait_seconds=0` odpowiada, gdy polecenie wystartuje. `get_command` znowu na nie czeka, a `watch_command` przesyła jego wynik na żywo: najpierw ostatnie 64 KiB, potem to, co przychodzi.
- `timeout_seconds` kończy polecenie, które działa za długo. Bez niego polecenie kończy tylko `stop_command`: SIGTERM, a 10 s później SIGKILL.

Każda odpowiedź mówi, ile bajtów polecenie już wypisało; odeślij tę liczbę, a następna odpowiedź zawiera tylko to, co nowe. Z `request_id` ponowienie w ciągu 24 godzin niczego nie uruchamia drugi raz i odpowiada tym, co zrobiło pierwsze wywołanie. `list_commands` pokazuje, co teraz działa, łącznie z poleceniami wpisanymi przez SSH, a 100 ostatnich zakończonych zostaje zachowanych.

Python

CLI

```
from pethost.sandboxes import FileChange, Sandboxes, TextEdit

sandboxes = Sandboxes()  # czyta PETHOST_TOKEN
box = sandboxes.create_sandbox()
code = "x = 1\nprint(x * 42)\n"
sandboxes.write_files(box.sandbox_id, changes=[FileChange(path="app.py", text=code)])
out = sandboxes.run_command(box.sandbox_id, command="python3 app.py", timeout_seconds=30)
print(out.exit_code, out.stdout)  # 0 42

edit = TextEdit(old_text="x = 1", new_text="x = 2")
sandboxes.write_files(box.sandbox_id, changes=[FileChange(path="app.py", edit=edit)])
server = sandboxes.run_command(box.sandbox_id, command="python3 -m http.server 8000",
                               wait_for_port=8000)
print(server.state.name)  # RUNNING: odpowiedziało, gdy port 8000 zaczął nasłuchiwać
```

```
pethost sandbox new --name tests --size small
pethost sandbox cp ./app tests:/home/user/app
pethost sandbox run tests --cwd /home/user/app -- python3 -m unittest
pethost sandbox open tests --terminal
```

## Pliki: paczki zmian i dokładne edycje

`write_files` przyjmuje listę zmian i wykonuje je po kolei: zapis tekstu albo bajtów pliku, zamiana tekstu, który występuje w nim dokładnie raz, przeniesienie, usunięcie, utworzenie katalogu, ustawienie uprawnień. Brakujące katalogi nadrzędne są tworzone. Zatrzymuje się na pierwszej zmianie, która się nie uda, i mówi, na której, z powodem, na którym można oprzeć logikę, na przykład że tekstu do zamiany nie ma. Edycja trafia więc tylko tam, gdzie jest jej tekst. Żądanie mieści do 17 MiB.

`read_file` czyta do 1 MiB od dowolnego przesunięcia, `list_files` wypisuje katalog na dowolną głębokość, a `watch_files` przesyła na żywo każdą zmianę pod nim. Plik dowolnej wielkości przechodzi przez link z `create_link`: adres pobierania wysyła plik albo katalog jako .tar, a adres wgrywania przyjmuje PUT. Każdy działa raz.

## Terminal w przeglądarce

`create_link` z terminalem daje stronę, na której działa bash albo polecenie takie jak `claude`, i WebSocket pod tym samym adresem, który przenosi jego bajty, do terminala we własnym produkcie. Link działa domyślnie godzinę, a najwyżej dzień.

## Co działa w środku

Docker działa w każdym sandboxie: `dockerd` startuje przy pierwszym połączeniu z jego gniazdem i trzyma obrazy na dysku sandboxa, więc przetrwają zatrzymanie, a szablon je przeniesie. Resztę zainstalujesz z apt, przez sudo.

Wywołania idą prosto do serwera sandboxa, który SDK znajduje za ciebie. Pierwsze polecenie po utworzeniu odpowiada w 29–48 ms. Na serwerze z 74 sandboxami, z których każdy budował projekt JavaScript i czekał między buildami, tak jak agent, proste polecenie trwało 6 ms (28 ms w 95. percentylu).

## Limity i ceny

| Co | Limit |
| --- | --- |
| Wywołania naraz, na sandbox | 64; `write_files` liczy się za 16 |
| Żądanie | 1 MiB; `write_files` 17 MiB |
| Odpowiedź | ok. 64 KiB; `read_file` 1 MiB; dowolna wielkość przez link |
| Wynik w odpowiedzi | ostatnie 32 KiB stdout i stderr |

Polecenia, pliki i linki nie mają własnej ceny: płacisz za sekundy działania sandboxa, od 0,018 $ za godzinę dla SMALL (2 vCPU, 4 GiB) do 0,144 $ dla XLARGE (16 vCPU, 32 GiB), a każdy okres działania zaokrąglamy w górę do sekundy, minimum 10 s. Po 5 minutach bezczynności sandbox wstrzymuje się za 30% tej ceny. [Jak działa rozliczanie co do sekundy](https://pethost.dev/pl/sandboxes/per-second-billing/).

## Jak to wypada na tle innych

21 listopada 2026 E2B liczyło 0,1656 $ za godzinę sandboxa z 2 vCPU i 4 GiB, tak samo Daytona; SMALL w Pethost, tego samego rozmiaru, kosztuje 0,018 $. Sesje w E2B trwały do 1 godziny w planie Hobby i do 24 godzin w planie Pro, w Vercel Sandbox 45 minut w planie Hobby i 24 godziny w planie Pro. Sandbox Pethost nie ma limitu czasu życia.

[Przeczytaj dokumentację](https://pethost.dev/pl/docs/sandboxes/commands-and-files/)

## Pytania

**Jakie języki uruchomi sandbox do wykonywania kodu?**

Wszystko, co działa na Linuksie. Python 3 i Node.js 22 są zainstalowane, Docker działa, a resztę zainstaluje apt. Zapisz sandbox ze swoimi narzędziami jako [szablon](https://pethost.dev/pl/sandboxes/templates/), a nowe sandboxy wystartują z nimi.

**Jak długo może działać polecenie?**

Tyle, ile potrzebuje: jedno wywołanie czeka do 45 sekund, potem czytasz albo odbierasz na żywo jego wynik. Po 5 minutach bezczynności sandbox wstrzymuje się z poleceniem w pamięci, które działa dalej przy następnym wywołaniu. Polecenie uruchomione z `keep_awake` działa bez przerwy, tak samo jak to, które śledzisz przez `watch_command`.

**Czy kod ma dostęp do internetu?**

Tak, przez TCP: domyślnie sandbox może łączyć się z czymkolwiek. [Lista dozwolonych dla ruchu wychodzącego](https://pethost.dev/pl/sandboxes/egress-allowlist/) zawęża to do wskazanych domen, adresów IP i portów. Żaden ruch UDP nie wychodzi z sandboxa.

**Jak przenosić duże pliki?**

Przez link pobierania albo wgrywania, dowolnej wielkości, albo przez scp po [SSH](https://pethost.dev/pl/sandboxes/ssh/).

## Powiązane

- [Prompt do agenta kodującego w sandboxie i jego wywołania narzędzi wracające na żywo: czyta plik, edytuje go, uruchamia testy, a tura kończy się jako gotowa z liczbą tokenów. Agenci kodujący, zainstalowani Claude Code, Codex i OpenCode działają w każdym sandboxie z pełną autonomią: jedno wywołanie daje agentowi prompt, drugie przesyła na żywo każde jego wywołanie narzędzia. Jak to działa](https://pethost.dev/pl/sandboxes/coding-agents/)
- [Wejście na adres HTTPS portu 3000 budzi wstrzymany sandbox w 0,2 s i pojawia się jego strona; port prywatny odpowiada 200 na żądanie z tokenem i 401 na żądanie bez niego. Adres dla każdego portu Serwer deweloperski na porcie 3000 odpowiada pod własnym adresem HTTPS, publicznym albo za tokenem, a wejście budzi wstrzymany sandbox w ok. 0,2 s. Jak to działa](https://pethost.dev/pl/sandboxes/preview-urls/)

## Daj swojemu agentowi komputer w 0,15 s

[Zacznij darmowy okres próbny](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Szablony](https://pethost.dev/pl/templates/)
- [O nas](https://pethost.dev/about/)
- [Dokumentacja](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pl/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Regulamin](https://pethost.dev/terms/)
- [Prywatność](https://pethost.dev/privacy/)
- [Zwroty](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bazy danych

- [Postgres](https://pethost.dev/pl/postgres/)
- [Valkey](https://pethost.dev/pl/valkey/)

Agent Sandboxes

- [Sandboxy](https://pethost.dev/pl/sandboxes/)
- [Cennik](https://pethost.dev/pl/sandboxes/#pricing)
- [Dokumentacja](https://pethost.dev/pl/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Porównania

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pl/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pl/blog/coolify-cloud-vs-dokploy-cloud/)
- [Cennik Railway vs Render vs Fly.io](https://pethost.dev/pl/blog/railway-vs-render-vs-fly-io-pricing/)
- [Zarządzany hosting Docker Compose](https://pethost.dev/pl/blog/managed-docker-compose-hosting/)

Alternatywy

- [Alternatywy dla Railway](https://pethost.dev/pl/blog/railway-alternatives/)
- [Alternatywy dla Heroku](https://pethost.dev/pl/blog/heroku-alternatives/)
- [Alternatywy dla Dokploy](https://pethost.dev/pl/blog/dokploy-alternatives/)
- [Alternatywy dla Coolify](https://pethost.dev/pl/blog/coolify-alternatives/)
- [Alternatywy dla Render](https://pethost.dev/pl/blog/render-alternatives/)
- [Alternatywy dla Sliplane](https://pethost.dev/pl/blog/sliplane-alternatives/)
