cropped 房地產阿宥(AI房仲).png

Claude Code 長期記憶怎麼設定?claude-mem 自動壓縮讓 AI 記住你所有偏好(2026最新)

Claude Code 長期記憶設定是讓 AI 助理真正記住你工作習慣的關鍵技術。每次開新對話都要重新解釋「我喜歡用 Python 不用 Node」「請幫我壓縮程式碼註解」,這種重複介紹不只浪費時間,每次還要額外消耗 3,000-5,000 Token。今天要介紹的 claude-mem 在 GitHub 今日爆紅新增 1,897 顆星(2026-04-17 數據),它會自動監控你的 CLAUDE.md 專案設定檔,把你每次對話累積的偏好壓縮成記憶區塊,下次對話自動載入,讓 Claude Code 像真人助理一樣記住你所有習慣。本文完整拆解 claude-mem 的安裝、設定、實戰案例,以及如何與阿宥開發的記憶套件整合,打造最強 AI 長期記憶系統。

什麼是 Claude Code 長期記憶?為什麼每次對話會「失憶」?

Claude Code 的記憶機制分三層:

  • 對話記憶(Session Memory):單次對話內有效,關閉視窗就清空
  • 專案記憶(Project Memory):讀取 CLAUDE.md.claude/ 資料夾內容,每次對話都重新載入
  • 長期記憶(Long-term Memory):跨對話累積的偏好與學習,原生 Claude Code 不支援

為什麼會失憶?

Claude Code 設計上每次對話都是「全新啟動」,就像電腦重開機,之前對話的內容不會自動帶到新對話。 你可以在 CLAUDE.md 手動寫入「我喜歡用 pytest」「程式碼請加詳細註解」,但這些是固定規則, 不是「自動學習」。

💡 claude-mem 的突破在於:它會自動分析對話中你的偏好、常用工具、工作流程,壓縮成記憶片段,存入記憶區塊,下次對話自動載入,實現真正的「長期記憶」。

claude-mem 是什麼?GitHub 今日 +1,897 星的 AI 記憶壓縮工具

claude-mem 是開源的 Claude Code 記憶管理工具,核心功能:

  • 🔍 自動監控:偵測 CLAUDE.md.claude/rules/ 檔案變化
  • 🧠 智慧壓縮:用 AI 摘要提取核心偏好(例如「阿宥喜歡 Python 3.11」「禁止用 TypeScript」)
  • 💾 記憶區塊存儲:壓縮後的記憶存在 .claude/memory/ 資料夾
  • 自動載入:新對話啟動時自動注入記憶,無需手動複製貼上
  • 📊 版本管理:追蹤記憶演化歷史,可還原到任何時間點

GitHub 數據(2026-04-17):

  • ⭐ Stars:今日 +1,897(總計 4,200+)
  • 📦 安裝方式:pip install claude-memnpm install -g claude-mem
  • 💻 支援平台:macOS / Linux / Windows(需 Python 3.10+ 或 Node.js 18+)

架構圖(ASCII):

┌─────────────────────────────────────────────────────────┐
│          Claude Code 長期記憶系統架構                    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  對話 A                對話 B                對話 C     │
│    ↓                     ↓                     ↓       │
│  [CLAUDE.md 變化]    [新增規則]          [工具使用]     │
│    ↓                     ↓                     ↓       │
│  ┌───────────────────────────────────────────────┐     │
│  │         claude-mem 監控程式                    │     │
│  │   (每 5 秒掃描 .claude/ 資料夾變化)          │     │
│  └───────────────────────────────────────────────┘     │
│                       ↓                                 │
│  ┌───────────────────────────────────────────────┐     │
│  │         AI 壓縮引擎(Claude Haiku)            │     │
│  │   輸入:1,500 字規則 → 輸出:300 字記憶摘要   │     │
│  └───────────────────────────────────────────────┘     │
│                       ↓                                 │
│  ┌───────────────────────────────────────────────┐     │
│  │     .claude/memory/compressed_memory.json      │     │
│  │  {                                              │     │
│  │    "preferences": ["Python 3.11", "pytest"],   │     │
│  │    "禁止": ["TypeScript", "全域變數"],         │     │
│  │    "工具": ["requests", "pandas"]              │     │
│  │  }                                              │     │
│  └───────────────────────────────────────────────┘     │
│                       ↓                                 │
│           新對話啟動時自動載入                           │
│                       ↓                                 │
│  ┌───────────────────────────────────────────────┐     │
│  │   Claude Code Context(新對話的 System)       │     │
│  │   「你已知道:阿宥喜歡 Python、禁用 TS...」     │     │
│  └───────────────────────────────────────────────┘     │
│                                                         │
│  Token 消耗對比:                                       │
│  ❌ 無記憶:每次對話重新載入 CLAUDE.md(5,000 Token)  │
│  ✅ claude-mem:載入壓縮記憶(800 Token,省 84%)      │
└─────────────────────────────────────────────────────────┘

