---
title: "Dokumentacja Pethost Agent Sandboxes"
description: "Jak działają i ile kosztują Pethost Agent Sandboxes: maszyny microVM Firecracker do kodu, agentów kodujących i przeglądarki, z twojego kodu albo przez agenta."
---

# Dokumentacja Pethost Agent Sandboxes

Zaktualizowano 22 listopada 2026 · 2 min czytania

Sandbox to linuksowa microVM do kodu, agentów kodujących i pulpitu z Chrome: maszyna wirtualna Firecracker z własnym jądrem i rootem w środku. Startuje z szablonu w ok. 0,15 s, wstrzymuje się razem z pamięcią i procesami, gdy nic się w nim nie dzieje, budzi przy następnym wywołaniu w ok. 0,1 s, a gdy dłużej jest bezczynny, zatrzymuje się do magazynu obiektów. Płacisz co do sekundy za to, co trzyma każdy stan.

**RUNNING**

W pamięci swojego serwera

Wykonuje twoje procesy i odpowiada na każde wywołanie.

0,018 $ za godzinę, SMALL

5 min bezczynności: wstrzymuje się

Następne wywołanie go budzi

**PAUSED**

Na dysku swojego serwera

Zachowuje pamięć, procesy i dysk.

0,0054 $ za godzinę, SMALL

30 min bezczynności: zatrzymuje się

**STOPPED**

W magazynie obiektów

Zachowuje dysk; jego procesy się kończą.

0,03 $ miesięcznie za GiB

ResumeSandbox uruchamia go ponownie, z plikami takimi, jakie zostawił

