3 条命令让 AI 助手读懂整个代码库CodeGraph 本地代码知识图谱装完即用【免费下载链接】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/codegraphAI 助手翻遍二十个文件才回答你一个问题又慢又烧 token。CodeGraph 在本地预建整库的符号、调用边与依赖关系让 AI 助手一次查询就拿到精准上下文100% 本地运行、无需 API 密钥。读完这段你已能在自己的项目上跑通 CodeGraph 自动同步让 Claude Code、Cursor 这类助手直接查图。装上 CodeGraph一次查询拿全上下文没有它助手靠 grep、逐个读文件自己重建调用路径一次回答动辄几十次工具调用。有它助手一次codegraph_explore就拿到相关源码、调用路径和影响范围。官方在 7 个真实开源项目上的实测指标传统方式本项目工具调用次数最多 43 次减少 88%回答速度基线平均快 53%Token 消耗基线少 62%成本基线平均省 44%文件读取最多 19 个0 次装完之后你唯一需要记住的事改代码时图谱自动同步索引永远不会过期。部署前看一眼支持的 macOS 与 Windows所有发行版都是自包含构建无需安装 Node.js、无需编译。平台架构安装方式macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm索引数据全部存在本地.codegraph/目录不会离开你的机器。3 条命令跑通 CodeGraph 自动同步幕一装macOS / Linux 在 Terminal 里敲curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh脚本把程序装到~/.codegraph并在~/.local/bin建好codegraph启动链接。Windows 在 PowerShell 里敲irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex已有 Node.js一行备选npm i -g colbymchenry/codegraph⚠️ 安装脚本不会改当前 Shell 的环境变量必须打开新终端再往下走。幕二接在新终端里运行安装器把 MCP 服务接入你的助手codegraph install它会自动检测并配置主流 AI 助手如 Claude Code、Cursor、GitHub Copilot。写入 MCP 配置后重启助手即生效。这一步只接线不索引任何代码。 需要脚本化或 CI非交互参数codegraph install --yes --init自动检测并顺便初始化当前项目--targetcursor,claude指定目标。幕三建进入项目一条命令建库cd your-project codegraph init它会创建本地.codegraph/目录并在同一步构建完整代码图谱。以两万七千文件的 Swift 编译器仓库为例首次索引约 100 秒。之后项目里有了.codegraph/助手检测到就会自动用图无需任何额外设置。改代码前先查影响面改一个函数前先看它会波及谁codegraph impact AuthMiddleware --depth 3直接列出受影响的调用链与半径。跑测试前查哪些测试文件会被你刚改的源码牵动codegraph affected src/user.service.ts按导入依赖传递只圈出真正相关的测试。日常升级与查状态各一条命令codegraph upgrade codegraph status前者原地更新后者打印索引统计和待同步文件。完整命令见 CLI 参考。CodeGraph 怎么保持图谱新鲜文件监听捕获每次增删改原生事件跨平台一致。防抖窗口默认 2 秒把一批编辑合并成一次同步。助手每次连接时做一次快速对账补上离线期间的改动。所以你不需要记任何同步命令保存文件几秒后图谱就是新的。踩坑速查现象直接对解法如果看到command not found说明安装没改当前 Shell打开新终端并确认~/.local/bin在PATH中。如果提示 CodeGraph not initialized先在项目目录里跑一次codegraph init。如果索引慢确认node_modules、dist已被排除默认排除可加--quiet减少输出。如果 MCP 报database is locked多因旧版本未内置运行时重装即可WSL2 中项目放在/mnt/c时建议移到 Linux 原生文件系统。如果 Windows 与 WSL2 共用一个仓库给 Windows 侧设CODEGRAPH_DIR.codegraph-win两边各建独立索引。更多问题见 故障排查。不想留了一条命令卸载codegraph uninstall它会从所有已配置的助手里移除 CodeGraph并删除 CLI 本体删除前先给你看清单。只想拆助手配置、保留 CLI加--keep-cli。单个项目的图谱用codegraph uninit删。回到开头那个翻遍二十个文件的场景——装上 CodeGraph 后助手一次查图就拿到答案token 和调用都降下来了。想弄清图谱怎么解析、符号怎么跨文件关联可以翻一翻 工作原理。【免费下载链接】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），仅供参考