memvid hooks memory system

Claude Code 長期記憶怎麼設定?Memvid + Hooks 讓 AI 自動記住你,零基礎完整教學(2026)

Claude Code 有個很多人不知道的問題:每次開新對話,它就完全忘記你之前說過的一切。

你上次花了半小時設定好的偏好、你教它的操作習慣、它犯過的錯誤⋯⋯全部清零。等於每次都在跟一個剛認識的 AI 說話,什麼都要重新交代。

這篇文章要教你用 Memvid + Hooks 雙軌記憶系統,讓 Claude Code 擁有真正的長期記憶。而且完全自動——任務開始前自動調出相關歷史,任務結束後自動歸檔新學到的東西,完全不用你手動管理。

Claude Code 為什麼沒有記憶?

這不是 Claude 的 bug,而是設計使然。每個對話(Session)都是獨立的,不會保留上一次的內容。這樣做的好處是隱私安全,但對長期使用的人來說非常麻煩。

你可能遇過這些問題:

  • 每次都要重新告訴 Claude 你的偏好與習慣
  • 上次遇到的錯誤,這次又犯了同樣的毛病
  • 花時間教它的技巧,下次開對話全部消失
  • 不同任務之間的學習無法共享

Claude Code 其實有提供一個基本的解法:CLAUDE.md 檔案——你把規則寫進這個檔案,每次啟動 Claude Code 就會自動載入。但這只解決了「規則」的問題,沒辦法讓 Claude 記住歷史經驗、錯誤教訓和跨任務的學習。

什麼是雙軌記憶系統?

這套系統由兩個部分組成,分別解決不同的問題:

軌道一:人類可讀的 Markdown 檔案

就是一般的 .md 文字檔,你可以直接打開來看、修改。這條軌道包含:

  • CLAUDE.md:任務規則,Claude Code 每次啟動自動載入
  • 執行報告.md:每次任務的結果記錄
  • 錯誤紀錄.md:失敗案例與解決方法
  • 技能庫/SKILL.md:可複用的操作技能

軌道二:Memvid 向量記憶庫(.mv2 檔案)

Memvid 是一個開源工具,可以把大量文字內容壓縮成單一檔案,並支援快速的語意搜尋。它的特點是:

  • 所有記憶存在一個 .mv2 檔案裡,不需要資料庫
  • 搜尋速度極快(毫秒級)
  • 可以根據關鍵字找出「最相關」的記憶,而不是全部載入

兩條軌道的關係是:Markdown 是來源,Memvid 是索引。你寫的 .md 檔案會被自動索引進 .mv2,之後每次查詢只取出最相關的幾筆,而不是把所有內容都塞給 Claude 看。

Hooks 是什麼?為什麼要用它?

Claude Code 有一個功能叫做 Hooks(鉤子)——簡單說,就是「在特定時機自動執行某個動作」。

這套記憶系統用了兩個 Hook:

Hook 類型觸發時機做什麼
UserPromptSubmit你每次送出訊息前自動搜尋 .mv2,把最相關的 3 筆記憶注入對話
StopClaude 完成任務後自動掃描所有 .md 檔案,更新 .mv2 索引

整個流程變成這樣:

你輸入任何指令
      ↓
[自動] 搜尋歷史記憶 → 注入最相關的 3 筆到對話
      ↓
Claude 執行任務(帶著歷史記憶)
      ↓
[自動] 掃描 .md 檔案 → 更新記憶庫
      ↓
下次更聰明

安裝教學:從零開始,5 個步驟

以下步驟在 Mac 上操作,需要已安裝 Claude Code。

步驟一:安裝 Memvid SDK

打開終端機(Terminal),輸入:

python3 -m pip install memvid-sdk

看到 Successfully installed memvid-sdk 就代表安裝成功。

步驟二:建立任務資料夾

在桌面建立一個資料夾,結構如下:

~/Desktop/我的任務/
├── CLAUDE.md        ← 規則檔,Claude Code 自動載入
├── 流程.md          ← 任務 SOP
├── 執行報告.md      ← 每次執行結果
├── 錯誤紀錄.md      ← 失敗案例記錄
└── 技能庫/
    └── SKILL.md     ← 可複用技能

步驟三:建立 Hook 腳本

~/.claude/hooks/ 資料夾下建立兩個腳本檔案:

pre_task.sh(任務開始前執行):

#!/bin/bash
exec "$(which python3)" "$HOME/.claude/hooks/memvid_search.py"

post_task.sh(任務結束後執行):

#!/bin/bash
exec "$(which python3)" "$HOME/.claude/hooks/memvid_index.py" 2>/dev/null

