Codexタスク削除の方法と履歴・変更ファイルの確認手順

Codexタスク削除で消したい対象を決める

「タスクを削除したい」という依頼には、終わった作業を一覧から片付けたい場合と、途中の処理を止めたい場合、失敗した変更を取り消したい場合が含まれます。この三つを同じ操作で済ませようとすると、会話を消したのにコードが残った、履歴を残すつもりだったのに読み返せなくなった、といった食い違いが起こります。最初に画面の見た目ではなく、残したいものと不要なものを言葉にしてください。たとえば「回答は残し、一覧だけ整理したい」なら、完全削除を選ぶ必要はありません。

OpenAIのProjects and chatsでは、CLIの会話には記録された作業ディレクトリと会話履歴があり、ファイルは現在の作業ツリーから読み取ると説明されています。この構造からも、会話の管理とファイルの状態を別に見る必要があります。履歴の削除コマンドを、ファイルを以前の内容へ戻す手段として使わないでください。

更新時期には利用画面と版を確かめる

2026年11月1日を基準に確認したOpenAI公式の更新履歴には、10月29日のCodex CLI 0.166.0が掲載されています。記事の手順を読むときは、公開日だけでなく、説明がCLI向けなのか、デスクトップアプリ向けなのかを確認します。名称が同じCodexでも、一覧の作りや利用できる操作が同じとは限りません。更新履歴に新しい版が載っていることだけを根拠に、削除操作の対象や復元の条件が変わったと判断しないようにします。

本記事で具体的なコマンドを示すのは、CLIに保存された対話セッションです。クラウド上の作業やアプリのプロジェクト全体を消す方法としては扱いません。OpenAIのDeveloper commandsは、codex deleteを保存済み対話セッションの完全削除として案内しています。手元で同じ操作を使う前に、現在の版に対応する説明と対象を照合してください。

CLI・アプリ・クラウドを取り違えない

削除したい作業を、どこから開始したのか振り返ります。端末から始めた対話なのか、アプリで開いた会話なのか、クラウド上にある作業なのかを確認してください。CLIの公式資料にはクラウドの作業を扱う別の項目もありますが、それだけでローカルの保存済みセッションと同じ対象になるわけではありません。画面上の名前が似ていても、保存先や作業場所が同じと推測しないことが重要です。

同じ名前より対象のIDを照合する

「不具合修正」「テスト確認」のような名前は、複数の作業で重なります。公式資料では削除対象にセッションIDまたは名前を指定でき、IDが名前より優先されると説明されています。似た名前がある場合は、対象の会話内容や作業場所とIDを合わせて確認します。名前が一致したという理由だけで削除対象を決めず、終了したい作業そのものを特定してください。

削除前に実行状態と変更ファイルを確認する

会話の整理に進む前に、対象の作業が終了しているかを見ます。回答が表示されていても、別の端末や関連する処理の状況を確認できていなければ、停止済みとは断定できません。途中で終える必要がある場合は、使っている画面で実行状態と停止操作の説明を確認し、停止した結果を確かめます。履歴を消す操作で処理の停止まで保証されると考えず、先に動いている作業の状態を把握しておくと、後から何が起きたかを追いやすくなります。

続いて、対象フォルダーの変更を調べます。複数の作業が同じフォルダーへ触れている場合、現在の差分には他の依頼や人の編集も含まれる可能性があります。ファイル名だけで判断せず、変更内容と、その変更が必要になった理由を確認してください。不要なタスクを整理するために、関係のない編集まで一緒に消す必要はありません。変更を残すか戻すか決められない場合は、会話も保管して判断材料を残す方が進めやすくなります。

Gitで管理されているフォルダーなら、読み取り用の確認として次のコマンドが使えます。これらは記事内の確認例であり、Codexへ新たな作業を依頼する指示ではありません。

git status --short
git diff --stat
git diff

この確認では、追跡済みファイルの差分と、まだ管理対象になっていないファイルを区別します。git diffだけでは新規ファイルの内容まで分からないため、状態一覧に新しいファイルが出ていたら内容も個別に見ます。Git管理外のフォルダーでは、手元のバックアップや編集前の資料と比較してください。会話の削除とは別の確認として実施することが要点です。

