← AI 寫程式記憶實用指南

指南

有 Claude Code 自動記憶了,什麼時候還需要外部記憶工具?

只在同一台電腦的 Claude Code 使用,可先用原生自動記憶;需要跨工具、跨電腦或獨立來源檢查流程時,再評估外部記憶。

作者: Cairn

更新於:

發布於:

如果脈絡只需要留給同一台電腦、同一個版本庫裡的 Claude Code,自動記憶通常就夠了。需要讓其他助理或另一台電腦取用相同私人脈絡,或想另有一套來源檢查流程,再考慮外部記憶。跨專案偏好也不一定需要新服務,個人指示檔已能處理。

Claude Code 現在有哪些原生記憶功能?

官方記憶文件把你維護的指示與 Claude 自己寫下的心得分開。前者告訴助理應該怎麼做,後者從互動中挑選值得留給下次的學習,不是每段對話的完整錄影。文件查閱日期為 2026-11-12。

目前文件說,自動記憶以版本庫為範圍,同一台電腦上的 worktree 可共用;檔案留在本機,不會自動同步到另一台電腦或雲端環境。它有索引和各主題檔案,可以打開查看,不必猜 Claude 到底保存了什麼。

專案指示可放 CLAUDE.md 或受支援的 AGENTS.md,規則可分在 .claude/rules/,個人指示則用 ~/.claude/CLAUDE.md。自動記憶放在 ~/.claude/projects/<project>/memory/,可從 /memory 檢查記憶設定。

上面的專案目錄由 Claude Code 決定,不要照字面建立含角括號的資料夾。多種指示檔同時存在時,載入方式會受到版本與設定影響,調整既有專案前先對照官方文件。

一般本機對話預設啟用自動記憶,部分託管或背景情境例外。官方文件把心得分為使用者脈絡、回饋、專案脈絡與外部參考。每次對話開始會載入索引前 200 行或 25KB,以先達到者為準;細節主題檔可另外讀取。可以從記憶面板檢查保存內容或調整開關。

需要從技術上限制操作時,使用用戶端的權限控制。記憶提供行為脈絡,權限設定負責可執行的操作。

哪些情況留在原生功能就好?

假設你只在一個版本庫用 Claude Code,想讓它記得你對合作方式的修正。你可以查看已保存的心得、改掉錯誤內容,再繼續工作,不必增加登入、資料庫或另一個服務。

先想下一個讀者是誰。如果仍是讀取同一份本機記憶的 Claude Code,新系統可能沒有解決眼前任何缺口。如果這是每個貢獻者都要遵守的固定規則,直接寫成專案指示,比等助理自己推論更清楚。

個人層級指示也常被忽略。回覆詳略、解釋習慣這類偏好,可以放在個人指示檔,跨 Claude Code 專案使用。如果偏好只需要給 Claude Code 讀取,先用這個原生選項。

能說清楚內容放哪裡、現有行為也夠用,就先保留原生做法。另一個儲存區應該補上一個具體缺口。

哪些缺口值得另外接服務?

最明確的是換助理。你在 Claude Code 決定一項私人偏好,之後希望 Codex 或 Cursor 能找回,兩邊就需要約定好的共同來源。替每個用戶端接好共同來源,才能找回同一筆脈絡。

第二種是換電腦。桌機與筆電輪流工作,不想自己複製記憶目錄,可以評估有共同帳號儲存區的託管服務,但兩台都要完成連線。本機儲存區也能自行搬移或備份,搬移與備份流程由你管理。

還有一種是你想怎麼檢查記憶。團隊已經在版本控制裡維護正式決策,而你另外想留一個私人提醒,並看得到當初形成這項提醒的來源摘錄。這和把所有指示檔越寫越長,是不同需求。採用前先比較查看、更正與刪除方式。

安裝前先列出要讀取脈絡的用戶端,核對支援的接法,再選擇符合需求的保存位置與檢查功能。

Cairn.ink Memory 適合放在哪裡?

Cairn.ink Memory適合需要跨 Claude Code、Codex 與電腦使用的私人脈絡。Memory 是使用者擁有的私人事實、偏好或決策;Source Receipt 提供由來的對話摘錄與用戶端資訊,方便檢查。

