deja-vu

这是什么？

deja-vu 是 AI Coding Agent 的记忆层——为 Claude Code、Codex、opencode 等 Agent 提供长期记忆能力。它解决的核心痛点是：AI Agent 每次对话都像”失忆”，不记得你的偏好、项目上下文和历史决策。deja-vu 通过搜索、MCP 召回、自动上下文注入、密钥脱敏、统计分析和同步功能，让 Agent 越用越懂你。

适合谁：日常使用 Claude Code/Codex 的开发者、管理多个 AI Agent 项目的技术负责人、追求上下文工程效率的 AI 重度用户。

准备工作

• Go 环境（或直接下载零依赖二进制）
• 支持的 Agent：Claude Code / Codex / opencode
• 安装：从 GitHub Releases 下载对应平台二进制
• 时间预算：5 分钟安装，15 分钟配置记忆策略

三步快速上手

第一步：安装 deja-vu

# macOS / Linux
curl -L https://github.com/vshulcz/deja-vu/releases/latest/download/deja-vu-$(uname -s)-$(uname -m) -o deja-vu
chmod +x deja-vu
./deja-vu --help

# 或通过 Go 安装
go install github.com/vshulcz/deja-vu@latest

第二步：配置 MCP Server

deja-vu 以 MCP（Model Context Protocol）协议运行，可被任何支持 MCP 的 Agent 调用：

{
  "mcpServers": {
    "deja-vu": {
      "command": "deja-vu",
      "args": ["serve"]
    }
  }
}

第三步：开始使用记忆功能

配置完成后，Agent 自动获得以下能力：

• 搜索历史对话和决策
• 自动注入相关上下文
• 密钥和敏感信息自动脱敏
• 跨会话记忆同步

常见踩坑

1. 二进制路径：确保 deja-vu 二进制在 PATH 中，否则 MCP 配置需要绝对路径
2. 存储位置：deja-vu 的本地存储默认在 ~/.deja-vu/，注意磁盘空间
3. 密钥脱敏：虽然有自动脱敏，但仍建议不要在对话中明文粘贴 API Key
4. 多 Agent 并发：多个 Agent 同时写入时可能出现冲突，建议按项目隔离存储
5. 搜索精度：基于关键词的搜索可能不如语义搜索精准，需要合理设置搜索参数

常见问题 FAQ

Q1: deja-vu 和 Claude Memory 有什么区别？

A: Claude Memory 是 Claude 内置的简单记忆功能，deja-vu 是独立的记忆层，支持多 Agent、MCP 协议、自动上下文注入和搜索，功能更强大。

Q2: 数据存储在哪里？安全吗？

A: 数据完全本地存储，不出本机。支持密钥脱敏，敏感信息不会明文存储。

Q3: 支持哪些 Agent？

A: 支持所有兼容 MCP 协议的 Agent，包括 Claude Code、Codex、opencode 等。

Q4: 可以跨设备同步吗？

A: 支持 share and sync 功能，可以在多台设备间同步记忆数据。

Q5: 免费吗？

A: MIT 开源，完全免费。

参考链接

• 官方仓库
• MIT License
• MCP 协议文档