保存済みタスクの会話を削除する手順

ここからはCLIの保存済み対話セッションを対象にします。公式資料が示すcodex deleteは、会話記録を完全に消したい場合に使う操作です。一覧を短くするだけなら、次節の保管も候補になります。必要な説明、検証結果、未解決事項を読み返せるか確認してから進めてください。複数の対象をまとめて片付けるより、最初は一件ずつ、対象の特定と結果の確認を繰り返す方が取り違えに気づきやすくなります。次の手順は、対象の作業が終了したことを確認してから行います。

Step 1: 必要な成果と判断理由を確認する

対象の会話を読み、変更理由、確認済みの項目、残った問題を把握します。成果物が作業フォルダーにあるなら、保存先と現在の内容も確認してください。後で参照する必要がある情報は、チームで管理している文書など、継続して使う場所へ必要な範囲だけ残します。会話を残すこととコードを残すことを同一視せず、どちらが次の作業に必要なのかを判断します。

Step 2: 特定したセッションを指定して削除する

対象のIDまたは名前を照合したうえで、端末からcodex deleteに対象を指定します。以下の<SESSION>は説明用の表記です。実際には、確認したセッションIDまたは名前へ置き換えてください。名前に空白がある場合は端末で一つの引数として扱えるように引用符で囲みます。画面に確認が出たら、対象を読み直してから進めます。

codex delete <SESSION>

公式資料には確認を省く指定もありますが、不要な作業を整理する通常の場面では、対象を確かめる機会を残す方が適しています。本記事では省略指定を使いません。名前が似た別の作業や、まだ必要な会話を選んでいたと分かったら、その場で中止して対象の確認へ戻ります。

Step 3: 履歴の整理結果とファイルを別々に確認する

削除後は、対象の保存済みセッションが一覧から除かれたことを確認します。続いて、作業フォルダーの状態を見て、残すと決めたファイルや編集が保たれているかを調べます。これで確認できるのは、会話の整理結果と手元のファイルの状態です。外部へ反映した変更まで取り消されたとは判断しません。未解決の不具合がある場合は、残した記録と現在のファイルを基に、次の依頼を別途組み立てます。

続ける可能性があるタスクは保管を選ぶ

削除するか迷う場合は、迷っている理由を確かめます。再調査の可能性がある、判断理由を別の担当が読む、修正結果を後日確認する、といった事情があるなら、会話を完全に消すより保管が向いています。OpenAIのDeveloper commandsの保管・復元の説明では、会話記録を削除せずにセッション選択画面を整理する目的で、保管と復元が案内されています。

1. 対象のセッションIDまたは名前を確認し、codex archive <SESSION>で保管します。
2. 続きを行う必要が出たら、codex unarchive <SESSION>で保管状態を解除します。
3. 復元した対象を確認し、codex resumeの選択画面から続ける会話を選びます。

保管は、不要なファイルを消す機能ではありません。作業フォルダーが大きくなったという相談なら、会話一覧の整理と保存容量の調査を分けます。また、履歴を残せば次の作業が必ず同じ状態から始まるとも限りません。会話を保管している間にファイルが変わることもあるため、再開時には現在のコードと残した判断理由を照合します。

削除できないときは対象と操作範囲を見直す

コマンドが見つからない、指定した対象が見つからない、想定した一覧から消えない場合は、同じ操作を繰り返す前に利用場所を確認します。別の端末環境や別の保存先を見ていないか、作業がCLIの保存済み対話に該当するか、名前ではなくIDを確認できるかを順に調べてください。対象の保存場所を推測してフォルダーごと消す方法では、関係する別の会話や設定まで巻き込むおそれがあります。

確認結果を残す際は、使った入口、CLIの版、対象の種類、試した操作、表示されたメッセージを整理します。相談先に会話の全文やプロジェクト全体を渡す必要はなく、問題の判断に必要な範囲へ絞ります。目的が一覧の整理なら保管、会話記録の消去なら対象を特定した削除、コードの修正なら現在の差分の確認へ進みます。この判断を先に揃えることで、作業を片付けながら必要な成果と記録を残せます。