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-mem或npm 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)
- 確認 Python 版本:
python3 --version
需要 Python 3.10 或以上。macOS Sonoma 內建 Python 3.11,可直接使用。 - 安裝 claude-mem:
pip3 install claude-mem
如果遇到權限問題,加--user:pip3 install --user claude-mem
- 驗證安裝:
claude-mem --version
應該顯示版本號(例如claude-mem 1.2.0)。 - 設定 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 安裝(適合前端開發者)
- 確認 Node.js 版本:
node --version
需要 Node.js 18 或以上。 - 全域安裝:
npm install -g claude-mem
- 驗證:
claude-mem --version
- 設定 API Key:同 Python 方法。
💡 注意:claude-mem 每次壓縮會消耗約 200-500 Token(使用 Claude Haiku 模型,成本約 $0.001)。如果你每天開 5 次新對話,一個月約 $0.15,非常划算。
claude-mem 設定方法:與 CLAUDE.md 整合
claude-mem 的運作依賴 CLAUDE.md 專案檔,以下是完整設定流程:
- 進入專案資料夾:
cd /path/to/your/project
- 初始化 claude-mem:
claude-mem init
這會在專案根目錄建立.claude/memory/資料夾,並生成設定檔.claude/memory/config.json。 - 編輯 CLAUDE.md(範例):
# 專案規則 ## 程式語言偏好 - 使用 Python 3.11 - 禁止使用 TypeScript - 測試框架:pytest ## 程式碼風格 - 函數命名:snake_case - 類別命名:PascalCase - 每個函數加 docstring ## 工具偏好 - HTTP 請求:requests(不用 urllib) - 資料處理:pandas - 日期時間:datetime(不用 arrow) ## 禁止事項 - 不使用全域變數 - 不寫超過 50 行的函數 - 不在主程式寫商業邏輯
- 啟動監控:
claude-mem watch
這會在背景執行,監控CLAUDE.md和.claude/rules/的變化。 進階選項:--interval 10:每 10 秒掃描一次(預設 5 秒)--model haiku:使用 Claude Haiku 壓縮(預設,最便宜)--model sonnet:使用 Claude Sonnet(壓縮品質更高,但貴 10 倍)
- 測試記憶載入:
開啟 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-mem | AI 自動壓縮對話偏好 | ✅ 高度自動(監控檔案變化) | ✅ 低(壓縮後 800 Token,省 84%) | 個人開發者、多專案切換 |
| MemPalace MCP | 向量資料庫 + 語意搜尋 | ✅ 全自動(MCP 整合) | ✅ 極低(只載入相關片段,300 Token) | 進階用戶、需要快速查詢知識庫 |
| 阿宥記憶套件 | 雙層記憶 + 規則路由 + 品質評估 | ✅ 全自動 + AI 自我優化 | ✅ 極低(智慧載入,省 89%) | 專業用戶、企業級自動化需求 |
結論:
- 如果你只需要「記住基本偏好」→ 用 claude-mem
- 如果你有大量知識庫需要快速查詢 → 加裝 MemPalace MCP
- 如果你需要完整的「AI 自我學習系統」→ 購買 阿宥記憶套件
進階:claude-mem 與 Git Hooks 整合自動觸發
如果你希望「每次 commit 前自動壓縮記憶」,可以設定 Git Hook:
- 建立 pre-commit hook:
nano .git/hooks/pre-commit
- 加入以下腳本:
#!/bin/bash # 自動壓縮 claude-mem 記憶 echo "🧠 壓縮 Claude 記憶中..." claude-mem compress --force git add .claude/memory/ echo "✅ 記憶已更新並加入 commit"
- 設定執行權限:
chmod +x .git/hooks/pre-commit
- 測試:
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/ 資料夾。
解法:
- 確認 Claude Code 設定檔路徑正確:
claude-mem config --show
- 手動載入記憶測試:
claude-mem load --verbose
查看輸出是否有錯誤訊息。 - 重新初始化:
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 成為你最強的生產力工具!
📚 延伸閱讀:你可能也有興趣
- 購買 Claude Code 記憶與技能套件
- 雲林 AI 房仲・阿宥的 AI 教室
- claude-mem GitHub 官方頁面
- 2026 最新 AI 工具推薦清單
- Claude Code Token 優化完整指南
關於作者|阿宥
AI 數位應用研究者,專注於 Claude Code、Cursor AI、NotebookLM 等工具的實戰應用。 開發「Claude Code 記憶與技能套件」,幫助開發者打造自我學習的 AI 助理系統。 同時經營「雲林 AI 房仲」,結合 AI 技術與房地產分析,提供雲林地區最專業的不動產資訊。
資料來源:claude-mem GitHub・GitHub Trending(2026-04-17)
解壓縮 → 拖入 Claude Code → 輸入序號,5 分鐘完成安裝
✅ 套件內含功能:
🧠 雙層記憶系統(跨對話長期記憶,越用越懂你)
🔄 智慧規則載入(自動選最相關規則,省最高 89% Token)
📊 品質評估閘門(文章/程式碼送出前自動評分把關)
⚡ 自動學習任務框架(自動記錯誤→優化流程→持續進化)
🛠️ 11 個內建技能(知識餵養・網頁爬取・每日收尾等)
☁️ Google Drive 雲端同步引導
🔒 單一裝置授權,資料不外傳
原價 NT$1,288
NT$600
前 100 名限定優惠價格
每組序號第一裝置限一用・不可轉讓或分享

.png)