Começar

Uma box é um computador Linux na nuvem para o seu agente. O Claude Code ou o Codex cria a box, manda o trabalho pesado para ela e traz o resultado. O seu computador fica livre

A primeira box em dois minutos

  1. Cole no terminal

    No Claude Code:

    Terminal
    $ PUXADINHO_API_URL=https://www.usepuxadinho.com.br npx puxadinho@latest setup claude

    No Codex:

    Terminal
    $ PUXADINHO_API_URL=https://www.usepuxadinho.com.br npx puxadinho@latest setup codex

    O comando abre o navegador para você entrar com e-mail e senha, cria uma chave só para o agente, registra o MCP do puxadinho e instala a skill que ensina o agente a usar as boxes. Precisa do Node 24 ou mais novo.

  2. Reinicie o agente

    Feche e abra o Claude Code ou o Codex de novo para ele carregar o MCP.

  3. Peça o trabalho

    Fale com o agente como sempre. Por exemplo:

    Prompt
    Cria uma box no puxadinho, roda os testes deste projeto lá e me traz o resultado.
  4. Acompanhe

    Em https://www.usepuxadinho.com.br/boxes você vê cada box trabalhando, o progresso e quanto ela já custou.

Rodou o setup sem terminal (por exemplo, o próprio agente rodou)? Então ele faz um pedido de acesso e mostra um link https://www.usepuxadinho.com.br/claim?code=XXXX-XXXX. Abra o link, confira o código e toque em Liberar. Nada é liberado sem a sua confirmação

O que é uma box

  • Um Linux com Node, Python, Go, git e as CLIs de agentes. Para vídeo e imagem existe o modelo midia, com ffmpeg, Chromium e Remotion.
  • Seus arquivos ficam em /data/home. Eles continuam lá quando a box dorme e voltam quando ela acorda.
  • Box parada dorme sozinha e para de cobrar processamento. Um comando ou uma leitura de arquivo acorda ela.
  • Você paga só o tempo trabalhando, por hora, em reais.
  • Quando o agente termina, ele apaga a box. Você também pode apagar pelo painel.

Como o agente usa

Estas são as instruções que o MCP entrega ao agente, do jeito que estão no servidor:

Instruções do MCP
puxadinho: boxes são computadores Linux na nuvem para rodar trabalho pesado ou longo fora da sua máquina.
Padrão: create_box → write_file (até 1 MB) ou get_upload_url → exec (até 600 s) ou start_job + job_wait → read_file ou get_download_url → delete_box com confirm: true.
Use metadata.kind para o tipo de tarefa. Box ociosa dorme sozinha e acorda com exec/arquivos. Consulte get_usage para ver o gasto do mês.

A lista completa está em Ferramentas do MCP.

Próximos passos