ai-memory接入Claude Codeinstall-mcp与install-hooks两条命令实战指南【免费下载链接】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-memoryai-memory 是一款为 AI 编码智能体提供长期记忆的开源工具在 Claude Code 会话中产生的提示词与工具调用会被自动捕获编译成结构化的 markdown 记忆库下次开会话甚至换用 Codex 等其他智能体时自动注入上次进度。本文只讲最实用的两条接入命令——install-mcp与install-hooks帮你 5 分钟完成 Claude Code 与 ai-memory 的对接。两条命令各自负责什么命令作用缺了会怎样ai-memory install-mcp把 ai-memory 注册为 Claude Code 的 MCP 服务器Claude 只能写入记忆无法主动查询memory_query、接受 handoffai-memory install-hooks注册生命周期钩子自动捕获会话事件Claude 可以查记忆但不会自动记录新内容需手动调用一句话概括MCP 负责读Hooks 负责写两条都装才是完整的长期记忆闭环。前置步骤先启动 ai-memory 服务器ai-memory 采用客户端/服务器架构CLI 是薄 HTTP 客户端状态全部由服务器写入。Docker 是最快的启动方式支持 amd64/arm64docker run -d --name ai-memory \ --restart unless-stopped \ -p 127.0.0.1:49374:49374 \ -v ai-memory-data:/data \ akitaonrails/ai-memory:latest默认只绑定回环地址、不开启鉴权适合单机使用。如果你的服务器跑在局域网机器上需要额外导出两个环境变量install-mcp/install-hooks会自动读取export AI_MEMORY_SERVER_URLhttp://服务器IP:49374 export AI_MEMORY_AUTH_TOKENtoken实战一用 install-mcp 注册 MCP 服务器ai-memory install-mcp --client claude-code --apply这条命令做的事很简单向 Claude Code 的配置文件~/.claude.json合并一个名为ai-memory的 MCP 条目指向http://127.0.0.1:49374/mcp。安装器源码见 install_mcp.rs。几个实用细节--apply是幂等的重复执行只会替换 ai-memory 自己的条目其他 MCP 服务器原样保留且每次写入前生成带时间戳的.bak-ts备份。去掉--apply则只打印配置片段方便你手动粘贴或检查内容。并发会话隔离如果同一台机器上会同时跑多个 Claude Code 会话可改用会话感知模式ai-memory install-mcp --client claude-code --session-aware --apply它生成一个本地 stdio 桥接进程把 Claude 的生命周期会话 ID 附加到每个 MCP 请求上配合服务器端[auto_scope] mode per_session实现多会话记忆隔离。详见 auto-scope.md。实战二用 install-hooks 注册生命周期钩子ai-memory install-hooks --agent claude-code --apply这条命令会向~/.claude/settings.json合并 ai-memory 的钩子条目并把可执行的钩子脚本暂存到~/.local/share/ai-memory/hooks/claude-code/。钩子脚本源码位于 hooks/claude-code/安装器实现见 install_hooks.rs。覆盖的事件包括SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、PreCompact、Stop、SessionEnd以及子智能体的SubagentStart/SubagentStop。其中最关键的是 session-start.sh把会话开始事件发射即忘地发给服务器同步拉取待处理的handoff跨会话交接并打印到 stdout——Claude Code 会把SessionStart钩子的输出注入新会话开头于是你打开项目的那一刻Claude 已经知道上次做到哪了。几个常用开关选项用途--project-strategy repo-root按 git 仓库根目录归一化项目名子目录和 worktree 都收敛到同一个项目--no-capture-prompts禁用用户提示词捕获合规环境可用--capture-assistant附加捕获助手最后一轮回复需服务器端同步开启capture_assistant true验证如何确认记忆真的生效跑一段对话像平时一样打开 Claude Code 做点开发工作然后退出。看计数变化运行ai-memory status对比前后sessions与observations的数量有增长说明捕获成功。打开 Web 界面浏览器访问http://127.0.0.1:49374/web可以按项目浏览自动编译出的记忆页面concepts、decisions、gotchas 等。开会话测试 handoff重新打开 Claude Code首条提示前会自动注入where you left off上下文块。常见问题与卸载升级后要不要重装本地原生安装下钩子命令直接调用已升级的ai-memory二进制通常无需重装脚本回退安装方式建议重跑一次install-hooks --agent claude-code --apply刷新暂存脚本。改了CLAUDE_CONFIG_DIR两条安装命令都遵循 Claude Code 自己的配置解析规则会自动把 MCP 注册写到$CLAUDE_CONFIG_DIR/.claude.json、钩子写到$CLAUDE_CONFIG_DIR/settings.json。想彻底移除运行ai-memory uninstall --apply它会按 ai-memory 签名精确清理自己写入的配置条目、指令块和托管技能文件不碰你的其他配置。延伸资料完整安装手册局域网部署、AUR 原生包、各智能体配置install.mdMCP 接入更多客户端mcp-install.md跨智能体 handoff 与托管工作流managed-workstreams.md整体架构设计ARCHITECTURE.md至此Claude Code 已经拥有了记性——退出、换智能体、隔天再开上下文都还在。【免费下载链接】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），仅供参考