产品简介
CodeGraph 是开发者 **colbymchenry 于 2026/5 开源**的一个**本地代码知识图谱工具**，专门为 Claude Code / Codex / Gemini / Cursor / OpenCode / AntiGravity / Kiro / Hermes Agent 等 AI 编程工具优化 Token 消耗与代码检索效率。
**要解决的核心问题**：AI 编程工具在处理大型代码库时有一个通病——**大量 Token 被浪费在「发现阶段」**（Agent 需要不断执行 find/ls/grep 探索项目结构，才能找到真正需要的代码），实际写代码只占很小比例。这会导致 Token 消耗爆炸、响应速度慢、Claude Code 一天几十美元轻松花掉。
**CodeGraph 的解法**：**预先扫描整个代码库，用 tree-sitter 解析出所有函数、类、变量、依赖关系，构建成一份 SQLite 存储的代码知识图谱**，然后通过 MCP 协议对接 AI Agent。Agent 需要理解代码时**直接查图谱**（一次查询秒级返回精确结果），不再需要反复执行文件系统命令。
**关键卖点**：
- **100% 本地运行**：所有解析、存储、查询都在你的机器上，代码不上传任何第三方服务，隐私和企业合规完全放心
- **Token 消耗大幅下降**：实测（掘金社区反馈）在大型项目上，Agent 的 Token 消耗可减少 30-60%，尤其是 Claude Code 这种「烧钱大户」，效果立竿见影
- **响应速度提升**：图谱查询是毫秒级，比 Agent 反复执行 grep 快得多，整体编程体验更流畅
- **零编译零依赖**：CodeGraph 自带 runtime，无需 native 编译，Windows/Mac/Linux 一致体验
- **MCP 协议标准接入**：Claude Code、Codex、Gemini、Cursor、OpenCode、AntiGravity、Kiro、Hermes Agent 等主流 AI 编程工具通过 MCP 配置直接集成
- **自动同步代码变更**：代码修改后图谱自动更新，无需手动重新索引
**技术路线**：tree-sitter 解析（覆盖 40+ 语言）+ SQLite 存储（无外部数据库依赖）+ MCP 协议对接。没有黑魔法，就是「把发现阶段的成本预先支付掉」这一个朴素但极其有效的思路。
核心功能
- 100% 本地运行：代码解析、存储、查询全部在本地机器，无任何数据上传，隐私与合规友好
- 预索引代码知识图谱：用 tree-sitter 解析代码结构，SQLite 存储函数/类/依赖关系图
- Token 消耗降低 30-60%：Agent 不再需要反复 find/ls/grep 探索项目，直接查图谱定位代码
- 响应速度大幅提升：毫秒级图谱查询 vs 秒级文件系统探索，整体流程更流畅
- MCP 协议对接：Claude Code / Codex / Gemini / Cursor / OpenCode / AntiGravity / Kiro / Hermes Agent 等主流 AI 编程工具直接集成
- 40+ 语言支持：基于 tree-sitter 覆盖主流编程语言
- 零编译零依赖：自带 runtime，无需 native 编译，跨平台一致体验
- 自动同步代码变更：代码修改后图谱自动更新，无需手动重新索引
- 开源免费：GitHub 仓库 colbymchenry/codegraph，个人和商业用户免费使用
适合谁用
以下类型的用户会特别受益于 CodeGraph：
- 大型代码库（10 万行以上）的 AI 编程加速
- Claude Code 用户降低 Token 消耗（每天几十美元 → 十几美元）
- Cursor / Windsurf / Codex / Gemini / OpenCode / AntiGravity / Kiro / Hermes Agent 等 AI 编程工具提升代码检索效率
- 需要自动同步代码变更的持续开发场景
- 隐私敏感或企业合规要求严格的本地开发环境
优点亮点
- Token 消耗降低 30-60%，显著节省 AI 编程工具使用成本
- 毫秒级图谱查询，大幅提升代码检索和响应速度
- 100% 本地运行，代码不上传第三方，隐私与合规无忧
- 零编译零依赖，跨平台一致体验，开箱即用
- 支持 40+ 编程语言，自动同步代码变更，无需手动维护
总结与建议
CodeGraph 是一款专为 AI 编程工具设计的本地代码知识图谱工具，适合使用 Claude Code、Cursor、Codex 等 AI 编程助手处理大型代码库的开发者。其核心优势在于通过预索引代码结构，大幅降低 Token 消耗（30-60%）并提升响应速度，同时 100% 本地运行保障隐私安全，零编译零依赖，支持 40+ 语言和自动同步代码变更。