メモリ

チームで必ず守る指針は、AGENTS.md またはリポジトリにコミットしたドキュメントに記載してください。メモリは過去の情報を思い出すための補助手段です。常に適用する必要があるルールをメモリだけに保存しないでください。

ChatGPT デスクトップアプリでは、/memories を使って、そのチャットでローカルメモリを使用できるかどうかと、そのチャットの内容を今後のメモリ生成に使えるかどうかを選べます。設定 > パーソナライズのCodex メモリを有効にするで、選択中のマシンのメモリ機能をオンまたはオフにします。ツールを使用したチャットからのメモリ生成を許可するでは、MCP ツールやウェブ検索を使用したチャットを今後のメモリ生成に使えるかどうかを選べます。

選択中のマシンのメモリストアをリセットするには、Codex メモリを削除するを選択し、削除を確定します。ローカルマシンでコンピューター履歴機能を利用できる場合は、その履歴も消去されます。

ChatGPT のメモリは設定 > パーソナライズで管理します。ChatGPT Work には、アカウントとワークスペースで利用できるメモリ設定が適用されます。Codex のローカルメモリストアやローカルメモリ設定は使用しません。

Codex CLI では、対話型セッションで /memories を使って、現在のチャットで既存のローカルメモリを使用できるかどうかと、そのチャットの内容を今後のメモリ生成に使えるかどうかを設定できます。コマンドを利用できない場合は、ローカルメモリの設定を参照してください。

IDE 拡張機能は、接続先の Codex ホストのローカルメモリストアを使用します。そのホストでメモリが有効になっている場合は、Codex CLI と同じ方法でチャットごとにメモリの利用を設定できます。

コンピューター履歴は、macOS のデスクトップ機能です。許可したアプリやウェブサイトでの操作をもとに、ChatGPT と Codex が参照できるメモリとタイムラインを作成します。

Codex のローカルメモリの仕組み

メモリを有効にすると、Codex は対象となる過去のチャットから役立つコンテキストを抽出し、ローカルのメモリファイルに保存できます。進行中のセッションや短時間で終了したセッションは対象外です。Codex は生成したメモリの各フィールドから機密情報を取り除きます。メモリの更新はチャットが終わるたびにその場で行うのではなく、バックグラウンドで行います。

チャットが終了しても、メモリがすぐに更新されるとは限りません。進行中の作業を途中で要約しないよう、Codex はチャットに動きがない状態が十分に長く続くまで待ちます。

Codex のレート制限の利用枠に占める残りの割合が設定したしきい値を下回ると、その回のバックグラウンドでのメモリ生成をスキップすることがあります。これにより、利用上限に近づいたときにメモリ生成で利用枠を消費せずに済みます。

ローカルメモリの保存場所

Codex は、Codex のホームディレクトリにメモリを保存します。デフォルトの場所は ~/.codex です。設定と状態の保存場所では、Codex が CODEX_HOME をどのように使用するかを説明しています。

新しい Codex ホームディレクトリでメモリを有効にすると、CLI はデフォルトで $CODEX_HOME/memories_v2/ を使用します。$CODEX_HOME/memories/ がすでに存在する場合は、デフォルトでそのストアを引き続き使用します。バージョンを明示的に指定するには、memories.version を設定します。バージョンを明示的に指定せずに memories.dual_write = false を設定すると、新しいプロファイルでも v1 が使われます。

デスクトップアプリで過去のチャットから生成された要約やその根拠となる情報を調べるには、$CODEX_HOME/memories/ と $CODEX_HOME/memories_v2/ の両方を確認してください。移行期間中にメモリを有効にした新しいローカルチャットを開始すると、新しいプロファイルでも、memories/ から読み込み、両方のディレクトリに書き込むことがあります。

これらのファイルは、Codex が生成する状態データとして扱ってください。トラブルシューティング時や Codex のホームディレクトリを共有する前に内容を確認できますが、メモリの管理にはファイルの手動編集に頼らず、メモリ設定を使用してください。

チャットごとのローカルメモリ設定

ChatGPT デスクトップアプリと Codex TUI では、/memories で現在のチャットのメモリ設定を変更できます。現在のチャットで既存のメモリを使用できるかどうかと、Codex がそのチャットを今後のメモリ生成に使えるかどうかを個別に選べます。

チャットごとの選択は、メモリの全体設定には影響しません。

ローカルメモリの確認

メモリに機密情報を保存しないでください。Codex は生成したメモリの各フィールドから機密情報を取り除きますが、Codex のホームディレクトリや生成されたメモリ関連のファイルを共有する前には、メモリファイルの内容を確認してください。

ローカルメモリの設定

Codex のローカルメモリはデフォルトでオフになっています。ChatGPT デスクトップアプリでは、設定 > パーソナライズを開き、Codex メモリを有効にするをオンにします。

設定ファイルで有効にするには、次の機能フラグを config.toml に追加します。

[features]
memories = true

設定ファイルの場所とメモリ関連の設定一覧については、設定の基本と設定リファレンスを参照してください。

メモリに関する主な設定は次のとおりです。

• memories.generate_memories は、新しく作成したチャットをメモリ生成用の入力として保存できるかどうかを指定します。
• memories.use_memories は、Codex が今後のセッションに既存のメモリを読み込むかどうかを指定します。
• memories.disable_on_external_context を true にすると、MCP ツールの呼び出し、ウェブ検索、ツール検索などで外部コンテキストを使用したチャットがメモリ生成の対象から除外されます。従来のキー memories.no_memories_if_mcp_or_web_search も引き続き別名として使用できます。
• memories.min_rate_limit_remaining_percent は、メモリ生成を開始するために Codex のレート制限の利用枠が最低でも何パーセント残っている必要があるかを指定します。
• memories.extract_model は、チャットごとのメモリ抽出に使用するモデルを上書きします。
• memories.consolidation_model は、メモリ全体の統合に使用するモデルを上書きします。