Material prático · Graphify + Claude Code
Um mapa do seu código para orientar o Claude Code
O Graphify cria um grafo local das relações entre arquivos, funções e outros elementos do projeto. O Claude Code pode consultá-lo para investigar perguntas que atravessam vários arquivos.
Ver instalação ↓O que você precisa
- Claude Code funcionando, um terminal e acesso a um repositório local que você pode analisar.
uvinstalado para adicionar o CLI como ferramenta isolada.- Permissão para alterar a configuração do Claude Code e o
CLAUDE.mddo repositório.
Instale e gere o mapa
1. Instale o CLI no terminal
Com
uvdisponível, execute:Terminal · instalar Graphifyuv tool install graphifyy2. Registre a integração com Claude Code
Ainda no terminal, instale a skill
/graphifypara o Claude Code:Terminal · integrar com Claude Codegraphify install3. Configure o seu repositório
Entre na pasta raiz do projeto no terminal e execute o comando abaixo. Ele adiciona orientações ao
CLAUDE.mde hooks para sugerir a consulta ao grafo.Terminal · dentro do repositóriographify claude install4. Abra o Claude Code no projeto
Em uma sessão do Claude Code aberta na raiz do repositório, digite o comando. O ponto indica o diretório atual.
Sessão do Claude Code · gerar grafo/graphify .
Onde fica o grafo
Depois da geração, procure a pasta graphify-out/ na raiz do repositório:
graph.html· visualização interativa para abrir no navegador.GRAPH_REPORT.md· destaques e perguntas sugeridas.graph.json· dados do grafo usados nas consultas.
Faça uma pergunta que cruza arquivos
Exemplo de pergunta ao Claude Code: “Se eu alterar a validação de login, quais partes do projeto podem ser afetadas? Consulte o grafo e indique as evidências antes de concluir.”
Se quiser consultar pelo terminal, experimente esta pergunta genérica e adapte-a ao seu projeto:
graphify query "Quais partes do projeto participam da validação de login e o que depende delas?"“Validação de login” é apenas um cenário ilustrativo. Nenhum arquivo ou função do seu repositório foi analisado aqui.
Quando vale usar
O grafo pode ajudar em projetos grandes ou desconhecidos, especialmente quando a dúvida envolve chamadas, dependências ou documentação espalhadas por vários arquivos. Para uma alteração localizada em um arquivo que você já conhece, uma busca direta costuma bastar.
Sobre tokens: economia não é garantida. O resultado depende da pergunta, do tamanho e da estrutura do projeto e de como o Claude Code usa o grafo.
Se algo não aparecer
graphify: command not found
O diretório de ferramentas do uv pode não estar no PATH. Execute o comando abaixo e abra um novo terminal antes de tentar graphify install novamente.
uv tool update-shell O comando /graphify não aparece?
Confira se a skill foi instalada em ~/.claude/skills/graphify/SKILL.md e inicie uma nova sessão do Claude Code. No repositório, confirme também a seção Graphify em CLAUDE.md.
Preciso instalar um servidor MCP?
Não para este fluxo. A documentação descreve a skill e o CLI como configuração padrão; o servidor MCP é opcional.
Continue pela documentação
- Graphify + Claude Code · integração oficial ↗
Instalação, arquivos gerados, consulta ao grafo e solução de problemas.
- Graphify vs Claude Code · quando usar ↗
Cenários em que um grafo pode ajudar e limites da economia de tokens.