---
title: "Документація Pethost Agent Sandboxes"
description: "Як працюють Pethost Agent Sandboxes і скільки вони коштують: microVM Firecracker для коду, агентів для коду й браузера, з вашого коду чи від вашого агента."
---

# Документація Pethost Agent Sandboxes

Оновлено 22 листопада 2026 р. · 2 хв читання

Пісочниця — це microVM Linux для коду, агентів для коду й робочого столу з Chrome: ВМ Firecracker із власним ядром і root усередині. Вона запускається із шаблону приблизно за 0,15 с, стає на паузу разом із пам’яттю й процесами, коли в ній нічого не відбувається, прокидається від наступного виклику приблизно за 0,1 с, а якщо простоює довше, зупиняється в об’єктне сховище. Ви платите посекундно за те, що тримає кожен стан.

**RUNNING**

У пам’яті свого сервера

Виконує ваші процеси й відповідає на кожен виклик.

0,018 $ на годину, SMALL

5 хв простою: стає на паузу

Наступний виклик її будить

**PAUSED**

На диску свого сервера

Зберігає пам’ять, процеси й диск.

0,0054 $ на годину, SMALL

30 хв простою: зупиняється

**STOPPED**

В об’єктному сховищі

Зберігає диск; процеси завершуються.

0,03 $ за GiB на місяць

ResumeSandbox запускає її знову, з файлами такими, як вона їх лишила

