RUFLO
Guia de configuração do Ruflo no Claude Code
O Ruflo é um projeto de código aberto que coloca equipes de agentes, memória compartilhada e escolha de modelo por tarefa em cima do Claude Code. Este guia mostra os comandos de instalação e como fazer o primeiro teste sem risco.
Para quem já usa o Claude Code no terminal e tem o Node.js instalado. O Ruflo é gratuito (licença MIT), mas o Claude Code exige plano pago ou crédito de API.
Passo a passo
Confira o que você já tem
Rode claude --version no terminal para ver se o Claude Code está instalado. Você também precisa do Node.js, porque a instalação usa o npx.
Crie uma pasta de teste
Não instale direto no projeto de um cliente. Abra o terminal numa pasta nova, só para conhecer a ferramenta.
Rode a instalação
Dentro da pasta, rode o comando de instalação que está abaixo. Se preferir responder perguntas na tela, use a versão com wizard.
Abra o Claude Code de novo
Segundo o repositório, o Claude Code reconhece o Ruflo na próxima vez que você abrir. Feche a sessão e abra outra na mesma pasta.
Use o caminho por plugin, se preferir
Quem quer só uma parte pode instalar como plugin, de dentro do Claude Code, com os três comandos abaixo. Esse caminho pede o Claude Code na versão 2.1.287 ou mais nova.
Comece por uma tarefa pequena
Cole o prompt de primeiro teste. Peça o plano antes da execução e veja como os agentes dividem o trabalho.
Acompanhe o consumo
Vários agentes ao mesmo tempo também gastam. Olhe o uso do seu plano depois do primeiro teste antes de soltar uma tarefa grande.
Prompts para copiar
Comando de instalação (terminal, dentro da pasta)
npx ruflo@latest init
Instalação com perguntas na tela
npx ruflo@latest init wizard
Caminho por plugin (um comando por vez, dentro do Claude Code)
/plugin marketplace add ruvnet/ruflo /plugin install ruflo-core@ruflo /reload-plugins
Prompt do primeiro teste
Você vai coordenar uma equipe pequena de agentes do Ruflo nesta pasta de teste. Contexto: eu quero conhecer a ferramenta antes de usar em projeto de verdade. A tarefa é [DESCREVA UMA TAREFA PEQUENA, POR EXEMPLO UMA PÁGINA SIMPLES COM FORMULÁRIO DE CONTATO PARA O MEU NEGÓCIO DE ...]. Tarefa: monte um plano curto dizendo quais agentes entram, o que cada um faz e em que ordem. Espere eu aprovar o plano. Depois execute. Formato da resposta final: o que foi feito, onde estão os arquivos, como eu confiro que funciona e quanto de uso a tarefa consumiu, se você tiver esse dado. Não faça: não crie mais agentes do que o plano aprovado, não instale nada fora desta pasta e não diga que terminou sem ter rodado e conferido o resultado.
Links
- Ruflo no GitHubRepositório oficial, com os comandos de instalação e a lista de plugins.
- Guia do usuário do RufloDocumento do projeto que explica as rainhas, os agentes de execução, a memória e a escolha de modelo.
- Instalação do Claude CodePasso oficial para instalar o Claude Code, que vem antes do Ruflo.
Os números de economia (de 30% a 50% de tokens e até 250% a mais de uso do Claude Code) são do guia do próprio projeto. Meça no seu uso antes de contar com eles.
O Ruflo roda comandos e cria arquivos no seu computador. Teste numa pasta separada, sem dado de cliente.
O repositório hoje fala em mais de 100 agentes. O número muda a cada versão, confira na página.
Conferido em 14/11/2026. Ferramenta muda rápido: se algo não bater, me avisa no direct.