Tres agentes de programación, ya instalados
Nuestra plantilla base trae Claude Code, Codex y OpenCode instalados con sus SDK oficiales, y sus CLI en el PATH: claude, codex, opencode. Cada uno se ejecuta sin pedir permiso: Claude Code en modo bypassPermissions, Codex con acceso total y sin aprobaciones, OpenCode con todos los permisos concedidos y su herramienta de preguntas desactivada, porque nadie la respondería. El sandbox es el límite: una microVM Firecracker con su propio kernel, donde el agente es root y llega a lo que permite tu lista de destinos permitidos.
Una llamada por prompt
prompt_agent le da un prompt a un agente, en una conversación nueva o en una que indiques, con un modelo y un directorio de trabajo si los quieres, y espera hasta 45 segundos el turno. Una conversación ejecuta un turno a la vez: los demás prompts se ponen en cola. Un turno responde con su estado (QUEUED, RUNNING, DONE, FAILED, STOPPED o LOST), el último mensaje del agente hasta 16 KiB y los tokens que leyó y escribió. get_agent_turn espera un turno más largo, y stop_agent_turn lo termina.
watch_conversation transmite lo que hace el agente, con la misma forma para los tres agentes: cada prompt, cada mensaje que escribe, cada llamada a herramienta con su entrada en JSON, cada resultado y el final de cada turno. Cuando un turno termina, el agente termina con él, pero lo que inició en segundo plano sigue en ejecución: un servidor de desarrollo que inició sigue ahí para abrirlo en su URL de vista previa.
import os
from pethost.sandboxes import EnvVar, Environment, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # lee 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)
breakpethost 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"Iniciar sesión sin la clave dentro
Guarda tu clave de API como secreto del espacio de trabajo y vincúlala a ANTHROPIC_API_KEY o a OPENAI_API_KEY. La variable dentro del sandbox guarda un marcador, y el proxy de salida, fuera de la VM, pone la clave real en las cabeceras de la petición, solo de camino a los hosts que nombra el secreto, como api.anthropic.com. Un programa que imprime su entorno ve el marcador. Cómo funcionan los secretos que el sandbox nunca tiene.
O bien una persona inicia sesión una vez en la terminal del sandbox, con claude auth login o codex login --device-auth. OpenCode no necesita iniciar sesión: sin la clave de un proveedor, usa los modelos gratis de OpenCode. Un prompt a un agente que no puede llegar a su modelo se rechaza con la variable que hay que configurar y el comando que inicia sesión, para que tu código pueda decir qué falta.
La conversación se queda con el sandbox
El historial de una conversación está en el disco del sandbox. Una pausa lo conserva con los archivos y procesos del agente, y el siguiente prompt lo retoma. Un fork lo lleva consigo: copia un sandbox entre dos turnos en diez, y envía a la conversación de cada copia su siguiente prompt en otra dirección. Una plantilla no guarda conversaciones: un sandbox iniciado desde una empieza sin ninguna.
Para ver trabajar a un agente, transmite su conversación, o abre la página del sandbox en el panel web, cuya pestaña Agentes muestra sus conversaciones.
Límites y precios
Un turno a la vez por conversación. El agente se ejecuta en las vCPU y la memoria del sandbox, facturadas por segundo al precio de su tamaño, 0,018 US$ la hora para SMALL (2 vCPU, 4 GiB) y 0,036 US$ para DEFAULT (4 vCPU, 8 GiB). Un turno en curso mantiene despierto el sandbox; entre turnos, tras 5 minutos inactivo, se pausa al 30 % de ese precio. Los tokens del modelo son la factura de tu proveedor, no la nuestra.
Cómo se compara
El 21 de noviembre de 2026, el proxy de boat.dev que mantiene las claves de IA fuera de sus sandboxes costaba 1 US$ por cada día activo, más 1 US$ por cada 1000 peticiones. En Pethost el reemplazo forma parte de cada sandbox, para cualquier clave y cualquier host HTTPS que indiques, sin precio propio.