Типовий життєвий цикл. Кожен таймер можна змінити або вимкнути, а пісочниця ніколи не видаляється, якщо ви не попросите: [життєвий цикл і простій](https://pethost.dev/uk/docs/sandboxes/lifecycle/).

## З чого почати

[**Писати код** Швидкий старт: пісочниця, команда, файл і публічний URL із Python, TypeScript, Go чи Rust або з CLI pethost.](https://pethost.dev/uk/docs/sandboxes/quickstart/) [**Дати її агентові** Додайте MCP-сервер у Claude, Codex, Cursor чи інший MCP-клієнт, і агент сам створюватиме пісочниці й працюватиме в них.](https://pethost.dev/uk/docs/sandboxes/connect-an-agent/) [**Спершу розібратися** Три стани, що будить пісочницю і де лежить кожен її байт.](https://pethost.dev/uk/docs/sandboxes/how-it-works/)

## У цифрах

- **0,15 с**, щоб запустити пісочницю, виміряно через панель за 16 ms від її сервера
- **0,1 с**, щоб розбудити пісочницю з паузи наступним викликом
- **0,018 $** на годину за 2 vCPU і 4 GiB, посекундно
- **30%** від цієї ціни, поки вона на паузі

## Що вміє пісочниця

- **Команди, файли й термінал.** Запустіть команду й дочекайтеся її порту, редагуйте файл точною заміною, транслюйте вивід або відкрийте термінал у браузері: [команди й файли](https://pethost.dev/uk/docs/sandboxes/commands-and-files/).
- **Порти.** Будь-який порт за адресою `https://<port>-<id>.<server>`, публічно або за токеном: [порти й прев’ю](https://pethost.dev/uk/docs/sandboxes/ports-and-previews/).
- **Агенти для коду.** Claude Code, Codex і OpenCode встановлені. Один виклик дає агентові промпт, інший транслює кожен виклик інструмента, який він робить: [агенти для коду](https://pethost.dev/uk/docs/sandboxes/coding-agents/).
- **Робочий стіл.** Chrome на екрані 1280×800, що запускається з першим використанням: клацнути, ввести текст і зробити скриншот одним викликом або дивитися наживо: [керування комп’ютером](https://pethost.dev/uk/docs/sandboxes/computer-use/).
- **Шаблони, копії й томи.** Збережіть диск пісочниці й запускайте з нього нові ([шаблони](https://pethost.dev/uk/docs/sandboxes/templates/)); зробіть до 100 копій пісочниці, що працює, разом із її пам’яттю ([копіювання](https://pethost.dev/uk/docs/sandboxes/forks/)); тримайте дані на диску поза будь-якою пісочницею, на одному сервері ([томи](https://pethost.dev/uk/docs/sandboxes/volumes/)).
- **Секрети й вихідний трафік.** API-ключі, яких пісочниця ніколи не тримає, і список дозволених адрес, куди вона може підключатися: [секрети й вихідний трафік](https://pethost.dev/uk/docs/sandboxes/secrets-and-egress/).
- **SSH і спостережуваність.** Звичайні `ssh`, `scp` і `ssh -L` ([SSH](https://pethost.dev/uk/docs/sandboxes/ssh/)), а також метрики, події й використання кожної пісочниці ([спостережуваність](https://pethost.dev/uk/docs/sandboxes/observability/)).

## Agent Sandboxes і App Platform

У Pethost є два види робочих просторів. **App Platform** — це машина тарифу для ваших застосунків Docker Compose за фіксованою ціною на місяць: її документація — [документація App Platform](https://pethost.dev/docs/). **Agent Sandboxes** — те, про що ці сторінки: microVM, які ваш код чи ваш агент запускає, використовує й зупиняє через API, з посекундною оплатою. Кожен робочий простір має один вид, а в одному акаунті можуть бути обидва.

## Усі сторінки

### Початок

- [Як працюють Pethost Agent Sandboxes](https://pethost.dev/uk/docs/sandboxes/how-it-works/) Що таке пісочниця, її три стани RUNNING, PAUSED і STOPPED, що її будить, два API і де лежать її пам’ять, процеси й файли.
- [Швидкий старт: ваша перша пісочниця](https://pethost.dev/uk/docs/sandboxes/quickstart/) Створіть пісочницю, виконайте команду, запишіть файл, відкрийте порт і приберіть за собою: із Python, TypeScript, Go, Rust, CLI pethost або через агента.
- [Підключіть агента до пісочниць через MCP](https://pethost.dev/uk/docs/sandboxes/connect-an-agent/) Дайте Claude Code, Codex, Cursor чи Claude пісочниці як інструменти: додайте MCP-сервер Pethost Agent Sandboxes і увійдіть у робочий простір пісочниць.

### Основи

- [Життєвий цикл пісочниці: автопауза, автозупинка й простій](https://pethost.dev/uk/docs/sandboxes/lifecycle/) Коли пісочниця в простої стає на паузу, зупиняється чи видаляється: що вважається активністю, три таймери, keep_awake, wake_when_stopped і готові значення.
- [Ціни й оплата пісочниць: посекундно, за станом](https://pethost.dev/uk/docs/sandboxes/billing/) Скільки коштує кожна секунда роботи, паузи чи сну пісочниці, що включає тариф, безкоштовні запуски та їхні ліміти, пробний період і приклади розрахунків.
- [Найкращі практики для Pethost Agent Sandboxes](https://pethost.dev/uk/docs/sandboxes/best-practices/) Кілька рішень, з якими пісочниці швидко стартують, менше коштують і безпечні: шаблони, пауза для агентів, пакетні задачі, keep_awake, request_id, секрети.

### Завдання

- [Виконуйте команди й редагуйте файли в пісочниці](https://pethost.dev/uk/docs/sandboxes/commands-and-files/) Виконуйте команди оболонки в пісочниці й чекайте виводу чи порту, транслюйте довгі, редагуйте файли точною заміною й передавайте великі файли через посилання.
- [Порти й прев’ю: URL пісочниці](https://pethost.dev/uk/docs/sandboxes/ports-and-previews/) Дайте будь-якому порту пісочниці HTTPS-адресу, публічну чи за токеном, дочекайтеся сервера розробки й запускайте прев’ю, що сплять між відвідуваннями.
- [Запускайте Claude Code, Codex і OpenCode у пісочниці](https://pethost.dev/uk/docs/sandboxes/coding-agents/) Дайте Claude Code, Codex чи OpenCode промпт у пісочниці одним викликом, транслюйте його виклики інструментів і дайте йому увійти без ключа в пісочниці.
- [Керування комп’ютером: Chrome на робочому столі в пісочниці](https://pethost.dev/uk/docs/sandboxes/computer-use/) Клацніть, введіть текст і зробіть скриншот робочого стола з Chrome одним викликом, для агента, що керує комп’ютером, або дивіться екран наживо в браузері.
- [Шаблони: пісочниці, готові до роботи з першої секунди](https://pethost.dev/uk/docs/sandboxes/templates/) Збережіть диск пісочниці як шаблон, разом із пакетами й образами Docker, і запускайте з нього нові пісочниці на будь-якому сервері приблизно за 0,2 с.
- [Секрети й вихідний трафік: ключі, яких пісочниця не тримає](https://pethost.dev/uk/docs/sandboxes/secrets-and-egress/) Дайте пісочниці API-ключі, яких вона не тримає, — проксі вихідного трафіку підставляє їх для названих вами хостів, — і обмежте, куди вона підключається.
- [Копіюйте пісочницю разом із пам’яттю й процесами](https://pethost.dev/uk/docs/sandboxes/forks/) Скопіюйте пісочницю, що працює, з її пам’яттю, процесами й диском — до 100 копій одним викликом, щоб пробувати кілька речей з тієї самої точки водночас.
- [Томи: диск, що переживає пісочниці](https://pethost.dev/uk/docs/sandboxes/volumes/) Створіть том, змонтуйте його в пісочниці за шляхом, для читання й запису в одній або лише для читання в багатьох, і дізнайтеся, де він лежить і скільки коштує.
- [SSH у пісочницю: оболонка, scp, SFTP і тунелі](https://pethost.dev/uk/docs/sandboxes/ssh/) Входьте в будь-яку пісочницю звичайним ssh, копіюйте файли через scp і SFTP, прокидайте порти через ssh -L, з ключем робочого простору або токеном як паролем.
- [Спостережуваність: метрики, події й використання пісочниці](https://pethost.dev/uk/docs/sandboxes/observability/) CPU, пам’ять, диск і мережа пісочниці, її життєвий цикл, команди, з’єднання, запити до портів і ходи агентів списком чи наживо, а також скільки вона коштувала.

### Довідник

- [Ліміти Pethost Agent Sandboxes](https://pethost.dev/uk/docs/sandboxes/limits/) Усі межі Pethost Agent Sandboxes в одному місці: розміри, бюджети тарифів, ліміти запусків, ліміти пісочниці й виклику, збережена історія й мережа.
- [Помилки API пісочниць і що з ними робити](https://pethost.dev/uk/docs/sandboxes/errors/) Кожна відмова API пісочниць, її код і типізована деталь, що вона означає і що далі робити вашій програмі чи агентові.

[ДаліЯк працюють Pethost Agent Sandboxes](https://pethost.dev/uk/docs/sandboxes/how-it-works/)

## Спробуйте Pethost Agent Sandboxes

Пробний період на 7 днів із використанням на 1 $ і 4 vCPU, потрібна картка. Далі — тариф від 20 $ на місяць, який включає стільки ж використання.

[Почати пробний період](https://console.pethost.dev/)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблони](https://pethost.dev/uk/templates/)
- [Про нас](https://pethost.dev/about/)
- [Документація](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/uk/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Плагін](https://github.com/pethost-dev/plugin)
- [Умови](https://pethost.dev/terms/)
- [Конфіденційність](https://pethost.dev/privacy/)
- [Повернення коштів](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Бази даних

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

Agent Sandboxes

- [Пісочниці](https://pethost.dev/uk/sandboxes/)
- [Тарифи](https://pethost.dev/uk/sandboxes/#pricing)
- [Документація](https://pethost.dev/uk/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Порівняння

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/uk/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/uk/blog/coolify-cloud-vs-dokploy-cloud/)
- [Ціни Railway vs Render vs Fly.io](https://pethost.dev/uk/blog/railway-vs-render-vs-fly-io-pricing/)
- [Керований хостинг Docker Compose](https://pethost.dev/uk/blog/managed-docker-compose-hosting/)

Альтернативи

- [Альтернативи Railway](https://pethost.dev/uk/blog/railway-alternatives/)
- [Альтернативи Heroku](https://pethost.dev/uk/blog/heroku-alternatives/)
- [Альтернативи Dokploy](https://pethost.dev/uk/blog/dokploy-alternatives/)
- [Альтернативи Coolify](https://pethost.dev/uk/blog/coolify-alternatives/)
- [Альтернативи Render](https://pethost.dev/uk/blog/render-alternatives/)
- [Альтернативи Sliplane](https://pethost.dev/uk/blog/sliplane-alternatives/)
