---
title: "Docs do Pethost Agent Sandboxes"
description: "Como o Pethost Agent Sandboxes funciona e quanto custa: microVMs Firecracker para código, agentes de código e um navegador, do seu código ou do seu agente."
---

# Docs do Pethost Agent Sandboxes

Atualizado em 22 de novembro de 2026 · 3 min de leitura

Um sandbox é uma microVM Linux para código, agentes de código e um desktop com Chrome: uma VM Firecracker com kernel próprio e root lá dentro. Ele inicia a partir de um template em cerca de 0,15 s, pausa com a memória e os processos quando nada acontece nele, acorda na próxima chamada em cerca de 0,1 s e para no armazenamento de objetos quando fica ocioso por mais tempo. Você paga por segundo pelo que cada estado guarda.

**RUNNING**

Na memória do servidor

Roda os seus processos e responde a toda chamada.

US$ 0,018 por hora, SMALL

Ocioso por 5min: ele pausa

A próxima chamada o acorda

**PAUSED**

No disco do servidor

Guarda memória, processos e disco.

US$ 0,0054 por hora, SMALL

Ocioso por 30min: ele para

**STOPPED**

No armazenamento de objetos

Guarda o disco; os processos terminam.

US$ 0,03 por GiB ao mês

ResumeSandbox o inicia de novo, com os arquivos como ele os deixou

