Skip to main content
Nowledge MemNowledge Mem
连接

让 Claude Code 记住之前的决定

把 Claude Code 接入 Nowledge Mem,新会话也能查回之前的决定和项目背景。从安装插件开始,再验证一次记忆搜索。

给你的智能体

把这行交给你的智能体。它应该先使用统一安装指南;这一页保留为行为说明和排障参考:

读取 https://mem.nowledge.co/SKILL.md,按其中说明为 Claude Code 安装或更新 Nowledge Mem。用 nmem status 和 Working Memory 检查验证结果,并总结你改了什么。
一键安装
claude plugin marketplace add https://github.com/nowledge-co/community && claude plugin install nowledge-mem@nowledge-community

插件原生支持

Claude Code 支持插件,一次安装即可获得内置自主行为,无需配置系统提示或 MCP。

智能体会自动搜索你已经知道的内容,并在正确的时机保存值得留下的东西,无需你手动触发。

第一次成功应该是什么样

安装好插件、确认 nmem 可用,然后开一个新的 Claude Code 会话。只要你能看到工作记忆简报在开局被读取,或者 /search / /save 无需额外配置就能工作,这条路径就已经接通了。

开始之前

  • Nowledge Mem 已在本地运行(安装指南),或你已经有可访问的远程 Mem 服务
  • 已安装 Claude Code

设置

安装插件

# 添加 Nowledge 社区插件市场
claude plugin marketplace add https://github.com/nowledge-co/community

# 安装 Nowledge Mem 插件
claude plugin install nowledge-mem@nowledge-community

插件需要 nmem CLI:

# 方式一(推荐):使用 uvx,无需额外安装
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version

# 方式二:pip 安装
pip install nmem-cli

如果这台机器上已经安装 Nowledge Mem 桌面端,最稳妥的方式是打开 Settings → Preferences → Developer Tools → Install CLI。只有在远程机器或没有桌面端的环境中,才需要用 uvx 或手动安装。

使用斜杠命令与技能

斜杠命令:

  • /save:保存当前会话到 Nowledge Mem
  • /sum:将对话洞察提炼成记忆
  • /search <关键词>:搜索知识库
  • /status:检查服务器连接状态

自然语言: 说「保存这个会话」或「提炼这次对话」,Claude 会自动运行对应的 nmem 命令。

自主运行(技能): 插件包含三个自动触发的技能:

  • Read Working Memory:会话开始和上下文压缩后加载工作记忆简报
  • Search Memory:引用过去工作时自动搜索
  • Distill Memory:在关键发现时建议提炼

按需触发: Save Thread:当你说「保存会话」或「checkpoint」时保存对话

更新

claude plugin marketplace add https://github.com/nowledge-co/community
claude plugin marketplace update nowledge-community
claude plugin update nowledge-mem@nowledge-community
# 重启 Claude Code 以应用更改

导入旧会话

自动捕获会从插件和 hooks 安装完成后开始。如果你想把更早的 Claude Code 会话也导入 Nowledge Mem,先预览:

nmem t sync --from claude-code --all-projects --limit 20

确认无误后再导入:

nmem t sync --from claude-code --all-projects --apply

如果只想导入某个项目,用 -p /path/to/project 代替 --all-projects。这个命令会读取本机 Claude Code 会话文件,并写入 nmem 当前配置的 Mem 服务器。

Spaces

Spaces 是显式选择,不是目录名自动生成。Claude Code 插件不会根据当前文件夹、git 仓库、分支或项目名创建或选择 Mem space。没有额外设置时,Context Bundle、Working Memory、搜索和自动会话捕获都会使用默认 space。

只有当整个 Claude Code 进程都应该使用某个已存在的 Mem space 时,才设置 NMEM_SPACE:

NMEM_SPACE="Research Agent" claude

如果是多 Agent 启动器,优先用稳定的 NMEM_AGENT_ID 表示 worker 身份。只有这个 worker 需要覆盖身份默认 space 时,再加 NMEM_SPACE。

安全地自定义

优先使用 Claude Code 自己的记忆文件,而不是去改插件安装目录:

  • 个人调整放在 CLAUDE.local.md
  • 仓库共享规则放在 CLAUDE.md

不要直接修改已安装的 Nowledge Mem 插件文件。完整对照表见 安全地自定义连接行为。

生命周期钩子

插件使用 Claude Code hooks 实现自动生命周期管理:

事件触发条件操作
SessionStart(启动/恢复/清除)新会话、恢复或清除先通过 nmem context 加载 Context Bundle,再回退到 nmem wm read 和本地文件
SessionStart(压缩)上下文压缩后重新加载 Context Bundle 或 Working Memory,提示 Claude 保存重要发现
UserPromptSubmit每条用户消息注入搜索/保存语法提示,Claude 可见
PreCompact手动或自动压缩前在上下文被压缩前,先保存这条 Claude Code 会话
Stop模型完成响应在有界重试窗口内捕获会话到知识图谱

上下文压缩后,Context Bundle 或 Working Memory 会重新加载。PreCompact 钩子会在 Claude Code 压缩上下文前先保存完整本地会话,Stop 钩子则继续负责平时每轮回复后的捕获。即使 Nowledge Mem 运行在另一台机器上(远程模式),这条路径也能工作。如果 Claude Code 在回复后还需要一点时间把 transcript 写完,钩子会等待并重试,而不是静默产生一次空保存。

如果桌面应用里的 Claude Code 文件监听也已开启,可以继续保留。文件监听和插件钩子会写入同一个 claude-code-<sessionId> 线程;重复保存只会更新已有线程,不会再生成第二条。

本地与远程模式

插件在两种模式下透明运行:

  • 本地(Mem 在同一台机器上):优先通过 Mem 读取 Context Bundle,旧版 CLI 会回退到 Working Memory。只有 API 路径不可用时,插件才会把 ~/ai-now/memory.md 当作 Default 分区的兼容回退。会话会由桌面应用文件监听、Stop 钩子,以及压缩前的 PreCompact 钩子一起捕获。
  • 远程(Mem 在不同机器上):先在这台机器上执行一次:
nmem config client set url https://your-server
nmem config client set api-key your-key

这会写入 nmem 和插件共用的本地客户端配置。也可使用环境变量(NMEM_API_URL、NMEM_API_KEY)做临时覆盖。优先级:CLI 参数 > 环境变量 > 配置文件 > 默认值。

当 Stop 或 PreCompact 钩子运行 nmem t save --from claude-code 时,Claude 的会话文件会先在运行 Claude Code 的那台机器上被本地读取,再以规范化后的线程消息上传到 Mem。默认会读取 ~/.claude;如果你把 Claude 配置放在别的位置,设置 CLAUDE_CONFIG_DIR 就可以了。远程 Mem 服务器不需要直接访问这个本地目录。

进阶

AGENTS.md:基于 agents.md 标准 的完整记忆守护 Agent 示例,适配任何 AI 编程工具。

相关

On this page