Codexの相談用ログを整える

不具合を相談するとき、ログがあると「いつ、何をして、どこで止まったか」を説明しやすくなります。ただし、ログや会話にはファイル名、依頼内容、接続先、認証に関する値が含まれる場合があります。

ここでは、元の記録を保管し、共有用のコピーを作る手順を紹介します。まずエラーを伝える基本で状況を整理してから、必要な記録だけを加えます。

相談に必要な範囲を決める

最初に、利用した製品、OS、版、作業時刻、行った操作、期待した結果をメモします。CLIとデスクトップアプリは別の版を含む場合があるため、「Codexの最新版」だけで済ませないようにします。

各段階で確認してから、次の操作へ進みます。

1. 1必要な範囲を切り出す時刻・環境・エラー前後を揃えます。
2. 2共有用のコピーを作る秘密の値を伏せ、同じ箇所は同じ印にします。
3. 3送る内容を確認添付・会話・本文の範囲を確認してから共有します。

具体的な依頼と、結果の確かめ方は本文にあります。

大量の記録を先に送るより、問題の範囲を決めてから共有用の内容を見直します。ログを整理することと、誰かへ送信することは別の工程です。

元を残してコピーを作る

公式資料では、セッション記録の標準的な場所として ~/.codex/sessions、アーカイブ済み記録として ~/.codex/archived_sessions が案内されています。CODEX_HOME を変更している環境では場所も変わります。アプリのログ位置はOSごとの案内を確認し、macOSのパスをWindowsへそのまま当てはめません。

ログが見つからないだけで、記録が一切ないとは判断しません。むやみにフォルダー全体を圧縮する前に、該当する時刻・タスクの記録を探します。

指定したログから、このエラーに関係する範囲だけを整理する案を示してください。
元ファイルは変更せず、外部へ送信しません。
時刻、実行した操作、エラー前後の順序を残します。
認証の値、個人情報、非公開の本文を含む箇所は、引用せず伏せる候補として報告してください。
まだ安全に共有できると断定せず、私が確認する項目も示してください。

この依頼自体でもAIが対象の記録を読む点に注意します。組織のルールで渡せない情報は、AIへ読ませる前に対象から外してください。

同じ対象には同じ伏せ字を使う

次は実際のログではなく、共有形式を考えるための架空例です。

環境：Windows、Codex CLI、版は確認した値を記入
時刻：2026-09-12 15:00 JST
操作：C:\Users\<USER_A>\<PROJECT_A>\input.txt を読み取り
結果：Permission denied
期待：ファイルの内容を確認できること
未確認：どの権限条件で拒否されたか

同じフォルダーを別の箇所でも <PROJECT_A> と表せば、関係を追いやすくなります。すべてを「非公開」にすると、別のファイルなのか同じファイルなのか分からなくなります。

キーやトークン、Cookie、接続文字列は、一部分だけなら大丈夫と決めず、値を含む範囲を確認します。画像で隠す場合も、単に見えにくくしただけで元の情報が消えたと扱わないようにします。

送信前に本文と添付を確認する

共有用コピーを元と比べ、エラーの種類・時刻・操作順が残っているか確認してください。
秘密の値や私的な名前を見落とす可能性があるため、自動点検だけで共有可能とは判定しません。
本文、添付ファイル、画面画像、含める会話履歴を一覧にしてください。
共有や投稿は行わず、確認用の内容を示してください。

フィードバック機能では、既存の会話を含めて共有する選択肢がある場合があります。ログの一部を伏せても、別の添付や会話に元の値が残っていないか、実際の送信画面で範囲を確かめます。

伏せすぎた場合は元ログから共有用コピーを作り直せます。すでに公開した内容は、ローカルのコピーを消すだけでは取り消せません。元ログと共有先を混同しないことが大切です。

この記事は公式の共有前確認と、架空例の整理方法を照合したものです。実ユーザーのログ、共有操作、自動検出の精度を試した結果ではありません。