CodeGraph – lokální znalostní graf kódu pro AI agenty

Toto je starší verze dokumentu!

Vytvořeno: 30.7.2026 | Aktualizováno: 30.07.2026 13:12

CodeGraph je lokální nástroj, který vytváří sémantický graf zdrojového kódu a zpřístupní ho AI coding agentům přes MCP. Agent tak místo postupného procházení souborů získá relevantní symboly, úryvky kódu, cesty volání a dopad změny.

Praktické představení je ve videu How To Save 90% of Claude Code Token Usage.

CodeGraph analyzuje zdrojové soubory, vytváří graf symbolů a jejich vztahů a ukládá jej lokálně do adresáře .codegraph/. Index vytváří program s vlastním Rust kernelem; nepoužívá k tomu LLM ani AI tokeny.

AI agent pracuje až s hotovým grafem přes MCP. Při dotazu může použít například nástroj codegraph_explore a dostat vybraný kontext pro konkrétní úkol místo opakovaného hledání přes grep a čtení celých souborů.

Největší náklad AI agenta při práci ve větším repozitáři často není vlastní změna kódu, ale zjišťování souvislostí: hledání názvů, otevírání souborů, rekonstrukce cest volání a dohledávání závislostí. Každý takový krok přidává tool call a jeho výstup do kontextu.

CodeGraph tento průzkum zkracuje na několik cílených dotazů. Úspora vzniká z menšího množství přečteného kódu a méně volání nástrojů, ne z levnějšího vytváření indexu.

Projekt uvádí vlastní benchmark na sedmi open-source repozitářích: v průměru o 69 % méně tokenů, o 89 % méně tool callů a o 60 % nižší náklady. Nejde o nezávislé měření a přínos není stejný všude: pro rozsáhlý nebo provázaný repozitář je výraznější než pro malý projekt.

Úspora také závisí na tom, zda agent používá CodeGraph přímo. Pokud místo toho dál prochází soubory přes Read a grep, graf mu nepomůže tolik.

Instalační skript stáhne binární CLI pro daný systém. Před spuštěním je vhodné zkontrolovat jeho obsah a důvěryhodnost zdroje.

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

Poté je potřeba otevřít nový terminál, aby byl příkaz codegraph dostupný v PATH, a propojit CLI s používanými agenty:

codegraph install

Příkaz automaticky nastavuje MCP server pro podporované klienty, mezi které patří Claude Code, Codex CLI, OpenCode, Cursor a Gemini CLI. Pro každý repozitář se graf vytvoří samostatně:

cd muj-projekt
codegraph init

Po inicializaci CodeGraph sleduje změny souborů a graf průběžně synchronizuje. Platí to i pro změny vytvořené AI agentem nebo po git pull. Synchronizace je lokální operace nad změněnými soubory; nezpůsobuje spotřebu tokenů ani volání modelu.

Ve výchozím nastavení se změny krátce seskupí a pak se index aktualizuje. Stav lze ověřit příkazem:

codegraph status

V prostředí bez běžícího watcheru, například při nastavení CODEGRAPH_NO_DAEMON=1, je možné index synchronizovat ručně:

codegraph sync

Vytvoření a aktualizace indexu vyžadují lokální CPU, paměť a diskový prostor; u velkého repozitáře tedy nejsou zdarma z pohledu výkonu, ale nejde o náklad na LLM. Projekt uvádí, že kód a index zůstávají lokálně a nevyžaduje API klíč. Anonymní telemetrii lze vypnout: