Tempo di lettura stimato
2 min di lettura
Difficoltà
media

Come usare Graphify con Claude Code

Crea una mappa locale dei collegamenti nel codice e usala per trovare i file utili con Claude Code.

Cosa fa Graphify

Graphify trasforma i collegamenti fra file e funzioni in una mappa interrogabile. Puoi usarla per individuare il codice che ti serve e le sue dipendenze prima di aprire i file coinvolti.

La mappa resta nella cartella del progetto. Quando il codice cambia, aggiornala prima di riutilizzarla.

Cosa ti serve

Ti servono Claude Code già configurato, un progetto con codice sul computer e uv, che gestisce l’installazione di Graphify e della versione Python necessaria.

Se uv non è installato, apri la pagina ufficiale di installazione di uv, seleziona macOS e Linux e segui il comando indicato per il tuo terminale.

Se uv non è installato, apri la pagina ufficiale di installazione di uv, seleziona Windows e segui il comando indicato per PowerShell.

Apri un nuovo terminale e verifica che uv sia disponibile:

uv --version

Installa Graphify e la skill

Nel terminale esegui:

uv tool install graphifyy

Il pacchetto si chiama graphifyy, con due y finali. Il comando da usare dopo l’installazione è graphify.

Registra la skill di Claude Code:

graphify install

Riavvia Claude Code per caricare la skill.

Crea la mappa del codice

Apri il terminale nella cartella del progetto. Per analizzare il solo codice in locale, senza chiamate a un modello AI, esegui:

graphify extract . --code-only

Il file graphify-out/graph.json contiene la mappa. Per generare anche il riepilogo e la visualizzazione senza assegnare i nomi dei gruppi con un modello, esegui:

graphify cluster-only . --no-label

Ora trovi anche GRAPH_REPORT.md e graph.html, da aprire nel browser.

La schermata seguente è l’esempio ufficiale sul progetto FastAPI. Nel tuo progetto vedrai nomi e collegamenti diversi.

Esempio ufficiale del grafo FastAPI, con nodi collegati e gruppi filtrabili

Usa la mappa con Claude Code

Apri Claude Code nella stessa cartella del progetto e incolla questo prompt:

Usa la skill Graphify e la mappa già presente in graphify-out/graph.json per trovare il punto d’ingresso dell’app e i moduli da cui dipende. Interroga prima il grafo, poi apri soltanto i file utili. Indicami i percorsi e spiegami i collegamenti che hai trovato.

Claude può usare la mappa per restringere la ricerca e leggere i file pertinenti alla domanda. Il contesto necessario dipende dal progetto e dal lavoro richiesto.

Aggiorna la mappa dopo le modifiche

Quando modifichi il codice, torna nel terminale del progetto ed esegui:

graphify extract . --code-only

Rigenera anche il riepilogo e la visualizzazione:

graphify cluster-only . --no-label

Poi riusa il prompt in Claude Code sulla mappa aggiornata.