CodeGraph funciona com Claude Code, Cursor, Codex e Copilot? Veja a lista de agentes suportados

Ferramenta nova só entra no fluxo se ela conversar com o agente que já está aberto na sua tela, senão vira só mais uma coisa pra manter

O CodeGraph da vez é o projeto open source colbymchenry/codegraph: um grafo de conhecimento do seu código, já pré-indexado, que fica disponível pro agente consultar em vez de ele sair lendo arquivo por arquivo até achar o que interessa

E a resposta pra pergunta do título é ampla: os quatro estão cobertos, e ainda sobra lista 🙂

Bora ver quem está dentro?

Lista completa de agentes suportados pelo CodeGraph

A página oficial de integrações lista nove alvos que o instalador detecta e configura automaticamente:

• Claude Code
• Cursor
• Codex CLI
• opencode
• Hermes Agent
• Gemini CLI
• Antigravity IDE
• Kiro
• GitHub Copilot

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

A própria descrição do repositório repete quase a mesma lista na tagline: "Pre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, and Hermes Agent: fewer tokens, fewer tool calls, 100% local"

Repara numa coisa: o GitHub Copilot não aparece nessa frase

Ele entrou depois, registrado no CHANGELOG do projeto, e por isso ainda gera dúvida em quem só bate o olho na capa do repo

Essa pergunta de compatibilidade virou rotina em ferramenta nova, é a mesma dúvida de quais CLIs o OpenDesign aceita: antes de instalar, o dev quer saber se aquilo encaixa no setup que ele já tem montado

Como o CodeGraph se conecta a esses agentes: tudo passa por MCP

Agora o porquê da lista ser tão grande

O CodeGraph não escreve um plugin pra cada IDE, ele roda como servidor MCP

Que MCP? Model Context Protocol, o protocolo que padroniza como um agente conversa com ferramentas externas

Ou seja: quem fala MCP entra na festa

É como energia elétrica com padrão de tomada: você não precisa de um adaptador diferente por aparelho, todo mundo pluga no mesmo lugar

A ferramenta principal exposta pro agente é a codegraph_explore, e normalmente basta uma chamada dela: ela devolve o código-fonte literal dos símbolos relevantes pra pergunta que foi feita

As outras ferramentas ficam não listadas por padrão, pra não poluir o contexto do agente, e podem ser reativadas pela variável de ambiente CODEGRAPH_MCP_TOOLS

Sacou a lógica? A compatibilidade não é caso a caso, é consequência do protocolo

GitHub Copilot: três superfícies configuradas de uma vez

Esse é o caso mais recente e o mais perguntado

O comando codegraph install configura três superfícies do Copilot de uma vez só:

• copilot-vscode: o Copilot Chat no VS Code
• copilot-cli: o GitHub Copilot CLI
• copilot-jetbrains: o plugin do Copilot nas IDEs JetBrains

O que já existe na sua máquina é detectado sozinho, igual acontece com os demais agentes

Entradas MCP que já estavam nos seus arquivos de config são preservadas, então ele não passa por cima do que você configurou na mão

E se não rolar, o codegraph uninstall reverte a configuração

Tome cuidado com um detalhe bobo que derruba muita gente: é preciso reiniciar o VS Code ou a IDE JetBrains pro Copilot enxergar o servidor

Se você instalou e o agente age como se nada tivesse acontecido, começa por aí antes de sair caçando bug

O que o instalador faz em cada agente (e por que isso importa)

"Suportado" não significa exatamente a mesma coisa em todo lugar

O trabalho que o instalador faz muda conforme o formato de config de cada alvo:

Isso importa por um motivo prático: você sabe qual arquivo do seu projeto vai mudar depois de rodar o comando

E, sim, no Cursor e no Kiro é só a config MCP mesmo

Como conectar o CodeGraph ao seu agente

São duas etapas que a galera costuma confundir: conectar os agentes é uma coisa, indexar o projeto é outra

Vamos por partes

1. Instale a CLI global via npm:

npm install -g @colbymchenry/codegraph

Não tem Node.js na máquina? No macOS e no Linux dá pra usar o script:

curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

2. Conecte os agentes com o install:

codegraph install

Esse comando auto-detecta os agentes suportados e configura cada um deles

O erro comum deste passo: achar que o install já indexou seu código

Ele só conecta, não constrói grafo nenhum, e um install global já cobre todos os seus projetos

E tem o atalho de quem não quer instalar a CLI antes: dá pra rodar o instalador direto pelo npx, escolhendo os agentes na interface interativa

npx @colbymchenry/codegraph

