指南
Claude Code 和 Codex 怎麼共用記憶?
用共用指示檔保存專案規範,讓 Claude Code 與 Codex 連到同一個私人記憶儲存區,再從新對話驗證保存與讀取。
執行 npx @cairn-ink/memory setup 並選 Cloud,就能讓 Claude Code 與 Codex 自動共用記憶。第一次一起設定只需一次瀏覽器登入,記憶身分會連起兩邊的同一個專案。不想登入、只在一台電腦使用,則選 Local 的明確工具模式。完成後,到另一個工具的新對話驗證。
怎麼設定自動共用?
Cairn.ink Memory的安裝器支援這兩個用戶端。先準備 Node 22.16 以上版本,確認 Claude Code 與 Codex CLI 都在執行路徑上,再執行:
npx @cairn-ink/memory setup
第一次詢問保存位置時選 Cloud。已經確定要用雲端,也可以直接執行:
npx @cairn-ink/memory setup --cloud
安裝器會找出兩個工具,詢問尚未建立的連線,請同意連接兩邊。確認共用前,完全關閉 Claude Code 與 Codex,等背景工作結束,再依畫面提示登入 cairn.ink、輸入一次性代碼。第一次同時設定兩個工具,只需一次瀏覽器授權。
Cloud 提供自動保存對話與提問前回想,讓相關脈絡能帶進之後的提問。記憶身分會連起兩個工具的同一個專案,既有身分會保留;如果兩邊已經各有一份,安裝器會請你選擇,並在登入及驗證成功後備份另一把 key。更新舊安裝時,請看清楚這個選擇。
設定後重開兩個工具,在 Codex 的 /hooks 檢查並允許四項 Cairn 設定。Hook 是在對話事件發生時執行的用戶端動作,負責自動整合;MCP 工具則供助理明確呼叫。流程依發版安裝器 README。
怎麼確認兩邊真的共用?
先看本機安裝報告:
npx @cairn-ink/memory status
接著實際保存和讀取。第一次先用個人範圍,讓測試不依賴專案配對。在 Claude Code 輸入:
Use remember_memory to save this in personal scope:
For the fictional Harbor demo, I want review summaries to start with test results.
Show the Memory ID and Source Receipt returned by the tool.
查看工具回應,留下識別碼與 Source Receipt 給自己比對。Memory 是使用者的私人脈絡,Source Receipt 包含由來的對話摘錄與用戶端資訊。開啟全新 Codex 對話,不要貼入剛才保存的答案,只問:
Use recall_memory to find my review-summary preference for the Harbor demo.
Show the returned Memory ID and Source Receipt, or report no matching result.
比對識別碼與來源。平常兩邊都會保存的話,再反向測一次。這先確認共用儲存區;要檢查自動整合,再於一般對話提到一個無敏感資料的偏好,等回合及背景工作完成後,到另一邊的新對話詢問,查看實際保存和回想的內容。
個人範圍成功後,再用安裝器連起的同一專案測專案私人脈絡。簡單記下哪邊保存、哪邊讀取,日後比較容易找出帳號或範圍不一致的原因。
自動保存和回想怎麼控制?
雲端對話會先在本機盡力遮蔽敏感內容,再保存;每次提問也會送出經遮蔽、限制長度的副本供回想。啟用前先讀隱私控制。
成對安裝時,以下指令使用已安裝的 Codex 整合,並與 Claude 共用保存暫停狀態:
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 工具;要恢復,用相同指令前綴執行 prompt-recall-on --client codex。Codex 預設每天自動保存 200 次,既有安裝保留原本上限;已有當日計數時,新上限在下次每日重置生效,Claude 額度獨立計算。自動執行的 Codex 工作預設排除保存與提問回想。
不想登入,可以用 Local 嗎?
可以在初次設定選 Local,或直接執行:
npx @cairn-ink/memory setup --local
npx @cairn-ink/memory status
兩個工具會以 cairn-local 共用這台電腦上的資料庫和 owner,預設位置是 ~/.cairn-memory/data/memory.sqlite。Local 免費、不需帳號,透過明確工具操作,沒有自動保存或跨電腦同步。
保存和查看不需要模型金鑰。第一次可先存一筆合成記錄,再到另一個工具的新對話查看:
Use inspect_memory to list saved Memories, then inspect the test Memory.
Show its ID, content and receipt from the tool response.
語意回想需要設定模型金鑰,可能把選取文字送到供應商。本機安裝器已測 Linux/WSL,macOS 尚未測試,原生 Windows 請用 WSL。變更既有安裝前保留備份;切換模式依畫面步驟處理,setup 不會在 Local 與 Cloud 之間搬移記憶。
可以只用託管明確工具嗎?
只想手動存取、不啟用自動保存時,Claude Code 可用 HTTP 註冊,並從 /mcp 完成瀏覽器 OAuth:
claude mcp add --transport http --scope user cairn https://cairn.ink/api/mcp
Codex 的文件也提供權杖替代接法。請自行到 https://cairn.ink/settings/tokens 建立權杖,透過版本庫外的方式提供;下面是佔位值:
export CAIRN_MCP_TOKEN='your-token-from-cairn.ink'
codex mcp add cairn --url https://cairn.ink/api/mcp --bearer-token-env-var CAIRN_MCP_TOKEN
codex mcp list
從包含該環境變數的環境重開 Codex。接法見發版 README,用戶端語法見 Claude Code MCP 文件及 Codex MCP 指南,查閱日期為 2026-11-12。
共用規則和使用限制放哪裡?
固定專案規範放在 AGENTS.md,依 Codex 指示檔指南維護。Claude Code 可依記憶文件,從旁邊的 CLAUDE.md 匯入,兩份文件查閱日期為 2026-11-12:
@AGENTS.md
加入匯入時保留既有指示。版本與建置命令留在持續維護的專案檔案,私人 Memory 保存跨工具個人脈絡。團隊知識則放在經審閱的檔案或 Knowledge Card,發布另需人為授權。
排錯先查伺服器、帳號、範圍與安裝器連起的專案身分。status 只讀本機狀態,不驗證遠端服務或 hook。Source Receipt 說明由來,拿記憶中的技術資訊改程式前,仍要核對目前來源。
從連線指南設定適合的路徑。
常見問題
- 共用專案規則一定要伺服器嗎?
- 不需要。可在 AGENTS.md 維護共同指示,Claude Code 的 CLAUDE.md 則可匯入它。
- 兩個工具能使用同一個本機資料庫嗎?
- Cairn.ink Memory 本機設定可讓同電腦上的 Claude Code 與 Codex 共用資料庫和 owner,沒有自動擷取或跨電腦同步。
- 怎麼開啟自動共用?
- 執行 npx @cairn-ink/memory setup 並選 Cloud,同意連接兩個工具後完成一次瀏覽器登入。安裝器會連起專案身分,設定自動保存與提問回想。
- 怎麼證明跨工具讀取成功?
- 第二個工具必須在沒有拿到答案的新對話裡呼叫記憶工具,回傳相同的保存識別碼與來源。