你是否试过让 Claude Code 帮你理解一个陌生的大型项目,却等它反复 grep、读文件、调用工具,半天才理清一个函数调用链?CodeGraph 正是为解决这个痛点而生——它不依赖云端 API,也不增加 token 消耗,而是提前为你的代码库构建一份轻量、精准、完全离线的“语义知识图谱”。从此,Claude Code 的探索不再靠暴力扫描,而是像查字典一样秒级定位符号、跳转定义、追溯调用关系。
核心功能
- 零网络依赖的本地知识图谱:所有索引(函数/类/变量定义、引用、继承、调用关系)均在本地生成并存储,无需联网、不上传代码、隐私零泄露
- 大幅减少 Claude Code 工具调用:实测平均降低 94% 的 grep/glob/read 等工具调用次数,显著缩短响应延迟
- 加速代码探索与理解:基于图谱的语义查询让“这个方法被谁调用?”“这个接口在哪实现?”等问题响应速度提升 77%
- 开箱即用的 Claude Code 深度集成:一键安装自动配置 Claude Code 插件,无需手动修改设置或环境变量
- 跨平台原生支持:完美兼容 Windows、macOS 和主流 Linux 发行版,Node.js 18+ 即可运行
- 交互式项目初始化:执行
codegraph init -i后通过友好向导完成语言识别、索引范围设定和排除规则配置,新手也能轻松上手
适合哪些人用
如果你是使用 Claude Code(尤其是 Claude for Code 或 VS Code 插件版)的开发者,且经常需要快速接手新项目、进行跨模块调试、梳理遗留系统或为团队新人提供代码导航支持,那么 CodeGraph 就是为你量身打造的“认知加速器”。它特别适合中大型 TypeScript/JavaScript 项目,同时也支持 Python、Rust、Go 等主流语言(通过社区扩展或自定义解析器),是追求效率、重视隐私与本地化体验的技术团队和个人开发者的理想选择。
快速上手
只需两步,30 秒内启用:
- 全局安装并启动配置向导:
npx @colbymchenry/codegraph—— 运行后自动检测已安装的 Claude Code 插件,并引导完成集成配置 - 进入项目目录,初始化图谱:
cd your-projectcodegraph init -i—— 选择要索引的语言、指定源码路径(支持 glob)、设置忽略规则(如 node_modules),完成后图谱即刻就绪
之后在 Claude Code 中使用 Explore 功能时,所有语义查询将默认优先从本地图谱获取结果,全程无感切换,效果立竿见影。
项目信息
Pre-indexed code knowledge graph for Claude Code — fewer tokens, fewer tool calls, 100% local
2.2k
今日 +397 stars today
Stars
195
Forks
TypeScript
MIT
TypeScript | 2211 颗星 | MIT 开源协议 | GitHub 项目地址
一款真正把“代码理解”从 IO 密集型操作升级为内存级查询的本地化利器——不卷算力,不赌网络,只专注让你的 AI 编程助手更聪明、更安静、更可信。


