---
title: "Rode Claude Code, Codex e OpenCode em um sandbox · Pethost"
description: "O Claude Code, o Codex e o OpenCode já vêm em todo sandbox do Pethost: uma chamada dá um prompt, outra transmite cada chamada de ferramenta. Chaves ficam fora."
---

[Agent Sandboxes](https://pethost.dev/pt/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.

Um prompt a um agente de código em um sandbox, e as chamadas de ferramenta dele voltando ao vivo: ele lê um arquivo, edita, roda os testes, e o turno termina concluído com a contagem de tokens.

## 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](https://pethost.dev/pt/sandboxes/preview-urls/) dele.

Python

CLI

```
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](https://pethost.dev/pt/sandboxes/secrets/).

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](https://pethost.dev/pt/sandboxes/pause-resume/) 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](https://pethost.dev/pt/docs/sandboxes/coding-agents/)

## 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](https://pethost.dev/pt/sandboxes/fork/). 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

- [Dentro do sandbox a chave de API é um marcador; o proxy de saída coloca a chave real na requisição para api.anthropic.com, e uma requisição para outro host fica com o marcador. Chaves que nunca entram Um sandbox vê um marcador; o proxy de saída o troca pela chave de API real nos cabeçalhos das requisições HTTPS, só para os hosts que você indicar. Como funciona](https://pethost.dev/pt/sandboxes/secrets/)
- [Um sandbox rodando no passo 41 de uma tarefa vira três cópias por fork em 0,25 s; cada uma segue sozinha a partir do passo 41. Fork com memória e tudo Copie um sandbox rodando, com memória, processos e disco, para novos sandboxes em uma chamada. Três cópias levam cerca de um quarto de segundo. Como funciona](https://pethost.dev/pt/sandboxes/fork/)

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

[Começar o teste grátis](https://console.pethost.dev/welcome?kind=sandboxes)

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