Vai al contenuto principale
Claude Code e open source

claude-code-setup: quali automazioni attivare nel progetto

· 5 minuti di lettura · Redazione Scrivere.AI

In breve

  • claude-code-setup è un plugin ufficiale di Anthropic che analizza il progetto e consiglia una o due automazioni per tipo tra server MCP, skills, hook, subagenti e comandi.
  • Funziona in sola lettura: legge i file di configurazione e la struttura del codice, collega ogni proposta a un segnale trovato e lascia a te la decisione su cosa attivare.
  • Il complemento naturale è claude-md-management, che con la skill claude-md-improver e il comando /revise-claude-md tiene aggiornato il file CLAUDE.md, modificandolo solo dopo la tua approvazione.

claude-code-setup è un plugin ufficiale di Anthropic che analizza il tuo progetto e ti consiglia quali automazioni di Claude Code attivare: server MCP, skills, hook, subagenti e comandi. Per ogni tipo propone una o due scelte, quelle più utili per il codice che ha davanti. Lavora in sola lettura: suggerisce, ma non crea né modifica file.

Il problema che risolve è comune a chi inizia. Claude Code si può estendere in molti modi diversi, e davanti a un progetto reale non è ovvio da dove partire: meglio un hook che formatta il codice, un server MCP per la documentazione o un subagente che rivede la sicurezza? Questo plugin fa una ricognizione e ti dà un elenco breve e motivato. Se Claude Code ti è nuovo, parti dall'articolo su cos'è Claude Code e come iniziare.

Che cosa fa claude-code-setup?

Il plugin contiene una sola skill, claude-automation-recommender. Una skill è un insieme di istruzioni che Claude carica quando la richiesta è pertinente, quindi non c'è un comando da ricordare: basta chiedere, anche in italiano, qualcosa come "consigliami le automazioni per questo progetto", "aiutami a configurare Claude Code" o "quali hook dovrei usare?".

La skill lavora in due fasi. Prima esamina il progetto: file come package.json o pyproject.toml, dipendenze, struttura delle cartelle, test presenti, configurazione di Claude Code già esistente. Poi produce raccomandazioni divise per categoria, collegando ogni proposta a un segnale trovato nel codice. Alcuni esempi tratti dalla skill stessa:

Tipo Segnale nel progetto Proposta tipica
Server MCPLibrerie molto diffuseContext7 per la documentazione aggiornata
Server MCPInterfaccia web da testarePlaywright per automatizzare il browser
SkillsRotte di APIUna skill per documentarle partendo da un modello
HookFormattatori e linter configuratiFormattazione automatica, blocco dei file sensibili
SubagentiCodice con requisiti di qualitàRevisori dedicati a sicurezza, prestazioni, accessibilità

La regola della skill è proporre una o due automazioni per tipo, per non sommergerti. Se chiedi un tipo specifico, per esempio solo gli hook, ne propone di più, e alla fine ricorda che puoi chiedere altri suggerimenti per qualunque categoria.

Come si installa e come si usa?

Il plugin è nel marketplace ufficiale claude-plugins-official. Dentro una sessione di Claude Code:

/plugin install claude-code-setup@claude-plugins-official

Poi apri Claude Code nella cartella del progetto e chiedi le raccomandazioni. Un esempio concreto: su un gestionale in PHP con una cartella di test e un repository GitHub, è plausibile che la risposta includa un hook per lanciare i controlli di stile dopo le modifiche, il server MCP di GitHub per issue e pull request e un subagente di revisione della sicurezza. Il risultato dipende da cosa trova davvero nel codice, quindi su progetti diversi le proposte cambiano.

A quel punto decidi tu cosa attivare. Puoi installare un plugin suggerito, chiedere a Claude di scrivere l'hook proposto o ignorare la raccomandazione. Per gli hook di protezione, per esempio, puoi usare Hookify, che la skill stessa cita tra i plugin disponibili. Il codice è nella cartella di claude-code-setup nel repository ufficiale.

