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
- Cole no terminal
No Claude Code:
Terminal$ PUXADINHO_API_URL=https://www.usepuxadinho.com.br npx puxadinho@latest setup claudeNo Codex:
Terminal$ PUXADINHO_API_URL=https://www.usepuxadinho.com.br npx puxadinho@latest setup codexO 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.
- Reinicie o agente
Feche e abra o Claude Code ou o Codex de novo para ele carregar o MCP.
- Peça o trabalho
Fale com o agente como sempre. Por exemplo:
PromptCria uma box no puxadinho, roda os testes deste projeto lá e me traz o resultado. - Acompanhe
Em https://www.usepuxadinho.com.br/boxes você vê cada box trabalhando, o progresso e quanto ela já custou.
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çãoO 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:
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
- Conectar o MCP à mão, sem o setup, ou pelo MCP local da CLI.
- Boxes: dormir sozinha, snapshots, cópias e portas.
- Chaves e segurança: o que o agente pode fazer e como guardar as suas chaves.
- Planos e limites: preço por hora e quantas boxes ao mesmo tempo.