10 分钟上手：给 Claude Code 装上 ai-memory，让 Agent 跨会话记住你的项目偏好

10 分钟上手给 Claude Code 装上 ai-memory让 Agent 跨会话记住你的项目偏好【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory每天都在向 Claude Code 重复同一句话这个项目用 pnpm、测试放 tests/suite、别碰支付模块——然后在下一次会话、换一个 AI 编程工具、或换一台电脑时把同样的话再讲一遍。AI 编程智能体的记忆能力一直是碎片化的Claude Code 自己的笔记锁在单机、Cursor 记的东西换工具就失效、Codex 每次开新会话都像失忆。ai-memory 想解决的就是这件事它把记忆从每个工具各自的私房笔记变成一份跨 Agent、跨项目、跨机器的共享记忆。社区里已经有文章把它总结为给所有 AI 编程工具装上互通的长期记忆。本文不讨论它的架构理念直接带你 10 分钟跑起来——用 Docker 一键起服务、给 Claude Code 接上钩子与 MCP、再验证一次真实的跨会话回查。安装与初始化Rust 服务一键起ai-memory 的核心是一个用 Rust 写的单体二进制README.md同时承担 MCP/HTTP 服务器与 CLI 客户端两个角色。最省事的安装路径是 Docker仓库发布的镜像同时包含linux/amd64与linux/arm64Apple Silicon 和 ARM64 Linux 直接拉取即可不需要平台模拟。# 1. 安装 CLI 包装器宿主上唯一需要落盘的东西一个几百字节的 shell 脚本 mkdir -p ~/.local/bin # 从 release 下载 ai-memory-wrapper 并校验 sha256过程略见 README 快速开始 # 2. 启动服务器绑定 127.0.0.1:49374默认零 LLM 模式 docker run -d --name ai-memory \ --restart unless-stopped \ -p 127.0.0.1:49374:49374 \ -v ai-memory-data:/data \ docker.io/akitaonrails/ai-memory:latest这一步值得注意的细节快速开始默认不带任何认证服务只绑定 loopback单机场景下外部无法访问需要 LAN 暴露时再追加一行AI_MEMORY_AUTH_TOKEN即可docs/install.md 中针对 homelab 场景给出了完整的环境变量组合包括AI_MEMORY_ALLOWED_HOSTS防 DNS rebinding。数据落到容器卷里的ai-memory-data内部结构是三层wiki/Markdown 事实源git 版本化、db/SQLite 派生索引含 FTS5、实体与嵌入、logs/滚动日志——这正是仓库在 架构章节 中强调的唯一事实源 派生索引双层设计数据库随时可以从 Markdown 重建没有任何二进制私有格式绑架你的记忆。配置 Claude Code两条命令完成接线服务器起来后给 Claude Code 接线只需要两条命令ai-memory install-mcp --client claude-code --apply ai-memory install-hooks --agent claude-code --apply这两条命令分别做两件不同的事MCP 注册install-mcp把 ai-memory 注册为 Claude Code 的 MCP 服务让 Agent 能主动调用memory_query、memory_write_page、memory_handoff_accept等记忆工具生命周期钩子install-hooks在~/.claude/settings.json里注册 Claude Code 的事件钩子让每一次提示、每一次工具调用、每一次会话开始/结束都自动流进 ai-memory。钩子不是摆设仓库 hooks/claude-code/ 下躺着真实可读的脚本session-start.sh在会话开始时把事件 POST 给服务器同时同步拉取待交接的 Handoff 并打印到 stdout——Claude Code 会把 SessionStart 钩子的 stdout 注入到下一个会话上下文里于是断点续传不需要人肉粘贴任何总结user-prompt-submit.sh和post-tool-use.sh则是 fire-and-forget 地把提示词与工具调用转发到/hook端点。三条脚本末尾都输出{}保持 Claude Code 的调试日志干净细节考虑得很到位。而 Docker 包装器在 Linux/macOS 上会把install-hooks转交给校验过 checksum 的原生宿主客户端执行所以这些钩子能强制实施[capture] ignore_paths之类的捕获策略——事件在进入本地 spool 之前就被过滤掉了。如果你不想手动分两步仓库还推荐一条更省事的路径直接用ai-memory run claude启动首次运行会自动补装该 harness 的 MCP 与钩子README.md。不止 Claude Code二十余种 CLI 客户端同一套命令ai-memory 的价值在于记忆是互通的README 的支持矩阵列出了二十多种第一方集成README.mdClaude Code、OpenAI Codex、Cursor、Gemini CLI、Grok Build CLI、Devin、Kimi Code、Kiro CLI、GitHub Copilot CLI、Zed、Claude Desktop……全部接同一份记忆。换工具的接线方式完全一样只是--client/--agent参数换名字# OpenAI Codex ai-memory install-mcp --client codex --apply ai-memory install-hooks --agent codex --apply # Cursor / Gemini CLI / Kimi Code / Copilot CLI ai-memory install-mcp --client cursor --apply ai-memory install-mcp --client gemini-cli --apply ai-memory install-hooks --agent kimi-code --apply ai-memory install-hooks --agent copilot-cli --apply每种客户端的配置路径、事件语义差异、Handoff 注入方式都记录在 docs/install.md 与 docs/support-matrix.md 中——比如 Kimi Code 把 Handoff 通过UserPromptSubmit的 stdout 注入它丢弃 SessionStart 的 stdoutGrok 则要等到第一个PostToolUse才打印additionalContext。这类各家 hook 契约不同的细节被封装成了统一的安装器是这套多客户端方案能成立的关键工程点。验证记忆跨会话回查你的项目上下文装完别急着关终端花两分钟验证一下记忆真的生效了。第一步先跑一局 Claude Code在一个真实项目目录里做一点活儿说一句Remember that we always use pnpm here然后退出会话。会话结束时生命周期钩子会自动触发会话摘要写入与 Handoff 创建——这一步完全不需要 LLM规则式摘要与 FTS 全文检索都是零 API 调用路径README.md。第二步跨会话回查。可以换个工具比如开 Codex也可以直接重启 Claude Code。两种验证姿势Handoff 断点续传新会话的 SessionStart 钩子会自动取回上一条 Handoff 并注入上下文。你什么都不用做Agent 已经知道上次干到哪、什么失败了、什么问题还悬着。文档 docs/usage.md 里有一段教科书式的演示claude里做到一半退出同一个目录下再开codexCodex 在收到你的第一条提示前就已经看到了交接内容。自然语言查记忆直接问Have we discussed X?或where did we leave off?Agent 会调用memory_querycrates/ai-memory-mcp/src/server.rs 中memory_query的实现是 FTS5 实体 图邻域 可选向量的 RRF 融合排序把编译成 Markdown 页面的历史记忆搜出来给你看。命令行也可以直接查ai-memory status打印运行时状态计数、路径、版本ai-memory search 关键词走 FTS5 全文检索crates/ai-memory-cli/src/cli.rs。给服务器加上--enable-web后还能在浏览器里以只读方式翻阅整个项目 wiki让偏好跨项目流动cross-project profile标题里提到的项目偏好对应的正是仓库里一个专门的设计跨项目画像docs/cross-project-profile.md。你平时随口说的习惯性表述——always use pnpm、keep integration tests in tests/suite——会被识别并沉淀进个人画像之后每个新项目、每一种 harness 的会话开始时Agent 都会收到一段你的惯用选择摘要默认低于仓库规则文件生效。单用户场景默认开启多用户服务器上则是每人的私有画像、按项目 opt-in。这套机制与抓取情报中社区文章总结的钩子捕获 → 脱敏入库 → 会话摘要 → Handoff 交接 → 混合检索 → 分层遗忘八步数据流完全对应记忆不再是一次性的 RAG 上下文补丁而是会积累、会老化、会在不同工具间流动的工程基础设施。对天天换着用 Claude Code 和 Codex 的开发者来说10 分钟装好它换来的是从此不用再向每个 Agent 解释第三遍这个项目该怎么干。【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考