Claude Code
Claude Code 专属插件，内置生命周期钩子。会话开始时自动读取工作记忆简报，并在恰当时机搜索与保存。
claude plugin marketplace add 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 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在 Windows/Linux 上安装了 Nowledge Mem 桌面应用时，
nmem已内置。macOS 或远程服务器上请使用uvx或手动安装。
开始使用
斜杠命令：
/save-- 保存当前会话到 Nowledge Mem/sum-- 将对话洞察提炼成记忆/search <关键词>-- 搜索知识库/status-- 检查服务器连接状态
自然语言： 说「保存这个会话」或「提炼这次对话」，Claude 会自动运行对应的 nmem 命令。
自主运行（技能）： 插件包含三个自动触发的技能：
- Read Working Memory：会话开始和上下文压缩后加载工作记忆简报
- Search Memory：引用过去工作时自动搜索
- Distill Memory：在关键发现时建议提炼
按需触发： Save Thread：当你说「保存会话」或「checkpoint」时保存对话
更新插件：
claude plugin marketplace update
claude plugin update nowledge-mem@nowledge-community
# 重启 Claude Code 以应用更改生命周期钩子
插件使用 Claude Code hooks 实现自动生命周期管理：
| 事件 | 触发条件 | 操作 |
|---|---|---|
SessionStart（启动/恢复/清除） | 新会话、恢复或清除 | 通过 nmem wm read（API）加载工作记忆简报，回退到本地文件 |
SessionStart（压缩） | 上下文压缩后 | 重新加载工作记忆简报，提示 Claude 保存重要发现 |
UserPromptSubmit | 每条用户消息 | 注入搜索/保存语法提示，Claude 可见 |
Stop | 模型完成响应 | 异步捕获会话到知识图谱（幂等） |
工作记忆简报会始终存在于上下文中。Stop 钩子确保即使 Nowledge Mem 运行在不同机器上（远程模式），会话也能被捕获。
本地与远程模式
插件在两种模式下透明运行：
- 本地（Mem 在同一台机器上）：通过 API 或
~/ai-now/memory.md读取工作记忆简报。会话由桌面应用文件监听和 Stop 钩子双重捕获。 - 远程（Mem 在不同机器上）：创建
~/.nowledge-mem/config.json配置连接参数。nmemCLI 会自动读取，无需设置环境变量。
{
"apiUrl": "https://your-server:14242",
"apiKey": "your-key"
}也可使用环境变量（NMEM_API_URL、NMEM_API_KEY），优先级高于配置文件。优先级：CLI 参数 > 环境变量 > 配置文件 > 默认值。
当 Stop 钩子运行 nmem t save --from claude-code 时，Claude 的会话文件会先在运行 Claude Code 的那台机器上被本地读取，再以规范化后的线程消息上传到 Mem。远程 Mem 服务器不需要直接访问 ~/.claude。
进阶
AGENTS.md -- 基于 agents.md 标准 的完整记忆守护 Agent 示例，适配任何 AI 编程工具。