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 ↓
Antes de começar

O que você precisa

  • Claude Code funcionando, um terminal e acesso a um repositório local que você pode analisar.
  • uv instalado para adicionar o CLI como ferramenta isolada.
  • Permissão para alterar a configuração do Claude Code e o CLAUDE.md do repositório.
01 / Passo a passo

Instale e gere o mapa

  1. 1. Instale o CLI no terminal

    Com uv disponível, execute:

    Terminal · instalar Graphify
    uv tool install graphifyy
  2. 2. Registre a integração com Claude Code

    Ainda no terminal, instale a skill /graphify para o Claude Code:

    Terminal · integrar com Claude Code
    graphify install
  3. 3. Configure o seu repositório

    Entre na pasta raiz do projeto no terminal e execute o comando abaixo. Ele adiciona orientações ao CLAUDE.md e hooks para sugerir a consulta ao grafo.

    Terminal · dentro do repositório
    graphify claude install
  4. 4. 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 .
02 / Resultado local

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.
03 / Exemplo fictício

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:

Exemplo · consulta ao grafo no terminal
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.

04 / Critério de uso

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.

05 / Dúvidas frequentes

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.

Terminal · atualizar PATH
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.

Fontes oficiais · conferidas em 09/11/2026

Continue pela documentação

Acompanhe meus estudos

@brunopaim.dev

© 2026 Bruno Paim. Engenharia de software, IA e produtos digitais.