codegraph工具

CodeGraph 是一个为AI编程助手（如Claude Code、Cursor）设计的本地代码知识图谱工具。它的核心价值在于，提前为你的代码库构建一张结构化的"地图"，让AI不再需要盲目地在文件里搜索，而是直接查询这张地图来获取信息。

1、安装CodeGraph

#安装npminstall-g@colbymchenry/codegraph#检查安装结果codegraph--version

2、常用命令示例

#构建知识图谱,这会在根目录下创建一个 .codegraph/ 文件夹，用来存放知识图谱索引。codegraph init-i/需要构建知识图谱代码目录的绝对路径/#全量重新构建索引codegraph index /需要构建知识图谱代码目录的绝对路径/#增量同步更新索引codegraphsync/需要构建知识图谱代码目录的绝对路径/

3、VS Code中怎样接入CodeGraph？

通过 MCP 配置文件接入（推荐）

（1）.如果使用的是VS Code中的CLI，则在~/.codex/config.toml 中增加 [mcp_servers.codegraph] 配置：

注意这里用的是codex大模型客户端，如果用的是其它大模型，则不是.codex

[mcp_servers.codegraph]command="npx"args=["-y","@colbymchenry/codegraph","serve","--mcp","-p","D:\\Document\\master_code",]

（2）.如果使用的是VS Code 里的GitHub Copilot / 其他 MCP 客户端。

创建 MCP 配置文件：在你的项目根目录下，创建 .vscode/mcp.json 文件。VS Code 会自动读取这个文件来配置 MCP 服务器。

填入 CodeGraph 配置：将以下内容复制到 mcp.json 文件中：

{"mcpServers":{"codegraph":{"type":"stdio","command":"npx","args":["-y","@colbymchenry/codegraph","serve","--mcp","--path","需要构建知识图谱代码目录的绝对路径"]}}}

注意：Windows 的绝对路径中的反斜杠\需要转义成\\，或者直接使用正斜杠/以避免 JSON 解析错误。

工程中如何使用?

上面在IDE中接入了Codegraph后，在工程中怎么用，可以通过SKILL.md写入到流程中，或写入AGENT.md指导AI工作。