单会话记忆治理栈（claude-mem + deepcode + code-review-graph） 已实测

场景

你的开发会话「失忆」：今天聊过的上下文、决定、坑，明天全忘了。你想要的单会话开发闭环是：记得住（跨会话记忆）、查得准（提交前静态分析拦住明显问题）、看得全（改动影响面图谱）。三件事三种工具，你会担心：claude-mem 要 npm + Bun + 插件注册，和 pip 工具一起装会不会冲突？

本组合包给答案：claude-mem 跨会话记忆底座（记忆 + UI + MCP）、deepcode 静态分析（提交前）、code-review-graph（crg） 审查图谱（影响面）。三件写面互不重叠（3/3 对子 verified），跨生态（npm + pip）共装实测兼容。

组合成员 （3）

npm_config_registry=https://registry.npmmirror.com npm install -g claude-mem
claude-mem install --ide claude-code   # 预期输出: Installation Complete（Plugin dir: ~/.claude/plugins/...；Worker port: 37700）

pip install deepcode-hku --index-url https://pypi.tuna.tsinghua.edu.cn/simple
deepcode --version   # 预期输出: DeepCode 2.1.0

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple code-review-graph==2.3.8
code-review-graph --version   # 预期输出: code-review-graph 2.3.8

方案总览

备选方案：只要「记得住」→ 只装 claude-mem；只要「提交前检查」→ 只装 deepcode。顺序逻辑：claude-mem 是唯一写 ~/.claude 注册面的成员，先装先确认；再 pip 分析器，最后图谱。

快速开始

一键脚本由本文档自动生成（渲染后位于 pages/combos/combo-memory-session.sh），逐条执行：

bash pages/combos/combo-memory-session.sh

• 装完你会得到：claude-mem 记忆底座（含插件注册）+ deepcode + code-review-graph，单会话开发闭环三件套。
• 预计耗时：10-15 分钟。最大卡点 = claude-mem 插件安装时的网络（npm 包 + 插件市场拉取，命令已带 npmmirror）。
• 前置条件：Bun（claude-mem worker 运行时）；Python >= 3.12（deepcode）；Claude Code 可用（插件注册需要）。

想弄明白每一步在干什么、装错了怎么恢复 → 看「逐步教学」。一键脚本出问题 → 按逐步教学手动执行定位。

逐步教学

第 1 步：装 claude-mem（跨会话记忆底座）

claude-mem 解决「失忆」：它把会话记忆持久化，提供记忆 UI 和 MCP 搜索。安装会写多个地方：~/.claude.json（插件注册）+ ~/.claude/plugins/ + ~/.claude/backups/ + ~/.claude-mem/（数据），worker 端口 37700。它是本组合唯一写注册面的成员，先装先确认；worker 运行时需要 Bun（先 curl -fsSL https://bun.sh/install | bash 或包管理器装）。

npm_config_registry=https://registry.npmmirror.com npm install -g claude-mem
claude-mem install --ide claude-code   # 预期输出: Installation Complete（Plugin dir: ~/.claude/plugins/...；Worker port: 37700）

预期输出: Installation Complete（含 Plugin dir 与 Worker port 37700）

装好确认：

• claude-mem --version 输出版本号；
• claude-mem install --ide claude-code 输出 Installation Complete；
• ~/.claude/plugins/ 下出现插件目录。

卡住怎么办：

• npm 慢 → 命令已带 npmmirror registry。
• Bun 缺失 → worker 运行时需要 Bun，先装 Bun 再 install。
• 安装写面被占（已有其它 claude 插件）→ 装前查 bash 站内文档 claude-mem，与 claude 生态条目共享 ~/.claude 注册面（possible-conflict 推断行）。

第 2 步：装 deepcode（静态分析）

deepcode 管「查得准」：提交前静态分析拦明显问题。重件（Python >= 3.12，全量依赖约 40s）；与 claude-mem 跨生态共装实测兼容（npm vs pip 天然隔离）。装完配置 provider 后即可跑分析。

pip install deepcode-hku --index-url https://pypi.tuna.tsinghua.edu.cn/simple
deepcode --version   # 预期输出: DeepCode 2.1.0

预期输出: DeepCode 2.1.0

装好确认：

• deepcode --version 输出 DeepCode 2.1.0；
• deepcode init 初始化成功。

卡住怎么办：

• 安装慢/超时 → 正常（40s 量级），命令已带清华镜像，重试一次。
• Python 版本不足 → 需要 3.12，升级后再装。
• provider 未配置 → deepcode provider set <厂商> --api-key <key>；本地 provider 无需 key。

第 3 步：装 code-review-graph（审查图谱）

crg 管「看得全」：构建代码关联图，看清改动影响面。轻件；与 claude-mem（npm）和 deepcode（pip）均 verified 兼容。不要执行 crg install 注册子命令（会写 ~/.claude.json 等注册面，与 claude-mem 的注册面叠加重叠风险），本组合只用 CLI 面（build/status）。

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple code-review-graph==2.3.8
code-review-graph --version   # 预期输出: code-review-graph 2.3.8

预期输出: code-review-graph 2.3.8

装好确认：

• code-review-graph --version 输出版本号；
• 工作区 code-review-graph build 建图成功。