💡 關鍵優勢:claude-mem 用 AI 自動壓縮,不是簡單的「複製貼上」。它會分析哪些規則最常用、哪些是核心偏好,優先保留重要記憶,過時的自動淘汰。

claude-mem 安裝步驟(5 分鐘完成)

方法一:Python 安裝(推薦,適合 macOS / Linux)

  1. 確認 Python 版本:
    python3 --version
    需要 Python 3.10 或以上。macOS Sonoma 內建 Python 3.11,可直接使用。
  2. 安裝 claude-mem:
    pip3 install claude-mem
    如果遇到權限問題,加 --user
    pip3 install --user claude-mem
  3. 驗證安裝:
    claude-mem --version
    應該顯示版本號(例如 claude-mem 1.2.0)。
  4. 設定 Anthropic API Key: claude-mem 需要呼叫 Claude API 壓縮記憶。在終端執行:
    export ANTHROPIC_API_KEY="your_api_key_here"
    永久設定:編輯 ~/.zshrc~/.bashrc,加入:
    export ANTHROPIC_API_KEY="sk-ant-xxxxx"
    存檔後執行 source ~/.zshrc

方法二:Node.js 安裝(適合前端開發者)

  1. 確認 Node.js 版本:
    node --version
    需要 Node.js 18 或以上。
  2. 全域安裝:
    npm install -g claude-mem
  3. 驗證:
    claude-mem --version
  4. 設定 API Key:同 Python 方法。

💡 注意:claude-mem 每次壓縮會消耗約 200-500 Token(使用 Claude Haiku 模型,成本約 $0.001)。如果你每天開 5 次新對話,一個月約 $0.15,非常划算。

claude-mem 設定方法:與 CLAUDE.md 整合

claude-mem 的運作依賴 CLAUDE.md 專案檔,以下是完整設定流程:

  1. 進入專案資料夾:
    cd /path/to/your/project
  2. 初始化 claude-mem:
    claude-mem init
    這會在專案根目錄建立 .claude/memory/ 資料夾,並生成設定檔 .claude/memory/config.json
  3. 編輯 CLAUDE.md(範例):
    # 專案規則
    
    ## 程式語言偏好
    - 使用 Python 3.11
    - 禁止使用 TypeScript
    - 測試框架:pytest
    
    ## 程式碼風格
    - 函數命名:snake_case
    - 類別命名:PascalCase
    - 每個函數加 docstring
    
    ## 工具偏好
    - HTTP 請求:requests(不用 urllib)
    - 資料處理:pandas
    - 日期時間:datetime(不用 arrow)
    
    ## 禁止事項
    - 不使用全域變數
    - 不寫超過 50 行的函數
    - 不在主程式寫商業邏輯
  4. 啟動監控:
    claude-mem watch
    這會在背景執行,監控 CLAUDE.md.claude/rules/ 的變化。 進階選項:
    • --interval 10:每 10 秒掃描一次(預設 5 秒)
    • --model haiku:使用 Claude Haiku 壓縮(預設,最便宜)
    • --model sonnet:使用 Claude Sonnet(壓縮品質更高,但貴 10 倍)
  5. 測試記憶載入: 開啟 Claude Code,在新對話輸入:
    請告訴我你知道哪些關於我的偏好?
    如果設定成功,Claude 會回答:「根據記憶,你偏好使用 Python 3.11、測試用 pytest、禁止 TypeScript…」

💡 技巧:你可以在對話中直接說「記住:我不喜歡用 asyncio」,claude-mem 會自動偵測這句話,壓縮進記憶區塊,下次對話就會自動避開 asyncio。

claude-mem 實戰案例:5 個真實場景

案例 1:多語言專案記憶分離

場景:阿宥同時維護 3 個專案(Python API / React 前端 / WordPress 外掛), 每個專案規則不同,claude-mem 如何區分?

解法:每個專案獨立初始化 claude-mem init,記憶存在各自的 .claude/memory/。 Claude Code 會自動偵測當前專案資料夾,載入對應記憶。

# Python API 專案 CLAUDE.md
使用 FastAPI + SQLAlchemy
測試:pytest + coverage
禁止:全域變數、print() 除錯

