Tempo di lettura stimato
4 min di lettura
Difficoltà
media

Come configurare Ruflo in Claude Code, passo per passo

Installa i plugin Ruflo su Mac o Windows, apri la console e crea una prima missione con un prompt pronto da incollare.

Cosa fa Ruflo

Ruflo aggiunge a Claude Code strumenti per organizzare il lavoro degli agenti, gestire memoria e seguire le attività da una console. Il percorso qui sotto installa i plugin di base e crea una prima missione, un obiettivo salvato che puoi ritrovare nella console.

Cosa ti serve

  • Un Mac con macOS 13 o successivo, oppure un PC con Windows 10 versione 1809 o successiva.
  • Un account con accesso a Claude Code, tramite abbonamento o API.
  • Node.js 20 o successivo e npm 9 o successivo. Se mancano, scarica l'installer LTS per il tuo sistema dalla pagina ufficiale di Node.js. npm è incluso nell'installer.
  • Git disponibile nel terminale, dalla pagina ufficiale di Git.

Dopo le installazioni, apri una nuova finestra del terminale e controlla i tre strumenti, un comando alla volta:

node --version
npm --version
git --version

Ogni comando deve stampare la propria versione.

1. Prepara Claude Code

Se hai già Claude Code, controlla che sia almeno alla versione 2.1.287, richiesta dal percorso plugin attuale di Ruflo. Se devi ancora installarlo, usa l'installer nativo:

Apri Terminale e incolla:

curl -fsSL https://claude.ai/install.sh | bash

Apri PowerShell, senza passare a WSL o al Prompt dei comandi, e incolla:

irm https://claude.ai/install.ps1 | iex

Apri una nuova finestra del terminale e controlla la versione:

claude --version

Per aggiornare un'installazione nativa precedente, esegui:

claude update

Se hai installato Claude Code con un gestore di pacchetti, usa invece il relativo aggiornamento indicato nella documentazione ufficiale.

Nel terminale crea una nuova cartella per la prova, poi entraci. Questi due comandi valgono anche in PowerShell:

mkdir prova-ruflo
cd prova-ruflo

Avvia Claude Code:

claude

Al primo avvio segui la procedura di accesso. Se Claude Code chiede di confermare la cartella di lavoro, controlla che sia prova-ruflo.

2. Installa i plugin Ruflo

Da questo punto incolla i comandi dentro Claude Code, uno alla volta. Aggiungi prima il marketplace:

/plugin marketplace add ruvnet/ruflo

Installa il plugin di base, che collega gli strumenti Ruflo:

/plugin install ruflo-core@ruflo

Il comando apre i dettagli del plugin. Leggi i componenti elencati e scegli Install for you, così lo installi per il tuo utente su questo computer.

Ripeti la stessa scelta per la console:

/plugin install ruflo-console@ruflo

Con la stessa scelta, installa il plugin che integra instradamento e regole di esecuzione in Claude Code:

/plugin install ruflo-mods@ruflo

Applica le modifiche:

/reload-plugins

Apri il pannello dei plugin e verifica che risultino installati ruflo-core, ruflo-console e ruflo-mods:

/plugin

3. Apri la console

Chiudi il pannello dei plugin e lancia:

/ruflo

Deve aprirsi la console Ruflo. Entra in Settings, apri Claude control, attivalo se è spento e scegli write + ask. Questa impostazione permette a Claude di proporre una scrittura nella console e ti chiede di confermarla.

4. Crea la prima missione

Nella chat di Claude Code incolla questo messaggio. L'obiettivo in inglese riprende l'esempio della documentazione di Ruflo:

Usa la console Ruflo per creare una missione con obiettivo "add a dark mode toggle". Mostrami la missione e il suo stato nella pagina Missions, poi apri Overview e mostrami l'azione registrata. Fermati dopo la creazione della missione, senza implementare la funzione.

Quando la console presenta la richiesta di creazione, conferma l'azione. Controlla che Missions contenga l'obiettivo add a dark mode toggle e leggi lo stato mostrato. In Overview cerca la registrazione dell'azione di creazione.

La schermata seguente proviene dalla registrazione ufficiale dello stesso esempio, distribuita con licenza MIT. Mostra le azioni nel pannello Claude control di Overview. La registrazione usa la conferma automatica; nel percorso appena seguito hai scelto ask e confermi tu la creazione.

La console della registrazione ufficiale mostra in Overview le azioni set goal e run mission-goal

La missione salvata è il risultato di questa prova. Il selettore del tema verrà realizzato solo quando chiederai di eseguire il lavoro. Per sospendere il controllo della console da parte di Claude, premi Take back control.