Domyślny cykl życia. Każdy licznik możesz zmienić albo wyłączyć, a sandbox nigdy nie jest usuwany, chyba że o to poprosisz: [cykl życia i bezczynność](https://pethost.dev/pl/docs/sandboxes/lifecycle/).

## Od czego zacząć

[**Pisz kod** Szybki start: sandbox, polecenie, plik i publiczny URL z Pythona, TypeScriptu, Go albo Rusta albo z CLI pethost.](https://pethost.dev/pl/docs/sandboxes/quickstart/) [**Daj go swojemu agentowi** Dodaj serwer MCP do Claude’a, Codexa, Cursora albo innego klienta MCP, a agent sam będzie tworzył sandboxy i ich używał.](https://pethost.dev/pl/docs/sandboxes/connect-an-agent/) [**Najpierw zrozum** Trzy stany, co budzi sandbox i gdzie leży każdy jego bajt.](https://pethost.dev/pl/docs/sandboxes/how-it-works/)

## W liczbach

- **0,15 s** na start sandboxa, zmierzone przez panel oddalony o 16 ms od jego serwera
- **0,1 s** na wybudzenie wstrzymanego, przy jego następnym wywołaniu
- **0,018 $** za godzinę przy 2 vCPU i 4 GiB, co do sekundy
- **30%** tej ceny, gdy jest wstrzymany

## Co robi sandbox

- **Polecenia, pliki i terminal.** Uruchom polecenie i poczekaj na jego port, edytuj plik przez dokładną zamianę, odbieraj wyjście na żywo albo otwórz terminal w przeglądarce: [polecenia i pliki](https://pethost.dev/pl/docs/sandboxes/commands-and-files/).
- **Porty.** Dowolny port pod `https://<port>-<id>.<server>`, publiczny albo za tokenem: [porty i podglądy](https://pethost.dev/pl/docs/sandboxes/ports-and-previews/).
- **Agenci kodujący.** Claude Code, Codex i OpenCode są zainstalowani. Jedno wywołanie daje agentowi prompt, drugie przesyła na żywo każde jego wywołanie narzędzia: [agenci kodujący](https://pethost.dev/pl/docs/sandboxes/coding-agents/).
- **Pulpit.** Chrome na ekranie 1280×800, który startuje przy pierwszym użyciu: kliknij, wpisz i zrób zrzut ekranu jednym wywołaniem albo oglądaj na żywo: [sterowanie komputerem](https://pethost.dev/pl/docs/sandboxes/computer-use/).
- **Szablony, forki i wolumeny.** Zapisz dysk sandboxa i uruchamiaj z niego nowe ([szablony](https://pethost.dev/pl/docs/sandboxes/templates/)); skopiuj działający sandbox, razem z pamięcią, nawet do 100 kopii ([forki](https://pethost.dev/pl/docs/sandboxes/forks/)); trzymaj dane na dysku poza sandboxami, na jednym serwerze ([wolumeny](https://pethost.dev/pl/docs/sandboxes/volumes/)).
- **Sekrety i ruch wychodzący.** Klucze API, których sandbox nigdy nie trzyma, i lista dozwolonych miejsc, z którymi może się łączyć: [sekrety i ruch wychodzący](https://pethost.dev/pl/docs/sandboxes/secrets-and-egress/).
- **SSH i obserwowalność.** Zwykłe `ssh`, `scp` i `ssh -L` ([SSH](https://pethost.dev/pl/docs/sandboxes/ssh/)) oraz metryki, zdarzenia i zużycie każdego sandboxa ([obserwowalność](https://pethost.dev/pl/docs/sandboxes/observability/)).

## Agent Sandboxes i App Platform

Pethost ma dwa rodzaje przestrzeni roboczych. **App Platform** to maszyna z planu dla twoich aplikacji Docker Compose, w stałej cenie miesięcznej: jej dokumentacja to [dokumentacja App Platform](https://pethost.dev/docs/). **Agent Sandboxes** to temat tych stron: maszyny microVM, które twój kod albo twój agent uruchamia, używa i zatrzymuje przez API, rozliczane co do sekundy. Każda przestrzeń robocza jest jednego rodzaju, a jedno konto może mieć oba.

## Wszystkie strony

### Pierwsze kroki

- [Jak działają Pethost Agent Sandboxes](https://pethost.dev/pl/docs/sandboxes/how-it-works/) Czym jest sandbox, jego trzy stany RUNNING, PAUSED i STOPPED, co go budzi, dwa API oraz gdzie są jego pamięć, procesy i pliki.
- [Szybki start: twój pierwszy sandbox](https://pethost.dev/pl/docs/sandboxes/quickstart/) Utwórz sandbox, uruchom polecenie, zapisz plik, otwórz port i posprzątaj: z Pythona, TypeScriptu, Go, Rusta, CLI pethost albo przez agenta.
- [Podłącz agenta do sandboxów przez MCP](https://pethost.dev/pl/docs/sandboxes/connect-an-agent/) Daj Claude Code, Codexowi, Cursorowi albo Claude’owi sandboxy jako narzędzia: dodaj serwer MCP Pethost Agent Sandboxes i zaloguj się do przestrzeni roboczej.

### Pojęcia

- [Cykl życia sandboxa: automatyczne wstrzymanie, zatrzymanie i bezczynność](https://pethost.dev/pl/docs/sandboxes/lifecycle/) Kiedy bezczynny sandbox się wstrzymuje, zatrzymuje albo jest usuwany: co liczy się jako aktywność, trzy liczniki, keep_awake, wake_when_stopped i wartości.
- [Ceny i rozliczanie sandboxów: co do sekundy, według stanu](https://pethost.dev/pl/docs/sandboxes/billing/) Ile sandbox kosztuje za każdą sekundę działania, wstrzymania czy snu, co zawiera plan, darmowe starty i ich limity, okres próbny i przykłady z wyliczeniami.
- [Dobre praktyki Pethost Agent Sandboxes](https://pethost.dev/pl/docs/sandboxes/best-practices/) Kilka wyborów, dzięki którym sandboxy startują szybko, kosztują mniej i są bezpieczne: szablony, wstrzymanie, zadania wsadowe, keep_awake, request_id, sekrety.

### Zadania

- [Uruchamianie poleceń i edycja plików w sandboxie](https://pethost.dev/pl/docs/sandboxes/commands-and-files/) Uruchamiaj polecenia w sandboxie i czekaj na ich wynik albo port, śledź długie na żywo, edytuj pliki przez dokładną zamianę i przenoś duże pliki linkami.
- [Porty i podglądy: adresy URL sandboxa](https://pethost.dev/pl/docs/sandboxes/ports-and-previews/) Daj dowolnemu portowi sandboxa adres HTTPS, publiczny albo za tokenem, poczekaj, aż serwer deweloperski zacznie nasłuchiwać, i trzymaj podglądy, które śpią.
- [Uruchamianie Claude Code, Codex i OpenCode w sandboxie](https://pethost.dev/pl/docs/sandboxes/coding-agents/) Daj Claude Code, Codexowi albo OpenCode prompt w sandboxie jednym wywołaniem, śledź jego wywołania narzędzi i zaloguj go bez wpuszczania klucza do sandboxa.
- [Sterowanie komputerem: Chrome na pulpicie w sandboxie](https://pethost.dev/pl/docs/sandboxes/computer-use/) Kliknij, wpisz i zrób zrzut ekranu pulpitu z Chrome jednym wywołaniem, dla agenta sterującego komputerem, albo oglądaj ekran sandboxa na żywo w przeglądarce.
- [Szablony: sandboxy gotowe do pracy od startu](https://pethost.dev/pl/docs/sandboxes/templates/) Zapisz dysk sandboxa jako szablon, z pakietami i obrazami Dockera, i uruchamiaj z niego nowe sandboxy na dowolnym serwerze w ok. 0,2 s.
- [Sekrety i ruch wychodzący: klucze, których sandbox nie trzyma](https://pethost.dev/pl/docs/sandboxes/secrets-and-egress/) Daj sandboxowi klucze API, których nie trzyma, podstawiane przez proxy ruchu wychodzącego do wskazanych hostów, i ogranicz listą dozwolonych, dokąd się łączy.
- [Fork sandboxa, razem z pamięcią i procesami](https://pethost.dev/pl/docs/sandboxes/forks/) Skopiuj działający sandbox, z pamięcią, procesami i dyskiem, nawet do 100 sandboxów jednym wywołaniem, żeby naraz próbować kilku rzeczy od tego samego miejsca.
- [Wolumeny: dysk, który przeżywa sandboxy](https://pethost.dev/pl/docs/sandboxes/volumes/) Utwórz wolumen, zamontuj go w sandboxach pod ścieżką, do zapisu w jednym albo do odczytu w wielu, i dowiedz się, gdzie leży i ile kosztuje.
- [SSH do sandboxa: powłoka, scp, SFTP i tunele](https://pethost.dev/pl/docs/sandboxes/ssh/) Loguj się do sandboxa zwykłym ssh, kopiuj pliki przez scp i SFTP, przekierowuj porty przez ssh -L, z kluczem przestrzeni roboczej albo tokenem jako hasłem.
- [Obserwowalność: metryki, zdarzenia i zużycie sandboxa](https://pethost.dev/pl/docs/sandboxes/observability/) Odczytaj CPU, pamięć, dysk i sieć sandboxa, listuj i śledź na żywo jego cykl życia, polecenia, połączenia, żądania do portów i tury agentów, i zobacz koszt.

### Referencja

- [Limity Pethost Agent Sandboxes](https://pethost.dev/pl/docs/sandboxes/limits/) Wszystkie granice Pethost Agent Sandboxes w jednym miejscu: rozmiary, budżety planów, limity startów, sandboxa i wywołania, przechowywana historia i sieć.
- [Błędy API sandboxów i co z nimi zrobić](https://pethost.dev/pl/docs/sandboxes/errors/) Każda odmowa API sandboxów, jej kod i typowany szczegół, co oznacza i co twój program albo agent powinien zrobić dalej.

[NastępnaJak działają Pethost Agent Sandboxes](https://pethost.dev/pl/docs/sandboxes/how-it-works/)

## Wypróbuj Pethost Agent Sandboxes

Okres próbny na 7 dni z 1 $ zużycia i 4 vCPU, z kartą. Potem plan od 20 $ miesięcznie, który zawiera tyle samo zużycia.

[Zacznij okres próbny](https://console.pethost.dev/)

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/)
