Graphify Claude Code: ce este, cum il instalezi, merita?

Graphify pentru Claude Code este un skill open source care transforma proiectul tau intr-un graf de cunostinte (knowledge graph): scrii /graphify . si Claude primeste o harta a fisierelor, functiilor, claselor si documentelor pe care o poate interoga, in loc sa citeasca fisierele unul cate unul.

Codul este analizat local, fara model AI si fara cost. Se instaleaza cu doua comenzi, dar merita cu adevarat doar pe proiecte medii si mari.

In acest ghid despre Graphify Claude Code iti arat ce este, cum il instalezi corect in Claude Code (fara pachete false), cum il faci pe Claude sa il foloseasca si cand nu are rost sa il pui deloc.

Graphify Claude Code: ce este si ce face

Graphify este un proiect open source (licenta Apache 2.0 si MIT), publicat pe GitHub de organizatia Graphify-Labs. La inceputul lui noiembrie 2026 depaseste 140 de mii de stele si e printre cele mai urmarite skill-uri pentru agenti AI.

Problema pe care o rezolva o cunoaste oricine lucreaza cu agenti: intrebi Claude Code "unde se leaga autentificarea de baza de date?", iar el cauta cu grep, deschide fisiere, urmareste importurile. Pe un repository mare asta consuma tokeni si timp.

Graphify construieste mai intai o harta structurala a proiectului si o salveaza pe disc, iar agentul pune o intrebare precisa grafului.

Ce intra in graf

• Cod: aproximativ 40 de limbaje analizate cu tree-sitter (AST), cu apeluri, importuri si mosteniri rezolvate intre fisiere.
• Documentatie: Markdown, PDF, imagini si, cu extra-uri, fisiere Office, scheme SQL, video.
• Comentarii cu motivatia deciziilor: # WHY:, # NOTE: si referintele la ADR devin noduri legate de cod.
• Comunitati: graful este impartit in subsisteme (algoritmul Leiden).

Fiecare legatura are o eticheta: EXTRACTED daca apare explicit in sursa, INFERRED daca a fost dedusa de Graphify. Nu este o baza de date vectoriala, nu foloseste embedding-uri.

Cele trei fisiere generate

• graph.html: harta interactiva, o deschizi in browser si dai click pe noduri.
• GRAPH_REPORT.md: rezumatul cu nodurile centrale ("god nodes"), legaturile surprinzatoare si intrebarile sugerate.
• graph.json: graful complet, pe care Claude il interogheaza fara sa recitesca fisierele.

Toate apar in folderul graphify-out/ din radacina proiectului.

Graphify e gratuit?

Da, versiunea open source este gratuita. Partea de cod ruleaza integral local si nu consuma credite la niciun model. Costul indirect apare doar pentru documente, PDF-uri si imagini: acestea trec prin modelul sesiunii tale de Claude Code, deci consuma din abonament sau din API key.

Exista si Graphify Cloud, un serviciu cu plata care tine graful mereu actualizat pe mai multe repository-uri, cu perioada de proba gratuita de 14 zile. Pretul nu este publicat in repository, asa ca nu il dau.

Daca vrei sa stii cat te costa partea de Claude in lei, am facut un ghid separat despre cat costa Claude in 2026.

Daca te loveste limita de utilizare, inainte de orice skill nou verifica cum consumi mai putini tokeni in Claude Code cu comenzile native. De multe ori acolo e economia cea mai mare.

Cum instalezi Graphify in Claude Code

Ai nevoie de Python 3.10 sau mai nou si de uv (sau pipx). Daca nu ai inca agentul, porneste de la ghidul de instalare Claude Code pe Windows, Mac si Linux.

Atentie la numele pachetului

Pachetul oficial pe PyPI se numeste graphifyy, cu doi de y. Comanda ramane graphify. Celelalte pachete "graphify" de pe PyPI nu au legatura cu proiectul, iar in rezultatele Google apar si fork-uri.

Un nume gresit tastat de tine sau de agent inseamna cod strain pe masina ta. Am scris mai pe larg despre riscurile extensiilor de la terti in articolul despre Claude Code mods.

Instalare Graphify Claude Code: pasii

1. Instalezi CLI-ul: uv tool install graphifyy (sau pipx install graphifyy).
2. Inregistrezi skill-ul: graphify install. Detecteaza singur Claude Code, inclusiv pe Windows.
3. Deschizi Claude Code in folderul proiectului si scrii /graphify .
4. Deschizi graphify-out/graph.html in browser si citesti GRAPH_REPORT.md.
5. Legi graful de agent cu graphify claude install, ca Claude sa il consulte inainte sa caute prin fisiere.

Pentru o instalare doar in proiectul curent foloseste graphify install --project. Fisierele ajung in .claude/skills/graphify/ si le poti pune in git pentru toata echipa.

Erori frecvente

• "graphify: command not found": ruleaza uv tool update-shell si redeschide terminalul.
• PDF-uri sau fisiere Office ignorate: instaleaza extra-ul potrivit, de exemplu uv tool install "graphifyy[pdf]" sau "graphifyy[office]".
• Prea multe cereri de permisiune in aplicatia desktop: e o problema cunoscuta, discutata de utilizatori. Configureaza permisiunile Claude Code pentru comenzile graphify, nu aproba totul orbeste.
• Codex: comanda devine $graphify, iar in ~/.codex/config.toml trebuie multi_agent = true la sectiunea [features].

