Quando você pergunta algo sobre um projeto grande, o Claude Code sai abrindo arquivo por arquivo pra entender como as partes se ligam. Cada arquivo lido ocupa espaço na conversa e gasta o seu limite.
O Graphify (github.com/Graphify-Labs/graphify, grátis e open source) lê o projeto uma vez e monta um mapa: cada função, arquivo e conceito vira uma bolinha, e cada ligação entre eles vira uma linha. Depois, o Claude consulta o mapa em vez de reabrir tudo.
6 passosGrátis e open sourceConferido no GitHub e na documentação em 28/10/2026
Entrada
Seu projeto
Código, documentos, PDFs, imagens, vídeos e áudios
Leitura
Graphify
Lê o projeto uma vez
Mapa
graphify-out
Cada parte vira uma bolinha, cada ligação vira uma linha
Consulta
Claude Code
Olha o mapa em vez de reabrir tudo
Tudo aqui foi conferido no GitHub do projeto e na documentação do Claude Code em 28 de outubro de 2026.
Comandos e telas mudam. Na dúvida, confira os links oficiais no fim do guia.
Como ele monta o mapa
O que é lido no seu computador e o que gasta do seu plano.
sem IA · sem custo
Código
É lido no seu computador, sem IA e sem custo.
no seu computador
Vídeos e áudios
Viram texto também no seu computador.
gasta do seu plano
Documentos, PDFs e imagens
Passam pela IA que você já usa no Claude Code, então esses gastam do seu plano.
O passo a passo
Marque cada passo como concluído: o progresso fica salvo e aparece no topo.
01
Confira o que você precisa
Antes de instalar
O Claude Code instalado e funcionando (ele faz parte dos planos Pro, Max, Team e Enterprise do Claude).
O Python 3.10 ou mais novo e o uv, um instalador de programas em Python.
No terminal, este comando mostra a versão do Python:
python3 --version
E este mostra se o uv já está aí:
uv --version
Se faltar alguma coisa, instale com um comando só:
Mac (com Homebrew)
brew install python@3.12 uv
Windows (PowerShell)
winget install astral-sh.uv
Pronto quando: os dois comandos mostram a versão, com o Python em 3.10 ou mais novo.
02
Instale o Graphify
2 comandos, uma vez só
No terminal (no Windows, o PowerShell), rode:
Terminal
uv tool install graphifyy
graphify install
Atenção ao nome: o pacote oficial é graphifyy, com dois y. Os outros pacotes com nome parecido não são do projeto. O comando continua sendo graphify.
O graphify install acha o Claude Code e instala a skill /graphify nele.
Se aparecer "command not found" depois do primeiro comando, rode este, feche e abra o terminal de novo:
uv tool update-shell
Vai mapear PDFs ou vídeos também? Instale com os extras:
uv tool install "graphifyy[pdf,video]"
Pronto quando: os dois comandos rodaram sem erro e a skill /graphify está no Claude Code.
03
Monte o mapa do seu projeto
Dentro do Claude Code
Abra o Claude Code na pasta do projeto e digite:
Claude Code
/graphify .
O ponto quer dizer "a pasta onde eu estou". Quando termina, aparece a pasta graphify-out com 3 arquivos:
graph.html
O mapa pra abrir no navegador. Dá pra clicar em qualquer bolinha, filtrar e buscar. Cada cor é um grupo de coisas que andam juntas.
GRAPH_REPORT.md
O resumo, com as partes mais ligadas do projeto, as conexões que surpreendem e sugestões de perguntas.
graph.json
O mapa completo, que o Claude consulta sem reler os seus arquivos.
Pronto quando: a pasta graphify-out apareceu com os 3 arquivos.
04
Faça o Claude consultar o mapa sempre
Uma vez por projeto
Depois do primeiro mapa, rode isto no terminal, dentro da pasta do projeto:
Terminal
graphify claude install
Ele grava uma configuração que avisa o Claude Code pra olhar o mapa antes de sair buscando e abrindo arquivos um por um. Assim você não precisa lembrar de pedir.
Pronto quando: o comando rodou dentro da pasta do projeto, depois do primeiro mapa.
05
Faça o teste das duas abas
Veja a diferença no seu projeto
Abra duas abas do Claude Code na mesma pasta. Use uma pergunta de verdade sobre o seu projeto, de preferência uma que cruza várias partes.
Na aba 1, pergunte normalmente. Na aba 2, faça a mesma pergunta e acrescente "não use o graphify".
Os dois textos abaixo se atualizam sozinhos
Aba 1
Aba 2
No fim, compare as duas abas:
O resultado muda de projeto pra projeto, e é por isso que o teste vale mais do que qualquer número pronto.
0 de 3 testes ok
06
Os comandos pra saber
Com exemplo
Os que começam com / você digita dentro do Claude Code. Os outros, no terminal.
Troque "Cadastro" e "Pagamento" pelos nomes de verdade do seu projeto: o nome de uma função, de um arquivo ou de um assunto. Os comandos se atualizam sozinhos.
/graphify .
Claude Codemonta o mapa da pasta
/graphify . --update
Claude Coderefaz só o que mudou
/graphify query ""
Claude Codepergunta direto pro mapa
/graphify path "" ""
Claude Codemostra o caminho entre duas partes do projeto
/graphify explain ""
Claude Codeexplica uma parte e tudo que se liga a ela
graphify claude install
Terminalfaz o Claude consultar o mapa sempre
graphify hook install
Terminalrefaz o mapa sozinho a cada commit (cada versão salva no git)
graphify uninstall
Terminaltira o Graphify (com --purge, apaga também a pasta graphify-out)
A lista completa dos comandos do próprio Claude Code (como o /context e o /usage) está na documentação oficial.
Pronto quando: você trocou os exemplos pelos nomes do seu projeto e testou uma pergunta direto pro mapa.
Bônus: perguntas que funcionam bem com o mapa
Copie e cole no Claude Code, dentro da pasta do projeto.
Visão geral
"Lê o GRAPH_REPORT.md e me explica, em palavras simples, como esse projeto está organizado."
Antes de mexer
"Se eu mudar a parte de pagamento, o que mais pode quebrar? Usa o mapa do graphify."
Achar o lugar certo
"Onde fica o código que manda o e-mail de boas-vindas e quem chama ele?"
Privacidade
O código e os vídeos ficam no seu computador. Documentos, PDFs e imagens vão pra IA que você usa no Claude Code. O projeto diz que não coleta dados de uso.
Dica do Ivan Mendes
Abra o graph.html antes de perguntar qualquer coisa. Só de ver os grupos de cores você já entende como o projeto está dividido, e faz perguntas muito melhores pro Claude.