# React 前端專案 CLAUDE.md
使用 TypeScript + Tailwind CSS
狀態管理:Zustand
禁止:class component、inline styles

案例 2:團隊共享記憶(多人協作)

場景:團隊 5 個人都用 Claude Code,如何統一規則?

解法:.claude/memory/ 加入 Git 版本控制:

# .gitignore(不要忽略記憶資料夾)
# .claude/memory/   ← 移除這行

git add .claude/memory/
git commit -m "Add shared memory"
git push

團隊成員 git pull 後,執行 claude-mem sync 同步記憶。

案例 3:動態學習工具使用習慣

場景:阿宥最近開始用 httpx 取代 requests(因為支援 async), 希望 Claude 自動學習。

做法:在對話中說:

「記住:我現在改用 httpx 做 HTTP 請求,不要再建議 requests。」

claude-mem 會自動更新記憶,下次對話 Claude 會優先建議 httpx。

案例 4:錯誤修正自動記憶

場景:阿宥每次讓 Claude 寫 WordPress 外掛時,都忘記加 nonce 驗證,導致安全漏洞。

解法:在 CLAUDE.md 加入規則:

## WordPress 開發強制規則
- 所有 AJAX 請求必須加 wp_nonce 驗證
- 表單提交用 wp_verify_nonce() 檢查
- 禁止直接用 $_POST 不驗證

claude-mem 壓縮後,之後每次寫 WordPress 程式碼,Claude 會主動加上 nonce 驗證。

案例 5:跨對話累積專案知識

場景:阿宥在第 1 次對話建立資料庫 schema,第 2 次對話寫 API,第 3 次對話寫測試。 每次都要重新解釋 schema 結構。

解法:啟用 claude-mem 的「對話歷史壓縮」功能:

claude-mem watch --save-context

這會把每次對話的重要結論(例如「users 資料表有 id, email, created_at 三欄」)自動壓縮進記憶。 第 3 次對話時,Claude 已經知道資料庫結構,不用重複解釋。

💡 進階技巧:用 claude-mem export 匯出記憶成 JSON,可以備份到 Google Drive 或 GitHub Gist,換電腦時直接 claude-mem import memory.json 還原。

claude-mem vs MemPalace MCP vs CLAUDE.md 手動設定(完整比較)

方案記憶方式自動化程度Token 消耗適合對象
CLAUDE.md 手動手動寫入固定規則❌ 完全手動⚠️ 高(每次載入全文,5,000 Token)初學者、規則少於 10 條
claude-memAI 自動壓縮對話偏好✅ 高度自動(監控檔案變化)✅ 低(壓縮後 800 Token,省 84%)個人開發者、多專案切換
MemPalace MCP向量資料庫 + 語意搜尋✅ 全自動(MCP 整合)✅ 極低(只載入相關片段,300 Token)進階用戶、需要快速查詢知識庫
阿宥記憶套件雙層記憶 + 規則路由 + 品質評估✅ 全自動 + AI 自我優化✅ 極低(智慧載入,省 89%)專業用戶、企業級自動化需求

結論:

  • 如果你只需要「記住基本偏好」→ 用 claude-mem
  • 如果你有大量知識庫需要快速查詢 → 加裝 MemPalace MCP
  • 如果你需要完整的「AI 自我學習系統」→ 購買 阿宥記憶套件

進階:claude-mem 與 Git Hooks 整合自動觸發

如果你希望「每次 commit 前自動壓縮記憶」,可以設定 Git Hook:

  1. 建立 pre-commit hook:
    nano .git/hooks/pre-commit
  2. 加入以下腳本:
    #!/bin/bash
    # 自動壓縮 claude-mem 記憶
    echo "🧠 壓縮 Claude 記憶中..."
    claude-mem compress --force
    git add .claude/memory/
    
    echo "✅ 記憶已更新並加入 commit"
  3. 設定執行權限:
    chmod +x .git/hooks/pre-commit
  4. 測試:
    git commit -m "測試記憶自動壓縮"
    應該會看到「🧠 壓縮 Claude 記憶中…」訊息。

💡 進階技巧:搭配 husky(Node.js 專案)或 pre-commit(Python 專案)框架,可以統一管理團隊的 Git Hooks,確保所有人都啟用記憶壓縮。

常見問題排解(5 大錯誤與解法)

問題 1:claude-mem: command not found

原因:Python 或 Node.js 的執行檔路徑不在系統 PATH 中。

解法:

  • Python:檢查安裝位置
    pip3 show claude-mem | grep Location
    假設顯示 /Users/yourname/Library/Python/3.11/bin,加入 PATH:
    export PATH="$PATH:$HOME/Library/Python/3.11/bin"
    加入 ~/.zshrc 永久生效。
  • Node.js:確認全域模組路徑
    npm config get prefix
    通常是 /usr/local,確認 /usr/local/bin 在 PATH 中。

