Claude Code 持久记忆 + Graphify 令牌节省指南
用 Obsidian Zettelkasten 与 Graphify 知识图谱为 Claude Code 加上跨会话记忆与代码结构地图,减少重复读码与重复解释项目的令牌开销。
- Star 数
- ★ 1.1k
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Python
- FA 评分
- 69/100 · 存在缺口
30 秒速览
- 可在哪里用
- 平台专用Claude Code
- 开始前需要
- 典型场景
- 多项目开发者,想让 Claude Code 记住各项目的技术栈、历史决策与待办,不再每次会话重新解释。
- 主要局限
- 核心令牌节省声明(71.5x/会话、499x/查询)为作者自述,原始负载与分词器未公开,无法从已发布数据复现。
- 维护状态
- 近半年有提交最近提交 2026-10-21
- 源码审查
- 69/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
这是 lucasrosati 的 claude-code-memory-setup 仓库,一份 MIT 许可的完整配置指南(含葡萄牙语版),把 Claude Code 变成具备长期记忆与代码库全局感知的智能体。它由四个互补部分组成:单一 Obsidian 仓库作为持久记忆(Zettelkasten 笔记规范)、聊天导入流水线(claude_to_obsidian.py 与 sync_claude_obsidian.sh,通过 cron 自动把 Claude Code/Web 对话导入为笔记)、Graphify 代码知识图谱(tree-sitter AST 本地处理,默认零令牌),以及 /save、/resume、/memorize、/commit 会话命令和 SessionEnd 自动存档钩子。它并非独立软件,而是一套配置、命令文件与脚本,安装在 ~/.claude/commands/、~/.claude/skills/ 与 ~/scripts/ 中。README 明确声明 71.5x/会话与 499x/查询的令牌节省是作者自述、无法从公开数据复现,并附带了基准协议与证据审计链接。适合已在深度使用 Claude Code、愿意自建并维护 Obsidian 仓库的用户。
仓库提供可复制的配置与脚本而非可安装产品:1) 在单一 Obsidian 仓库(~/vault/)按 Zettelkasten 规范(原子笔记、wikilink、YAML frontmatter、kebab-case 文件名)建立 permanent/、inbox/、logs/、chats/、graphify/ 等结构,并在仓库根写 CLAUDE.md 全局规则。2) 安装 commands/ 目录中的 /save、/resume、/memorize、/commit 命令文件到 ~/.claude/commands/:/resume 加载仓库上下文,/save 写会话日志并执行去重后的知识整合(决策写入 architecture/decisions.md,可复用洞见写入 permanent/),/commit 提交后触发图谱重建。3) 聊天导入:pip install claude-conversation-extractor 导出对话,claude_to_obsidian.py 依关键词生成标签与 frontmatter,sync_claude_obsidian.sh 由 cron(如每日 22:00)自动同步到 chats/code/ 与 chats/web/。4) pip install graphifyy && graphify install --platform claude 在 ~/.claude/skills/graphify/ 注册技能;在 Claude Code 内用 /graphify . --obsidian --obsidian-dir ~/vault/graphify/project-name 生成 graph.json、GRAPH_REPORT.md 与 Obsidian 笔记,或在终端用 graphify extract . --out ./graphify-out(无头模式不识别 --obsidian/--wiki/--mode deep)。5) scripts/session_autosave.py 注册为 ~/.claude/settings.json 的 SessionEnd 钩子,纯 JSONL 解析零 LLM 调用,在忘跑 /save 时也写入最简自动日志。
- 多项目开发者,想让 Claude Code 记住各项目的技术栈、历史决策与待办,不再每次会话重新解释。
- 维护大型 TypeScript/Python 代码库的工程师,想让智能体先查 graph.json 结构图、只在编辑时读源码,以减少上下文令牌消耗。
- 在 Claude Web 与 Claude Code 之间切换的用户,想把散落在聊天历史中的决策自动整理成可搜索的 Obsidian 笔记。
- 经常忘记跑 /save 的用户,希望 SessionEnd 钩子自动留下最简会话日志作为兜底。
- 想为 React + Supabase 等项目建立架构决策记录(decisions.md)与永久洞见笔记库的团队/个人。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install claude-conversation-extractorpip install graphifyy
- 环境变量
VAULT_DIRANTHROPIC_API_KEYMOONSHOT_API_KEY- 配置文件
~/.claude/commands/README.mdgraphify-out/graph.json
如何安装或部署这个 Agent?
前置:已安装并认证 Claude Code、Obsidian、Python 3。
创建仓库结构:
cd ~/vault
mkdir -p permanent inbox fleeting templates logs references
mkdir -p my-project/{architecture,pipeline,data,features,logs}在 vault 根创建 CLAUDE.md(内容含项目栈、Zettelkasten 规则与禁止事项),并创建笔记模板:
cat > templates/default-note.md << 'EOF'
---
title: {{title}}
tags: []
created: {{date}}
updated: {{date}}
status: draft
type: permanent
---
# {{title}}
## Context
## Details
## Related links
EOF安装会话命令:
cp commands/*.md ~/.claude/commands/
rm ~/.claude/commands/README.md
export VAULT_DIR=~/vault安装聊天导入依赖与 Graphify:
pip install claude-conversation-extractor
pip install graphifyy
graphify install --platform claude如需 Graphify 的 LLM 语义抽取,先导出密钥(AST 默认模式不需要):
export ANTHROPIC_API_KEY="your-key-here"
# 或
export MOONSHOT_API_KEY="your-key-here"自动存档钩子脚本与 crontab:
mkdir -p ~/scripts
cp scripts/session_autosave.py ~/scripts/
chmod +x ~/scripts/session_autosave.py{
"hooks": {
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": "VAULT_DIR=$HOME/vault python3 $HOME/scripts/session_autosave.py"
}
]
}
]
}
}如何使用这个 Agent?
典型会话流程:
1) 进入 Claude Code 会话后先运行 /resume 加载 vault 上下文(近期日志、决策、进度)。
2) Claude 依项目 CLAUDE.md 的三层查询规则先查 graphify-out/graph.json,再查 vault,最后才读源码。
3) 正常开发;中途可用 /memorize 立即固化某个决策或洞见。
4) 结束时运行 /save 写会话日志并执行知识整合(写入 decisions.md 或 permanent/,并返回 Memory 报告);/commit 提交推送后也会触发 /save 与图谱重建。
图谱生成(Claude Code 内):
/graphify . --obsidian --obsidian-dir ~/vault/graphify/project-name或终端无头模式:
graphify extract . --out ./graphify-out
# 增量更新
graphify update .
# 查询与解释
graphify query "question"
graphify explain "NodeName"自动导入 Claude 对话:把导出的 .md 放入 ~/claude-exports/code/ 或 web/,cron 每天 22:00 运行:
0 22 * * * $HOME/scripts/sync_claude_obsidian.sh在 Obsidian 图谱视图用 path:graphify、tag:chat-import、tag:auto-log 等过滤不同来源的笔记。
这个 Agent 有哪些优点和局限?
- 四层互补设计(声明记忆 / 结构图谱 / 聊天归档 / 自动兜底日志),覆盖了 Claude Code 跨会话遗忘与重复读码两类令牌浪费的完整闭环。
- Graphify 默认 AST 模式 100% 本地 tree-sitter 处理,代码内容不出机器、0 令牌,且支持 20 种语言与 SHA256 缓存增量更新。
- /save 有明确的整合与去重标准(grep 查重后才写入,区分决策、洞见、事实与惯例),自动日志钩子零 LLM 调用、毫秒级、静默失败。
- README 对 71.5x/499x 令牌声明的可信度做了诚实的免责声明,并附带基准协议(benchmarks/)与证据审计 issue。
- 核心令牌节省声明(71.5x/会话、499x/查询)为作者自述,原始负载与分词器未公开,无法从已发布数据复现。
- 深度绑定 Claude Code 专属机制(CLAUDE.md、~/.claude/skills、SessionEnd 事件),迁移到其他智能体需重做全部配置。
- 初始设置量大:需自建 Obsidian 仓库结构、写 CLAUDE.md、配置 cron、复制命令文件、注册 JSON 钩子。
- Graphify 的语义模式需要 Anthropic 或 Moonshot(Kimi)API 密钥;无头 CLI 与技能调用支持的标志集不同(--obsidian/--wiki 仅技能形式可用),易混淆。
- 并非安装即用的软件,而是文档+脚本集合,需要用户自行维护和调整脚本(如 claude_to_obsidian.py 需自行编写关键词映射)。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Code 持久记忆 + Graphify 令牌节省指南 当前 | 69 · 存在缺口 | — | ★ 1.1k | 1 个月前 | Python | Claude Code |
| EGC — 让每个 AI 编码代理共享同一个大脑 | 76 · 表现良好 | 命令行工具免费 | ★ 70 | 今天 | JavaScript | Codex · Claude Code |
| Mnemon — AI 智能体的持久记忆引擎 | 71 · 存在缺口 | 命令行工具免费 | ★ 733 | 3 天前 | Go | Codex · Claude Code |
| MCP Memory Service | 68 · 存在缺口 | MCP 服务器免费 | ★ 2.1k | 今天 | Python | ChatGPT · Codex · Claude Code · Claude.ai |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
权限范围总体克制:写入限于 vault 目录与 ~/.claude/commands, hook 仅做机械 JSONL 解析且明言零 LLM 调用;/save 的去重与约定写入需 y/n 确认,CLAUDE.md 规定不得未经询问删除笔记。扣分点:第三方 pip 依赖(claude-conversation-extractor、graphifyy)与浏览器扩展均未锁定版本、未经安全审查,聊天导出含潜在敏感对话被移入第三方工具与明文 staging 目录,API key 以明文环境变量导出;无卸载/回滚说明,crontab 自动任务一旦安装也无恢复路径。
自洽性出色:README 主动区分 skill 与 headless 两种调用路径的参数差异(--obsidian 仅在 skill 形式可用),并修正了 71.5x 表述。扣分点:依赖可用性依赖外部工具(graphify、extractor、浏览器扩展)且未给版本兼容信息;故障处理仅 autosave.log 静默落日志与简略测试步骤,Troubleshooting 章节在样本中未见正文。
明确目标场景(Claude Code + Obsidian 用户),能力边界描述诚实:声明 token 节省因任务而异、历史数字不可复现、源码读取仍必要。扣分点:触发精度一般(auto-save 有噪声过滤但 /save 的触发动机依赖用户记忆);环境偏向 Unix/macOS(crontab、ln -s、bash),Windows 用户未获说明。
信息架构清晰(分层目录、TOC、表格),安装步骤详尽含先决条件与验证方法;MIT 许可证完整,Graphify 与 ai-memory 的来源署名明确。扣分点:CHANGELOG 被 CI 引用但样本中未见内容,无版本号;示例丰富但 troubleshooting/FAQ 正文未见,无法证实;维护责任仅由 CI 设计规则体现,无明确的维护承诺或更新路径说明。
产出可用:/save 报告格式、记忆去向、过滤标签均有具体规范。边际价值真实(持久记忆 + 结构图谱确实解决重读代码痛点),成本说明较诚实(AST 模式 0 token,deep 模式需 API key)。扣分点:核心卖点 71.5x/499x 已被作者自认不可复现,剩余收益难以量化为成本效益;无任何实测数据支撑。
可追溯性好:README 直接标注 71.5x 为作者报告、不可复现,并解释 71.4x 只是检索上下文对比而非会话用量,区分事实与推断的纪律明显。扣分点:所有量化收益均无第三方佐证;Graphify『本地处理、代码不出机器』为转述第三方声明,仓库内无法核实。
- 第三方依赖(graphifyy、claude-conversation-extractor、浏览器导出扩展)未锁定版本且发布方未经验证,安装前请自行审查。
- 聊天记录可能包含敏感信息,导出后以明文存放于 ~/claude-exports 并交给第三方扩展处理,请注意数据暴露面。
- crontab 定时任务与 SessionEnd hook 一旦注册缺少卸载/回滚说明,建议自行记录如何移除。
- 71.5x/499x 等量化收益为作者自报且不可复现,请勿作为采购依据。
常见问题
Claude Code 持久记忆 + Graphify 令牌节省指南 开源吗?
Claude Code 持久记忆 + Graphify 令牌节省指南 安全吗?
Claude Code 持久记忆 + Graphify 令牌节省指南 还在维护吗?
Claude Code 持久记忆 + Graphify 令牌节省指南 是谁开发的?
谢谢反馈,我们会据此改进页面。