Cosa legge e cosa esegue?

"Sola lettura" significa che la skill non modifica i file, non che non faccia nulla. Per l'analisi usa gli strumenti di lettura e ricerca di Claude Code e la shell, con comandi come ls e cat sui file di configurazione del progetto. Le istruzioni le chiedono anche di cercare sul web raccomandazioni specifiche per le librerie che trova. Questi passaggi seguono le normali regole di permesso della tua sessione, quindi vedrai le richieste di approvazione come per qualunque altro comando.

Due cautele pratiche. Le proposte sono un punto di partenza e non una verifica: un server MCP consigliato va comunque valutato per i dati a cui accede, con i criteri dell'articolo sulla sicurezza dei plugin. E più automazioni non significa lavorare meglio: ognuna aggiunge contesto e comportamenti da conoscere, quindi attivane poche e verifica che servano.

Il complemento naturale: claude-md-management

Una volta impostate le automazioni, resta da tenere aggiornata la memoria di progetto, cioè il file CLAUDE.md con le istruzioni che Claude legge a ogni sessione. Cos'è e come si scrive lo spieghiamo nell'articolo su CLAUDE.md. Il plugin ufficiale claude-md-management offre due strumenti:

  • claude-md-improver, una skill che trova i file CLAUDE.md del repository, li confronta con lo stato attuale del codice e produce un rapporto di qualità con un punteggio per file. Prima di modificare qualcosa mostra le aggiunte proposte e chiede conferma. Si attiva con richieste come "verifica se il mio CLAUDE.md è aggiornato".
  • /revise-claude-md, un comando da lanciare a fine sessione: rilegge il lavoro appena fatto, individua i comandi, le convenzioni e le insidie emerse e propone di aggiungerle in forma breve. Modifica solo i file che approvi.

Si installa allo stesso modo:

/plugin install claude-md-management@claude-plugins-official

A differenza di claude-code-setup, questo plugin scrive nei file CLAUDE.md, sempre dopo la tua approvazione: rileggi le aggiunte prima di confermare, soprattutto se il file è condiviso con il team.

Per chi ha senso?

claude-code-setup ha senso per chi introduce Claude Code su un progetto esistente e vuole un primo elenco ragionato invece di provare plugin a caso, e per chi segue più progetti e vuole una ricognizione rapida di ciascuno. claude-md-management serve a chiunque usi Claude Code con continuità, perché un CLAUDE.md non aggiornato fa ripetere sempre gli stessi errori.

Cosa fare adesso: installa claude-code-setup, chiedi le raccomandazioni sul tuo progetto principale e attiva una sola automazione tra quelle proposte. Dopo qualche giorno di lavoro lancia /revise-claude-md per fissare ciò che hai imparato. Gli altri plugin utili per partire sono nella guida ai plugin di Claude Code.

Domande frequenti

Come si usa claude-code-setup?

Si installa con /plugin install claude-code-setup@claude-plugins-official e poi si chiede a Claude, anche in italiano, di consigliare le automazioni per il progetto. Non c'è un comando da lanciare perché si tratta di una skill che si attiva dalla richiesta.

claude-code-setup modifica i file del progetto?

No, la skill è in sola lettura e si limita a proporre raccomandazioni. Per analizzare il progetto esegue comandi di lettura che seguono le normali regole di permesso della sessione.

Che differenza c'è tra claude-md-improver e /revise-claude-md?

claude-md-improver confronta i CLAUDE.md con lo stato attuale del codice e produce un rapporto di qualità, utile come manutenzione periodica. /revise-claude-md si lancia a fine sessione per salvare comandi e insidie emersi durante il lavoro.

Quante automazioni conviene attivare all'inizio?

Poche. La skill ne propone una o due per tipo proprio per questo: ogni automazione aggiunge contesto e comportamenti da conoscere, quindi conviene attivarle una alla volta e verificare che servano.

Continua a leggere