🧠

あなたの Claude Code、実は前回のセッションを完全に忘れている (5 分で永続記憶を入れる)

に公開
Model Context Protocol
Agent
Claude
Anthropic
Claude Code
tech

こんな経験ありませんか?

月曜の朝、 Claude Code を立ち上げる。

「先週直したあのバグ、 どう直したか覚えてる?」

Claude: すみません、 過去のセッションの内容にはアクセスできません。
        どのような問題だったか、 もう一度教えていただけますか?

…またこれだ。 先週も先々週も同じ説明をした。

私は Claude Code を毎日使っている。 そして毎日、 同じ説明を同じ AI に何度も繰り返している。 「JWT_SECRET を rotate したら全 session が invalidate するから、 並行 redeploy しろ」 と教えた caveat も、 翌日には完全に忘れている。

これは Claude Code の bug ではなく、 設計上そうなっている。 セッション間で記憶を共有する公式機構が無いから、 毎セッション 0 から始まる。

この記事は、 その session 跨ぎの記憶喪失を 5 分で解決する方法 を示す。

体感の before / after

before — 普通の Claude Code

You:    先週の deploy が落ちたあれ、 どう直したっけ
Claude: 過去のセッションは見えないので、 まず状況を再現してください
You:    [30 分かけて再説明 + log 探し]

毎週これを繰り返す。 同じバグ、 同じ説明、 同じ時間ロス。

after — Linksee Memory 入りの Claude Code

You:    先週の deploy が落ちたあれ、 どう直したっけ
Claude: caveat を確認します。

        🧠 [caveat] NextAuth は JWT_SECRET を rotate すると
           全 session が invalidate する。 影響プロジェクトを
           並行 redeploy で対応。 (2026-04-13、 importance: 0.95)

        この時の deploy 失敗ですね? 同じ手順で対応できます。
You:    そうそれ、 ありがとう。

3 週間前の caveat を Claude が 自動で recall して引用 する。 説明し直す必要なし。

何が起きてるのか — 仕組みの説明

Claude Code の session memory は 一時的:

  • 会話履歴は session 内でのみ保持
  • 次のセッション開始時に context が 0 リセット
  • ローカルに自動保存される CLAUDE.md 系の auto-memory も flat な markdown で 「なぜ その修正をしたか」 (= WHY) を保持しない

つまり Claude Code は 「何を編集したか」 (= WHAT) は記録できても、 「なぜそれが必要だったか」 「どう失敗したか」 「次回も同じ罠を踏まないために」 という最も再利用したい情報が消える。

これを解決する MCP server が Linksee Memory だ。 ローカルの SQLite ファイルに 6 層構造化メモリ で永続化し、 Claude Code / Cursor / OpenAI Codex / Gemini CLI のすべてから同じ記憶にアクセスできる。

層 記録するもの
goal このプロジェクト / タスクで達成したいこと
context なぜ今これをやっているか、 制約や前提
emotion ユーザーの tone (frustration / excitement)
implementation 何を試して、 何が成功 / 失敗したか
caveat ⚠️ 「絶対に X するな」 の教訓、 自動忘却から保護
learning 振り返って残った insight

特に caveat 層は protected で、 Ebbinghaus の忘却曲線で勝手に消えない。 「同じ失敗を二度しない」 を構造で担保する。

5 分で入れる手順

Step 1: Node.js が入ってるか確認

node --version

v20.x 以上が出れば OK。 入っていない人は nodejs.org からインストール。

Step 2: Linksee Memory を Claude Code に登録

claude mcp add -s user linksee -- npx -y linksee-memory

これ 1 行で MCP server として登録される。 ローカル SQLite ファイルが ~/.linksee-memory/memory.db に自動作成される。

Step 3: 自動発動 Skill をインストール (推奨)

npx -y linksee-memory-install-skill

これを入れないと、 Claude が自分から recall / remember を呼ばない。 Skill は 「前に また同じエラー 覚えておいて のような表現を Claude が検知したら自動的に Linksee Memory を使う」 ルールを Claude にロードする。

Step 4: Claude Code を再起動

完全に閉じて開き直す (ウィンドウを閉じるだけでは足りない)。 起動後、 ツールが mcp__linksee__remember mcp__linksee__recall などの prefix で見えるようになる。

Step 5: 動作確認

新しいチャットで:

TypeScript が JavaScript より好きって覚えておいて

Claude が 「Linksee Memory に保存しました」 と返してくれば成功。

別のセッションを開いて:

私のコーディング言語の好みは?

「TypeScript が好き」 と返ってくれば、 永続記憶が動いている。

つまづきポイント (3 つ)

罠 1: Skill を入れ忘れる

Step 3 を skip すると、 Claude が recall を呼ばない。 ツールは登録されているが、 Claude が 「いつ使うべきか」 を判断する手がかりが無い。 公式 docs に書いてないので落ちやすい。

罠 2: Stop hook を設定しない

セッション終了時に自動で会話を取り込む Stop hook を設定すると、 手動で 「これ覚えて」 と言わなくても各 session の重要な部分が保存される。 ~/.claude/settings.json に:

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "npx -y linksee-memory-sync" }
        ]
      }
    ]
  }
}

各 session 終了時に ~100 ms。 失敗しても silent (Claude を block しない)。

罠 3: caveat 層を 「ただの note」 と混同する

Linksee Memory の真価は caveat 層。 ここに保存したものは forget しない。 「絶対に X するな」 「Y は二度とやらない」 を 明示的に caveat として保存 すると、 Claude は重要度の高い教訓として recall 上位に出してくる。 自動 markdown 記録には無い差別化。

TL;DR

  • Claude Code は session 跨ぎで記憶を持たない (= 設計上そう)
  • Linksee Memory は 6 層構造化メモリの MCP server、 ローカル SQLite で永続化
  • 5 分で導入可能 (claude mcp add + skill install + 再起動)
  • caveat 層が auto-forget から protected = 「同じ失敗を二度しない」 構造保証
  • Cursor / OpenAI Codex / Gemini CLI でも同じ SQLite を共有可能 = cross-agent

次のアクション

今すぐ試したい人:

claude mcp add -s user linksee -- npx -y linksee-memory
npx -y linksee-memory-install-skill

Claude Code を再起動して、 「[何か] を覚えておいて」 と話しかける。

Pro tier (cross-device sync / team shared memory / web dashboard) は 2026 夏 launch 予定。 早期登録者は v0.3.0 OSS の継続支援込みで $19/mo、 LP の waitlist から登録できる。

Discussion