Cairn
登入
← AI 寫程式記憶實用指南

指南

AI 寫程式助理的記憶是怎麼運作的？

從 context window、指示檔、原生記憶到外部檢索，了解寫程式助理的脈絡怎麼保存，又如何回到新對話。

作者: Cairn

更新於:

發布於:

AI 寫程式助理的記憶，是把先前保存的脈絡帶進下一次模型請求。指示檔提供維護中的規則，原生記憶保存挑選過的學習，外部儲存區則找回相關記錄。Context window 容納的是眼前能用的資料；視窗越大，工作容量越大，跨對話延續則靠持久儲存與載入、檢索機制。

Context window 裡面裝了什麼？

Context window 是模型處理一次請求時能用的資料。在寫程式助理中，可能包含你的訊息、檔案內容、指令輸出、規範與檢索記錄。Claude Code 運作指南說明這些輸入如何組成工作脈絡，以及長對話如何壓縮，查閱日期為 2026-11-12。

更大的視窗能同時考慮更多程式與討論。長期記憶處理的是另一個問題，哪些資訊要留下，下次怎麼收到？可以把視窗想成桌面，持久儲存想成檔案櫃。桌面大，今天比較放得下；有櫃子，也找得到對的資料夾，下週才接得上。

例如你說，虛構的 Harbor 原型要能離線展示。眼前對話可以直接用這則訊息，新對話則需要保存的指示、筆記、檢索記錄或另外提供的來源，才能找回這個限制。

哪幾種保存脈絡要分開看？

層次脈絡從哪裡來下次如何收到
指示檔人維護的規範用戶端尋找並載入適用檔案
原生記憶助理功能保存的學習用戶端載入筆記或帶入相關記憶
外部記憶明確保存或整合提交的脈絡工具檢索或自動回想整合
維護中的專案來源程式、manifest、決策文件助理讀取目前相關來源

這些層次可以一起使用。例如指示檔說如何找測試，設定檔保有實際命令，私人記憶保存你喜歡怎麼聽測試結果。重要內容有明確位置，更新時才找得到。

CLAUDE.md、AGENTS.md 和 Cursor rules 做什麼？

指示檔是持久文字，由用戶端帶入工作脈絡。像「改持久儲存前先讀貢獻指南」「依修改的元件選 focused test」，都適合放這裡。進版本控制後，貢獻者能審閱同一條規則。

Claude Code 記憶指南記載 CLAUDE.md、分類規則與匯入，包含需要時使用的 @AGENTS.md。OpenAI 的 AGENTS.md 指南則說明 Codex 如何讀取全域指示，再沿專案一路讀到目前工作目錄，查閱日期皆為 2026-11-12。

Cursor 規則文件介紹個人、專案、團隊規則，以及較簡單的 AGENTS.md。專案規則放在 .cursor/rules，使用 .mdc，由中繼資料決定何時套用，查閱日期同為 2026-11-12。照各用戶端的載入方式設定，再請助理指出這次相關的規則。

剛開始可以先放一份精簡的版本庫指示檔，連到維護中的文件。所有人都該遵守的決定寫清楚，經常變動的細節則留在實際來源，不必每個提問都帶整本專案手冊。

原生記憶怎麼從先前工作學習？

Claude Code 把人維護的指示，和自己寫的 auto memory 分開。自動記憶使用本機 Markdown，包含 MEMORY.md 和主題檔，可從 /memory 查看。脈絡只需留在 Claude Code 文件記載的版本庫與電腦範圍時，這個做法很方便，來源是官方記憶指南。

Codex 也有官方記載的本機記憶，查閱日期為 2026-11-12，預設關閉。開啟後，符合條件的先前對話可以形成產生式本機記憶檔，在適當閒置時間後背景處理。互動 CLI 的 /memories 可以控制目前對話是否使用既有記憶，以及是否成為未來記憶的輸入。

Cursor 目前可先用規則維護原生脈絡。官方 1.2 更新公告也記載 Memories，以及背景產生記憶需要使用者核准的設計；版本可用性留到下面一起檢查。

單一用戶端的儲存與控制已經夠用，就先用原生功能。修正重複出現的錯誤理解後，實際查看存下什麼。有用的筆記要有主題、範圍與理由，讓下次分得清決策和提議。

外部記憶怎麼保存，又怎麼回來？

外部儲存區讓記錄獨立於目前對話。明確保存是你要求留下偏好或決策；自動擷取則由整合提交符合條件的對話，記憶系統再挑出可長期使用的資訊。範圍、欄位、保留方式由各服務決定。

檢索從問題或任務脈絡開始，搜尋找出候選記錄，回傳文字進入模型眼前的脈絡。有些系統比對關鍵字，有些使用語意搜尋或額外模型處理。MCP是讓助理存取外部工具與資料的一種標準，查閱日期為 2026-11-12。

需要在 Claude Code 和 Codex 延續私人脈絡時，Cairn.ink Memory 從這個指令開始：

npx @cairn-ink/memory setup

選 Cloud，啟用自動保存與提問回想。同意連接兩個 CLI，完全關閉並等背景工作結束後，再確認共用，第一次成對安裝只需一次瀏覽器登入。選 Local，則免費、不需帳號，在單機使用明確工具。兩種模式見發版安裝器指南；完成後重開用戶端，Cloud 的 Codex 請在 /hooks 查看四項設定。

私人 Memory 帶有 Source Receipt，提供摘錄與用戶端資訊。共享 Knowledge Card 則另有審閱和人為授權發布流程，見發版文件。想在支援助理之間切換，又能查看私人脈絡的由來，可以評估這條路徑。

記憶不見或內容不對時，先查什麼？

Cursor 過去的 Memories 公告和現在的 Rules 頁面，無法確認每個目前安裝都還有舊版控制選項。本機儲存仍可能使用外部處理，Cairn.ink Memory 的模型引導語意回想也是如此。找回的記憶可能過時，技術決策仍要和目前維護中的來源核對。

排查偏好為何不見時，沿著原始陳述、保存記錄、檢索操作、實際回傳脈絡逐一查，也確認帳號和範圍。用無敏感內容的虛構偏好保存，再到新對話查詢，別把答案一起提供，才能分辨持久化流程正常，還是只是依目前提問生成合理回覆。

需要跨支援助理使用私人記憶，可從連線指南開始。

常見問題

更大的 context window 等於記憶嗎？
更大的視窗能在目前互動容納更多資料。跨對話記憶還需要持久記錄，以及下次載入或檢索它的機制。
指示檔和記憶是誰寫的？
專案指示通常由人維護，原生記憶可從符合條件的互動產生筆記；外部儲存區則接受明確保存，或整合提交的脈絡。
哪些內容應該放版本庫？
團隊規則、目前建置方式與已接受的架構決策，和程式一起維護。跨助理使用的個人脈絡，可以放私人記憶儲存區。
舊脈絡怎麼回到新對話？
用戶端載入指示或記憶檔，透過工具找回記錄，或由提問 hook 帶入脈絡。回傳的文字成為模型這次輸入的一部分。

參考來源