步驟四:設定 settings.json

~/.claude/settings.json 設定 Hook 觸發規則:

{
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": ["/Users/你的帳號/.claude/hooks/pre_task.sh"] }
    ],
    "Stop": [
      { "hooks": ["/Users/你的帳號/.claude/hooks/post_task.sh"] }
    ]
  }
}

步驟五:初始化記憶庫

把現有的 .md 檔案全部索引進去:

python3 ~/.claude/hooks/memvid_index.py --force

看到「已索引 N 個檔案」就完成了。

最省力的方法:讓 Claude 幫你一鍵建立

如果你覺得上面步驟太複雜,有個更簡單的方式:直接把設定需求貼給 Claude Code,讓它幫你執行。

請幫我建立智能任務資料夾系統:
任務名稱:[你的任務]
任務目標:[一句話說明]
啟動指令:[你以後說這句話就自動執行任務]

請完整建立資料夾結構、CLAUDE.md、流程.md、執行報告.md、
錯誤紀錄.md、技能庫/SKILL.md,
並安裝 memvid-sdk、建立 Hook 腳本、設定 settings.json、
初始化記憶庫,最後驗證全部正常運作。

Claude Code 會自動完成所有步驟,包括安裝套件、建立腳本、設定 hooks。

使用後的實際效果

設定完成後,每次你對 Claude Code 說任何話,它會自動在回應前顯示:

[已自動檢索相關記憶...]

記憶1《錯誤紀錄》:上次 API 返回 401,原因是...
記憶2《執行報告》:上次執行時,SEO 設定步驟為...
記憶3《SKILL》:處理標籤時要先搜尋再建立,避免重複...

任務結束後,它也會自動顯示:

[已自動歸檔本次任務經驗... 2026-04-08 10:40]
已索引 3 個更新的檔案

搭配 ClawHub 技能,效果加倍

記憶系統建好之後,可以搭配 ClawHub 技能市集 安裝更多自訂指令,讓 Claude Code 更好用。其中有兩個技能和本文的記憶系統搭配特別順:

  • /humanize:一鍵移除文章中的 AI 感,讓文字讀起來更自然有人味。記憶系統會記住你的文字風格,下次自動套用。
  • /multi-search:同時用 17 個搜尋引擎(Google、DuckDuckGo、Brave 等)搜尋,不需要 API 金鑰。記憶系統會記住你常用的搜尋組合,下次直接沿用。

這兩個技能都可以透過 ClawHub 安裝教學 取得,安裝後輸入 /humanize/multi-search 即可直接使用。

注意事項

  • 英文技術詞搜尋效果最好:Memvid 內建的搜尋引擎對英文詞效果佳,純中文搜尋效果較有限
  • CLAUDE.md 仍會全文載入:Memvid 是在 CLAUDE.md 之上加入歷史記憶召回的能力,兩者互補
  • Hook 需重啟 Claude Code 才生效:設定好 settings.json 後,重新開啟 Claude Code 才會啟動
  • 記憶庫會持續成長:每次任務結束都會自動更新,用越久越準確

結論

Claude Code 的記憶問題一直是重度使用者的痛點。這套 Memvid + Hooks 雙軌記憶系統提供了一個實用的解法:

  • 人類看得懂的 Markdown 檔案(透明、可編輯)
  • AI 可快速檢索的向量記憶庫(智能、自動)
  • 任務開始前自動喚起歷史、結束後自動歸檔新知

最重要的是,整個系統設定好之後完全不需要你手動管理。說一個指令,剩下的 Claude 自己來。


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

➜ 查看更多 AI 數位應用與新知文章


❓ 常見問題 FAQ

Claude Code 的記憶為什麼每次對話都會消失?

Claude Code 預設沒有持久記憶,每次新對話都從零開始。這是隱私設計,但對長期使用者造成不便。解決方法是用 CLAUDE.md 儲存固定指令,或搭配 Memvid 建立可搜尋的向量記憶庫。

CLAUDE.md 和 Memvid 記憶有什麼差別?

CLAUDE.md 是靜態記憶,適合儲存固定的工作規則和偏好;Memvid 是動態向量記憶庫,可儲存過去的對話和決策,並用語意搜尋找出相關記憶。兩者搭配使用效果最佳。

Hooks 在記憶系統裡扮演什麼角色?

Hooks 是自動觸發器,例如每次對話結束後自動把重要內容存入 Memvid,不需要手動操作。設定好後,記憶系統完全自動化運作。

Compare Listings

TitlePriceStatusTypeAreaPurposeBedroomsBathrooms

Compare