codegraph简介
AI/ML
CodeGraph 是一个本地运行的代码知识图谱引擎,专为 AI 编程助手(如 Claude Code、Cursor、GitHub Copilot 等)设计。它通过静态分析将项目中的符号、调用关系和依赖项构建为完整的语义图谱,让 AI 代理无需逐文件搜索即可一次性获取精准的代码上下文。
它解决了 AI 编程助手在理解大型代码库时工具调用频繁、Token 消耗巨大且响应缓慢的问题。通过预建索引和 MCP 协议集成,AI 代理只需一次查询就能获得相关源码、调用链路及变更影响范围,大幅降低 Token 开销并提升回答速度。
亮点特性
01Rust 内核驱动
20+ 种语言的解析与提取均在 Rust 原生引擎中完成,支持按机器实际核心数和内存自适应调度并发任务
02极低 Token 消耗
基准测试显示相比传统文件读取方式,平均减少 62% 的 Token 消耗和 88% 的工具调用次数,文件读取降为零
03框架路由感知
内置对 Django、Express、Next.js、Vue Router 等 17 个 Web 框架的路由识别,直接将 URL 模式链接到处理函数
04跨语言桥接追踪
支持 Swift 与 Objective-C 互调、React Native 新旧桥接机制以及 Expo Modules 的跨语言调用链穿透
05完全本地化运行
所有数据存储在本地 SQLite 数据库中,无需 API 密钥,无外部网络请求,保障代码隐私安全
使用场景
场景 1在 Cursor 或 Claude Code 中快速理解陌生大型项目的架构与核心调用链路
场景 2提交 PR 前精准分析某次代码修改的影响范围,自动定位需要重跑的测试文件
场景 3跨语言混合项目(如 React Native 结合 iOS 原生代码)中追踪 JS 到原生的完整调用流
使用环境
快速上手
安装 CLI
macOS / Linux:
|
Windows (PowerShell):
|
如果已有 Node.js 环境,也可直接使用 npm:
|
配置 AI 代理
打开新终端,运行安装向导,自动检测并连接你使用的 AI 编程助手:
|
初始化项目索引
进入你的项目目录,一键构建代码图谱:
|
命令行查询示例
|
替代方案
对比 1Sourcegraph
企业级代码搜索平台,侧重于全局代码搜索与导航,而 CodeGraph 专注于为本地 AI 代理提供轻量级的结构化上下文
对比 2Bloop
基于 AI 的代码搜索引擎,依赖云端模型进行语义检索,CodeGraph 则完全离线运行并通过图结构提供精确的调用关系
对比 3Aider
AI 结对编程工具,本身是 AI 交互界面,CodeGraph 可作为其底层上下文提供者来增强其对大型项目的理解能力
相关资源
项目地址github.com/colbymchenry/codegraph