卡住怎么办：

• pip 超时 → 清华镜像已内置，重试。
• build 失败 → 确认在 git 仓库根目录。

装完验收（一步到位）

作用：装完跑下面一条命令块，全绿 = 本组合包就绪；某条失败 → 回「逐步教学」对应步骤定位。

claude-mem --version
deepcode --version
code-review-graph --version
claude-mem install --ide claude-code 2>&1 | tail -2

预期输出: claude-mem 版本号（CLI 12.4.7 滞后于插件本体 13.16.1 属官方现象）；DeepCode 2.1.0；code-review-graph 2.3.8；install 输出 Installation Complete（无报错）

注：成员级命令已实测；worker 运行时需 Bun（先装 Bun 再跑 install）。

日常使用

启动与入口

• claude-mem：worker 自动随 Claude Code 启动（端口 37700）；记忆 UI 与 MCP 搜索按官方文档启用。
• deepcode：deepcode init → deepcode run。
• crg：code-review-graph build / code-review-graph status。

常用操作

1. 会话闭环：写码时 claude-mem 自动记 → 提交前 deepcode run 查问题 → 审查时 code-review-graph build 看影响面。
2. 记忆检索：通过 claude-mem 的 MCP mcp-search 在会话里直接搜历史记忆。
3. 组合冒烟：claude-mem --version && deepcode --version && code-review-graph --version。

数据与目录

• claude-mem：~/.claude-mem/（记忆数据）+ ~/.claude/plugins/（插件）+ ~/.claude/backups/。
• deepcode：配置 ~/.config/deepcode/（推断）。
• crg：工作区 .code-review-graph/。

卸载与清理

按安装相反顺序卸载：

# 1. crg + deepcode（同 venv）
pip uninstall -y code-review-graph deepcode-hku
rm -rf .code-review-graph
# 2. claude-mem（npm 全局 + 插件注册 + 数据）
npm uninstall -g claude-mem
rm -rf ~/.claude-mem ~/.claude/backups
# 插件注册残留以 claude-mem 官方卸载说明为准（~/.claude.json / ~/.claude/plugins/ 内条目）

提示：~/.claude-mem/ 是记忆数据，删除即永久丢失历史记忆；卸载前确认不需要。

安装顺序

1. 先 claude-mem（记忆底座，npm + 插件注册）——唯一写 ~/.claude 注册面的成员，先装先确认。
2. 再 deepcode（pip 分析器）——与 claude-mem 跨生态共装实测兼容（coexist-deepcode 证据）。
3. 最后 crg（pip 图谱）——与两者均 verified 兼容；任意顺序均可，但记忆底座先于分析/图谱语义上更顺。

依赖警告

• 冲突：claude-mem×deepcode compatible（verified 2026-08-28，跨生态 npm+pip 共装双冒烟 exit 0）；claude-mem×crg compatible（verified）；crg×deepcode compatible（verified）——3/3 对子 verified，出处：站内文档。注意：claude-mem 与 claude 生态条目（omc/cc-switch/ccr/skilldock 等）存在 possible-conflict 推断行（共享 ~/.claude 注册面），装前查 bash 站内文档 claude-mem。
• 版本：claude-mem [13.16.1,13.16.1]（npm CLI 12.4.7）；deepcode [2.1.0,2.1.0]（Python >= 3.12）；crg [2.3.8,2.3.8]。
• 环境：claude-mem worker 需 Bun（运行时）+ 端口 37700（记忆 UI/MCP）；deepcode 分析需 LLM provider；crg build 写工作区 .code-review-graph/。
• 国内网络：npm 走 npmmirror；pip 走清华镜像；最容易卡的一步 = claude-mem 插件安装时的网络（npm 包 + 插件市场拉取），命令已带 npmmirror。

FAQ

1. claude-mem 和 pip 工具一起装会冲突吗？ → 不会。npm/pip 分属独立生态，3/3 对子 verified（跨生态共装双冒烟 exit 0，写面无重叠，实测复现日志（2026-08-28） 等）。
2. claude-mem 装完没生效？ → 确认 Bun 已装 + claude-mem install --ide claude-code 输出 Installation Complete；与其它 claude 生态条目共享注册面时可能互相干扰（possible-conflict 推断态），装前 bash 站内文档 claude-mem。
3. deepcode 没 API key 能用吗？ → 能，本地 provider 不需要云 key；用云厂商才需要。
4. 要不要执行 crg install 注册到 Claude Code？ → 本组合不需要。它和 claude-mem 都写 ~/.claude 注册面，叠加有风险；只用 CLI 面（build/status）。

验证证据

每份组合包在隔离环境实测（冒烟 + 写面检查），未实测项在文中如实标注；实测日期见下方验证证据。

验证于 2026-08-29 · TTL 到期 2027-02-25（180 天）

本站实测记录（2026-08-28）

• 实测复现日志（2026-08-28）；实测复现日志（2026-08-28）；实测复现日志（2026-08-28）。
• 未实测（如实标注）：claude-mem 插件注册形态与 claude 生态条目共装（本机未登录 Claude，矩阵推断态）；deepcode 完整分析流程（需 provider）；crg 注册子命令（本组合不执行）。

关联问题

• claude-mem-6
• claude-mem-3