codegraph
SHA-256面向 AI 编码助手的预索引代码知识图谱,自动同步代码变更,减少 58% 工具调用,100% 本地运行。
给 AI 编程工具装上“代码导航地图”,省 token、省时间、省费用。
核心功能
- 自动构建代码知识图谱(符号、调用关系、模块依赖)
- 文件变更时自动同步,无需手动重新索引
- 作为 MCP 服务器集成,支持 Claude Code、Cursor、Codex 等 8 大 AI 代理
- 一键安装,自带运行环境,无需 Node.js
- 100% 本地运行,代码不出本机
避坑指南
- •安装后需要打开新终端才能使用 codegraph 命令,因为安装器不会修改当前 shell 的 PATH
- •codegraph install 是连接 AI 代理的独立步骤,仅安装 CLI 不会自动启用图谱功能
- •卸载时不会清除项目索引文件,如需完全退出请手动删除 .codegraph/ 目录
- •目前不支持远程仓库或云同步,图谱完全存储在本地
适用场景
- 在使用 AI 编码助手(如 Claude Code)进行大型代码库重构或理解时,减少 token 费用和等待时间
- 团队持续集成中,自动维护代码知识图谱,辅助 PR 代码审查和影响分析
详细介绍
CodeGraph 是一个本地优先的代码知识图谱,专为增强 Claude Code、Cursor、Codex、Gemini 等 AI 编码助手而设计。传统方式下,AI 代理需要通过 grep、glob 和文件读取来理解代码库,消耗大量 token。CodeGraph 预先构建了代码中符号关系、调用层次和模块依赖的图谱,并在你编辑文件时自动同步。基于 7 个真实开源项目(VS Code、Django、Tokio、Alamofire 等)的基准测试,平均降低 16% 成本、减少 47% token 消耗、提速 22%、减少 58% 工具调用。与 ripgrep、Sourcegraph 等通用代码搜索工具不同,CodeGraph 直接作为 MCP 服务器集成,无需为每个代理单独配置,完全离线运行。非常适合希望大幅削减 AI 编码成本同时保持代码深度理解的开发者。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
打开终端,运行一键安装命令(macOS/Linux 或 Windows 各一条命令)
安装完成后,在新终端中运行 codegraph install,自动将 CodeGraph 连接到已安装的 AI 代理
进入项目目录,运行 codegraph init 构建代码图谱(只需一次)
- 打开终端,运行一键安装命令(macOS/Linux 或 Windows 各一条命令)
- 安装完成后,在新终端中运行 codegraph install,自动将 CodeGraph 连接到已安装的 AI 代理
- 进入项目目录,运行 codegraph init 构建代码图谱(只需一次)
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
d45a068f44596a85c7ba7d0ef924eaf7103fbbf3cafbeb668127daff60a52228该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
运行 codegraph uninstall 即可移除 CodeGraph 在所有已配置 AI 代理中的集成。项目索引文件(.codegraph/ 目录)不会被删除,如需清理每个项目,可手动执行 codegraph uninit 或直接删除目录。
无额外依赖
下载后即可直接使用,无需安装其他运行环境