怎麼讓 Codex 記住專案脈絡？

把持續維護的專案指示寫在 AGENTS.md，Codex 啟動時就會讀取；詳細決策則連到版本庫文件。個人偏好與需要跨對話、跨助理延續的脈絡，放私人記憶。Cairn.ink Memory 的 Cloud 安裝器提供 Codex 自動保存與提問回想，Local 則在單機使用明確記憶工具。

AGENTS.md 應該讓 Codex 知道什麼？

寫下每次開始任務都得重講的工作脈絡，例如如何找到合適測試、有哪些貢獻規範、重要決策放在哪裡。規則要具體到新同事也能依照執行。

假設某個版本庫可以從這樣的內容開始：

## Working rules

- Read package.json before choosing build or test commands.
- Use the existing focused test for the component you change.
- Read docs/architecture.md before changing persistence behavior.
- Report the actual check result and any unresolved failure.

依真實專案調整範例。執行環境版本、套件 script 等經常變動的細節，指向持續維護的檔案。根目錄指示保持精簡，較長說明放一般文件，人和 Codex 都比較容易審閱入口。

團隊希望共用的指示放進版本控制，和對應行為一起 review。新增 script 取代舊命令，或 migration 改變支援流程時，順手更新相關規範。

Codex 怎麼找到這些指示檔？

依 官方 AGENTS.md 指南，查閱日期為 2026-11-12，Codex 啟動時會建立指示鏈。先讀 Codex home 的全域指示，通常是 ~/.codex，設定 CODEX_HOME 時則改用指定位置；先查 AGENTS.override.md，再查 AGENTS.md，使用第一份非空檔案。

專案部分從根目錄一路找到目前工作目錄，每層依序查 AGENTS.override.md、AGENTS.md，再查設定的替代檔名，每個目錄最多納入一份。越接近目前工作目錄的內容越後面載入，優先於前面的指示。

專案文件合計預設上限為 32 KiB，由 project_doc_max_bytes 控制。必要規則寫短，特殊工作放巢狀指示。從某服務目錄啟動 Codex 時，就能納入那一層的工作規範。

怎麼確認 Codex 真的有讀到？

修改指示檔後，從預期目錄重新啟動 Codex，請它列出有效指示來源，摘要本次相關規則。再拿答案和檔案核對，較高風險的修改開始前，也先確認規則會怎麼影響操作。

載入內容不對時，查目前目錄、Codex home 和 override。同一目錄的 override 優先於 AGENTS.md，空檔會被略過。使用不同 profile 時，也要看 CODEX_HOME 是否指向另一組全域指示。

指示檔提供脈絡，不保證強制執行。權限和必要驗證要放在實際管控操作的機制中。一般專案任務可以先核對載入的規則與它選擇的測試命令，確認設定符合預期。

哪些內容改放私人記憶？

希望 Codex 普遍讀到的固定偏好，可放使用者層級指示；希望在支援的助理間選擇性回想的個人脈絡，則放私人 Memory，例如解釋方式、討論後釐清的偏好，或自己在某專案的工作背景。

團隊發布流程放經審閱的來源。私人提醒可以指向那份流程，貢獻者繼續維護共同文件。對話改變了專案決策，就先把已接受的決定記進版本庫，再作為團隊規則使用。

Cairn.ink Memory 的 Memory 屬於個人；個人範圍跨專案，專案私人範圍則使用不透明身分。Knowledge Card 是另一種長期知識文件，發布到共享收藏需要另一個明確的人類決定。

Cairn.ink Memory 的 Codex 整合怎麼開？

先執行：

npx @cairn-ink/memory setup

選 Cloud，啟用自動保存與提問回想。需要 Node 22.16 以上與執行路徑上的 CLI。安裝器會找出 Claude Code 和 Codex，詢問新連線；同意想連接的工具，兩邊一起設定時，完全關閉並等背景工作結束後再確認共用。

第一次成對安裝只需一次瀏覽器登入。Memory ID 連起同一專案，應使用安裝器身分，不靠資料夾名稱猜測。重開 Codex，在 /hooks 檢查並允許四項 Cairn.ink Memory 設定。

Hook 會在用戶端事件發生時執行整合動作。安裝器 README記載，Cloud 透過它自動保存與提問回想，並搭配明確 MCP 工具。自動記憶需要通過 Codex 格式資格檢查；codex exec 自動工作預設略過保存與提問回想。遇到格式問題，依 setup 診斷處理。

Cloud 保存前會在本機盡力遮蔽對話，提問回想也會傳送經遮蔽、限制長度的副本。資料流見隱私控制。成對安裝可用以下指令暫停和恢復：

npx @cairn-ink/memory pause
npx @cairn-ink/memory resume

Local 或託管明確工具怎麼用？

在 setup 選 Local，免費、不需帳號，在單機使用明確工具，沒有自動保存或跨電腦同步。它會註冊 cairn-local，支援的用戶端共用資料庫和 owner。請助理明確保存，再用 inspect_memory 查看 ID、內容和收據。模型引導的語意回想需要設定模型 key，保存和查看則不需要。

只想用託管明確工具時，發版 README提供手動 codex mcp add 替代接法，bearer token 環境變數應留在提交設定之外。官方 Codex MCP 指南說明註冊與授權，查閱日期為 2026-11-12。選這條路徑時，依既有連線教學操作。

正式依賴前，要分開確認哪些事？

分兩層測試。重開後先請 Codex 指出本次適用的版本庫規範；再從新對話查一項無敏感內容的私人偏好，顯示回傳識別碼和來源。若準備依賴 Cloud 自動行為，也檢查一次一般對話的無敏感保存。

修改實作前，把技術記憶和目前專案檔案核對。跨用戶端共用與修正舊記憶的完整流程，可接著看相關指南，讓 AGENTS.md 專注在專案規範，私人 Memory 延續個人脈絡。

依連線指南設定 Codex，搭配持續維護的專案指示。