Codexにエラーを伝える：状況・全文・期待する結果

「動かない」と伝えたあと、何を説明すればよいか迷うことがあります。Codexに調べてもらうときは、やりたかったこと・実際にした操作・表示された内容を揃えると、確認すべき場所を絞れます。

このページは、ファイルの読み取りや保存で困った初心者向けです。エラーの言葉だけで原因を断定せず、まず小さく確認する依頼文を用意します。

エラーが出たときの状態を残す

エラー表示の前後を読み、実行した操作と時刻をメモします。何度もやり直す前に、ファイルができているか、途中まで変更されていないかも確認してください。失敗と表示されても、すべての操作が未実行とは限りません。

スクリーンショットだけでなく、コピーできるエラーは文字でも残すと確認しやすくなります。パスに含まれる自分の名前、メールアドレス、APIキーなどは伏せます。伏せた場所が分かるように [ユーザー名] などへ置き換え、文章全体の構造は残してください。

操作の順番と、途中で確かめることを図で確認します。

1. 1状態を記録操作と表示、途中の成果物を残す。
2. 2秘密を伏せる名前やキーを置き換え、エラーの構造は残す。
3. 3一つだけ確認変更を伴わない確認から原因を絞る。
4. 4結果を伝える分かった事実と、まだ推測のことを分ける。

具体的な依頼文と、うまく進まない場合の確認先は本文で説明します。

そのまま使える相談のひな形

やりたいこと：練習用のメモを読んで要約する。
使っているもの：Windows／Codex（デスクトップかCLIかを書く）。
操作：練習フォルダーを開き、memo.txt の読み取りを頼んだ。
期待した結果：メモの内容が要約される。
実際の結果：以下のエラーが表示された。
エラー全文：ここへ秘密情報を除いた文字列を貼る。
確認済み：memo.txt はエクスプローラーで見える。
まず原因の候補と、変更を伴わない確認を一つ提案してください。
根拠を確認できないものは推測と分けてください。

製品名やOSは自分の環境へ書き換えます。バージョンを確認できる場合は添えますが、分からなければ「未確認」で構いません。見ていない番号を埋める必要はありません。

エラーの種類で最初の確認を変える

次の表は切り分けの例です。表示だけで根本原因が確定するわけではありません。

権限の拒否は権限と作業範囲、利用上限は利用状況の確認へ進めます。再インストールや設定の削除を最初の一手にする必要はありません。

一つ確認してから次へ進む

「ファイル名が違うかもしれない」と分かったら、まず実際の名前を一覧で確認します。直す条件を一度に増やすと、何が効いたのか分からなくなります。確認後は、行った操作と結果を短く伝えます。

確認した結果、ファイル名は memo.txt.txt でした。
まだ名前は変えていません。
この結果から分かることと、次の一手を教えてください。

これは説明用の例で、あなたのエラー原因を示したものではありません。

解決したら再利用できる記録にする

作業が進んだら、症状、原因として確認できたこと、直した操作、再確認の結果を4行程度で残します。「たぶん通信が悪かった」など未確定の部分は、確定した事実と分けます。

当サイトの検証では、CLIがファイル読み取りの前にポリシーで拒否された例と、応答時間切れの例がありました。どちらも同じ原因とは判定していません。制限を外して成功扱いにするのではなく、失敗した段階を記録しています。小さく試す素材は練習ページに用意しています。