CodeGraph 是一个为AI编程助手(如Claude Code、Cursor)设计的本地代码知识图谱工具。它的核心价值在于,提前为你的代码库构建一张结构化的"地图",让AI不再需要盲目地在文件里搜索,而是直接查询这张地图来获取信息。
1、安装CodeGraph
#安装npminstall-g@colbymchenry/codegraph#检查安装结果codegraph--version2、常用命令示例
#构建知识图谱,这会在根目录下创建一个 .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工作。