Codex memoryの使い方｜保存内容と長期スレッド管理の要点

Codex memoryとは何か

memory codexや「Codex メモリー」で探している人が知りたいのは、以前伝えた前提を別の会話でも使えるかどうかでしょう。Codex memoryは、利用対象になった過去の会話から、繰り返し役立つ背景や好み、作業上の判断を抽出してローカルへ残す機能です。新しい会話では関連する記憶だけが文脈として取り込まれるため、毎回すべてを説明し直す負担を減らせます。ただし、記憶は補助的な想起層であり、常に守るべき命令や正本の文書を置き換えるものではありません。公式の解説は、ChatGPTの記憶とローカルCodexの記憶が別の保存領域と操作方法を持つことも明記しています（出典: OpenAI Memories）。

ChatGPTの記憶とローカルCodexの記憶は別

ChatGPT上の記憶はWeb側の体験に使われますが、ローカルCodexクライアントはCodexホーム配下の専用領域を使います。そのため、ChatGPTで覚えさせた内容が、そのままCodex CLIの会話へ入ると考えるのは適切ではありません。どの端末のどのCodexホームを使っているか、メモリーが有効か、現在の会話で利用が許可されているかを個別に確認する必要があります。端末を移しただけでは同じ記憶が当然に現れるとは限らない点も押さえておきましょう。

なぜ今メモリーを確認するのか

OpenAIの公式更新履歴では、2026年7月21日付のCodex CLI 0.145.0に、長いスレッドのページ分割、再開、検索、保存名、複数担当の支援と並んでメモリー対応が記載されました（出典: Codex changelog）。同時期の公式リポジトリの変更では、メモリーの機能区分を安定扱いへ移しつつ、初期値は無効のまま維持する方針が確認できます（出典: openai/codex #31804）。つまり、仕様を理解して自分で有効化する段階に入ったことが、今確認する理由です。

Codex memoryが保存する内容と動くタイミング

メモリーを有効にすると、Codexは対象条件を満たす過去の会話から、今後も使える文脈をローカルの記憶ファイルへ整理します。保存対象は会話全文の単純な複製ではなく、要約、長く使える項目、最近の入力、判断を裏付ける情報などです。処理は会話の終了と同時ではなく、進行中の内容を途中で確定しないよう、会話が十分に使われていない時間を置いてから行われます。短時間で終わった会話や現在進行中の会話は対象から外れるため、直前に伝えた内容が新しい会話へすぐ現れなくても、直ちに不具合とは判断できません。

保存場所はCodexホーム配下

標準設定では、記憶の主要ファイルは~/.codex/memories/配下に置かれます。ここには要約、長く残す項目、最近の入力、過去の会話から得た補助情報が含まれます。Codexホームの場所を変更している場合は、その変更先のmemoriesディレクトリを確認してください。これらはCodexが生成・管理する状態ファイルなので、問題調査や共有前の確認には使えますが、手編集を日常の操作方法にするのは避けます。正しい制御は設定画面、設定ファイル、/memoriesから行うのが安全です。

進行中・短時間の会話は記憶にならない

Codexは、まだ作業が続いている会話を途中の状態で要約しないよう、しばらく使われていない会話を待ってから記憶を更新します。また、短時間で終わった会話は繰り返し使う価値が低い可能性があるため、対象外になる場合があります。残り利用量が設定された下限を下回っていると、追加消費を避けるため記憶作成が見送られることもあります。反映時刻だけを見るのではなく、会話の長さ、経過時間、残り利用量を合わせて確認すると原因を切り分けやすくなります。

機密情報への配慮と記憶の役割

公式説明では、記憶を作る際に機密情報を取り除く処理があるとされています。それでも、Codexホームや記憶ファイルを他人へ渡す前には内容を確認してください。記憶は便利な補助ですが、社内規約、必須の確認事項、禁止事項などを唯一の保存先にするべきではありません。必ず適用したい指示はAGENTS.mdやリポジトリ内の確認可能な文書へ置き、メモリーには会話を始めやすくする背景や、繰り返し現れる判断材料を担わせると役割分担が明確になります。

Codex memoryを有効にする手順