先執行安裝器:

npx @cairn-ink/memory setup

選 Cloud,就能替 Claude Code 與 Codex 設定自動保存與提問回想。安裝器找到兩個 CLI 後,同意連接,完全關閉兩個工具並等背景工作結束,再確認共用。第一次成對設定只需一次瀏覽器登入,記憶身分會連起同一個專案。也可以直接選 Cloud:

npx @cairn-ink/memory setup --cloud
npx @cairn-ink/memory status

重開 Codex 後,在 /hooks 檢查四項 Cairn 設定。Hook 是隨用戶端對話事件執行的動作,負責自動行為;MCP,也就是 Model Context Protocol,則提供可明確呼叫的工具。需要平常工作時就接續脈絡,尤其常換助理的人,可以從 Cloud 開始。

只在一台電腦使用、希望免費且不需帳號,則在設定時選 Local,或執行:

npx @cairn-ink/memory setup --local

Local 讓受支援用戶端共用 SQLite,使用明確工具,沒有自動保存或跨電腦同步。語意回想可能把選取文字送到設定的模型供應商。各模式行為見發版文件與安裝器 README。

成對雲端安裝可用以下控制:

npx @cairn-ink/memory pause
npx @cairn-ink/memory resume
npx @cairn-ink/memory prompt-recall-off --client codex
npx @cairn-ink/memory config --codex-daily-cap 300

暫停期間的對話不補存。Codex 關閉提問回想後,仍繼續自動保存,MCP 也可使用。每日上限控制保存次數:Codex 預設 200 次,既有安裝保留原上限;已有當日計數時,修改在下次每日重置生效,Claude 額度獨立計算。

Cloud 會先在本機盡力遮蔽敏感內容,再保存對話;提問時也會送出經遮蔽、限制長度的副本供回想。啟用前先看隱私控制。私人 Memory 與 Knowledge Card 分開,後者有自己的審閱與人為授權發布流程。

不搬全部筆記,也能先判斷嗎?

挑一個經常重複解釋的問題,例如你在兩個助理都會提到的偏好。原本的專案指示與原生記憶先留著,寫清楚由誰保存、誰要讀取,以及它是個人還是專案範圍。

用不含敏感資料的合成內容測試,先看到工具真的保存成功,再到另一個工具的新對話查詢,過程不要把答案一起貼過去。產品若提供識別碼與來源,就拿來比對。第二個助理只是複述你剛貼的偏好,還不算驗證共用記憶。

接著測一次改變心意。照產品文件完成更正或遺忘,再查詢一次。能記住舊偏好,卻不知道怎麼讓它退場,表示這套流程還沒通過你的工作測試。

同時使用兩套記憶,怎麼避免矛盾?

先替內容指定保存位置。執行環境版本留在維護中的專案設定,團隊慣例留在審閱過的指示檔,跨工具私人偏好可以放在共用私人記憶,原生學習則處理本機互動細節。

內容衝突時,回到目前來源與你現在的指示,修正或移除過時副本,不要讓模型猜哪份才是你的意思。遇到新舊資訊或優先順序問題,就拿 Source Receipt 與目前來源核對。以這裡示範的服務而言,託管工具提供保存、回想與遺忘,本機另有更正工具,不能假設兩邊命令相同。

下一步,挑一個要跨助理使用的偏好,依連線指南實際測一次。

常見問題

每個 Claude Code 專案都需要外部記憶嗎?
不需要。如果脈絡只在這台電腦的 Claude Code 使用,原生自動記憶和維護中的指示檔可能就夠了。
原生指示能跨專案使用嗎?
可以。個人層級的指示檔能保存你在不同 Claude Code 專案的偏好。跨專案本身不代表一定要外部服務。
Source Receipt 能證明記憶正確嗎?
不能。它提供檢查來源的線索,仍要和目前指示、持續維護的專案紀錄核對。
Cairn.ink Memory 要取代自動記憶嗎?
兩者可以並用。重點是替反覆使用的內容指定明確的保存位置,避免多處留下互相矛盾的版本。

參考來源