CodeGraph 今日发布

CodeGraph 简介

CodeGraph 是专为 AI 编程助手打造的本地代码知识图谱工具，通过为代码库建立符号、调用关系和依赖项的索引，让 Claude Code、Codex、Gemini、Cursor、OpenCode 等编程助手能够精准追踪调用链、在修改前快速定位影响范围。与传统基于正则的代码搜索不同，CodeGraph 基于语言的抽象语法树（AST）构建语义级的知识图谱，AI 每次查询都只需极少的 Token 即可获得精准结果。

核心能力

全语言覆盖的知识图谱：CodeGraph 支持 30+ 编程语言的 AST 解析，构建涵盖符号定义（函数、类、变量）、调用关系、继承链和导入导出的完整图谱。无需人工标注，开箱即用。

MCP 工具接口：内置 codegraph_query、codegraph_paths、codegraph_impact 三个 MCP 工具，任何 MCP 客户端均可直接调用图谱查询能力，实现与 AI 编程助手的无缝集成。

代码变更自动同步：安装后即在后台监控代码库变更，增量更新图谱索引，无需手动重建。

Framework 感知的路由分析：能够理解 React Router、Next.js App Router、Angular Router 等主流框架的路由配置，将 API 调用与页面路由对应起来，帮助 AI 判断功能变更的影响范围。

混合移动端支持：同时支持 iOS + React Native + Expo 混编项目的桥接层分析，解决了 AI 编程助手处理跨平台代码时的上下文困惑问题。

手术级上下文注入：AI 每次查询只获取与当前任务最相关的图谱子图，Token 消耗大幅降低，同时保证了分析质量。

100% 本地运行：所有索引数据存储在本地 .codegraph/ 目录，不上传任何代码内容到云端。

安装配置

方式一：curl 一键安装（推荐，无需 Node.js）

curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

Windows 用户：

irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex

方式二：npm 安装（已有 Node.js 环境）

npm i -g @colbymchenry/codegraph

方式三：按需安装

npx @colbymchenry/codegraph init ./my-project

使用步骤

第一步：初始化项目索引

codegraph init ./my-project

在目标代码库根目录执行，工具将递归解析所有源代码文件并构建图谱索引。

第二步：启动 MCP 服务器

codegraph mcp

启动后 AI 编程助手即可通过 MCP 协议调用图谱工具。

第三步：在 AI 助手中查询调用链

codegraph_paths(mainFunction)

查看 mainFunction 的完整调用下游，了解所有被触发的函数和模块。

第四步：评估变更影响范围

codegraph_impact(authenticateUser)

查看修改 authenticateUser 会影响哪些上游调用者和下游被调用者。

第五步：启动本地图谱浏览器（可选）

codegraph serve

在浏览器中可视化浏览整个代码库的知识图谱。

适用场景

场景一：大型重构前的影响分析 当需要重构核心业务函数时，AI 助手通过 codegraph_impact 可列出所有受影响的调用路径，避免遗漏导致的线上故障。

场景二：Bug 修复时的根因追溯 通过 codegraph_paths 从报错位置向上追溯，找到所有可能的调用栈和触发条件。

场景三：新成员快速理解陌生代码库 图谱提供了自上而下的架构视图，AI 助手可以引导新成员从顶层模块逐步深入，而非面对海量文件无从下手。

场景四：跨平台移动项目的接口追踪 对于同时包含 iOS 原生代码和 React Native 桥接层的混合项目，CodeGraph 能够追踪 JS 层函数调用如何映射到 Native 实现。

适用人群

维护大型代码库的开发者、关注代码质量的工程团队、使用 AI 编程助手处理复杂重构任务的工程师，以及需要 AI 辅助理解陌生项目的新成员。

工作原理

CodeGraph 的索引管线分为三个阶段。解析阶段：使用 Tree-sitter 或语言内置解析器将每个源代码文件转换为 AST，提取符号定义节点和调用关系边。图谱构建阶段：将所有文件的 AST 结果合并为统一的图谱数据库（存储在 .codegraph/ 目录），边代表调用或引用关系，节点代表代码实体。查询阶段：MCP 服务器接收来自 AI 编程助手的查询请求（如 codegraph_paths），在本地图谱数据库中执行图遍历算法，返回相关子图。查询结果以结构化格式返回给 AI 助手，确保每次查询的 Token 消耗最小化。

官方链接

GitHub 仓库：https://github.com/colbymchenry/codegraph

官网（含 Beta 申请）：https://getcodegraph.com