O Paperclip é um programa de código aberto que organiza vários agentes de IA como se fossem funcionários de uma empresa. Cada agente ganha cargo, chefe, função, limite do que pode fazer e orçamento. Você define a meta da empresa, e as tarefas descem pela hierarquia.
Ele não substitui os agentes que você já usa. Ele coordena. Claude Code, Codex, Cursor, Gemini CLI e outros entram no organograma como "funcionários", e a regra do projeto é curta: se o agente recebe um sinal de vida (o heartbeat), está contratado.
Este guia explica o que ele faz, como instalar, como montar a primeira equipe e onde o custo aparece. Números conferidos na API do GitHub em 04/10/2026: 97.071 estrelas, licença MIT.
Os links
- Repositório: https://github.com/paperclipai/paperclip
- Site: https://paperclip.ing
- Documentação: https://docs.paperclip.ing
- Primeiros passos em 5 minutos: https://docs.paperclip.ing/guides/getting-started/five-minute-path/
O que ele faz, em quatro partes
- Organograma. Hierarquia, cargos, quem responde a quem e o que cada um pode fazer. Pode misturar pessoas e agentes.
- Metas e tarefas. Cada tarefa fica ligada a um projeto e a uma meta da empresa. O agente recebe esse contexto junto, então sabe o porquê do que está fazendo, não só o título da tarefa.
- Orçamento. Limite de gasto por empresa, por agente e por projeto, com alerta ao chegar perto e pausa automática ao atingir o teto.
- Acompanhamento. Painel com tudo que cada agente fez, histórico de cada execução, aprovações e funciona pelo celular.
Tem também rotinas agendadas (tarefas que se repetem sozinhas), aprovação antes de contratar agente novo e modelos de equipe prontos para instalar.
Quando faz sentido
- Você já usa mais de um agente e perde o controle de quem está fazendo o quê.
- Tem tarefas recorrentes (relatório, suporte, post) que hoje dependem de você lembrar de disparar.
- Já levou susto com conta de API depois de um agente rodar em loop.
Quando não faz: se você usa um agente só, de vez em quando, o Paperclip é estrutura demais. Comece pelo agente e volte aqui quando tiver três ou mais rodando.
Como instalar
Precisa do Node.js 24.11 ou mais novo instalado. No terminal:
npx paperclipai@latest onboard --yes
Isso sobe o painel em http://localhost:3100, já com um banco de dados embutido. Não precisa criar conta no Paperclip.
Para só experimentar, sem instalar nada fixo, existe o modo de teste, que já cria um agente "CEO":
ANTHROPIC_API_KEY=sua-chave npx paperclipai test-drive
Também dá para pedir ao próprio Claude Code para instalar, passando o link do guia de instalação: https://docs.paperclip.ing/reference/cli/installation/
Montando a primeira equipe
- Escreva a meta em uma frase com número. Exemplo: "publicar 20 posts de blog sobre o meu nicho até o fim do mês". Meta vaga gera tarefa vaga.
- Comece com dois ou três agentes, não dez. Um que planeja, um que executa, um que revisa. Aumente depois de ver a equipe funcionando.
- Dê a cada um um cargo e um limite. O revisor não precisa de permissão para publicar; o executor não precisa aprovar o próprio trabalho.
- Ligue a aprovação. Deixe a etapa de revisão humana ativa nas primeiras semanas. Você vê o que sai antes de ir para o mundo.
- Defina o orçamento antes de apertar o play. Veja a próxima seção.
O custo: o programa é grátis, os modelos não
O Paperclip não cobra nada. Quem cobra são os modelos de IA que os agentes usam (Claude, GPT, Gemini), pela chave de API ou pela assinatura de cada um.
E agente rodando sozinho, 24 horas, gasta sem você ver. Por isso:
- Coloque teto por agente, não só por empresa. Um agente em loop não pode consumir o orçamento dos outros.
- Use o alerta de limite para ser avisado antes do teto, não depois.
- Comece com orçamento diário pequeno e aumente quando entender quanto cada tipo de tarefa consome.
- Use modelo mais barato em tarefa simples. O Paperclip deixa escolher o modelo por agente: o revisor de formatação não precisa do modelo mais caro.
A própria documentação avisa: a pausa automática usa o gasto já registrado, e o que está rodando pode passar um pouco do limite antes de parar. Deixe folga.