Claude Code

claude plugin marketplace add nowledge-co/community && claude plugin install nowledge-mem@nowledge-community

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

开始之前

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

设置

# 添加 Nowledge 社区插件市场
claude plugin marketplace add nowledge-co/community

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

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

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

claude plugin marketplace update
claude plugin update nowledge-mem@nowledge-community
# 重启 Claude Code 以应用更改

安全地自定义

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

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

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

生命周期钩子

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

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

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

本地与远程模式

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

• 本地（Mem 在同一台机器上）：优先通过 Mem 读取 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 编程工具。

相关

• 集成概览 -- 原生集成、复用包、MCP 与浏览器捕获
• Claude Desktop · Codex CLI · Alma · OpenClaw · Raycast · 内置 Web 聊天