有効化は、デスクトップアプリの設定画面を使う方法と、config.tomlへ機能設定を書く方法の2通りです。どちらを使っても、最初に利用中のCodexを新しい版へ更新し、/memoriesが利用できる状態か確かめます。設定を入れただけでは、すべての会話が無条件に記憶へ使われるわけではありません。全体で機能を有効にした後、現在の会話で既存の記憶を使うか、会話を将来の記憶作成へ回すかを選びます。公式の設定項目と現在の画面表示を照らし合わせながら進めると、古い版との違いで迷いにくくなります。

Step 1: Codex CLIを更新して版を確認する

公式更新履歴に記載された0.145.0以降を基準にすると、メモリーと長期スレッド管理の説明を同じ前提で確認できます。npmから導入している場合はnpm install -g @openai/codex@latestで更新し、続けてcodex --versionを実行します。別の方法で導入した環境では、その導入元に合わせて更新してください。版番号が想定より古い場合は、複数の場所にCodexが入り、以前の実行ファイルが先に参照されていないかも確かめます。

Step 2: 設定画面またはconfig.tomlで有効にする

デスクトップアプリでは、SettingsからPersonalizationを開き、Enable memoriesをオンにします。設定ファイルを使う場合は、利用者単位のconfig.tomlに次の項目を追加します。既に[features]がある場合は同じ見出しを重ねず、その中へmemories = trueだけを加えてください。ローカルCodexのメモリーは初期状態で無効なので、この操作をしない限り記憶は生成されません。設定の正式な項目は公式リファレンスでも確認できます（出典: Configuration Reference）。

[features]
memories = true

Step 3: 現在の会話で利用方法を選ぶ

対話画面で/memoriesを開くと、現在の会話が既存の記憶を使うか、現在の会話を将来の記憶作成に使うかを選べます。この選択は会話単位であり、全体設定そのものを書き換えるわけではありません。機密性の高い一時作業では両方を使わず、長く続く開発案件では必要な側だけを許可するといった調整ができます。まずは検証用の会話で有効にし、別の新しい会話で背景が適切に引き継がれるかを確かめてから対象を広げると安心です。

設定項目で記憶の作成と利用を分ける

メモリーには、記憶を「作る」側と「使う」側を分ける設定があります。過去の会話を材料にすることは許可するが新しい会話へは入れない、または既存の記憶は参照するが現在の会話は今後の材料にしない、といった使い分けが可能です。さらに、外部の情報を参照した会話を記憶作成から外す設定や、残り利用量が少ないときに処理を止める設定も用意されています。各項目は必要な理由があるときだけ変更し、最初は機能の有効化と会話単位の選択だけで挙動を確かめると、設定同士の影響を追いやすくなります。

作る設定と使う設定を混同しない

generate_memoriesを無効にしても、use_memoriesが有効なら既にある記憶が新しい会話へ入る可能性があります。反対に、use_memoriesを無効にしても、現在の会話が今後の記憶作成に使われる設定は残り得ます。「今回の会話に記憶を入れたくない」のか、「今回の会話を後で記憶にしたくない」のかを分けて考えてください。両方を止めたい会話では、/memoriesで2つの選択をそれぞれ確認する必要があります。

外部情報を使った会話を残さない設定

disable_on_external_contextを有効にすると、ウェブ検索や外部ツールなどから得た文脈を使った会話を記憶作成の対象から外せます。検索結果は時間とともに変わり、外部サービスの応答も永続的な前提とは限りません。変化しやすい情報を長期記憶へ混ぜたくない場合に有効です。一方、公式資料を参照して得た判断を継続的に使いたい場合は、判断の根拠をリポジトリ内の文書へ整理し、そこを正本にしたほうが後から検証しやすくなります。

Codex memoryが反映されないときの確認方法

メモリーが見えないときは、機能の有効化、会話単位の選択、記憶作成までの待ち時間、対象会話の長さ、残り利用量、保存場所の順に確認します。とくに多いのは、全体設定を有効にしただけで会話側の選択を確認していないケースと、会話終了直後に別の会話を開いて結果を求めるケースです。記憶作成は進行中の内容を誤って固定しないよう遅れて行われるため、即時反映を前提にしないでください。設定ファイルを変更した場合は、Codexを開き直してから同じ条件で再確認します。

