CodeGraph 安装实战指南三条命令接入你的 AI Agent【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraphCodeGraph 是一款面向 AI 编程 Agent 的 100% 本地代码知识图谱把整个仓库的符号、调用关系预先索引成图Agent 不再需要逐个文件 grep。CodeGraph 安装流程只有三条命令——装 CLI、接入 Agent、初始化项目装好后你向 Agent 问代码它一次查询就能拿到源码、调用路径和影响范围。开工前核对四件事先确认平台macOSIntel 与 Apple Silicon、Linux、Windows 均支持 x64 / arm64发行版都是自包含构建环境不用装 Node.js、不用编译只需网络能访问下载地址若偏好 npm 方式则需要一个 Node 环境数据索引全部落在项目的.codegraph/目录里不会离开你的机器也不需要任何 API 密钥语言TypeScript、Python、Go、Rust、Java、C/C 等 30 语言开箱即用无需逐语言配置 快速上手三条命令接入 Agent先装 CLI这一步只有第一条命令因平台而异。macOS / Linux 一行安装curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh脚本自动识别系统与架构把对应构建下载进~/.codegraph并在~/.local/bin建好codegraph启动链接细节见 install.sh。Windows 一行安装PowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex逻辑与 Shell 脚本一致程序解到%LOCALAPPDATA%\codegraph并把它的bin目录追加进用户 PATH见 install.ps1。用 npm 装npm i -g colbymchenry/codegraph与上面两条等效CLI 自带运行时两种方式都不涉及编译。注意安装脚本不会改动当前 shell 的环境变量先打开一个新终端再执行下一步否则找不到codegraph命令。新终端里任何平台都是同样三条命令# 自动检测并写入你正在用的 Agent 的 MCP 配置 codegraph install # 进入项目创建 .codegraph/ 并构建完整图谱 cd your-project codegraph init # 可选查看索引统计与待同步文件 codegraph statuscodegraph install跑完记得重启你的 AgentMCP 服务才会加载init每个项目跑一次而install全局装一次就覆盖所有项目。想图省事还有捷径npx colbymchenry/codegraph会下载并直接跑安装器CI 里则用codegraph install --yes --init免交互一次完成。安装到底改了什么花半分钟看看幕后发生了什么知道东西写在哪以后排障就快一半。安装脚本写了什么macOS/Linux 脚本把构建包放进~/.codegraph/versions/version维护一个current软链~/.local/bin的启动链接指向它Windows 脚本解包到%LOCALAPPDATA%\codegraph\current并把bin目录写进用户 PATH。两个脚本还会沿 PATH 找有没有别的codegraph副本最常见的是 npm 全局装的旧版本找到就警告它会抢先被执行。codegraph install 写了什么它给每个 Agent 逐个接上 CodeGraph 的 MCP 服务器覆盖 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 和 GitHub CopilotVS Code / Copilot CLI / JetBrains。以 Claude Code 为例MCP 条目写进~/.claude.json全局或项目里的.mcp.json本地权限写进settings.jsonCLAUDE.md追加一小段带标记的说明其他 Agent 写各自的说明文件Cursor、Kiro 只写 MCP 配置。这一步只接线不索引代码。init 在项目里生成了什么项目根目录多出.codegraph/核心是codegraph.db——一个本地 SQLite 库存着符号、调用边、依赖和全文索引。这个目录一旦出现Agent 会自动启用 CodeGraph 工具无需额外配置。之后的文件改动由原生文件监听macOS FSEvents、Linux inotify、Windows ReadDirectoryChangesW捕获经 2 秒防抖合并后增量同步Agent 每次连接时还会做一次快速对账补上离线期间的改动。 坑与自救codegraph: command not found→ 安装脚本不改动当前 shell → 打开新终端仍不行就确认~/.local/bin在 PATH 中版本号对不上刚装的→ PATH 里靠前有个同名旧副本通常是 npm 全局装被抢先执行 →npm rm -g colbymchenry/codegraph或把新路径排在 PATH 前面MCP 提示 CodeGraph not initialized→ 项目还没建索引 → 在项目目录跑一次codegraph initdatabase is locked→ 0.9 之前的老安装或文件系统不支持 WALWSL2 的/mntWindows 盘常见→ 重装最新版确认codegraph status里Journal:显示wal不是的话把项目挪到本地盘WSL2 中工具调用报Transport closed→ Windows 盘上共享后台服务不可靠 → 设CODEGRAPH_NO_DAEMON1或把项目挪到~/等 Linux 原生路径Windows 与 WSL 共用一个仓库→ 两侧锁会互相冲突 → Windows 侧设CODEGRAPH_DIR.codegraph-win各建各的索引程序会自动跳过对方的目录日常与退场codegraph explore 登录流程是怎么走的—— 一次返回相关源码、调用路径与影响范围codegraph impact 符号/codegraph affected src/xx.ts—— 改前查波及面改后找受影响的测试codegraph status—— 随时查看索引统计与待同步文件codegraph upgrade—— 一键升级自动识别你当初的安装方式bundle / npm / npx--check只查询不升级codegraph telemetry off—— 关闭匿名使用统计安装器会先询问设DO_NOT_TRACK1同样有效codegraph uninstall—— 从所有已配置的 Agent 和 CLI 本体一并移除删除前先展示清单--keep-cli只拆 Agent 配置codegraph uninit删掉单个项目的索引官方在 7 个开源项目上的对照测试里Agent 的工具调用次数最多减少 88%文件读取从最多的 19 次降到零——这次安装从你问的第一次代码问题就开始回本。想弄清索引是怎么建的、图谱长什么样可以继续读 工作原理 和 安装文档。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/8 18:55:27 · 阅读 1.2k CodeGraph 安装实战指南：三条命令接入你的 AI Agent
CodeGraph 安装实战指南三条命令接入你的 AI Agent【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraphCodeGraph 是一款面向 AI 编程 Agent 的 100% 本地代码知识图谱把整个仓库的符号、调用关系预先索引成图Agent 不再需要逐个文件 grep。CodeGraph 安装流程只有三条命令——装 CLI、接入 Agent、初始化项目装好后你向 Agent 问代码它一次查询就能拿到源码、调用路径和影响范围。开工前核对四件事先确认平台macOSIntel 与 Apple Silicon、Linux、Windows 均支持 x64 / arm64发行版都是自包含构建环境不用装 Node.js、不用编译只需网络能访问下载地址若偏好 npm 方式则需要一个 Node 环境数据索引全部落在项目的.codegraph/目录里不会离开你的机器也不需要任何 API 密钥语言TypeScript、Python、Go、Rust、Java、C/C 等 30 语言开箱即用无需逐语言配置 快速上手三条命令接入 Agent先装 CLI这一步只有第一条命令因平台而异。macOS / Linux 一行安装curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh脚本自动识别系统与架构把对应构建下载进~/.codegraph并在~/.local/bin建好codegraph启动链接细节见 install.sh。Windows 一行安装PowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex逻辑与 Shell 脚本一致程序解到%LOCALAPPDATA%\codegraph并把它的bin目录追加进用户 PATH见 install.ps1。用 npm 装npm i -g colbymchenry/codegraph与上面两条等效CLI 自带运行时两种方式都不涉及编译。注意安装脚本不会改动当前 shell 的环境变量先打开一个新终端再执行下一步否则找不到codegraph命令。新终端里任何平台都是同样三条命令# 自动检测并写入你正在用的 Agent 的 MCP 配置 codegraph install # 进入项目创建 .codegraph/ 并构建完整图谱 cd your-project codegraph init # 可选查看索引统计与待同步文件 codegraph statuscodegraph install跑完记得重启你的 AgentMCP 服务才会加载init每个项目跑一次而install全局装一次就覆盖所有项目。想图省事还有捷径npx colbymchenry/codegraph会下载并直接跑安装器CI 里则用codegraph install --yes --init免交互一次完成。安装到底改了什么花半分钟看看幕后发生了什么知道东西写在哪以后排障就快一半。安装脚本写了什么macOS/Linux 脚本把构建包放进~/.codegraph/versions/version维护一个current软链~/.local/bin的启动链接指向它Windows 脚本解包到%LOCALAPPDATA%\codegraph\current并把bin目录写进用户 PATH。两个脚本还会沿 PATH 找有没有别的codegraph副本最常见的是 npm 全局装的旧版本找到就警告它会抢先被执行。codegraph install 写了什么它给每个 Agent 逐个接上 CodeGraph 的 MCP 服务器覆盖 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 和 GitHub CopilotVS Code / Copilot CLI / JetBrains。以 Claude Code 为例MCP 条目写进~/.claude.json全局或项目里的.mcp.json本地权限写进settings.jsonCLAUDE.md追加一小段带标记的说明其他 Agent 写各自的说明文件Cursor、Kiro 只写 MCP 配置。这一步只接线不索引代码。init 在项目里生成了什么项目根目录多出.codegraph/核心是codegraph.db——一个本地 SQLite 库存着符号、调用边、依赖和全文索引。这个目录一旦出现Agent 会自动启用 CodeGraph 工具无需额外配置。之后的文件改动由原生文件监听macOS FSEvents、Linux inotify、Windows ReadDirectoryChangesW捕获经 2 秒防抖合并后增量同步Agent 每次连接时还会做一次快速对账补上离线期间的改动。 坑与自救codegraph: command not found→ 安装脚本不改动当前 shell → 打开新终端仍不行就确认~/.local/bin在 PATH 中版本号对不上刚装的→ PATH 里靠前有个同名旧副本通常是 npm 全局装被抢先执行 →npm rm -g colbymchenry/codegraph或把新路径排在 PATH 前面MCP 提示 CodeGraph not initialized→ 项目还没建索引 → 在项目目录跑一次codegraph initdatabase is locked→ 0.9 之前的老安装或文件系统不支持 WALWSL2 的/mntWindows 盘常见→ 重装最新版确认codegraph status里Journal:显示wal不是的话把项目挪到本地盘WSL2 中工具调用报Transport closed→ Windows 盘上共享后台服务不可靠 → 设CODEGRAPH_NO_DAEMON1或把项目挪到~/等 Linux 原生路径Windows 与 WSL 共用一个仓库→ 两侧锁会互相冲突 → Windows 侧设CODEGRAPH_DIR.codegraph-win各建各的索引程序会自动跳过对方的目录日常与退场codegraph explore 登录流程是怎么走的—— 一次返回相关源码、调用路径与影响范围codegraph impact 符号/codegraph affected src/xx.ts—— 改前查波及面改后找受影响的测试codegraph status—— 随时查看索引统计与待同步文件codegraph upgrade—— 一键升级自动识别你当初的安装方式bundle / npm / npx--check只查询不升级codegraph telemetry off—— 关闭匿名使用统计安装器会先询问设DO_NOT_TRACK1同样有效codegraph uninstall—— 从所有已配置的 Agent 和 CLI 本体一并移除删除前先展示清单--keep-cli只拆 Agent 配置codegraph uninit删掉单个项目的索引官方在 7 个开源项目上的对照测试里Agent 的工具调用次数最多减少 88%文件读取从最多的 19 次降到零——这次安装从你问的第一次代码问题就开始回本。想弄清索引是怎么建的、图谱长什么样可以继续读 工作原理 和 安装文档。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考