IA by DNACX

#8 no GitHub · Pesquisa e entendimento

Como usar o Graphify no Claude Code: passo a passo

É uma skill do Claude Code. Você digita /graphify numa pasta, ele lê os arquivos (código, textos, PDFs, imagens) e monta um mapa de conceitos e ligações entre eles. O mapa mostra estrutura que você talvez não soubesse que existia.

Para quem
Quem tem uma pasta cheia de material misturado, como documentos, PDFs, anotações, prints e código, e quer um mapa navegável do que está ali sem ler tudo.
Estrelas (02/11/2026)
141.164, #8 no ranking
Licença
Apache 2.0
Repositório
Graphify-Labs/graphify

Passo a passo

Antes de começar: Claude Code instalado; Python 3.10 ou mais novo.

  1. Confira se tem Python 3.10 ou mais novo

    O graphify precisa de Claude Code e de Python 3.10 ou superior. Se o Python não estiver instalado, instale antes de seguir.

  2. Instale o graphify

    Rode o comando abaixo no terminal. São dois comandos em sequência: pip install graphifyy e graphify install. O pacote se chama graphifyy, com dois y, e o comando continua graphify.

    Comando
    pip install graphifyy && graphify install

  3. Abra o Claude Code na pasta que quer mapear

    Vá até a pasta com o material e abra o Claude Code ali. O README diz que pode ser qualquer pasta.

  4. Rode o graphify na pasta

    Digite o comando abaixo dentro do Claude Code. O ponto significa a pasta atual. Ele lê os arquivos, monta o mapa e imprime no fim uma medição de economia de tokens.

    Comando
    /graphify .

  5. Abra o mapa que foi gerado

    O resultado fica numa pasta nova chamada graphify-out. O arquivo graph.html é o mapa interativo, com busca e filtro. O GRAPH_REPORT.md resume os conceitos centrais, as ligações surpreendentes e perguntas sugeridas.

Primeiro teste

Numa sessão do Claude com a skill instalada, cole:

Primeiro teste
/graphify .

O README mostra que o comando cria a pasta graphify-out com graph.html (grafo interativo), GRAPH_REPORT.md (conceitos centrais, conexões surpreendentes e perguntas sugeridas), graph.json (grafo salvo para consultar depois) e cache. Também diz que um benchmark de tokens é impresso a cada execução.

Cuidados

  • O graphify usa o Claude para extrair conceitos de textos e entender imagens (visão). Isso significa que o conteúdo desses arquivos passa pelo Claude e consome o seu uso. O README não informa custo. Para código, ele indica leitura da estrutura (AST, com tree-sitter).
  • O README diz que não precisa de servidor nem de Neo4j. Ele afirma que roda inteiramente local, mas a parte de documentos e imagens depende do Claude, como descrito acima.
  • O ganho de 71,5 vezes menos tokens por consulta é um número do próprio projeto, medido em 52 arquivos (repositórios, artigos e imagens). O README admite que em 6 arquivos o ganho fica perto de 1 vez, porque tudo já caberia na conversa. O valor do mapa nesse caso é a clareza da estrutura.
  • Cada ligação do mapa vem marcada como EXTRACTED (encontrada), INFERRED (deduzida) ou AMBIGUOUS (ambígua). O README diz que assim dá para saber o que foi achado e o que foi chute.
  • No Windows, se o comando graphify não for reconhecido, é preciso colocar a pasta Scripts do Python no PATH. No macOS, se o pip der erro de ambiente gerenciado externamente (externally-managed-environment), o README manda usar pipx.
  • O README descreve opções extras, como um hook do Git que refaz o grafo a cada commit e um modo que acompanha mudanças. Elas não fazem parte do caminho básico e só entram se você pedir.

Como desfazer

O README não explica como remover.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README baixado de Graphify-Labs/graphify tem o selo de CI e o link da instalação manual apontando para outro repositório, safishamsi/graphify. A relação entre os dois não foi confirmada, nem qual é o oficial.
  • O README não descreve o que o comando graphify install grava no computador. A instalação manual mostra um arquivo em ~/.claude/skills/graphify/SKILL.md e uma linha no ~/.claude/CLAUDE.md, mas não confirma que o comando faz o mesmo.
  • O README não diz com que programa abrir o graph.html.
  • O README não diz se é preciso abrir uma sessão nova do Claude Code depois de instalar.
  • O README não informa o custo de uso, nem quanto tempo leva em pastas grandes.
  • O README não explica como desinstalar.

Dúvidas

Funciona só com código?

Não. O README lista código (.py, .ts, .js, .go, .rs, entre outros), textos (.md, .txt, .rst), PDFs e imagens (.png, .jpg, .webp, .gif), incluindo capturas de tela, diagramas e fotos de quadro branco.

Depois da instalação o comando graphify não é reconhecido. E agora?

No Windows, adicione a pasta Scripts do Python ao PATH (ou use pipx install graphifyy, que cuida disso). No macOS, se o pip reclamar de ambiente gerenciado externamente, use pipx install graphifyy.

Preciso rodar tudo de novo quando a pasta mudar?

O README diz que há um cache e que uma nova execução só processa os arquivos que mudaram. Ele também mostra o modo --update, que extrai de novo só o que mudou e junta ao grafo existente.

A DNACX já usou o Graphify?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próxima da lista

← #7 UI UX Pro Max · #9 gstack →

Ver as 15 skills

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de Graphify-Labs/graphify, lido em . A DNACX não rodou cada passo desta página. A skill é de terceiros e a DNACX não a criou.