Ruflo (anteriorment conegut com a Claude Flow) és un framework d'orquestració d'agents IA que transforma Claude Code en una plataforma multi-agent capaç de coordinar tasques complexes de programació. En aquesta guia veurem com instal·lar-lo a macOS pas a pas.

Requisits previs

Abans de començar, assegura't que tens el següent instal·lat al teu Mac:

  • Node.js v18 o superior
  • npm (s'instal·la amb Node.js)
  • Claude Code (disponible a claude.ai/code)

Pots verificar-ho obrint el Terminal i executant:

node --version
npm --version
claude --version

Pas 1 — Instal·la Ruflo globalment

Al Terminal, executa la següent comanda per instal·lar Ruflo de forma global al teu sistema:

npm install -g ruflo@latest

Comprova que la instal·lació ha funcionat correctament:

ruflo --version

Pas 2 — Registra Ruflo com a servidor MCP a Claude Code

Aquest pas és clau: permet que Claude Code reconegui Ruflo com una eina integrada i hi tingui accés directament des de la interfície.

claude mcp add ruflo -- npx -y @claude-flow/cli@latest

Pas 3 — Inicialitza Ruflo al teu projecte

Navega a la carpeta del projecte on vols usar Ruflo (o crea'n una de nova) i executa l'assistent d'inicialització:

mkdir el-meu-projecte && cd el-meu-projecte
npx ruflo@latest init --wizard

L'assistent interactiu et farà unes preguntes bàsiques de configuració. Segueix els passos fins que acabi.

Pas 4 — Comprova que tot funciona

Ruflo inclou una eina de diagnosi que verifica l'estat de tots els components i intenta reparar automàticament qualsevol problema:

ruflo doctor --fix

Hauries de veure una llista de verificacions amb el símbol ✓ en verd. Si algun component falla, el flag --fix ho repara sol.

Pas 5 — (Opcional) Instal·la plugins addicionals

Des de Claude Code, pots ampliar les capacitats de Ruflo amb mòduls addicionals:

/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo

Com usar-lo un cop instal·lat

Un cop tot és al seu lloc, simplement obre Claude Code a la carpeta del teu projecte i treballa normalment. Ruflo actua en segon pla, coordinant agents automàticament quan la tasca ho requereix.

Per iniciar el dimoni d'aprenentatge en background, que millora el rendiment amb l'ús:

ruflo daemon start

Sobre el directori de projecte

Una pregunta freqüent: el directori creat durant la inicialització (ruflo init) és local al projecte. Ruflo en si mateix no en depèn — està instal·lat globalment. Pots eliminar la carpeta de prova sense problema un cop has comprovat que tot funciona:

rm -rf el-meu-projecte

Reflexió final

Ruflo canvia la manera com interactuem amb Claude Code: en lloc de fer servir un sol agent per a tot, pots coordinar múltiples agents especialitzats que treballen en paral·lel. Per a projectes complexos, això pot marcar una diferència significativa en velocitat i qualitat del resultat.