Comenzile pe care le folosesti zilnic

• graphify query "intrebare": intoarce doar bucata de graf relevanta.
• graphify path A B: drumul cel mai scurt intre doua elemente, cu increderea celei mai slabe legaturi.
• graphify explain "Nume": toate conexiunile unui concept, cu fisierul si linia de unde vin.

Ca graful sa nu se invecheasca, ai /graphify . --update (reproceseaza doar fisierele modificate) si graphify hook install (reconstruire la fiecare commit si schimbare de branch).

Dupa git pull ruleaza graphify update ., altfel agentul lucreaza pe o harta veche.

De ce Claude Code ignora Graphify si cum rezolvi

Este cea mai frecventa plangere despre Graphify Claude Code in discutiile proiectului: instalezi tot, iar Claude foloseste in continuare grep si Read.

Doua recenzii independente in engleza ajung la aceeasi concluzie: pe task-uri bine delimitate, Claude sare peste graf pentru ca stie deja ce fisiere sa deschida.

• graphify claude install scrie instructiunile in fisierul proiectului si adauga un hook PreToolUse care il impinge pe Claude spre graf inainte de cautari si citiri de fisiere.
• Modul strict: graphify install --project --strict refuza o citire sau o cautare pe sesiune daca agentul nu a interogat graful in ultimele 30 de minute (valoarea implicita). Cautarile prin Bash si Glob raman doar sugestii.
• Prompturi explicite: la intrebarile de arhitectura cere direct "foloseste graphify query pentru...".

Eu nu as activa modul strict din prima zi. Verifica intai ca GRAPH_REPORT.md are continut util: daca raportul e slab, sa il obligi pe Claude sa il citeasca strica lucrul in loc sa il ajute.

Confidentialitate: ce pleaca de pe calculatorul tau

Pentru cine foloseste Graphify Claude Code pe cod de client, cu NDA sau cu date personale, asta e partea cea mai importanta:

• Codul sursa: analizat local, nu paraseste masina. Un proiect doar cu cod se indexeaza si offline, fara API key.
• Audio si video: transcrise local.
• Documente, PDF-uri, imagini: trimise la modelul sesiunii sau la providerul configurat. Le excluzi cu --code-only sau GRAPHIFY_BACKEND=none; cu Ollama ramai complet local.
• Telemetrie: proiectul declara zero telemetrie si zero analytics.
• Jurnalul intrebarilor: fiecare interogare se salveaza in ~/.cache/graphify-queries.log. Il opresti cu GRAPHIFY_QUERY_LOG_DISABLE=1.

Atentie la detectarea automata a providerului: daca ai o cheie API setata in terminal, Graphify o foloseste singur pentru partea semantica.

Daca in documentele din repository sunt date cu CNP-uri, contracte sau facturi ale clientilor, alege explicit backend-ul: din perspectiva GDPR si a unui eventual control ANSPDCP trebuie sa stii exact unde ajung datele. Pentru izolare completa poti rula agentul intr-un Docker Sandbox.

Merita Graphify?

Depinde de marimea si forma proiectului. Graphify are sens cand:

• repository-ul e mare sau e un monorepo;
• preiei un proiect scris de altcineva, de exemplu un ERP sau un magazin online mostenit;
• faci onboarding unui coleg sau o revizuire de arhitectura;
• codul si documentatia stau impreuna (specificatii, PDF-uri, scheme SQL).

Pe un site de prezentare, o aplicatie mica sau un task deja clar, Claude ajunge mai repede singur la fisierele potrivite, iar graful adauga doar pasi si mentenanta.

Regula mea pentru orice skill este cea din ghidul cu cele mai bune skill-uri Claude Code: il instalez doar daca rezolva o problema pe care am masurat-o.

Testul pentru Graphify Claude Code e simplu: construiesti graful, deschizi raportul si te intrebi daca iti spune ceva nou despre proiect.

Graphify, MCP si alternative

Graphify poate rula si ca server MCP (extra-ul graphifyy[mcp]).

Dar graphify install si conexiunea MCP sunt doua integrari diferite, cu instructiuni diferite: alege una ca drum principal. Daca protocolul e nou pentru tine, citeste ce este MCP si cum functioneaza.

Acelasi skill merge pe peste 20 de asistenti: Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Antigravity si altii. Daca inca alegi agentul, vezi comparatia Codex vs Claude Code in Romania.

Si nu uita: un fisier CLAUDE.md bun, cu arhitectura descrisa in cateva randuri, ramane solutia cea mai ieftina.

Cand ai nevoie de ajutor

Daca ai o aplicatie sau un magazin online crescut in ani si vrei sa folosesti agenti AI fara sa pierzi controlul asupra costurilor si datelor, problema nu e lipsa de unelte, ci fluxul. Asta fac in proiectele de automatizari AI pentru firme: pornesc de la codul real si decid ce merita.

Ai un repository in care Claude Code se pierde? Scrie-mi si ne uitam impreuna.