### [agentmemory：让AI编程代理拥有持久记忆的神器](https://www.willai.cc/article/45)

**Published:** 2026-05-13T01:06:45

**Author:** hiyoho

**Excerpt:** 说实话，用Claude Code或Cursor写代码时，最头疼的就是每次开新会话都要重新解释项目结构、代码规范和之前的决策。CLAUDE.md写满了又容易过时，这个痛点真的太普遍了。 直到我发现了agentmemory——这是一个专门为AI

![agentmemory](https://admin.hiyoho.com/wp-content/uploads/2026/05/agentmemory-banner.png)

说实话，用Claude Code或Cursor写代码时，最头疼的就是每次开新会话都要重新解释项目结构、代码规范和之前的决策。CLAUDE.md写满了又容易过时，这个痛点真的太普遍了。

直到我发现了agentmemory——这是一个专门为AI编程代理打造的持久记忆系统，能自动记住一切，彻底告别重复解释。

* * *

## 🎯 项目简介

agentmemory是GitHub上排名第一的AI编程代理持久记忆工具，基于真实基准测试构建。它能 silently 捕获编程代理的所有操作，将其压缩成可搜索的记忆，在下次会话时自动注入正确的上下文。

目前狂揽 **5.9k+ Stars**，今日增长超过1000 Stars，堪称年度黑马项目！

* * *

## ⚙️ 安装要求和过程

**快速开始（30秒上手）：**

1.  **终端1**：启动记忆服务器  
    `npx @agentmemory/agentmemory`
2.  **终端2**：体验演示  
    `npx @agentmemory/agentmemory demo`
3.  打开 `http://localhost:3113` 查看实时记忆构建过程

**👍 Claude Code 用户**

一行命令搞定：

`/plugin marketplace add rohitg00/agentmemory`

`/plugin install agentmemory`

**👨‍💻 其他代理（Cursor/Cline/Windsurf等）**

在MCP配置中添加：

```
{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"]
    }
  }
}
```

* * *

## 💡 核心功能

-   **🔍 智能检索**：BM25 + 向量 + 知识图谱三路混合搜索，R@5准确率达95.2%
-   **💾 4层记忆架构**：Working → Episodic → Semantic → Procedural，类比人类记忆的运作方式
-   **📌 自动捕获**：12个hooks自动记录所有操作，零手动操作
-   **🔒 隐私优先**：API密钥、私有标签在存储前自动剥离
-   **📈 极低成本**：年省约170K tokens，年成本仅$10（用本地embeddings可降到$0）

* * *

## 🖥️ 典型使用场景

**📈 场景1：长期项目维护**

当你要维护一个半年前的项目时，agentmemory能自动回忆：

-   之前为什么选择这个技术方案
-   哪些文件被频繁修改及原因
-   代码规范和架构决策

**👥 场景2：团队协作**

多个开发者使用同一项目，agentmemory支持命名空间隔离的团队记忆，共享知识同时保留个人偏好。

**🔋 场景3：复杂调试**

遇到之前解决过的类似bug？记忆系统能追溯到原始观察，帮你快速定位。

* * *

## ⭐ 推荐理由

用了快一个月了，最直观的感受是：每次开新会话，Claude真的能“想起来”上次在做什么。调试效率提升明显，因为不再需要反复解释项目背景。

最让我惊喜的是隐私保护——它会自动过滤敏感信息，这点对于企业项目非常重要。

另外，完全零外部依赖（仅需SQLite），安装和迁移都很轻量。

* * *

## 📥 下载地址

-   **🏠 GitHub**：[https://github.com/rohitg00/agentmemory](https://github.com/rohitg00/agentmemory)
-   **🌐 官网**：[https://agent-memory.dev](https://agent-memory.dev)
-   **📖 iii引擎文档**：[https://iii.dev/docs](https://iii.dev/docs)

**Tags:** AI, GitHub, LLM, MCP, 人工智能, 开源

**Categories:** 开源项目

---