Se liga nisso: esse comando É o passo 2 rodando sem CLI instalada, ele não é uma via alternativa de instalar a CLI

Ou seja, quem foi por aqui não precisa rodar o codegraph install depois, os agentes já saem configurados

Ele pergunta se as configs valem pra todos os projetos ou só pro atual, então leia antes de sair apertando enter no modo next, next e finish

3. Indexe o projeto com o init, dentro da pasta do repo:

codegraph init

Aqui sim ele cria o diretório local .codegraph/ e constrói o grafo

O erro comum deste passo: esquecer que o init roda uma vez por projeto, diferente do install

Depois de conectar: o grafo se atualiza sozinho e não sai da sua máquina

A segunda dúvida de quem vai adotar é sempre a mesma: e quando o código muda, tenho que reindexar na mão?

Não

O auto-sync vem ligado por padrão

O servidor MCP do CodeGraph sobe um file watcher nativo do sistema operacional na raiz do projeto (FSEvents no macOS, inotify no Linux, ReadDirectoryChangesW no Windows) e atualiza o grafo a cada criação, modificação ou exclusão de arquivo

Repara que isso não vira um terceiro comando na sua lista: o watcher vem junto do servidor MCP, aquele mesmo que o seu agente já conversa depois do install

Inclusive nas edições feitas pelo próprio agente, que é justamente quando o índice desatualizado mais atrapalha

E pra não surtar durante uma rajada de edições, um timer de debounce agrupa tudo num sync só

Sobre privacidade, o dado é bem direto: fica tudo local

O banco é um SQLite dentro do projeto, em .codegraph/codegraph.db, com busca full-text FTS5, usando o node:sqlite nativo em modo WAL

Quando um agente conecta por MCP, o CodeGraph anuncia cobertura de mais de 30 linguagens, entre elas TypeScript/JavaScript, Python, Go, Rust, Java, C#, C/C++, PHP, Ruby, Swift e Kotlin

Vale conectar ao seu setup? O que os números dizem (e o que ainda está em aberto)

Aqui é onde eu prefiro ser chato e separar o que é documentação do que é promessa

O benchmark oficial está no README e foi remedido em 05/08/2026, com o Claude Opus 4.8 respondendo perguntas de arquitetura com e sem o CodeGraph:

A composição do teste é razoável: sete bases open source reais em sete linguagens (VS Code, Excalidraw, Django, Tokio, OkHttp, Gin, Alamofire)

Mas tem contraponto, e ignorar isso seria zoado

O post "I Tested CodeGraph on Hono. The Tool-Call Savings Reproduce, the Cost Savings Don’t", da HarrisonSec, reproduziu a economia de chamadas de ferramenta e não reproduziu a economia de custo

Ou seja: a parte de "o agente para de tatear o repositório" se sustentou fora da casa do autor, a parte de conta menor no fim do mês ficou em aberto

O veredito honesto então é esse… a compatibilidade é ampla e está documentada, o ganho de custo merece medição no SEU repositório antes de virar argumento

E isso vale mais ainda pra quem já faz a conta de quanto cada agente custa por mês: economia de token é a métrica que você consegue observar no próprio uso, não precisa acreditar em ninguém

Cuidado com o homônimo: existe mais de um projeto chamado CodeGraph

Sintoma: você busca CodeGraph, cai num repositório, roda o comando da documentação e nada bate

Causa: o nome é disputado

Existe pelo menos o codegraph-ai/CodeGraph, que é outro software (42 ferramentas MCP, 38 linguagens, extensão pro VS Code), e o websines/codegraph-mcp, que também é outro projeto

Nenhum dos dois é o colbymchenry/codegraph

Solução e prevenção: antes de rodar qualquer comando, confere se você está no repositório github.com/colbymchenry/codegraph e na documentação em colbymchenry.github.io/codegraph

Tudo que está neste artigo, a lista de agentes suportados inclusive, vale só pra esse projeto

Conclusão: seu agente provavelmente já está na lista

Recapitulando pra fechar

Os quatro agentes da pergunta do título estão cobertos: Claude Code, Cursor, Codex e GitHub Copilot

E ainda entram Gemini CLI, opencode, Antigravity IDE, Kiro e Hermes Agent, porque o denominador comum não é IDE, é o MCP

Próximo passo concreto, se você quiser tirar a prova hoje: roda o npx @colbymchenry/codegraph pra ver quais agentes ele detecta na sua máquina, faz o codegraph init no projeto e mede no seu próprio repositório se a economia se confirma no seu caso

Até o próximo post! 😀