用途：CodeGraph 为 AI 编码代理（Claude Code、Cursor、Codex、Gemini 等）提供语义代码智能，回答“X 如何工作”“修改 X 影响什么”“谁调用了 X”等代码库问题。
主要能力：基于 tree-sitter 解析源码为 AST，提取节点与边，存入本地 SQLite（.codegraph/codegraph.db，支持 FTS5）。支持代码结构查询、符号搜索、调用链追踪（callers/callees）、变更影响分析、框架路由识别（Django/Express/NestJS/Spring/Gin 等 14 个框架）、跨语言桥接（Swift↔ObjC、React Native、Expo Modules）、全文搜索、受影响测试文件追踪（codegraph affected），以及文件监听加防抖的自动同步。支持 20+ 语言。
使用方式：先安装 CLI：curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh；再运行 codegraph install 配置 Agent；进入项目运行 codegraph init -i 初始化索引，之后需重启 Agent 加载 MCP 服务器。MCP 工具包括 codegraph_explore、search、callers、callees、impact、node、files、status。CLI 命令含 install/uninstall、init/uninit、index/sync、status/query/files、callers/callees/impact、affected、serve --mcp、upgrade。
适用场景：理解代码库架构、追踪符号依赖、分析变更影响、查找调用链、审查代码结构、确定受影响测试文件。
限制：不适用于实时调试或运行时动态分析、非文件系统项目、代码编辑生成、CI/CD 流水线管理。每个项目首次使用前必须初始化索引，否则 MCP 工具失败；首次索引可能需数分钟；防抖窗口（默认 2s）内数据可能过时；WSL/Windows 共享检出不要共用同一 .codegraph/，可用 CODEGRAPH_DIR 区分；node_modules、dist、build 等默认排除。所有数据本地存储，无 API 密钥与外部服务。