---
title: "Документация Pethost Agent Sandboxes"
description: "Как устроены Pethost Agent Sandboxes и сколько они стоят: микроВМ Firecracker для кода, агентов для кода и браузера — из вашего кода или вашим агентом."
---

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

Обновлено 22 ноября 2026 г. · 2 мин чтения

Песочница — это микроВМ 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/ru/docs/sandboxes/lifecycle/).

## С чего начать

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

## В цифрах

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

## Что умеет песочница

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

## Agent Sandboxes и App Platform

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

## Все страницы

### Начало

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

### Основы

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

### Задачи

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

### Справочник

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

[СледующаяКак устроены Pethost Agent Sandboxes](https://pethost.dev/ru/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/ru/templates/)
- [О нас](https://pethost.dev/about/)
- [Документация](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/ru/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/ru/postgres/)
- [Valkey](https://pethost.dev/ru/valkey/)

Agent Sandboxes

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

Сравнения

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

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

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