O ciclo de vida padrão. Cada timer pode ser alterado ou desativado, e um sandbox nunca é excluído a não ser que você peça: [ciclo de vida e ociosidade](https://pethost.dev/pt/docs/sandboxes/lifecycle/).

## Por onde começar

[**Escrever código** O início rápido: um sandbox, um comando, um arquivo e uma URL pública a partir de Python, TypeScript, Go ou Rust, ou da CLI pethost.](https://pethost.dev/pt/docs/sandboxes/quickstart/) [**Entregar ao seu agente** Adicione o servidor MCP ao Claude, ao Codex, ao Cursor ou a outro cliente MCP, e o agente cria e usa sandboxes sozinho.](https://pethost.dev/pt/docs/sandboxes/connect-an-agent/) [**Entender primeiro** Os três estados, o que acorda um sandbox e onde fica cada byte dele.](https://pethost.dev/pt/docs/sandboxes/how-it-works/)

## Em números

- **0,15 s** para iniciar um sandbox, medido por um painel a 16 ms do servidor dele
- **0,1 s** para acordar um pausado, na próxima chamada
- **US$ 0,018** por hora para 2 vCPUs e 4 GiB, por segundo
- **30%** desse preço enquanto ele está pausado

## O que um sandbox faz

- **Comandos, arquivos e um terminal.** Rode um comando e espere pela porta dele, edite um arquivo por substituição exata, transmita a saída ou abra um terminal no navegador: [comandos e arquivos](https://pethost.dev/pt/docs/sandboxes/commands-and-files/).
- **Portas.** Qualquer porta em `https://<port>-<id>.<server>`, pública ou atrás de um token: [portas e previews](https://pethost.dev/pt/docs/sandboxes/ports-and-previews/).
- **Agentes de código.** O Claude Code, o Codex e o OpenCode vêm instalados. Uma chamada dá um prompt a um agente, outra transmite cada chamada de ferramenta que ele faz: [agentes de código](https://pethost.dev/pt/docs/sandboxes/coding-agents/).
- **Um desktop.** Chrome em uma tela de 1280×800, que inicia no primeiro uso: clique, digite e tire uma captura de tela em uma chamada, ou assista ao vivo: [uso do computador](https://pethost.dev/pt/docs/sandboxes/computer-use/).
- **Templates, forks e volumes.** Salve o disco de um sandbox e inicie novos a partir dele ([templates](https://pethost.dev/pt/docs/sandboxes/templates/)); copie um sandbox rodando, com memória e tudo, em até 100 cópias ([forks](https://pethost.dev/pt/docs/sandboxes/forks/)); guarde dados em um disco fora de qualquer sandbox, em um servidor ([volumes](https://pethost.dev/pt/docs/sandboxes/volumes/)).
- **Segredos e saída.** Chaves de API que o sandbox nunca guarda e uma lista de permissões dos lugares a que ele pode se conectar: [segredos e saída](https://pethost.dev/pt/docs/sandboxes/secrets-and-egress/).
- **SSH e observabilidade.** `ssh`, `scp` e `ssh -L` puros ([SSH](https://pethost.dev/pt/docs/sandboxes/ssh/)), e as métricas, os eventos e o uso de cada sandbox ([observabilidade](https://pethost.dev/pt/docs/sandboxes/observability/)).

## Agent Sandboxes e App Platform

O Pethost tem dois tipos de espaço de trabalho. O **App Platform** é a máquina de um plano para os seus apps Docker Compose, por um preço fixo por mês: a documentação dele é a [documentação do App Platform](https://pethost.dev/docs/). O **Agent Sandboxes** é o assunto destas páginas: microVMs que o seu código ou o seu agente inicia, usa e para por uma API, cobradas por segundo. Cada espaço de trabalho é de um tipo, e uma conta pode ter os dois.

## Todas as páginas

### Começar

- [Como o Pethost Agent Sandboxes funciona](https://pethost.dev/pt/docs/sandboxes/how-it-works/) O que é um sandbox, seus três estados RUNNING, PAUSED e STOPPED, o que o acorda, as duas APIs e onde ficam a memória, os processos e os arquivos dele.
- [Início rápido: o seu primeiro sandbox](https://pethost.dev/pt/docs/sandboxes/quickstart/) Crie um sandbox, rode um comando, grave um arquivo, abra uma porta e faça a limpeza: em Python, TypeScript, Go, Rust, pela CLI pethost ou pelo seu agente.
- [Conecte um agente aos sandboxes por MCP](https://pethost.dev/pt/docs/sandboxes/connect-an-agent/) Dê sandboxes como ferramentas ao Claude Code, Codex, Cursor ou Claude: adicione o servidor MCP do Pethost Agent Sandboxes e escolha um espaço de trabalho.

### Conceitos

- [Ciclo de vida do sandbox: pausa automática, parada automática e ociosidade](https://pethost.dev/pt/docs/sandboxes/lifecycle/) Quando um sandbox ocioso pausa, para ou é excluído: o que conta como atividade, os três timers, keep_awake, wake_when_stopped e valores por caso de uso.
- [Preços e cobrança de sandboxes: por segundo, por estado](https://pethost.dev/pt/docs/sandboxes/billing/) Quanto um sandbox custa a cada segundo rodando, pausado ou dormindo, o que um plano inclui, inícios grátis e seus limites, o teste grátis e exemplos calculados.
- [Boas práticas do Pethost Agent Sandboxes](https://pethost.dev/pt/docs/sandboxes/best-practices/) As escolhas que fazem sandboxes iniciarem rápido, custarem menos e ficarem seguros: templates, pausa, jobs em lote, keep_awake, request_id, segredos, saída.

### Tarefas

- [Rode comandos e edite arquivos em um sandbox](https://pethost.dev/pt/docs/sandboxes/commands-and-files/) Rode comandos de shell em um sandbox e espere a saída ou a porta, transmita os longos, edite arquivos por substituição exata e mova arquivos grandes por links.
- [Portas e previews: as URLs de um sandbox](https://pethost.dev/pt/docs/sandboxes/ports-and-previews/) Dê a qualquer porta de um sandbox um endereço HTTPS, público ou atrás de um token, espere um servidor de desenvolvimento escutar e rode previews que dormem.
- [Rode Claude Code, Codex e OpenCode em um sandbox](https://pethost.dev/pt/docs/sandboxes/coding-agents/) Dê um prompt ao Claude Code, Codex ou OpenCode em um sandbox com uma chamada, transmita as chamadas de ferramenta e faça o login sem a chave entrar no sandbox.
- [Uso do computador: Chrome em um desktop dentro de um sandbox](https://pethost.dev/pt/docs/sandboxes/computer-use/) Clique, digite e tire uma captura de tela de um desktop com Chrome em uma chamada, para um agente de uso do computador, ou veja a tela do sandbox ao vivo.
- [Templates: inicie sandboxes prontos para trabalhar](https://pethost.dev/pt/docs/sandboxes/templates/) Salve o disco de um sandbox como template, com os seus pacotes e imagens Docker, e inicie novos sandboxes a partir dele em qualquer servidor em cerca de 0,2 s.
- [Segredos e saída: chaves que um sandbox nunca guarda](https://pethost.dev/pt/docs/sandboxes/secrets-and-egress/) Dê a um sandbox chaves de API que ele nunca guarda, trocadas pelo proxy de saída para os hosts indicados, e limite as conexões com uma lista de permissões.
- [Faça fork de um sandbox, com memória e processos](https://pethost.dev/pt/docs/sandboxes/forks/) Copie um sandbox rodando, com memória, processos e disco, para até 100 sandboxes em uma chamada, e tente várias coisas a partir do mesmo ponto ao mesmo tempo.
- [Volumes: um disco que sobrevive aos sandboxes](https://pethost.dev/pt/docs/sandboxes/volumes/) Crie um volume, monte-o em sandboxes em um caminho, com leitura e escrita por um ou só leitura por muitos, e saiba onde ele fica e quanto custa.
- [SSH em um sandbox: shell, scp, SFTP e túneis](https://pethost.dev/pt/docs/sandboxes/ssh/) Entre em qualquer sandbox com ssh puro, copie arquivos com scp e SFTP e encaminhe portas com ssh -L, com uma chave do espaço de trabalho ou um token como senha.
- [Observabilidade: métricas, eventos e uso de um sandbox](https://pethost.dev/pt/docs/sandboxes/observability/) Leia CPU, memória, disco e rede de um sandbox, liste e transmita ciclo de vida, comandos, conexões, requisições e turnos de agente, e veja quanto ele custou.

### Referência

- [Limites do Pethost Agent Sandboxes](https://pethost.dev/pt/docs/sandboxes/limits/) Todos os limites do Pethost Agent Sandboxes em um só lugar: tamanhos, orçamentos, inícios, limites por sandbox e por chamada, histórico guardado e rede.
- [Erros da API de sandboxes, e o que fazer](https://pethost.dev/pt/docs/sandboxes/errors/) Cada recusa da API de sandboxes, o código e o detalhe tipado dela, o que significa e o que o seu programa ou agente deve fazer em seguida.

[PróximaComo o Pethost Agent Sandboxes funciona](https://pethost.dev/pt/docs/sandboxes/how-it-works/)

## Experimente o Pethost Agent Sandboxes

Um teste grátis de 7 dias com US$ 1 de uso e 4 vCPUs; é preciso um cartão. Depois, um plano a partir de US$ 20 por mês, que inclui esse mesmo valor em uso.

[Começar o teste grátis](https://console.pethost.dev/)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/pt/templates/)
- [Sobre nós](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pt/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Termos](https://pethost.dev/terms/)
- [Privacidade](https://pethost.dev/privacy/)
- [Reembolsos](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bancos de dados

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/pt/sandboxes/)
- [Preços](https://pethost.dev/pt/sandboxes/#pricing)
- [Docs](https://pethost.dev/pt/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparativos

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pt/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pt/blog/coolify-cloud-vs-dokploy-cloud/)
- [Preços Railway vs Render vs Fly.io](https://pethost.dev/pt/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hospedagem gerenciada de Docker Compose](https://pethost.dev/pt/blog/managed-docker-compose-hosting/)

Alternativas

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