Português
Começar

Agent Sandboxes Agentes de código, já instalados

Agentes de código na nuvem: Claude Code, Codex e OpenCode

Rode o Claude Code, o Codex ou o OpenCode na nuvem com autonomia total, cada um em uma VM feita para a tarefa: o agente pode fazer qualquer coisa lá dentro, e não guarda nenhuma das suas chaves.

Três agentes de código, já instalados

Nosso template base tem o Claude Code, o Codex e o OpenCode instalados com os SDKs oficiais, e as CLIs deles no PATH: claude, codex, opencode. Cada um roda sem pedir permissão: o Claude Code no modo bypassPermissions, o Codex com acesso total e sem aprovações, o OpenCode com todas as permissões liberadas e a ferramenta de perguntas desativada, já que ninguém a responderia. O sandbox é a fronteira: uma microVM Firecracker com o próprio kernel, onde o agente tem root e alcança o que a sua lista de permissões de saída deixar.

Uma chamada por prompt

prompt_agent dá um prompt a um agente, em uma conversa nova ou em uma que você indicar, com um modelo e um diretório de trabalho se você quiser, e espera até 45 segundos pelo turno. Uma conversa roda um turno por vez: os prompts seguintes entram na fila. Um turno responde o estado (QUEUED, RUNNING, DONE, FAILED, STOPPED ou LOST), a última mensagem do agente até 16 KiB e os tokens que ele leu e escreveu. get_agent_turn espera por um turno mais longo, e stop_agent_turn encerra um.

watch_conversation transmite o que o agente faz, no mesmo formato para os três agentes: cada prompt, cada mensagem que ele escreve, cada chamada de ferramenta com a entrada em JSON, cada resultado e o fim de cada turno. Quando um turno termina, o agente termina com ele, mas o que ele iniciou em segundo plano continua rodando: um dev server que ele iniciou continua lá para abrir na URL de preview dele.

import os
from pethost.sandboxes import EnvVar, Environment, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # lê o PETHOST_TOKEN
key = os.environ["ANTHROPIC_API_KEY"]
sandboxes.set_secret("anthropic", value=key, hosts=["api.anthropic.com"])
env = Environment(variables=[EnvVar(name="ANTHROPIC_API_KEY", secret="anthropic")])
box = sandboxes.create_sandbox(settings=SandboxSettings(environment=env))

prompt = "Write fizzbuzz.py with a test and run it"
turn = sandboxes.prompt_agent(box.sandbox_id, prompt=prompt, wait_seconds=0)
conversation = turn.conversation_id
for event in sandboxes.watch_conversation(box.sandbox_id, conversation_id=conversation):
    if event.tool_call:
        print("›", event.tool_call.name, event.tool_call.input[:60])
    elif event.turn_end:
        print(event.turn_end.state.name, event.turn_end.reply)
        break
pethost sandbox secret set anthropic --host api.anthropic.com < key.txt
pethost sandbox new --name fizzbuzz --env ANTHROPIC_API_KEY=secret:anthropic
pethost sandbox agent fizzbuzz "Write fizzbuzz.py with a test and run it"
pethost sandbox agent fizzbuzz --agent opencode "Explain fizzbuzz.py"

Login sem a chave lá dentro

Guarde a sua chave de API como segredo do espaço de trabalho e ligue-a a ANTHROPIC_API_KEY ou OPENAI_API_KEY. A variável dentro do sandbox guarda um marcador, e o proxy de saída fora da VM coloca a chave real nos cabeçalhos da requisição, só a caminho dos hosts que o segredo indica, como api.anthropic.com. Um programa que imprime o ambiente vê o marcador. Como funcionam os segredos que o sandbox nunca guarda.

Ou uma pessoa faz login uma vez no terminal do sandbox, com claude auth login ou codex login --device-auth. O OpenCode não precisa de login: sem a chave de um provedor, ele usa os modelos grátis do próprio OpenCode. Um prompt a um agente que não alcança o modelo é recusado com a variável a definir e o comando que faz login, para o seu código dizer o que falta.

A conversa fica com o sandbox

O histórico de uma conversa fica no disco do sandbox. Uma pausa o guarda com os arquivos e os processos do agente, e o próximo prompt continua dali. Um fork o leva junto: copie um sandbox entre dois turnos em dez, e mande à conversa de cada cópia o próximo prompt em outra direção. Um template não guarda conversas: um sandbox iniciado a partir de um começa sem nenhuma.

Para ver um agente trabalhar, acompanhe a conversa ao vivo, ou abra a página do sandbox no painel web, cuja aba Agentes mostra as conversas.

Limites e preços

Um turno por vez por conversa. O agente roda nas vCPUs e na memória do sandbox, cobradas por segundo pelo preço do tamanho, US$ 0,018 por hora para SMALL (2 vCPU, 4 GiB) e US$ 0,036 para DEFAULT (4 vCPU, 8 GiB). Um turno rodando mantém o sandbox acordado; entre turnos, ocioso por 5 minutos, ele pausa por 30% desse preço. Os tokens do modelo vêm na conta do seu provedor, não na nossa.

Como se compara

Em 21 de novembro de 2026, o proxy do boat.dev que mantém chaves de IA fora dos sandboxes custava US$ 1 por dia ligado, mais US$ 1 a cada 1.000 requisições. No Pethost a troca faz parte de todo sandbox, para qualquer chave e qualquer host HTTPS que você indicar, sem preço próprio.

Ler a documentação

Perguntas

Preciso de uma chave de API para rodar o Claude Code em um sandbox?

Para o Claude Code e o Codex, uma chave ligada como segredo ou o login de uma pessoa no terminal. O Claude Code também entra com CLAUDE_CODE_OAUTH_TOKEN, Bedrock ou Vertex. O OpenCode roda sem chave, nos modelos grátis dele.

A minha chave entra no sandbox?

Não quando ela é um segredo: o agente e todos os processos veem um marcador, e a chave é adicionada às requisições fora da VM. Um login feito no terminal fica guardado dentro do sandbox, como no seu computador.

Dá para ramificar uma conversa?

Sim: faça fork do sandbox. Cada cópia leva a conversa, e um prompt com o id dela continua dali só naquela cópia.

Dá para ver o agente trabalhando?

Sim: acompanhe a conversa com watch_conversation, ou abra o sandbox no painel web. Um link de terminal que roda claude dá a você uma sessão própria ao lado.

Relacionados

Dê um computador ao seu agente em 0,15 s

Começar o teste grátis