CodeGraph 装完即战力一条命令建好本地代码知识图谱AI Agent 五分钟接入全链路【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph装完它你的 Agent 不用再逐文件翻代码CodeGraph 是一个本地代码知识图谱一次建好全库符号和调用边一次代码语义检索拿到精准上下文。值不值得装本地知识图谱的 4 项实测数据 官方在 7 个真实开源仓库TypeScript、Python、Rust、Java、Go、Swift 等上的对照实测启用知识图谱后四项指标全部改善对比维度基线启用后工具调用次数单问题最多 43 次减少 88%中位数 2 次平均回答耗时基线快 53%Token 消耗基线少 62%文件读取次数最多 19 个文件0 次数据背后的机制是同一件事没有图谱时Agent 把大部分预算花在「找代码」上——grep、列目录、逐文件读有了图谱一次explore调用直接返回相关源码、符号间的调用路径和影响范围Agent 可以马上开工。唯一的代价是答完问题后窗口里会多驻留约 80% 的检索上下文——那段致密的回答载荷会留在窗口里小窗口跑长会话要预留空间。逐仓库的实测细节见 residual-context-occupancy。环境要求哪些平台能直接装所有发行版都是自包含构建安装包内置运行时无需编译、无原生构建操作系统架构是否需额外依赖macOSIntel x64 / Apple Silicon arm64✅ 仅 npm 路线需本地 Node.js≥20Linuxx64 / arm64✅ 同上Windowsx64 / arm64✅ 同上FreeBSD 等其他系统x64 / arm64❌ 官方无该平台的预构建发行版唯一硬条件是 npm 路线需要本地装有 Node.js版本 ≥20。语言支持按文件扩展名自动识别无需按语言配置TypeScript、Python、Go、Rust、Java、C/C、PHP、Ruby、Swift、Kotlin、Scala、Dart、Vue、Svelte、COBOL、Nix 等 30 多种开箱即用。索引数据全部存在本地.codegraph/目录不离开机器也不需要任何 API 密钥。一条命令装 CodeGraph免编译免构建 这条命令从 npm 仓库拉取colbymchenry/codegraph包并全局安装包自带运行时装完即可用。npm i -g colbymchenry/codegraph可执行文件落在 npm 全局 bin 目录codegraph启动链接随之进入 PATH打开一个新终端运行codegraph version能看到版本号就算装好了。按对象配置接入 Agent、绑定仓库、打开实时索引接入你的 Agent在新终端里运行一次安装器把 CodeGraph 的 MCP 服务器写进你在用的 AgentClaude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity、Kiro、GitHub Copilot一次全局配置覆盖所有项目——它只接线不索引仓库。codegraph install跑完看到输出列出已写入的 Agent 及其 MCP 配置文件重启 Agent 后工具列表里出现codegraph_explore算成功。Agent 已经接好线仓库本身还没有图谱。绑定目标仓库这条命令按项目构建索引在目标仓库创建.codegraph/目录并在同一步建好完整的代码知识图谱仓库越大耗时越长两万七千文件的仓库约 100 秒。cd your-project codegraph init跑完看到输出显示构建完成、仓库下生成.codegraph/codegraph.db算成功——此后任何 Agent 打开这个项目都会自动用上图谱工具无需额外设置。图谱建好了剩下的顾虑是改完代码它会不会过期。打开实时索引自动同步默认开启零配置原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次文件增删改2 秒防抖窗口把一批改动合并为一次同步单文件编辑重同步约 4 秒Agent 重连时还会再对账一次补上离线期间的改动。codegraph status保存任意源码文件、等几秒后跑上面那条命令输出显示索引统计且没有 Pending sync 段落说明图谱和最新代码一致算成功。日常高频命令装完最常用到的几条codegraph explore 登录流程是怎么走的— 一次返回相关源码 调用路径 影响范围输出与 MCP 工具一致codegraph impact symbol— 重构前先看这个符号改动会波及哪些代码codegraph affected src/utils.ts— 提交前找出该跑哪些测试文件codegraph query UserService— 按符号名全库检索codegraph upgrade— 一键升级到最新版自动识别你的安装方式codegraph telemetry off— 关闭匿名使用统计也可用环境变量DO_NOT_TRACK1禁用踩坑排查五个最常见的症状⚠️ 均按「症状 → 原因 → 解法」给出codegraph: command not found→ npm 全局 bin 目录不在当前 shell 的 PATH 里 → 用npm config get prefix定位安装前缀把其下的bin目录加入 PATH。提示 CodeGraph not initialized→ 这个项目还没执行过 init 命令 → 到项目目录下跑一遍前面那条codegraph init。MCP 报database is locked→ 老版本0.9 之前缺内置运行时或文件系统无法启用 WAL → 先执行前面提到的 upgrade 命令仍复现就把项目连同.codegraph/移到本地磁盘。查不到某个符号→ 文件位于默认排除目录或被.gitignore覆盖 → 确认文件位置后误被忽略的真实源码可用codegraph.json的include强制纳入。WSL2 与 Windows 共用同一仓库锁冲突→ 两边指向同一个.codegraph/跨 OS 锁不可靠 → Windows 侧设置CODEGRAPH_DIR.codegraph-win建独立索引。再往下走图谱是怎么工作的全链路已经跑通Agent 现在会先查图谱再作答。想弄清符号和调用边如何跨文件解析读 知识图谱 与 工作原理。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考