Claude Code
ライフサイクルフックを備えたClaude Code用プラグイン。セッション開始時にContext BundleまたはWorking Memoryを読み込み、関連する場合に検索し、適切なタイミングでインサイトを保存します。
エージェント向け
この行をエージェントに渡してください。 まずユニバーサルインストールスキルを使用する必要があります。 このページは動作とトラブルシューティングのリファレンスとして残ります：
Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Claude Code. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.claude plugin marketplace add https://github.com/nowledge-co/community && claude plugin install nowledge-mem@nowledge-communityプラグインネイティブ
Claude Codeはプラグインをサポートしています。 一度インストールすれば、組み込みの自律的な動作が利用できます。 システムプロンプトやMCPの設定は不要です。
エージェントは、あなたが知っていることを検索し、重要なことを保存します。 あなたが頼まなくても。
最初の成功状態
プラグインをインストールし、nmemが利用可能であることを確認し、新しいClaude Codeセッションを開始して、実際の動作を1つ検証してください。
セッション開始時にContext BundleまたはWorking Memoryが読み込まれる、または/search / /saveが追加の設定なしで動作することを確認します。
始める前に
- ローカルで実行中のNowledge Mem（インストール）、または到達可能なリモートMemサーバー
- Claude Codeがインストールされていること
セットアップ
プラグインをインストールする
# Add the Nowledge community marketplace
claude plugin marketplace add https://github.com/nowledge-co/community
# Install the Nowledge Mem plugin
claude plugin install nowledge-mem@nowledge-communityこのプラグインにはnmem CLIが必要です：
# Option 1 -- uvx (no installation needed)
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version
# Option 2 -- pip
pip install nmem-cliNowledge Memデスクトップアプリがこのマシンにある場合、最も安全な方法はSettings → Preferences → Developer Tools → Install CLIです。 デスクトップアプリのないリモート専用マシンでは、
uvxを使用するか、手動でインストールしてください。
スラッシュコマンドとスキルを使用する
スラッシュコマンド：
/save: 現在のセッションをNowledge Memに保存します/sum: この会話からインサイトを抽出します/search <query>: ナレッジベースを検索します/status: サーバー接続とステータスを確認します
自然言語： 「Save this session」または「Distill this conversation」と言うと、Claudeが適切なnmemコマンドを自動的に実行します。
自律的（スキル）： このプラグインには、自動的に実行される3つのスキルが含まれています：
- Read Working Memory: 利用可能な場合はContext Bundleを読み込み、そうでない場合はセッション開始時およびコンテキスト圧縮後に日次のブリーフィングにフォールバックします
- Search Memory: 過去の作業を参照したときに検索します
- Distill Memory: 画期的な瞬間に抽出を提案します
リクエスト時： Save Thread: あなたが依頼したとき（「save this session」「checkpoint this」）にセッションを保存します
更新
claude plugin marketplace add https://github.com/nowledge-co/community
claude plugin marketplace update nowledge-community
claude plugin update nowledge-mem@nowledge-community
# Restart Claude Code to apply changes古いセッションをインポートする
自動キャプチャは、プラグインとフックがインストールされた後に開始されます。 古いClaude CodeセッションをNowledge Memに取り込むには、まずプレビューします：
nmem t sync --from claude-code --all-projects --limit 20次にインポートします：
nmem t sync --from claude-code --all-projects --apply1つのプロジェクトだけを対象にしたい場合は、--all-projectsの代わりに-p /path/to/projectを使用してください。
このコマンドは、このマシン上のローカルClaude Codeセッションファイルを読み取り、nmemで設定されたMemサーバーに書き込みます。
スペース
スペースは任意であり、明示的です。 Claude Codeプラグインは、現在のフォルダ、gitリポジトリ、ブランチ、またはプロジェクト名からMemスペースを作成したり選択したりしません。 オーバーライドがない場合、Context Bundle、Working Memory、検索、および自動セッションキャプチャはすべて、デフォルトのMemスペースを使用します。
このClaude Codeプロセス全体が既存のMemスペースを使用すべき場合にのみ、NMEM_SPACEを設定してください：
NMEM_SPACE="Research Agent" claudeマルチエージェントランチャーの場合、ワーカーIDには安定したNMEM_AGENT_IDを推奨します。
そのワーカーがIDのデフォルトスペースをオーバーライドすべき場合にのみ、NMEM_SPACEを追加してください。
安全にカスタマイズする
インストールされたプラグインディレクトリではなく、Claude Code自身のメモリファイルを使用してください：
CLAUDE.local.md: 更新後も保持されるべき個人的な調整用CLAUDE.md: リポジトリで共有するルール用
インストールされたNowledge Memプラグインファイルを直接編集しないでください。 ホストごとの完全なマップについては、Customize Integration Behaviorを参照してください。
ライフサイクルフック
このプラグインは、自動ライフサイクル管理のためにClaude Code hooksを使用します：
| イベント | トリガー | アクション |
|---|---|---|
SessionStart (startup/resume/clear) | 新規セッション、再開、またはクリア | nmem context経由でContext Bundleを読み込み、nmem wm readにフォールバックし、次にローカルファイルを使用 |
SessionStart (compact) | コンテキスト圧縮後 | Context BundleまたはWorking Memoryを再読み込みし、Claudeに進捗のチェックポイントを促す |
UserPromptSubmit | すべてのユーザーメッセージ | Claudeが参照できるコンテキストとして検索/保存の構文を注入 |
PreCompact | 手動または自動の圧縮前 | コンテキストが圧縮される前に、正確なClaude Codeセッションを保存 |
Stop | モデルが応答を完了 | 制限付きの再試行ウィンドウでセッションをナレッジグラフにキャプチャ |
Context Bundle、または古いCLIではWorking Memoryが、圧縮後に更新されます。
PreCompactフックは、Claude Codeが圧縮する前に完全なローカルトランスクリプトを保存し、Stopフックは、Nowledge Memが別のマシンで実行されている場合（リモートモード）でも、通常のターンごとのキャプチャを継続します。
応答後にClaude Codeがトランスクリプトファイルをフラッシュするのに少し時間が必要な場合、フックは待機して再試行し、サイレントなno-op保存を報告しません。
デスクトップアプリのClaude Codeファイルウォッチャーも有効になっている場合は、そのままにしておいて構いません。
ウォッチャーとプラグインフックは同じclaude-code-<sessionId>スレッドに収束するため、繰り返しの保存は2つ目のスレッドを作成するのではなく、既存のスレッドを更新します。
ローカルvsリモート
このプラグインは両方のモードで透過的に動作します：
- ローカル（Memが同じマシン上）：Context BundleまたはWorking MemoryはMem経由で読み取られます。
プラグインは、APIパスが利用できない場合のDefault-space互換フォールバックとしてのみ
~/ai-now/memory.mdを保持します。 セッションは、デスクトップアプリのファイルウォッチャー、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 standardを使用した、完全なメモリキーパーエージェントの例です。 任意のAIコーディングエージェントで動作します。
関連
- コネクタの概要: ネイティブコネクタ、再利用可能なパッケージ、MCP、およびブラウザキャプチャ
- Claude Desktop · Codex · Alma · OpenClaw · Raycast · その他のチャットAI