使用記憶能力

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
Memories	記憶	讓 Codex 跨會話記住偏好和上下文的能力。
Memory storage	記憶儲存	記憶資料儲存的位置和範圍。
per-thread 控制	按執行緒控制	單個會話維度開關或清理記憶。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你設定和管理 Codex 的記憶能力，既好用又不留風險。

你是 Codex 記憶設定顧問，幫我配好記憶能力，既能跨會話省事又不留隱私和誤記風險。

【角色】
你知道怎麼啟用 Memories、記憶如何工作、儲存位置、按 thread 控制記憶、相關設定。

【輸入】
- 我想讓它記住什麼（偏好 / 專案約定 / 流程）：___
- 哪些資訊不能被記住（敏感 / 臨時）：___
- 個人用還是多專案 / 多人：___
- 對隱私的顧慮：___

【工作流程】
1. 判斷哪些該記、哪些不該記
2. 給啟用和設定方式
3. 說明怎麼按 thread 控制和清理
4. 給記憶出錯（記了不該記的）時的處理

【輸出規範】
▌一、該記 / 不該記的清單
▌二、啟用與設定方式
▌三、按 thread 的控制和清理
▌四、誤記的清理和防範

【硬約束】
- 敏感資訊不進記憶，臨時資訊及時清
- 多專案 / 多人時注意記憶隔離
- 不確定記憶邊界時保守開啟
- 提醒定期複查記了什麼
- 不確定的機制標註需查官方文件

Memories 預設關閉。launch 時，European Economic Area、United Kingdom 和 Switzerland 不可用。

你可以在 Codex settings 中啟用 memories，或在 ~/.codex/config.toml 的 [features] table 中設定：

memories = true

Memories 讓 Codex 可以把早期 threads 中有用的 context 帶入未來工作。

啟用 memories 後，Codex 可以記住 stable preferences、recurring workflows、tech stacks、project conventions 和 known pitfalls，這樣你不需要在每個 thread 中重複相同 context。

required team guidance 仍應放在 AGENTS.md 或 checked-in documentation 中。

把 memories 當成有幫助的 local recall layer，不要把它當成必須始終生效的 rules 唯一來源。

Chronicle 可以幫助 Codex 從你的 screen 恢復最近 working context，並逐步建立 memory。

Enable Memories

在 Codex app settings 中啟用 Memories。

如果用 config-based setup，在 config.toml 中新增 feature flag：

[features]
memories = true

config.toml 的 user-level configuration 儲存位置，以及 Codex 如何載入 ~/.codex/config.toml，見 Config basics。

How Memories Work

啟用 memories 後，Codex 可以把 eligible prior threads 中有用的 context 轉成本地 memory files。

Codex 會跳過 active 或 short-lived sessions，從 generated memory fields 中 redact secrets，並在 background 更新 memories，而不是每個 thread 結束後立即更新。

thread 結束時，memories 不一定立刻更新。

Codex 會等 thread idle 足夠久，避免把仍在進行中的工作提前 summarize。

當 Codex rate-limit remaining percentage 低於 configured threshold 時，memory generation 也可能跳過一次 background pass，避免在接近 limit 時消耗 quota。

Memory Storage

Codex 把 memories 存在 Codex home directory 下。預設是 ~/.codex。

Codex 如何使用 CODEX_HOME，見 Config and state locations。

主要 memory files 位於 ~/.codex/memories/，包括 summaries、durable entries、recent inputs，以及 prior threads 的 supporting evidence。

把這些 files 當成 generated state。

排錯時，或分享 Codex home directory 前，你可以檢查它們；但不要把手動編輯這些 files 當成 primary control surface。

Control Memories per Thread

在 Codex app 和 Codex TUI 中，使用 /memories 控制目前 thread 的 memory behavior。

thread-level choices 讓你決定目前 thread 是否可以使用 existing memories，以及 Codex 是否可以用這個 thread 生成 future memories。

thread-level choices 不會改變 global memory settings。

Configuration

在 Codex app settings 中啟用 memories，或在 config.toml 的 [features] section 設定：

memories = true

config file locations 以及 memory-related settings 完整列表，見 configuration reference。

常見 memory-specific settings：

memories.generate_memories：控制 newly created threads 是否可以被儲存為 memory-generation inputs。
memories.use_memories：控制 Codex 是否把 existing memories 注入 future sessions。
memories.disable_on_external_context：當值為 true 時，使用過 external context 的 threads 不參與 memory generation，例如 MCP tool calls、web search 或 tool search。舊 key memories.no_memories_if_mcp_or_web_search 仍作為 alias 接受。
memories.min_rate_limit_remaining_percent：控制 memory generation 開始前所需的 minimum remaining Codex rate-limit percentage。
memories.extract_model：override per-thread memory extraction 使用的 model。
memories.consolidation_model：override global memory consolidation 使用的 model。

Review Memories

不要把 secrets 存入 memories。

Codex 會從 generated memory fields 中 redact secrets，但在分享 Codex home directory 或 generated memory artifacts 前，你仍應 review memory files。