Claude AI Memory

克劳德艾记忆

中文文档

问题

Claude Code会话是无状态的。当您关闭终端时，讨论的所有内容都会丢失：

• 为什么做出某种技术决策
• 上次会议讨论了什么，还有什么悬而未决
• 来自客户沟通的关键信息
• 通过多次会议积累的项目理解

项目文件捕获代码更改，但不捕获其背后的推理、讨论和上下文。

解决方案

克劳德艾记忆给克劳德代码一个 持久存储层 对于每个项目：

• 自动会话摘要 --关键决策、更改和TODO在每个会话结束时保存
• 手动内存捕获 --使用 /remember 明确存储重要信息
• 语义搜索 --使用自然语言查询查找相关历史上下文
• 智能上下文加载 --在会话启动时加载项目概述，按需检索详细上下文
• 多项目隔离 --每个项目都有自己独立的上下文空间

建筑

┌──────────────────────────────────────────────────────┐
│                   Docker Compose                      │
│                                                       │
│  ┌──────────────┐  ┌────────────┐  ┌──────────────┐  │
│  │ openviking   │  │ embedding  │  │ ollama       │  │
│  │ (Rust)       │  │ (FastAPI + │  │ Qwen3-0.6B   │  │
│  │ :1933        │←─│ MiniLM-L6) │  │ :11434       │  │
│  │              │  │ :8100      │  │ (fallback)   │  │
│  └──────┬───────┘  └────────────┘  └──────────────┘  │
│         │  /var/lib/openviking/data (persistent)      │
└─────────┼────────────────────────────────────────────┘
          ↑ HTTP
┌─────────┴────────────────┐
│  claude-ai-memory MCP    │
│  (Python, stdio)         │
└─────────┬────────────────┘
          ↑ MCP stdio
┌─────────┴────────┐
│  Claude Code CLI  │
│  + CLAUDE.md      │
└──────────────────┘

组件

成本

MCP工具

只有4个粗粒度工具被公开以最小化API调用：

context_load

在会话启动时调用一次。在单个响应中返回项目概述、最近会话摘要、待处理项目和活动决策。

{
  "project_path": "/home/user/my-project"
}

context_search

跨项目内存的语义搜索。直接返回L1级内容，无需后续调用。

{
  "project_path": "/home/user/my-project",
  "query": "why did we choose Stripe for payments",
  "scope": "decisions",
  "limit": 5
}

context_save

在一次调用中批量保存多个内存条目。

{
  "project_path": "/home/user/my-project",
  "entries": [
    {
      "type": "session_summary",
      "title": "Implemented user registration",
      "content": "Completed email registration, verification, password strength check. Used Resend for email. TODO: OAuth login."
    },
    {
      "type": "decision",
      "title": "Email service selection",
      "content": "Chose Resend over SendGrid: simpler API, sufficient free tier."
    }
  ]
}

context_manage

低频管理操作：列表、删除、更新和项目初始化。

典型的会话呼叫模式

多项目隔离

每个项目都映射到OpenViking文件系统范式中的一个独立URI命名空间：

viking://
├── projects/
│   ├── 
/        # Project A
│   │   ├── sessions/            # Session summaries
│   │   ├── decisions/           # Architecture decisions
│   │   ├── changes/             # Change records
│   │   └── knowledge/           # Dev resources, notes
│   ├── 
/        # Project B
│   └── ...
└── global/                      # Cross-project knowledge

项目ID：项目根绝对路径的SHA256哈希的前12个字符。

部署

先决条件

• Docker和Docker Compose v2
• Python 3.10+
• MiniMax API密钥(在这里买一个)

快速开始

# 1. Clone the repository
git clone https://github.com/alanshaka-real/claude-ai-memory.git
cd claude-ai-memory

# 2. Configure
cp config/ov.conf.example config/ov.conf
# Edit config/ov.conf with your MiniMax API key

# 3. Start services
docker compose up -d

# 4. Pull Ollama fallback model
docker compose exec ollama ollama pull qwen3:0.6b

# 5. Add MCP server to Claude Code
# Add to ~/.claude/settings.json:
# {
#   "mcpServers": {
#     "claude-ai-memory": {
#       "command": "python",
#       "args": ["/path/to/claude-ai-memory/mcp-server/server.py"]
#     }
#   }
# }

升级（零数据丢失）

docker compose pull openviking   # Pull latest image
docker compose up -d openviking  # Recreate container, data untouched
docker compose ps                # Verify healthy status

数据存储在主机上 /var/lib/openviking/data 通过绑定挂载——容器升级永远不会影响您的数据。

Docker编写服务

错误处理

所有后端故障都得到了妥善处理-- Claude Code始终正常工作，有或没有内存：

如何使用Claude代码

当项目初始化时，claude ai内存将指令注入到项目的 CLAUDE.md:

• 会话开始：克劳德打来电话 context_load 了解项目状态
• 工作期间：克劳德打来电话 context_search 当需要历史背景时
• 会话结束：克劳德打来电话 context_save 保存会话知识
• 手动保存：用户触发器 /remember 显式存储信息

这创建了一个自然的记忆循环，Claude在会话中逐步建立项目理解。

项目结构

claude-ai-memory/
├── docker-compose.yml
├── config/
│   └── ov.conf
├── embedding-service/
│   ├── Dockerfile
│   ├── main.py
│   └── requirements.txt
├── mcp-server/
│   ├── __init__.py
│   ├── server.py
│   ├── viking_client.py
│   ├── project_manager.py
│   └── models.py
├── tests/
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── scripts/
│   ├── setup.sh
│   └── inject-claude-md.sh
├── docs/
│   └── plans/
│       └── 2026-03-01-claude-ai-memory-design.md
├── pyproject.toml
└── README.md

许可证

Apache许可证2.0

致谢

• OpenViking --AI代理的上下文数据库
• 最小最大 -经济高效的LLM API
• 句子变换器 --本地嵌入模型
• 奥拉玛 --本地LLM推理