Was ist CodeGraph?
CodeGraph zerlegt ein Repository in einen lokalen SQLite-Graphen aus Symbolen, Aufrufen, Imports und Vererbung und stellt ihn Coding-Agenten über MCP bereit. Standardmäßig listet der Server ein einziges Tool, codegraph_explore, das in einem Aufruf den relevanten Quellcode nach Dateien gruppiert, die Aufrufpfade zwischen Symbolen und eine Blast-Radius-Zusammenfassung liefert. Sieben engere Tools (node, search, callers, callees, impact, files, status) bleiben über die Umgebungsvariable CODEGRAPH_MCP_TOOLS oder als CLI-Befehle verfügbar, und codegraph affected listet die Testdateien auf, die ein Diff berührt.
Das Parsen läuft für 20 Sprachen in einem Rust-Kern, insgesamt sind 34 aufgeführt, von TypeScript und Python bis COBOL, Terraform und Nix, dazu Routenerkennung für 17 Web-Frameworks. Ein Datei-Watcher aktualisiert den Graphen etwa zwei Sekunden nach jedem Speichern, und weder ein LLM noch ein API-Schlüssel ist beteiligt. codegraph install bindet neun Agenten an, darunter Claude Code, Cursor, Codex CLI, Gemini CLI und GitHub Copilot; codegraph init indexiert jedes Projekt.
Das im Januar 2026 angelegte Repo hat rund 75.400 Sterne und steht unter der MIT-Lizenz. Das neueste Release ist v1.6.2 vom 3. Oktober 2026, und das npm-Paket verzeichnete in der Woche bis zum 22. Oktober etwa 77.000 Downloads. Ein gehostetes Produkt für Pull-Request-Analysen steht unter getcodegraph.com auf einer Warteliste, Preise sind nicht veröffentlicht.
CodeGraph installieren
npx @colbymchenry/codegraph && codegraph initLohnt sich CodeGraph?
CodeGraph löst das Problem, an dem die meisten Code-Graphen kranken: Sie veralten. Sein Watcher synchronisiert geänderte Dateien etwa zwei Sekunden nach dem Speichern neu, Tool-Antworten markieren jede Datei, die noch auf die Synchronisierung wartet, und ein neu verbundener Server holt Änderungen nach, die gemacht wurden, während er aus war, etwa durch einen git pull. GitNexus braucht dafür --watch oder seine Enterprise-Stufe, und Graphify, das wir unter Repos besprechen, ist nach einem Pull veraltet, bis du ein Update ausführst.
Der Benchmark des Maintainers ist für einen selbst berichteten ungewöhnlich sorgfältig. Claude Opus 4.8 beantwortete auf jedem von sieben Open-Source-Repos eine Architekturfrage, vier Durchläufe pro Arm, wobei die codegraph-CLI in beiden Armen gesperrt war, nachdem ein früheres Harness den Kontrollarm in 26 von 28 Durchläufen darauf zugreifen ließ. Die Mediane: 88 % weniger Tool-Aufrufe, 62 % weniger Tokens und 44 % geringere Kosten. Die Streuung zählt mehr als der Durchschnitt. Bei VS Code machte der Agent 2 statt 28 Aufrufe und gab 0,53 $ statt 1,80 $ aus; bei Gin, einem kleinen Go-Projekt, lagen die Kosten gleichauf bei 0,31 $. Das README räumt auch den gegenteiligen Effekt ein: Die dichten Antworten von CodeGraph lassen am Ende einer Sitzung etwa 80 % mehr abgerufenen Text im Kontextfenster liegen, 67.000 Tokens gegenüber 18.000 bei VS Code.
Die schmale Oberfläche ist Absicht. Ein einziges gelistetes Tool lenkt Agenten besser als ein Menü, argumentiert der Maintainer, und es ist schreibgeschützt, sodass nichts im MCP-Server Code bearbeitet. Das heißt aber auch: keine Umbenennung mit Vorschau, keine rohen Graph-Abfragen und kein Datenfluss auf Anweisungsebene, was GitNexus alles bietet. GitNexus liest tiefer; die MIT-Lizenz von CodeGraph erlaubt einem Unternehmen den Einsatz schon heute, während GitNexus selbst für einen Pilotversuch einen kommerziellen Vertrag braucht.
Zwei Standardeinstellungen verdienen Aufmerksamkeit. Anonyme Nutzungstelemetrie ist eingeschaltet, sofern du sie nicht im Installer, mit codegraph telemetry off oder mit DO_NOT_TRACK=1 abschaltest; die dokumentierten Felder schließen Code, Pfade und Abfragen aus. Der Installer schreibt außerdem MCP-Konfiguration, Auto-Allow-Berechtigungen für Claude Code und einen durch Markierungen eingefassten Abschnitt in CLAUDE.md oder AGENTS.md. Agenten nutzen das Tool nicht immer: Ein Issue aus dem Juli berichtet, dass Claude Code trotzdem grept, und die Abhilfe ist die alwaysLoad-Einstellung, die jetzt im README steht.
Das Projekt liefert schnell und hat einen entsprechenden Rückstau: rund 140 offene Issues und 400 offene Pull Requests. Der Viewer codegraph ui steht in der Dokumentation, doch Nutzer von 1.6.0 melden "unknown command" in einem Issue, das seit September offen ist. Eine Suche in der offiziellen MCP-Registry findet andere Projekte namens CodeGraph und keines aus diesem Repo. Prüfe daher vor der Installation den npm-Namen, @colbymchenry/codegraph.
Wo es sich lohnt
Ein Backend-Entwickler in einem TypeScript-Monorepo mit 11.000 Dateien
Verhindern, dass der Agent Dutzende Dateien durchgrept, bevor er einen Ablauf erklären kann
Einmal npx @colbymchenry/codegraph ausführen, dann codegraph init im Repo, und alwaysLoad setzen, damit Claude Code codegraph_explore ab dem ersten Prompt sieht. Im VS-Code-Benchmark des README senkte das eine Frage von 28 Tool-Aufrufen auf 2; plane in langen Sitzungen den größeren Kontextbedarf ein.
Eine Platform Engineer in einem SaaS-Unternehmen mit 30 Entwicklern
In der CI nur die Tests ausführen, die eine Änderung betreffen kann
git diff --name-only an codegraph affected --stdin --quiet weiterreichen und das Ergebnis dem Test-Runner übergeben. Standardmäßig folgt es Imports bis zu einer Tiefe von 5, sodass Tests, die über Dependency Injection oder Reflection erreicht werden, durchrutschen können; behalte einen nächtlichen Volllauf bei.
Ein Engineering-Manager, der einen Agenten im ganzen Team einführt
Allen Entwicklern denselben Code-Kontext geben, ohne Lizenzverhandlung
MIT bedeutet anders als bei GitNexus keinen kommerziellen Vertrag. codegraph install --yes im Dev-Container-Image verwenden und dort CODEGRAPH_TELEMETRY=0 setzen, falls es ein Problem ist, dass Nutzungsstatistiken Firmenrechner verlassen. Das gehostete PR-Produkt gibt es nur über die Warteliste, es gibt also keinen Anbietervertrag zu unterschreiben und keinen Preis zu vergleichen.
Bevor du dich festlegst
- Einrichtung
- Der Shell- oder PowerShell-Installer bringt eine eigene Runtime mit, alternativ npm i -g @colbymchenry/codegraph; codegraph install konfiguriert Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity, Kiro und GitHub Copilot, danach baut codegraph init den Graphen jedes Projekts. Laut README dauert ein frischer Index des Swift-Compiler-Repos mit 27.000 Dateien etwa 100 Sekunden.
- Integrationen
- Standardmäßig ein MCP-Tool (codegraph_explore) über stdio; node, search, callers, callees, impact, files und status lassen sich mit CODEGRAPH_MCP_TOOLS wieder aktivieren. Alle sind schreibgeschützt. Dieselben Funktionen gibt es als CLI-Befehle und als Node-API (Node 22.5+ bei Einbettung).
- Daten und Datenschutz
- Code, Graph und Suchen bleiben lokal in .codegraph/codegraph.db. Die Telemetrie sendet tägliche Zählungen von Befehlen, Agenten und indexierten Sprachen, sofern sie nicht deaktiviert ist, und der Server prüft einmal am Tag auf GitHub, ob es eine neue Version gibt. Es sind keine Sicherheitshinweise veröffentlicht; npm-Pakete und Release-Bundles tragen seit Juli 2026 Provenance-Attestierungen.
- Kosten im großen Maßstab
- Kostenlos; die Kosten sind Rechenzeit. Laut README wird der Linux-Kernel (70.000 Dateien) auf einem VPS mit 2 Kernen und 6 GB in unter 12 Minuten indexiert, und eine Änderung an einer Datei synchronisiert sich im Swift-Repo in etwa 4 Sekunden neu. Keine Hosting-Gebühren, bis die Plattform auf der Warteliste Preise festlegt.
- Grenzen
- Dateien über 1 MB und per gitignore ausgeschlossene Pfade werden übersprungen. Die statische Analyse übersieht Laufzeit-Dispatch und Reflection: Die dateiübergreifende Abdeckung liegt bei 73,8 % für Liquid und 83,3 % für Spring-Routen. WSL2-Projekte auf /mnt-Laufwerken haben Probleme mit Sockets und Locking, und pro Projekt ist nur ein Schreiber erlaubt.
Was gut ist
- Der Graph synchronisiert sich etwa zwei Sekunden nach jedem Speichern neu
- MIT-Lizenz; kein LLM, kein API-Schlüssel und kein Netzwerkdienst für die Indexierung
- Schreibgeschützte MCP-Oberfläche mit standardmäßig einem Tool
- Sorgfältiger selbst berichteter Benchmark, auch dort, wo es mehr Kontext kostet
Was nicht
- Anonyme Telemetrie standardmäßig eingeschaltet
- Anders als GitNexus keine Umbenennung, keine rohen Abfragen und keine Datenflussanalyse
- Antworten lassen in langen Sitzungen mehr Text im Kontextfenster liegen
- Rund 400 offene Pull Requests; der dokumentierte ui-Befehl fehlt in den Releases
Am besten für
Teams, die ihren Coding-Agenten aus einem stets aktuellen lokalen Code-Graphen antworten lassen wollen, unter einer Lizenz, die ihr Arbeitgeber akzeptiert.
Alternativen zu CodeGraph
CodeGraph: häufige Fragen
- Lohnt sich CodeGraph?
- Ein Code-Graph, der sich selbst aktuell hält und den ein Unternehmen unter MIT einsetzen kann, auch wenn er weniger tief liest als GitNexus und nach Hause telefoniert, solange man es ihm nicht verbietet. Wir bewerten es mit 4.1 von 5.
- Was kostet CodeGraph?
- Kostenlos und MIT-lizenziert. Eine gehostete Plattform für Pull-Request-Analysen ist als Beta mit Warteliste unter getcodegraph.com verfügbar; Preise sind nicht veröffentlicht.
- Welche Nachteile hat CodeGraph?
- Anonyme Telemetrie standardmäßig eingeschaltet; Anders als GitNexus keine Umbenennung, keine rohen Abfragen und keine Datenflussanalyse; Antworten lassen in langen Sitzungen mehr Text im Kontextfenster liegen; Rund 400 offene Pull Requests; der dokumentierte ui-Befehl fehlt in den Releases.
- Für wen eignet sich CodeGraph?
- Teams, die ihren Coding-Agenten aus einem stets aktuellen lokalen Code-Graphen antworten lassen wollen, unter einer Lizenz, die ihr Arbeitgeber akzeptiert.
- Was kostet CodeGraph für ein Team oder im Produktivbetrieb?
- Kostenlos; die Kosten sind Rechenzeit. Laut README wird der Linux-Kernel (70.000 Dateien) auf einem VPS mit 2 Kernen und 6 GB in unter 12 Minuten indexiert, und eine Änderung an einer Datei synchronisiert sich im Swift-Repo in etwa 4 Sekunden neu. Keine Hosting-Gebühren, bis die Plattform auf der Warteliste Preise festlegt.
- Ist CodeGraph sicher für Firmendaten?
- Code, Graph und Suchen bleiben lokal in .codegraph/codegraph.db. Die Telemetrie sendet tägliche Zählungen von Befehlen, Agenten und indexierten Sprachen, sofern sie nicht deaktiviert ist, und der Server prüft einmal am Tag auf GitHub, ob es eine neue Version gibt. Es sind keine Sicherheitshinweise veröffentlicht; npm-Pakete und Release-Bundles tragen seit Juli 2026 Provenance-Attestierungen.
- Was sind die besten Alternativen zu CodeGraph?
- Die nächsten Alternativen, die wir getestet haben, sind GitNexus, code-review-graph, Serena, Semble und Project RAG.
Antworten geprüft am 26. Okt. 2026.