CodeGraph:代码语义知识图谱

解决什么问题

用 Claude Code 跑大项目时,它每次都需要先 grep、再 glob、再 Read,文件夹扫一圈、函数名追一遍,等它终于搞清楚入口在哪,token 已经烧了一截。

CodeGraph 做的事很直接:提前给代码库建一张语义知识图谱。Claude Code 不再每次从零扫文件,而是直接查图。函数调用链、类继承、模块引用这些关系,先被整理好,真正问问题时少绕很多路。

效果数据

项目 README 给出的基准:

指标 数据
平均工具调用减少 92%
探索速度提升 71%

VS Code 项目(TypeScript)实测:

场景 无 CodeGraph 有 CodeGraph
索引规模 4002 文件、59377 节点
回答"extension host 怎么和 main process 通信" 52 次工具调用,1 分 37 秒 3 次工具调用,17 秒

核心能力

不只是搜索

改代码前可以先看影响范围:这个函数被谁调用,这个类继承链往哪里走,这个模块改了会牵到哪些地方。对重构来说,这比单纯全文搜索舒服很多。

尤其是那种"我只想改一小块,但怕炸一大片"的场景。

语言和框架覆盖

支持 19 种编程语言,还能识别 Django、Express、Spring 这类框架里的路由映射。不只是找到函数,还能把请求入口、业务逻辑、底层调用串起来看。

数据在本地

不依赖外部服务,不用把公司代码库丢到第三方平台。对团队项目来说心理负担小很多。

自动同步

文件保存后会自动同步图谱,不需要每次手动重建。

安装与使用

# 安装
npx @colbymchenry/codegraph

# 进入项目后交互式初始化(配置 Claude Code 集成)
codegraph init -i

初始化完成后,Claude Code 会自动使用图谱。文件保存时图谱自动增量更新。

适用场景

适合
- 代码量已经上来、依赖关系开始绕的仓库
- 经常让 Claude Code 做代码探索和重构的场景
- 大型 monorepo 或复杂框架项目

不太需要
- 小项目里 Claude Code 本来就能很快扫完,收益不明显

与 Graphify 的区别

维度 CodeGraph Graphify
定位 代码专用语义图谱 软件工程知识图谱(代码+文档+PDF+视频)
解析方式 本地 AST(tree-sitter) 代码用 AST + 文档/PDF/视频用 AI 语义提取
核心价值 减少 Agent 工具调用、加速代码探索 关联代码与外部资料(论文/设计文档/视频)
框架识别 支持 Django/Express/Spring 路由映射 不特别针对框架
外部资料 不支持 支持论文/YouTube/PDF 等
自动同步 文件保存自动更新 需手动 --update 或 git hook

GitHub:https://github.com/colbymchenry/codegraph