Español
Empezar

Agent Sandboxes Agentes de programación, ya instalados

Agentes de programación en la nube: Claude Code, Codex y OpenCode

Ejecuta Claude Code, Codex u OpenCode en la nube con autonomía total, cada uno en una VM creada para la tarea: el agente puede hacer cualquier cosa dentro, y no guarda ninguna de tus claves.

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)
        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"

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.

Leer la documentación

Preguntas

¿Necesito una clave de API para ejecutar Claude Code en un sandbox?

Para Claude Code y Codex, o una clave vinculada como secreto o el inicio de sesión de una persona en la terminal. Claude Code también inicia sesión con CLAUDE_CODE_OAUTH_TOKEN, Bedrock o Vertex. OpenCode funciona sin clave, con sus propios modelos gratis.

¿Mi clave entra en el sandbox?

No si es un secreto: el agente y todos los procesos ven un marcador, y la clave se agrega a las peticiones fuera de la VM. Un inicio de sesión hecho en la terminal se guarda dentro del sandbox, como en tu equipo.

¿Puedo ramificar una conversación?

Sí: haz un fork del sandbox. Cada copia lleva la conversación, y un prompt con su id sigue desde ahí solo en esa copia.

¿Puedo ver trabajar al agente?

Sí: transmite su conversación con watch_conversation, o abre el sandbox en el panel web. Un enlace de terminal que ejecuta claude te da una sesión propia a su lado.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis