痛点：AI 编程代理的"盲人摸象"
用 Claude Code 问一句"AuthService 是怎么被调用的？"，AI 的回答过程：
→ glob("src/**/*.ts") # 工具调用 1
→ grep("AuthService") # 工具调用 2
→ read("auth.service.ts") # 工具调用 3
→ grep("import.*Auth") # 工具调用 4
→ read("user.controller.ts") # 工具调用 5
...一个问题触发 10-15 次工具调用，消耗数十万 tokens。下次问类似的问题？从头再来一遍。
所有 AI 编程代理都有这个问题——大量时间和 token 花在"发现阶段"（扫描目录、搜索关键词、读取文件），而不是真正的推理和代码生成。
CodeGraph：给 AI 一张"代码地图"
CodeGraph 在代理开始工作之前，就用 tree-sitter 把整个代码库解析成一张语义知识图谱——每个函数、类、接口的定义，调用关系、导入关系、继承关系，全部存入本地 SQLite。
AI 代理需要理解代码时，一次调用就能拿到完整上下文。
项目数据一览
GitHub Stars 50,000+ | Forks 3,000+ | License MIT
语言支持 20+ 种（TS / Python / Go / Rust / Java / C++...）| 框架路由识别 17 个
平台 Windows / macOS / Linux | 运行环境 Node.js 20-24
数据说话：7 个真实项目的 A/B 测试
同一架构问题跑 4 次取中位数（Claude Code headless）：
关键发现：Tokio（Rust）收益最大——89% 工具调用减少。VS Code 绝对数字最震撼——1.4M tokens 压到 393k，工具调用从 21 次降到 4 次。仓库越大、依赖越复杂，收益越大。
3 分钟上手
第一步：安装
# 推荐：npx 一键安装 npx @colbymchenry/codegraph # 或 npm 全局安装 npm install -g @colbymchenry/codegraph
安装器自动检测已安装的 AI 代理（Claude Code、Cursor、Codex CLI、Gemini CLI、Kiro 等 8 种），交互式配置 MCP 服务。
第二步：初始化
cd your-project codegraph init -i
tree-sitter 扫描代码库，构建语义图谱。中型项目 1-3 分钟，大型项目 5-10 分钟。
第三步：开用——启动你的 AI 代理，它会自动发现 CodeGraph 的 MCP 工具。就这样，没有第四步了。
8 个 MCP 工具速览
工具
一句话说明
典型问题
codegraph_explore
核心，一次调用返回完整上下文
"X 是怎么工作的？"
codegraph_search
按名称搜索符号
"找所有叫 authenticate 的函数"
codegraph_callers
谁在调用这个函数
"谁调用了 AuthService？"
codegraph_callees
这个函数调了谁
"processPayment 内部调了什么？"
codegraph_impact
改这个会影响哪些模块
"修改这个函数的影响范围？"
codegraph_node
获取符号详细信息和源码
"给我 UserController 的完整签名"
codegraph_files
获取已索引的文件结构
"项目整体结构是什么？"
codegraph_status
检查索引健康状态
"索引了多少符号？"
5 个实用技巧
不要先 grep——用 codegraph_search，基于 AST 语义搜索，比字符串匹配准得多
不要用 Read 读源文件——用 codegraph_node 传文件路径，更快还自带影响分析
不要连环调 search + node——一次 codegraph_explore 把相关符号源码按文件分组返回
看到警告就听它的——"过期文件"标记，提示 AI 代理 Read 一下拿最新内容
大文件读不全？分两步——codegraph_explore 收尾后，codegraph_node 单独读目标符号
为什么值得用？
三个核心价值
省钱：平均减少 35% API 费用
省时：工具调用减少 70%，响应速度提升 49%
安全：100% 本地运行，代码不出机器，无需 API Key
适合谁用：Claude Code / Cursor 重度用户、大型项目维护者、CI/CD 工程师（codegraph affected 做智能测试选择）、团队新人（用知识图谱快速理解陌生代码库）。
CodeGraph 改变了 AI 理解代码的方式——从"每次都从零探索"变成"拿着地图直奔目标"。
项目地址：github.com/colbymchenry/codegraph
安装命令：npx @colbymchenry/codegraph
文档：colbymchenry.github.io/codegraph
觉得有用？转发给你身边正在用 AI 写代码的朋友。
