Claude Code 总忘项目上下文?这个 Git 原生记忆层让 AI 真正记住你的代码规范
每次打开 Claude Code,都要重新跟它讲一遍项目规范?
这不是你的错觉——AI 编程代理天然「失忆」,每次新会话都是从零开始。你花了 10 分钟解释的架构约定,下次它就忘了。
Knowledge Graph 就是来解决这个问题的。它把你的文件操作和 Git 历史变成一个轻量级的记忆层,直接跑在你项目仓库里,跨会话持久化,零额外依赖。
它是怎么工作的?
装好之后,它会在你项目里做几件事:
- 自动生成 CLAUDE.md:每个模块一份 ≤20 行的知识节点,记录规范、禁忌、修改时机
- 钩子追踪文件操作:Read/Write 全记录,第一次访问新模块时自动推断共变依赖
- 会话快照注入:每次启动或
/clear后,自动把上次的上下文塞回去,不用你重新介绍 - 错误预判:基于真实共变历史,提前告诉你哪些模块改的时候要注意哪些坑
核心逻辑用纯 bash + jq 在会话边界跑,几乎不消耗 Token,不像那些每次查询都要调用 Embedding 接口的方案。
为什么值得装?
最直接的理由:装完之后,AI 真的开始「懂」你的项目了。
开发者自己测的反馈:目标达成率和「这真是我想要的」比例直接跳了 10 倍,他说「10 倍是地板,不是天花板」。
相比其他方案,它的优势在于:
| Knowledge Graph | Neo4j 类 | Vector DB 类 | |
|---|---|---|---|
| 存储 | 项目里的纯文本文件 | Neo4j + Docker | ChromaDB + Python |
| 依赖 | 只需 jq | Neo4j + Node.js | Python + ChromaDB |
| Token 消耗 | 几乎为零 | 每次查询都花钱 | Embedding 费用 |
| 跨团队共享 | Git push 即可 | 需要手动导出 | 需要手动导出 |
| 多代理支持 | ✅ MCP | ❌ | ❌ |
而且支持 Claude Code / Codex / Cursor / Windsurf 所有主流 AI 编程工具——团队里有人用 Codex,有人用 Claude Code,装一份知识图谱,大家读的是同一套上下文,不再出现「Claude Code 知道这个坑,Codex 不知道」的情况。
怎么安装?
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/hilyfux/knowledge-graph/main/standalone/install.sh) /path/to/your-project
Windows(PowerShell):
git clone https://github.com/hilyfux/knowledge-graph.git
cd knowledge-graph
.standaloneinstall.ps1 C:pathtoyour-project
装完重启 Claude Code,然后运行 /knowledge-graph init 初始化即可。之后每次对话,钩子自动在后台跑,你感受不到它的存在,但它一直在帮你记。
说真的,AI 编程工具越来越强,但「失忆」这个问题一直没人正面解决。Knowledge Graph 找到了一个优雅的切入点——不靠大模型硬记,不靠外部服务,就在你的 Git 历史里找答案。
对于经常被 Claude Code「重新认识项目」这件事搞烦了的开发者,这个工具值得一试。
🔗 GitHub:https://github.com/hilyfux/knowledge-graph
评论区
登录后可评论。