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

远程模式适合团队共用服务。地址与密钥必须成对出现，且数据集权限要在服务端控制。把个人实验密钥复制给整组开发者看似省事，失败时却很难区分是谁写入了错误记忆。

六个生命周期钩子各管一段

让一个项目持续使用同一会话标识

插件默认每次终端启动生成新的 session_id。需要让同一项目稳定续接时，在启动前指定标识：

export COGNEE_SESSION_ID="payment-refactor"
claude

两个终端设置相同标识时会共享同一会话记忆，协作调试很方便；不同仓库误用同一个标识，则会把无关操作混在一起。建议用仓库名加任务名，并避免把真实客户信息写进环境变量名称。

连接成功后做一次跨会话测试

1. 在第一个会话告诉 Claude Code 一条具体约束，例如“迁移脚本不得删除旧索引”。
2. 让它执行一次相关工具调用，并正常结束会话，给 SessionEnd 留出同步机会。
3. 重新启动，改用“数据库改造有哪些硬限制”提问，检查是否召回同一约束。

若启动时没有 Cognee Memory Connected，先检查安装后是否真的新开了会话，再确认环境变量来自当前 shell。若当前会话能回忆、重启后不能，重点检查结束同步和数据集；若完全没有相关结果，再看模型额度与本地 8011 端口。按症状定位比反复卸载插件更快，也能避免把连接问题误判成记忆质量问题。