如何管理 AI Agent 的记忆之二：让 Claude Code、Codex、OpenCode 共享同一份记忆

$ ls -la ~/.claude/CLAUDE.md ~/.codex/AGENTS.md ~/.config/opencode/AGENTS.md
~/.claude/CLAUDE.md          # 给 Claude Code 看的个人规则
~/.codex/AGENTS.md           # 给 Codex 看的，内容八成一样
~/.config/opencode/AGENTS.md # 给 OpenCode 看的，又抄了一遍

# 项目根目录下
# 1) 保留 AGENTS.md 作为单一事实源（Codex / OpenCode 直接读它）
# 2) 把 CLAUDE.md 变成指向 AGENTS.md 的软链（Claude Code 也读到同一份）
ln -sf AGENTS.md CLAUDE.md

# 验证：CLAUDE.md 现在是个指向 AGENTS.md 的链接
ls -l CLAUDE.md
# CLAUDE.md -> AGENTS.md

# 1) 真身放一个中立位置，比如 ~/.config/ai/AGENTS.md
mkdir -p ~/.config/ai
mv ~/.claude/CLAUDE.md ~/.config/ai/AGENTS.md   # 把现有内容挪过去当真身

# 2) 三个工具的路径都软链到这份真身
ln -sf ~/.config/ai/AGENTS.md ~/.claude/CLAUDE.md
ln -sf ~/.config/ai/AGENTS.md ~/.codex/AGENTS.md
ln -sf ~/.config/ai/AGENTS.md ~/.config/opencode/AGENTS.md

# 3) 验证三条都指向同一个 inode（ls -i 看 inode 号是否相同）
ls -li ~/.claude/CLAUDE.md ~/.codex/AGENTS.md ~/.config/opencode/AGENTS.md

<!-- ~/.claude/CLAUDE.md 里就写一行 -->
@~/.config/ai/AGENTS.md

<!-- ~/.codex/AGENTS.md 里也是 -->
@~/.config/ai/AGENTS.md

   Claude Code      Codex       OpenCode
        │             │            │
        └──────┬──────┴─────┬──────┘
               │  MCP 协议   │
               ▼             ▼
        ┌──────────────────────────┐
        │   记忆 MCP Server         │
        │   remember() / recall()   │  ← 上一篇那套逻辑
        └──────────────────────────┘
               │
        PostgreSQL + pgvector
        （单一记忆后端，谁写都读得到）

# memory_mcp_server.py
from mcp.server.fastmcp import FastMCP
from memory_store import remember, recall   # 上一篇实现的那两个函数

mcp = FastMCP("shared-memory")

@mcp.tool()
def save_memory(user_id: str, text: str, kind: str = "semantic") -> str:
    """把一条值得长期记住的信息存进共享记忆（会自动打分+去重）。"""
    remember(user_id, text, kind=kind, source="mcp")
    return "ok"

@mcp.tool()
def search_memory(user_id: str, query: str, k: int = 3) -> list[str]:
    """从共享记忆里检索与 query 最相关的 top-k 条。"""
    return recall(user_id, query, k=k)

if __name__ == "__main__":
    mcp.run()   # 默认 stdio 传输，三个工具都能连

// Claude Code: 项目根 .mcp.json（或用 `claude mcp add` 命令）
{
  "mcpServers": {
    "shared-memory": {
      "command": "python",
      "args": ["/path/to/memory_mcp_server.py"]
    }
  }
}

// OpenCode: opencode.json 里的 mcp 段
{
  "mcp": {
    "shared-memory": {
      "type": "local",
      "command": ["python", "/path/to/memory_mcp_server.py"]
    }
  }
}

#!/usr/bin/env bash
set -euo pipefail

# 单一事实源
SRC="$HOME/.config/ai/AGENTS.md"
mkdir -p "$(dirname "$SRC")"

# 若真身还不存在，从现有 Claude 规则迁过来（没有就建空文件）
if [[ ! -f "$SRC" ]]; then
  if [[ -f "$HOME/.claude/CLAUDE.md" && ! -L "$HOME/.claude/CLAUDE.md" ]]; then
    mv "$HOME/.claude/CLAUDE.md" "$SRC"
  else
    touch "$SRC"
  fi
fi

link() {  # 备份已有真文件，再建软链
  local target="$1"
  mkdir -p "$(dirname "$target")"
  if [[ -f "$target" && ! -L "$target" ]]; then
    mv "$target" "$target.bak.$(date +%s)"
    echo "backed up $target"
  fi
  ln -sf "$SRC" "$target"
  echo "linked $target -> $SRC"
}

link "$HOME/.claude/CLAUDE.md"
link "$HOME/.codex/AGENTS.md"
link "$HOME/.config/opencode/AGENTS.md"

echo "done. edit $SRC once, all three tools follow."

@startmindmap
<style>
mindmapDiagram {
  node {
    BackgroundColor #F8F9FA
    RoundCorner 10
    Padding 10
    FontSize 13
  }
  :depth(0) {
    BackgroundColor #1E3A5F
    FontColor white
    FontSize 18
    FontStyle bold
  }
  :depth(1) {
    FontSize 15
    FontStyle bold
  }
  :depth(2) {
    FontSize 13
  }
}
</style>

* 三个编码 Agent 共享记忆
** 痛点
*** 一套规则抄三份
*** 改了这个忘那个
*** 三个助手各说各话
** 各读哪份文件
*** Claude Code: CLAUDE.md
*** Codex: AGENTS.md
*** OpenCode: AGENTS.md
*** 都是磁盘上一个文件
** 静态规则层
*** 单一事实源
*** 符号链接（macOS/Linux）
*** import 引用（跨平台）
*** 全局 vs 项目分开
** 动态记忆层
*** 各工具自动记忆不互通
*** 用 MCP 做统一接口
*** 复用上一篇记忆库
*** 谁写的另俩都读得到
** 坑
*** 动态别写进静态文件
*** symlink 慎入 Git/Windows
*** MCP 记忆做用户/项目隔离
*** 工具更新快先小项目验
** 原则
*** 记忆只存一份
*** 工具是入口不是仓库
@endmindmap