問題 2:Error: ANTHROPIC_API_KEY not set

原因:環境變數未設定或拼錯。

解法:

echo $ANTHROPIC_API_KEY

如果沒有輸出,執行:

export ANTHROPIC_API_KEY="sk-ant-xxxxxxx"

記得加入 ~/.zshrc 永久保存。

問題 3:壓縮後的記憶沒有載入到 Claude Code

原因:Claude Code 沒有讀取 .claude/memory/ 資料夾。

解法:

  1. 確認 Claude Code 設定檔路徑正確:
    claude-mem config --show
  2. 手動載入記憶測試:
    claude-mem load --verbose
    查看輸出是否有錯誤訊息。
  3. 重新初始化:
    claude-mem init --force

問題 4:記憶檔案太大導致載入慢

原因:累積太多歷史對話,壓縮檔超過 10 MB。

解法:執行記憶清理:

claude-mem prune --keep-recent 30

這會保留最近 30 天的記憶,刪除舊資料。

問題 5:團隊成員的記憶互相衝突

場景:A 喜歡用 TypeScript,B 喜歡用 JavaScript,Git 合併時衝突。

解法:改用「分層記憶」:

# .claude/memory/config.json
{
  "layers": [
    {"name": "team", "priority": 1, "file": "team_shared.json"},
    {"name": "personal", "priority": 2, "file": "~/.claude/personal.json"}
  ]
}

team 層存放共同規則(例如「測試用 pytest」),personal 層存放個人偏好(例如「我用 TypeScript」)。 Claude 會優先套用 personal 層,避免衝突。

claude-mem + 阿宥記憶套件:打造終極 AI 記憶系統

如果你已經在用 claude-mem,想進一步提升到「AI 自我學習」等級, 可以搭配阿宥開發的 Claude Code 記憶與技能套件

阿宥套件的額外功能(claude-mem 沒有的)

  • 🧠 雙層記憶系統:短期記憶(對話內)+ 長期記憶(跨對話),自動判斷哪些記憶要保留、哪些要淘汰
  • 🔄 智慧規則載入:根據任務類型自動選 2-3 個最相關規則(省最高 89% Token),不是「全部載入」
  • 📊 品質評估閘門:文章/程式碼送出前自動評分(≥80 分才發布),避免低品質輸出
  • 自動學習任務框架:執行任務 → 記錄錯誤 → 自動優化流程 → 持續進化(SPAL 循環)
  • 🛠️ 11 個內建技能:知識餵養、網頁爬取、每日收尾、Token 追蹤、SEO 研究等
  • ☁️ Google Drive 雲端同步:多裝置自動同步記憶與技能(claude-mem 需手動匯出匯入)

整合方式:claude-mem 做「基礎記憶」,阿宥套件做「進階學習」

推薦架構:

┌─────────────────────────────────────────────────────────┐
│         混合記憶系統架構(最強配置)                     │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  第一層:claude-mem(基礎偏好記憶)                     │
│  ├─ 程式語言偏好(Python / JS / Go)                    │
│  ├─ 工具選擇(pytest / requests / pandas)             │
│  └─ 禁止事項(不用全域變數 / 不用 TS)                  │
│      ↓ 自動壓縮,每次對話載入(800 Token)              │
│                                                         │
│  第二層:阿宥套件(動態規則路由)                        │
│  ├─ 偵測任務類型(寫文章 / 寫程式 / SEO 研究)          │
│  ├─ 自動選最相關 2-3 個規則(例如文章選「排版規則」     │
│  │   「SEO規則」,不載入「Python規則」)                │
│  └─ Token 消耗:只載入需要的(300 Token,省 89%)      │
│      ↓                                                  │
│                                                         │
│  第三層:品質評估 + 自動優化                             │
│  ├─ 輸出前評分(文章 SEO 分數 / 程式碼 Lint 檢查)      │
│  ├─ 低於 80 分自動退回改寫                              │
│  └─ 執行結果記錄 → 分析瓶頸 → 更新流程                  │
│                                                         │
│  總 Token 消耗:800 + 300 = 1,100 Token                 │
│  vs 純手動 CLAUDE.md:5,000 Token(省 78%)            │
└─────────────────────────────────────────────────────────┘