Step 1: 有効化と会話単位の選択を見直す

まずデスクトップアプリのEnable memories、またはconfig.tomlのmemories = trueを確認します。次に対象の会話で/memoriesを開き、既存の記憶を使う選択と、現在の会話を記憶作成へ使う選択を別々に見ます。片方だけ無効になっていると、保存はされるが参照されない、または参照はされるが新しい記憶が増えない状態になります。期待する動きに必要な側が許可されているかを言葉にして確認すると見落としを減らせます。

Step 2: 待ち時間・会話の長さ・残り利用量を確認する

設定が正しければ、対象会話を閉じてすぐではなく、十分に使われていない時間を置いてから確認します。進行中の会話や短時間の会話は記憶作成を見送られることがあります。また、min_rate_limit_remaining_percentで定めた下限より残り利用量が少ない場合も、追加消費を避けるため処理されません。検証では、ある程度の背景と判断を含む会話を一つ用意し、時間を置いた後に新しい会話から関連内容を尋ねると挙動を判定しやすくなります。

Step 3: 保存場所を確認して切り分ける

最後に、利用中のCodexホーム配下にあるmemoriesディレクトリを確認します。標準なら~/.codex/memories/です。ファイルがない場合は、有効化、対象条件、待ち時間のどこかで記憶作成に進んでいない可能性があります。ファイルがあるのに新しい会話で使われない場合は、use_memoriesと会話単位の参照設定を見直します。ファイルを直接書き換えて直そうとせず、まず設定と対象条件を整えて再現性のある小さな会話で試してください。

長期案件でCodex memoryを安全に使うコツ

長期案件では、繰り返し説明している背景、採用した判断、好みの出力形式などをメモリーが補助すると、会話を再開しやすくなります。一方、必須規約や正確な仕様まで記憶任せにすると、抽出されなかった項目や古くなった前提を見落とすおそれがあります。変わりにくい規約はAGENTS.md、製品仕様はリポジトリ内の文書、会話を滑らかに再開するための補助情報はメモリーというように保存先を分けてください。新しい会話の冒頭では、重要な前提が正しく入っているか短く確認し、誤りがあれば正本の文書を示して修正する運用が堅実です。

記憶に向く情報と文書に残す情報を分ける

記憶に向くのは、同じ案件で何度も説明する背景、利用者が好む回答の粒度、過去の会話で合意した作業上の傾向などです。文書に残すべきなのは、必ず守る品質基準、公開条件、設計上の制約、障害時の復旧手順など、誰が見ても同じ内容である必要がある情報です。前者は会話の開始を速くし、後者は判断の根拠を検証可能にします。二つを混ぜず、重要な内容ほど正本を明示すると、メモリーの便利さを保ちながら誤用を防げます。

定期的に内容を見直して古い前提を残さない

案件が進むと、以前は正しかった選択が変わることがあります。Codexホームを共有する前だけでなく、節目ごとに記憶ファイルを確認し、古い前提が会話へ影響していないかを見直してください。内容に疑問がある場合は手編集で整えるのではなく、正しい情報を文書へ反映し、会話単位の参照を止めた状態で挙動を確かめます。必要なときだけメモリーを使う姿勢が、長期スレッドでの利便性と情報管理の両立につながります。

まとめ

Codex memoryは、過去の会話から役立つ文脈をローカルへ残し、将来の会話で再利用するための機能です。2026年7月21日付のCodex CLI 0.145.0で長期スレッド管理とともに公式更新へ掲載されましたが、現行仕様でも初期状態は無効です。まず利用中のCodexを更新し、設定画面またはconfig.tomlで有効化したうえで、/memoriesから会話ごとの作成・参照を選びます。反映されない場合は、即時性を求めず、対象会話の状態、待ち時間、残り利用量、~/.codex/memories/の順に確認してください。必須の規約や仕様は文書を正本にし、メモリーは会話を再開しやすくする補助として使うのが、安全で再現性の高い活用方法です。