Claude Code 怎么接入长期记忆？Cognee Memory 插件教程
昨天让 Claude Code 把数据库迁移拆成三步，今天重新打开终端，它又从仓库扫描开始。Cognee Memory 插件处理的正是这种断点：会话启动时找回相关上下文，操作过程中记录提示词与工具轨迹，结束时再把会话记忆同步进长期知识图谱。
插件要在新会话之前装
claude plugin marketplace add topoteretes/cognee-integrations
claude plugin install cognee-memory@cognee这两条命令通过 Claude Code 官方插件管理器添加 Cognee 集成并完成用户级安装。然后在准备启动 claude 的同一终端设置运行模式。
本地模式
export LLM_API_KEY="你的模型密钥"
claude未设置 COGNEE_BASE_URL 时，插件会拉起本地 Cognee API，默认地址为 http://localhost:8011。本地 API 密钥可自动生成并缓存；模型密钥缺失时，服务即使启动，也无法完成需要模型的记忆加工。
远程模式
export COGNEE_BASE_URL="https://你的-cognee-实例"
export COGNEE_API_KEY="ck_你的密钥"
claude远程模式适合团队共用服务。地址与密钥必须成对出现，且数据集权限要在服务端控制。把个人实验密钥复制给整组开发者看似省事，失败时却很难区分是谁写入了错误记忆。
六个生命周期钩子各管一段
| 阶段 | 插件动作 | 异常表现 |
|---|---|---|
SessionStart | 选择本地或远程模式，建立身份与会话 | 没有连接成功提示 |
UserPromptSubmit | 注入当前数据集相关上下文 | 新问题看不到旧决策 |
PostToolUse | 记录工具调用轨迹 | 只记得对话，不记得做过哪些操作 |
Stop | 写入本轮助手回答 | 会话记录缺少最终结论 |
PreCompact | 在上下文压缩前保存关键记忆 | 长会话压缩后断片 |
SessionEnd | 触发会话到永久图谱的最终同步 | 当前终端记得，重开后忘记 |
让一个项目持续使用同一会话标识
插件默认每次终端启动生成新的 session_id。需要让同一项目稳定续接时，在启动前指定标识：
export COGNEE_SESSION_ID="payment-refactor"
claude两个终端设置相同标识时会共享同一会话记忆，协作调试很方便；不同仓库误用同一个标识，则会把无关操作混在一起。建议用仓库名加任务名，并避免把真实客户信息写进环境变量名称。
连接成功后做一次跨会话测试
- 在第一个会话告诉 Claude Code 一条具体约束，例如“迁移脚本不得删除旧索引”。
- 让它执行一次相关工具调用，并正常结束会话，给
SessionEnd留出同步机会。 - 重新启动，改用“数据库改造有哪些硬限制”提问，检查是否召回同一约束。
若启动时没有 Cognee Memory Connected，先检查安装后是否真的新开了会话，再确认环境变量来自当前 shell。若当前会话能回忆、重启后不能，重点检查结束同步和数据集；若完全没有相关结果，再看模型额度与本地 8011 端口。按症状定位比反复卸载插件更快，也能避免把连接问题误判成记忆质量问题。
相关资讯
-
07.15
红色沙漠白纹大角鹿地点在哪
-
07.15
魔兽世界水能堡复能任务怎么完成
-
07.15
红色沙漠白鹿在哪个位置
-
07.15
魔兽世界前往水能堡任务如何做
-
07.15
红色沙漠大王白野牛具体在哪
-
07.15
魔兽世界双管齐下任务如何完成
游戏推荐
推荐专题
热门阅读
-
-
- 《怒火一刀》2026版三职业专精攻略
- 07.15
-
- 荒原曙光宠物战印怎么汇总
- 07.15
-
-
- 万词王提醒学习怎么关闭
- 07.15
-
- 永劫无间账号交易平台推荐与安全买卖APP指南
- 07.15
推荐下载
-
-
下载
- |
-
-
下载
- 《行尸走肉第一章》免安装中文汉化硬盘版下载
- 单机|436 MB
- 一款以动作冒险为主题的游戏
-
-
下载
- 《街头霸王X铁拳》免安装中文汉化硬盘版下载
- 单机|111MB
- 一款非常好玩的格斗游戏
-
-
下载
- |
-
-
下载
- 《暗黑破坏神3》免安装繁体中文正式版下载
- 单机|7630 MB
- 一款以角色扮演为主题的游戏
-
-
下载
- 《马克思佩恩3》免安装硬盘版下载
- 单机|27033 MB
- 一款以第三人称射击为主题的游戏