OpenAIのCodexで会話やプロジェクトを整理しているとき、間違えて非表示にしてしまったり、過去のやり取りをもう一度チェックしたくなったりすることってありますよね。ここでは、さまざまな環境で安全かつ確実にデータを復旧するための基本的なステップをわかりやすく解説します。
- デスクトップアプリ版での直感的なアーカイブ解除手順がわかります
- ウェブ画面やターミナル環境での最適なデータの探し方が理解できます
- 会話が突然消えてしまったように見える原因と対策が掴めます
- 履歴管理の仕組みを知ることでトラブルに強い環境を作れます
codexでアーカイブを戻す基本の手順
codexの復元をアプリでおこなう方法
デスクトップアプリケーション版（Codex App）を使っていて、サイドバーから消えてしまったスレッドを復活させたいときは、アプリの設定画面から簡単な操作で元に戻すことができます。まずは落ち着いて、次の手順を試してみてくださいね。
最初に、アプリのメニューから「Settings」を開くか、ショートカットキーの「Cmd + ,」（Mac）または「Ctrl + ,」（Windows）を押します。設定画面が表示されたら、メニュー内にある「Archived Threads」または「Archived Conversations」という管理ビューをクリックして切り替えましょう。
ここには過去にアーカイブしたスレッドが一覧で保管されているので、戻したい対象のセッションを見つけて「Unarchive（アーカイブを解除）」をクリックします。これだけで、メイン画面のサイドバーに過去のチャットが戻ってきます。最後に、サイドバーのフィルタ設定が時系列表示（Chronological）になっているか確認すると、作成された日時の場所にちゃんと再表示されているのが見つかるはずです。
codexの履歴をウェブ画面で確認する
Codexの動作の裏側や、クラウド連携時のセッションログをウェブインタフェース側で追いかけたい場合もありますよね。特にChatGPTの履歴管理システムと紐づいているアカウントでは、ブラウザ上のデータコントロール画面がとても役に立ちます。
ブラウザでChatGPTのウェブ画面を開き、設定の「データコントロール」にアクセスすると、これまでやり取りした会話の一覧を管理できます。ウェブ画面側で非表示になっていた会話も、ここから一発でアクティブな状態へと戻すことができるので、アプリ側でうまく同期が反映されないときなどは、一度ブラウザを開いてクラウド側のステートを覗いてみるのがおすすめの方法かなと思います。
codexの使い方の基礎と画面の見方
Codexをスムーズに使いこなすためには、プラットフォームごとに用意されている機能特性や、画面のどこに何のデータがあるかを把握しておくのが近道です。普段何気なく使っている画面ですが、ローカル環境とクラウド環境が賢く連携しているのが特徴ですね。
基本の使い方としては、チャット形式で指示を出すだけでなく、自動化のためのスクリプトやプランニング用のコマンドを活用することが挙げられます。画面のサイドバーは現在アクティブな会話を表示する場所であり、不要になったものを「アーカイブ」することで、いつでも見返せる状態を保ったまま画面をすっきりと整理できるようになっています。削除とは違ってデータそのものは残る仕組みなので、初心者の方も安心して整理整頓を試してみてください。
chatgptのアーカイブを戻す設定画面
ChatGPTの有料プラン（PlusやProなど）の資格情報を使ってCodexを動かしている場合、データのライフサイクルはOpenAIのデータ管理制御に準拠しています。ここで重要なのが、「アーカイブ」と「削除」の設定の違いをしっかりと理解しておくことです。よく混同して焦ってしまう部分なので、表にまとめてみました。
| 管理項目 | アーカイブ（Archive） | 削除（Delete） |
|---|---|---|
| データの保持 | クラウド上に完全な形で永続的に残る | システムやサポートから即座にアクセス不可 |
| 復元の可能性 | いつでも無制限に復元可能 | いかなる場合も復元は不可能（30日以内に抹消） |
| データ書き出し | エクスポートデータの中に含まれる | エクスポートデータから完全に排除される |
このように、設定画面からアーカイブを選んだだけであれば、後からいつでもやり直せます。しかし、ゴミ箱マークの削除を押してしまうと、一般的な目安として30日以内にデータが完全に抹消され、二度と元に戻せなくなってしまうので注意してくださいね。
消えた会話やデータを復旧させるコツ
「UIを操作してアーカイブを戻したはずなのに、なぜかサイドバーに出てこない！」というトラブルに直面したときは、データの保存先を直接確認したり、アプリの状態をリセットしたりするのが復旧のコツになります。
データが消えたように見えるときのセルフチェック
- アプリのプロセスが裏側でフリーズしていないか確認し、一度完全に再起動してみる
- サイドバーの表示フィルターが「最近の会話のみ」などになっていないか確認する
- ローカルのデータ格納フォルダに、該当ファイルが残っているかチェックする
多くの場合は、内部の処理が一時的に追いついていないか、表示のキャッシュが残っていることが原因です。タスクマネージャーなどを使ってアプリを完全に終了させてからもう一度立ち上げると、すんなり復活することが多いですよ。
エラーが起きてデータが消失した時の対策
不意のクラッシュや同期エラーによってデータが消失したように見える場合、焦って何度も操作を繰り返すと、かえって状態が悪化してしまうことがあります。まずは一度操作を止めて、安全な手順を踏むことが大切です。
注意：強制終了や初期化を行う前の心構え
手当たり次第に設定ファイルを削除したり、アンインストールを繰り返したりすると、ローカルにだけ残っていた貴重な過去ログが本当に消えてしまうリスクがあります。まずは次で紹介するフォルダの中身をコピーして、バックアップを取ることから始めましょう。
履歴管理ファイルを直接確認する手順
デスクトップアプリ版やCLI版のCodexは、セッション履歴をユーザーマシンのローカルディスク上に保存するアーキテクチャになっています。UIがバグを起こして動かないときは、このファイルを直接覗くのが一番確実な方法かも知れません。
お使いのパソコンのユーザーホームディレクトリ直下にある「.codex」というフォルダの中に、重要なデータが詰まっています。主な格納場所と役割を整理しておきますね。
- ~/.codex/sessions/ ：現在進行中のアクティブなチャット履歴（JSONL形式）が保存されています。
- ~/.codex/archived_sessions/ ：アーカイブ処理をしたスレッドが一時的に退避される格納庫です。
- ~/.codex/history.jsonl ：コマンドラインでの入力やアクションの実行記録履歴です。
アーカイブを戻す操作をしたはずなのに画面が変わらないときは、この「archived_sessions」から「sessions」フォルダへファイルが物理的に移動しているかを確認してみるのが、トラブルシューティングの第一歩になります。
codexのアーカイブを戻す高度な解決策
基本の手順やアプリの再起動を試してもどうしてもデータが戻らない、あるいはシステムエラーのダイアログが出てしまうといった場合は、一歩踏み込んだシステム的なアプローチが必要です。開発ツールやスクリプトを少し活用して、不整合を強制的に解決する方法を見ていきましょう。
- データベースのフラグのズレを手動で強制同期するテクニックを解説します
- 外部ランタイムのバックアップ機能を使った環境復旧コマンドを紹介します
- 複数のAIツールのログを一括で串刺し検索できる便利なビューアーを活用します
- Gitのワークツリーと連携した高度な復元プロンプトの記述例を提案します
sqliteのデータ整合性を修復する方法
「mismatched path」といったエラーが出てアーカイブが戻らない原因の多くは、アプリ内部のSQLiteデータベースと、先ほど紹介したローカルのJSONLファイルとの間でステートの不整合が起きていることにあります。ファイルは戻っているのに、データベース側が「まだアーカイブ状態である」と思い込んでいる状態ですね。
このようなケースでは、Codexアプリを完全に終了した状態で、内部データベース（state.db）に対して直接フラグを書き換えるクエリを実行するか、有志が公開している修復用のBunスクリプトなどを走らせて、archivedフラグを0に戻し、展開パス（rollout_path）を正しいフォルダ名に置換して強制同期させるアプローチが非常に有効です。
ollamaのコマンドで設定を復元する
ローカル環境のAIランタイムとして「Ollama」をシステムに統合している場合、モデルの動作設定や環境プロファイルが破損したことが原因で、スレッドの復元が阻害されるケースがあります。そんなときは、Ollamaが自動的に生成してくれているバックアップから構成を一括復旧させましょう。
ターミナルやコマンドプロンプトを開き、以下のコマンドを実行します。
ollama launch codex-app --restore
このコマンドをトリガーすると、システムは健全だった頃のバックアップフォルダから設定ファイルを自動で読み込み、破損してしまった環境設定を安全に上書き修復してくれます。環境全体の不具合が疑われるときは、ぜひ試してほしいコマンドです。
cc-searchで過去のログを横断検索
過去の会話をアーカイブから戻したいと思う理由の多くは、「あのとき書いたあのコードやアイデアをもう一度見たい」というものですよね。それなら、わざわざUI上でスレッドを元の場所に戻さなくても、ローカルのログファイルを直接横断検索できるツールを使うのが手っ取り早くてスマートです。
開発者コミュニティでよく使われているローカルウェブビューアーに「cc-search」というものがあります。ターミナルで npx @nogataka/cc-search を実行してローカルサーバーを立ち上げると、ブラウザ上でCodexや類似ツールのJSONL履歴をすべてまとめて全文検索できるようになります。特定の関数名やエラーログを入力するだけで、アーカイブフォルダの中身も含めて高速でハイライト表示してくれるので、ナレッジのサルベージがとても快適になりますよ。
gitワークツリーが消えた場合の対処法
自動化のプロセスや個別タスクのためにGitワークツリーを組み込んでいる場合、スレッドをアーカイブした瞬間に物理ディレクトリがディスクから自動クリーンアップされてしまう仕様があります。そのため、後からアーカイブを戻しても、インデックスから外れたファイル構造が復元されず、中身が不可視になってしまう現象が起こり得ます。
この問題を突破するには、Codexのエージェントに対して直接、バックアップされたJSONL内のメタデータから構造を読み取らせるプロンプトを投げるのが賢い方法です。「archived_sessionsの中から該当タスクのJSONLファイルを探し、記述されているGitワークツリーのメタデータを抽出して構造を再構成してください」と具体的に指示を出すことで、手動での再紐付けとハイドレーションを試みることができます。
codexのアーカイブを戻す手順のまとめ
ここまで、OpenAI Codexにおけるデータの仕組みから、具体的な復旧手順までを幅広く紹介してきました。最後に、今回お届けした内容を振り返ってまとめておきますね。
今回のポイントのおさらい
- まずはアプリの設定（Settings）内の「Archived Threads」から戻せるか確認する
- 削除ボタンとは違い、アーカイブであればデータはローカルやクラウドに無期限で残っている
- どうしても画面に反映されない場合は、アプリの強制再起動やローカルフォルダの確認を行う
- エラーが出る場合は、SQLiteの同期やOllamaのリストアコマンド、cc-searchでの検索を視野に入れる
ちょっとした不具合で過去のやり取りが見えなくなると焦ってしまいますが、構造を理解していれば意外とシンプルに対処できることが分かったかなと思います。大切な開発資産を守るためにも、今回ご紹介したcodexのアーカイブを戻す手順やコツを、ぜひ日々の作業スペースの整理整頓に役立ててみてくださいね。