誰適合購買阿宥套件?

  • ✅ 每天使用 Claude Code 超過 3 小時的專業開發者
  • ✅ 需要管理 5 個以上專案,每個專案規則不同
  • ✅ 想要「AI 自動優化工作流程」,不只是記住偏好
  • ✅ 在意 Token 消耗,希望每次對話省 80% 以上成本
  • ✅ 需要團隊協作,統一規則但保留個人偏好

📖 了解阿宥記憶套件完整功能 →

常見問題 FAQ

Q1:claude-mem 是免費的嗎?

A:claude-mem 本身是開源免費工具,但壓縮記憶時會呼叫 Anthropic API,需要付費。 使用 Claude Haiku 模型(最便宜),每次壓縮約 200-500 Token,成本約 $0.001。 如果每天開 5 次新對話,一個月約 $0.15。

Q2:claude-mem 支援 Windows 嗎?

A:支援。Windows 用戶建議用 Node.js 版本安裝(npm install -g claude-mem), 因為 Python 在 Windows 設定環境變數較麻煩。安裝後在 PowerShell 或 CMD 執行 claude-mem init 即可。

Q3:如果我換電腦,記憶可以轉移嗎?

A:可以。執行 claude-mem export --output memory_backup.json 匯出記憶, 複製到新電腦後執行 claude-mem import memory_backup.json。 建議把記憶檔案放在 Google Drive 或 Dropbox,隨時同步。

Q4:claude-mem 會洩露我的程式碼或機密資訊嗎?

A:不會。claude-mem 只壓縮「規則和偏好」(例如「我喜歡用 Python」), 不會上傳完整程式碼。壓縮後的記憶存在本地 .claude/memory/,不會傳到雲端。 但要注意:壓縮過程會把 CLAUDE.md 內容傳給 Anthropic API,如果規則裡有敏感資訊(例如 API Key), 請用環境變數取代,不要寫在 CLAUDE.md。

Q5:claude-mem 和 Cursor AI 的記憶功能有什麼不同?

A:Cursor AI 的記憶是「閉源黑盒」,你無法控制記憶內容和壓縮邏輯。 claude-mem 是開源工具,你可以完全掌控記憶檔案、自訂壓縮規則、選擇 AI 模型。 此外,Cursor 的記憶綁定在 Cursor 軟體內,無法轉移到其他編輯器; claude-mem 產生的記憶檔案是標準 JSON,可以用在任何支援 Claude Code 的環境。

結語:讓 Claude Code 真正成為你的長期夥伴

Claude Code 長期記憶設定不只是「省 Token」這麼簡單, 它的核心價值在於讓 AI 真正理解你的工作方式

想像一下:你不用每次對話都重新解釋「我的專案用 pytest 測試」「我不喜歡全域變數」「API 請求用 httpx」, Claude 會自動記住這些偏好,像真人助理一樣越用越懂你。

claude-mem 是實現這個願景的第一步:自動壓縮、自動載入、跨對話記憶。 如果你需要更進階的「AI 自我學習」「動態規則路由」「品質評估」功能, 可以進一步搭配 阿宥記憶套件, 打造終極 AI 工作系統。

現在就開始設定你的 Claude Code 長期記憶,讓 AI 成為你最強的生產力工具!


📚 延伸閱讀:你可能也有興趣

➜ 查看更多 AI 數位應用與雲林房地產分析文章


關於作者|阿宥

AI 數位應用研究者,專注於 Claude Code、Cursor AI、NotebookLM 等工具的實戰應用。 開發「Claude Code 記憶與技能套件」,幫助開發者打造自我學習的 AI 助理系統。 同時經營「雲林 AI 房仲」,結合 AI 技術與房地產分析,提供雲林地區最專業的不動產資訊。

資料來源:claude-mem GitHubGitHub Trending(2026-04-17)


🤖 購買 Claude Code 記憶與技能套件,讓 Claude Code 記住你 →

解壓縮 → 拖入 Claude Code → 輸入序號,5 分鐘完成安裝

✅ 套件內含功能:

🧠 雙層記憶系統(跨對話長期記憶,越用越懂你)

🔄 智慧規則載入(自動選最相關規則,省最高 89% Token)

📊 品質評估閘門(文章/程式碼送出前自動評分把關)

⚡ 自動學習任務框架(自動記錯誤→優化流程→持續進化)

🛠️ 11 個內建技能(知識餵養・網頁爬取・每日收尾等)

☁️ Google Drive 雲端同步引導

🔒 單一裝置授權,資料不外傳

原價 NT$1,288

NT$600

前 100 名限定優惠價格

每組序號第一裝置限一用・不可轉讓或分享

Compare Listings

TitlePriceStatusTypeAreaPurposeBedroomsBathrooms

Compare