Claude Code 持久记忆 + Graphify 令牌节省指南

用 Obsidian Zettelkasten 与 Graphify 知识图谱为 Claude Code 加上跨会话记忆与代码结构地图,减少重复读码与重复解释项目的令牌开销。

Star 数
★ 1.1k
最近更新
1 个月前
License
MIT
主语言
Python

30 秒速览

可在哪里用
平台专用Claude Code
开始前需要
Claude Code(已安装并认证)ObsidianPython 3pip 包:graphifyy、claude-conversation-extractorANTHROPIC_API_KEY 或 MOONSHOT_API_KEY(仅 --deep 语义模式需要)cron(用于聊天导入流水线)Shell / 命令行网络访问本地文件系统
典型场景
多项目开发者,想让 Claude Code 记住各项目的技术栈、历史决策与待办,不再每次会话重新解释。
主要局限
核心令牌节省声明(71.5x/会话、499x/查询)为作者自述,原始负载与分词器未公开,无法从已发布数据复现。
维护状态
近半年有提交最近提交 2026-10-21

这个 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 时也写入最简自动日志。

  1. 多项目开发者,想让 Claude Code 记住各项目的技术栈、历史决策与待办,不再每次会话重新解释。
  2. 维护大型 TypeScript/Python 代码库的工程师,想让智能体先查 graph.json 结构图、只在编辑时读源码,以减少上下文令牌消耗。
  3. 在 Claude Web 与 Claude Code 之间切换的用户,想把散落在聊天历史中的决策自动整理成可搜索的 Obsidian 笔记。
  4. 经常忘记跑 /save 的用户,希望 SessionEnd 钩子自动留下最简会话日志作为兜底。
  5. 想为 React + Supabase 等项目建立架构决策记录(decisions.md)与永久洞见笔记库的团队/个人。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • pip install claude-conversation-extractor
  • pip install graphifyy
环境变量
VAULT_DIR ANTHROPIC_API_KEY MOONSHOT_API_KEY
配置文件
~/.claude/commands/README.md graphify-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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
69/ 100 五分制 3.5 / 5
信任安全 17/29
可靠稳定 11/14
适用触发 14/18
规范维护 14/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

权限范围总体克制:写入限于 vault 目录与 ~/.claude/commands, hook 仅做机械 JSONL 解析且明言零 LLM 调用;/save 的去重与约定写入需 y/n 确认,CLAUDE.md 规定不得未经询问删除笔记。扣分点:第三方 pip 依赖(claude-conversation-extractor、graphifyy)与浏览器扩展均未锁定版本、未经安全审查,聊天导出含潜在敏感对话被移入第三方工具与明文 staging 目录,API key 以明文环境变量导出;无卸载/回滚说明,crontab 自动任务一旦安装也无恢复路径。

可靠稳定11 / 14 · 3.9/5

自洽性出色:README 主动区分 skill 与 headless 两种调用路径的参数差异(--obsidian 仅在 skill 形式可用),并修正了 71.5x 表述。扣分点:依赖可用性依赖外部工具(graphify、extractor、浏览器扩展)且未给版本兼容信息;故障处理仅 autosave.log 静默落日志与简略测试步骤,Troubleshooting 章节在样本中未见正文。

适用触发14 / 18 · 3.9/5

明确目标场景(Claude Code + Obsidian 用户),能力边界描述诚实:声明 token 节省因任务而异、历史数字不可复现、源码读取仍必要。扣分点:触发精度一般(auto-save 有噪声过滤但 /save 的触发动机依赖用户记忆);环境偏向 Unix/macOS(crontab、ln -s、bash),Windows 用户未获说明。

规范维护14 / 18 · 3.9/5

信息架构清晰(分层目录、TOC、表格),安装步骤详尽含先决条件与验证方法;MIT 许可证完整,Graphify 与 ai-memory 的来源署名明确。扣分点:CHANGELOG 被 CI 引用但样本中未见内容,无版本号;示例丰富但 troubleshooting/FAQ 正文未见,无法证实;维护责任仅由 CI 设计规则体现,无明确的维护承诺或更新路径说明。

有效结果9 / 13 · 3.5/5

产出可用:/save 报告格式、记忆去向、过滤标签均有具体规范。边际价值真实(持久记忆 + 结构图谱确实解决重读代码痛点),成本说明较诚实(AST 模式 0 token,deep 模式需 API key)。扣分点:核心卖点 71.5x/499x 已被作者自认不可复现,剩余收益难以量化为成本效益;无任何实测数据支撑。

证据核验4 / 8 · 2.5/5

可追溯性好:README 直接标注 71.5x 为作者报告、不可复现,并解释 71.4x 只是检索上下文对比而非会话用量,区分事实与推断的纪律明显。扣分点:所有量化收益均无第三方佐证;Graphify『本地处理、代码不出机器』为转述第三方声明,仓库内无法核实。

风险与缓解建议
  • 第三方依赖(graphifyy、claude-conversation-extractor、浏览器导出扩展)未锁定版本且发布方未经验证,安装前请自行审查。
  • 聊天记录可能包含敏感信息,导出后以明文存放于 ~/claude-exports 并交给第三方扩展处理,请注意数据暴露面。
  • crontab 定时任务与 SessionEnd hook 一旦注册缺少卸载/回滚说明,建议自行记录如何移除。
  • 71.5x/499x 等量化收益为作者自报且不可复现,请勿作为采购依据。
证据充分度:低 评估于 2026年11月22日 审查版本 4cd2e6bd4319
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/claude-code-memory-setup.svg?lang=zh)](https://followagents.com/zh/agents/claude-code-memory-setup)
<a href="https://followagents.com/zh/agents/claude-code-memory-setup"><img src="https://followagents.com/badge/claude-code-memory-setup.svg?lang=zh" alt="FARS 评测"></a>

常见问题

Claude Code 持久记忆 + Graphify 令牌节省指南 开源吗?
开源。源码在 GitHub(lucasrosati/claude-code-memory-setup),许可证是 MIT。
Claude Code 持久记忆 + Graphify 令牌节省指南 安全吗?
FollowAgents 的 FARS 评审(2026年11月22日)给 Claude Code 持久记忆 + Graphify 令牌节省指南 的“信任与安全”打了 17/29 分。评审检查的 8 项安全措施没有完全缺失的。
Claude Code 持久记忆 + Graphify 令牌节省指南 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-21,在最近半年内,但不在最近 30 天内。
Claude Code 持久记忆 + Graphify 令牌节省指南 是谁开发的?
Claude Code 持久记忆 + Graphify 令牌节省指南 由 GitHub 账号 lucasrosati 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念