Claude Code
Claude Code 专属插件，内置生命周期钩子。会话开始时自动读取工作记忆简报，并在恰当时机搜索与保存。
给你的智能体
把这行交给你的智能体。它应该先使用统一安装指南；这一页保留为行为说明和排障参考：
读取 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 服务器。
安全地自定义
优先使用 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 编程工具。