Codex 404エラーの原因と直し方をWindowsで確認する手順

Codex 404エラーは何を意味するか

HTTPの404は、要求された対象を見つけられないという意味です。ただしCodexを使うときに見えている404は、ブラウザで存在しないページを開いたときのような単純なURL間違いとは限りません。CodexアプリやCLIは、画面で選んだモデル、会話を送る経路、長い作業の途中で使う補助処理など、複数の対象を組み合わせて要求します。そのどれが見つからないのかをエラー文から切り分ける必要があります。

たとえば Model not found が含まれるなら、指定したモデル名がその利用経路で使えない、モデルの公開範囲がアカウントや地域にまだ届いていない、設定に古い名前が残っている、といった可能性があります。一方、/compact のように特定の処理経路が示されるなら、通常の応答ではなく文脈整理の処理に失敗している可能性が高まります。同じ404でも、見るべき設定と待つべき状況が変わるのです。

大切なのは、404を見た瞬間に「自分のWindowsが壊れた」と決めつけないことです。Windows固有のパスやアプリ版の違いが影響する場合はありますが、サーバー側のモデル公開や処理経路の変更でも発生します。まずは対象、入口、版、発生操作の四つを一つずつ固定し、何を変えた後に結果が変わったのかを残します。これだけで、原因の候補を広げすぎずに済みます。

Model not found が示すもの

Model not found は、送信したモデル識別子を処理先が解決できなかったときに表示されます。設定ファイルや画面で選んだ名前が、現在のCodexの入口で利用できる名前と一致しているかを確認します。OpenAIの モデル一覧 には、一般向けモデル、Codex向けモデル、提供終了のモデルが分けて掲載されています。名前が似ているから使えるとは限らない点に注意が必要です。

特定機能の処理先が見つからない場合

モデル名ではなく /compact などの処理経路がエラーに出る場合、通常の入力そのものではなく、会話の文脈を整理する機能やリモート側の補助処理が問題になっている可能性があります。この場合はモデル名だけを変えても改善しないことがあります。エラー文の対象を読み、通常の短い入力と長い会話の整理処理を分けて考えます。

一時的な公開差や処理側の問題

同じ設定でも時間や地域、アプリとCLIの組み合わせで結果が変わるなら、配布や公開の差を疑います。利用者が確認できるのは、版、入口、モデル名、発生時刻、再現条件までです。内部の配布状態を推測して断定せず、同じ条件で再試行した結果と公式Issueの更新を待つほうが、不要な設定変更を防げます。

2026年8月に確認したい公式情報

2026年8月25日時点で、まず確認しやすい公式情報は二つあります。一つは OpenAI/codexの0.149.1リリースページ です。ページ上で0.149.1はLatestと表示され、2026年8月24日に公開されています。リリース本文には0.149.0からの変更一覧へのリンクがありますが、0.149.1がすべての404を直したという説明はありません。Latestであることと、自分のエラーが解消することを混同しないようにします。

もう一つは、Windowsで起きた現象を具体的に確認できる Issue #38706 です。Issueでは、Codexアプリのバージョン26.519.2081.0を使うWindows環境で、文脈が圧縮された後にリモート処理が404になった状況が記載されています。新しいスレッドでも数回の入力後に同じエラーが出たという条件が書かれており、単なる入力ミスだけでは説明しにくい例です。

ただし、このIssueは公開された利用者報告であり、すべての環境に共通する仕様説明ではありません。Issueの状態がClosedでも、本文に一般利用者向けの修正方法や修正版が明記されているとは限りません。報告を「自分の症状と似た条件を探す資料」として読み、現在の版と公式リリースの説明を併せて判断します。公式情報の確度をそろえることが、404対策では重要です。

0.149.1を基準に版を確認する

Codex CLI 0.149.1を使っているか調べるときは、画面の表示だけでなく、実際に起動しているCLIの版を確認します。アプリに同梱されたCLIと、別に導入したCLIがある場合、同じ codex という名前でも実体が違うことがあります。リリースページのタグと手元の版を照合し、先行版の表示を安定版の表示と混ぜないようにします。

Issueを解決済みの証拠にしない

GitHub IssueのClosedは、重複、再現条件の不足、別の追跡先への移動などでも起こります。閉じているから原因が消えた、あるいは最新版に必ず修正が含まれた、と読むことはできません。本文、コメント、関連するリリースの変更説明まで読んで、修正内容が明示されているかを確認します。明示がなければ、条件付きの報告として扱います。

404と401・403・429を切り分ける

エラー番号だけを見ていると、対処を誤りやすくなります。401は認証状態、403は権限や利用許可、429は短時間の利用集中や上限に関係することが多く、404とは確認箇所が異なります。もちろんサービス側の応答は状況によって変わるため、番号だけで断定はできませんが、最初の分岐としては役立ちます。

404で Model not found が出ているのに、アカウントの再サインインだけを繰り返しても、モデル名の問題は解決しません。反対に、401が出ているのにモデルを次々と変更しても、認証の問題は残ります。エラーの番号、本文、発生した操作を一つの記録にまとめ、複数の原因を一度に直そうとしないことが近道です。

Codexの利用経路には、ChatGPTの画面、デスクトップアプリ、IDE拡張、CLIなどがあります。OpenAIの Codex製品ページ でも複数の入口が案内されているため、同じアカウントでも入口によって表示や利用できるモデルが異なる可能性があります。アプリで出た404をCLIの設定だけで直そうとせず、どの入口のエラーなのかを先に特定してください。

401・403なら認証と利用許可を見る

401や403が出ている場合は、ログイン状態、契約しているプラン、組織やプロジェクトの利用許可を確認します。404のように見える本文が併記される場合もあるため、番号だけでなくエラー文全体を保存します。アカウントを切り替える前に、現在の入口と対象プロジェクトを記録しておけば、別の環境との比較がしやすくなります。

429なら回数と時間を見る

429は、同じ短い時間に多くの要求を送った場合や、利用上限に達した場合に表示されます。これはモデルが存在しない404とは別の問題です。しばらく時間を置いた後も同じか、別の小さな入力で再現するかを確認します。上限の表示がある場合は、公式の料金や利用状況の案内と照合して、設定を不用意に変えないようにします。

番号のない接続失敗と混同しない

画面が固まる、応答が途中で切れる、接続がタイムアウトする、といった現象は、404が表示された場合と同じではありません。ログに404が残っているならその行を保存し、表示だけが止まった場合は通信状態やアプリの状態を別に調べます。複数の症状を一つの「Codexが動かない」にまとめると、公式資料との照合が難しくなります。

Windowsで安全に確認する順番

Windowsで404を調べるときは、いきなりアプリの削除や設定の初期化を行わず、変更の少ない確認から始めます。目的は、その場で必ず直すことではなく、モデル、入口、処理、版のどこに問題があるかを狭めることです。次の順番で一項目ずつ確認すると、結果が変わった理由を追いやすくなります。

調査の途中でログイン状態、モデル名、アプリ版を同時に変えると、結果が変わっても原因が分からなくなります。最初は記録を取るだけにして、変更を伴わない確認を優先します。同じ条件を再現できる小さな確認を一回ずつ行い、成功と失敗の差を残すことが、公式資料や公開Issueと照合する際にも役立ちます。

Step 1: 起動している入口と版を記録する

まず、Codexアプリ、CLI、IDE拡張のどこで404が出たのかを記録します。CLIなら codex --version で版を表示し、アプリなら「About」などの画面に出る版を控えます。アプリ内のターミナルと単体CLIを同じものと決めつけず、同じ操作をどの入口で行ったかを一行で残してください。

Step 2: エラー全文と時刻を保存する

「404」とだけ写すのではなく、Model not found、Unknown error、/compact など後半の文字列を含めて保存します。URLが表示される場合は、個人情報や不要な識別子を公開しない範囲で対象のパスを残します。発生時刻は日本時間で記録し、同じ操作をもう一度したときの時刻も分けて書きます。

Step 3: 選択中のモデル名を確認する

画面や設定で選ばれているモデル名を確認し、手入力した別名や古い名前が残っていないかを調べます。OpenAIの モデル資料 に掲載された名称と照合し、似た名前を推測して置き換えないことが大切です。名前を変更する場合も、一度に複数の設定を変えず、変更前の値を残してから小さく試します。

Step 4: 短い確認と長い会話を分ける

短い新規会話では成功し、長い会話の続きだけで404が出るなら、文脈整理やセッションの状態が関係している可能性があります。逆に新規会話の最初から Model not found が出るなら、モデル名や利用経路を優先して確認します。長い作業を続けたまま設定を何度も変えず、読み取り中心の短い確認で差を見ます。

Step 5: アプリとCLIを混ぜずに比較する

同じWindows端末にアプリ版と単体CLIがある場合、片方だけで404が出るかを比べます。片方が成功しても、もう片方の設定が正しいと証明されたわけではありません。版、モデル、入口を同じ記録欄に並べ、比較できる条件をそろえます。作業対象のファイルを変更する確認は後回しにし、まず表示と応答だけを見ます。

Step 6: 公式の版情報とIssueを照合する

最後に、手元の版を 0.149.1のリリースページ と照合し、エラー本文に近いIssueを探します。見つけたIssueのOS、アプリ版、モデル、処理内容が自分の条件と一致するかを確認してください。似た文字列があるだけでは同じ原因とは限らないため、一致した条件と一致しなかった条件を分けて記録します。

モデル名の問題を直すときの考え方

404の中でも Model not found は、利用者が設定を変更して改善する可能性がある種類です。ただし、表示されるモデル名と内部で解決される名前が必ず同じとは限らず、アプリ、CLI、API互換の接続先でも扱いが変わります。手元のモデル名を推測で書き換えるより、公式資料に掲載された名前、現在の版、利用している入口をそろえて判断するほうが安全です。

OpenAIの codex-mini-latestの資料 は、Codex CLI向けのモデルとしての説明、対応する入力、コンテキスト長などを掲載しています。ここで確認できる公開情報と、アプリ画面に表示される選択肢を分けて読みます。公開資料にない内部名を自分で組み立てたり、古い記事の名前をそのまま使ったりすると、404の原因を増やすおそれがあります。

モデルを変更して試すときは、最初にエラー全文と変更前の名前を保存します。次に、公式画面や公式資料から選べる候補を一つだけ選び、短い確認を行います。成功しても、それが元のモデルの不具合を証明するわけではありません。利用していたモデルが提供終了したのか、地域やプランの対象外なのか、単に設定の記述が古いのかは、リリース情報と利用条件を合わせて確認する必要があります。

公開名と内部名を混同しない

エラー文に長い識別子が出ても、それを次の設定値としてコピーすればよいとは限りません。内部の処理名や実験用の名前は、画面から選ぶ公開名と役割が異なる場合があります。404の調査では、表示された名前を証拠として保存しつつ、設定欄には公式に案内されている名前だけを使う、という二つの扱いを分けます。

モデル変更は一回ずつ行う

モデル、アプリ版、接続先、アカウントを同時に変えると、直ったとしても何が効いたのか分からなくなります。まず一つの条件を固定し、変更は一項目だけにします。元に戻す必要が出たときに比較できるよう、変更日時と変更前後の値を残してください。調査用の小さな会話で結果を見てから、本来の作業へ戻ります。

接続先や機能側の404を調べる

モデル名が正しく、短い新規会話でも特定の機能だけが失敗するなら、接続先や処理機能側を調べます。特にアプリの文脈圧縮、遠隔の作業、互換接続先などは、通常の入力と別の経路を使うことがあります。404のURLに機能名が含まれている場合は、その機能が利用中の版と入口で提供されているかを公式資料で確認します。

接続先を独自に変更している場合は、設定したホスト名、APIの経路、利用しているモデル名を一つずつ確認します。OpenAI公式の経路を使う場合と、互換性のある別の提供元を経由する場合では、対応するモデルと処理機能が同じとは限りません。404を見て接続先を次々と変えるのではなく、元の設定を保存してから一つの経路で再現します。

/compact が含まれる場合

Issue #38706のように、エラーのURLへ /compact が含まれているなら、通常の応答ではなく文脈の圧縮処理が失敗した可能性を考えます。長い会話の状態を引き継ぐ場面で発生したのか、新しい会話でも数回の入力後に起きたのかを分けて記録します。モデル変更だけで直そうとせず、公式Issueと現在のアプリ版の組み合わせを確認してください。

API互換の接続先を使っている場合

互換性のある接続先では、同じモデル名が表示されても、Responses APIの経路や補助機能まで対応しているとは限りません。通常の短い応答は成功するのに、文脈整理、画像入力、ツール利用など特定の機能だけ404になるなら、機能ごとの対応範囲を確認します。接続先の資料にない機能を前提にせず、公式の対応表と実際のエラー本文を比べます。

公開差が疑われる場合

過去の公式Issueには、ローカルのモデル一覧には名前が出ているのに、実際のCodex応答で404になる報告があります。たとえば Issue #26892 では、gpt-5.5が表示上は利用可能でも、実際の要求で404になり、別のモデルは動いたという条件が記録されています。これは当時の個別報告であり、2026年8月25日の全環境へそのまま適用できる説明ではありませんが、表示と実際の処理結果を分けて見る参考になります。

直らないときに残す情報

同じ404が続く場合、再試行の回数を増やすより、他の人が条件を再現できる記録を作るほうが役立ちます。公式Issueを読むと、OS、アプリ版、CLI版、モデル、契約プラン、エラー本文、発生操作がそろっている報告ほど状況を比較しやすくなっています。個人情報やプロジェクトの中身をそのまま貼る必要はありません。必要な部分だけを伏せて、技術的な条件を残します。

最初に、404が発生した日時と日本時間の時刻を書きます。次にWindowsの版、Codexアプリの版、CLIの版、アプリかCLIか、選択中のモデル名を記録します。その上で、新しい会話か既存会話か、入力を送った直後か、文脈の圧縮後か、特定の機能を使ったときかを説明します。同じ手順を短い確認で試した結果も添えると、長い会話の状態が関係するかを比較できます。

ログを共有する場合は、URLに含まれる識別子、作業フォルダー名、メールアドレス、プロジェクトの内容を確認してから伏せます。エラーの中心となる 404 Not Found、Model not found、機能名、OS、版番号まで消してしまうと、似たIssueとの比較ができません。必要な文字列を残しながら、公開してよい範囲を切り分けることが大切です。

公式Issueと自分の症状を比べる

Issueを見つけたら、タイトルだけで同じだと決めず、本文のOS、版、モデル、発生操作を確認します。条件の一部だけが一致する場合は「関連する可能性がある」と書き、原因が確定したように扱いません。Issueへの報告やコメントを行う場合も、既存の報告にない情報を短く追加すると、状況が伝わりやすくなります。

変更前の状態を保つ

設定を直す前に、現在の値を別の場所へ控えます。アプリの削除、設定ファイルの初期化、モデル名の変更を先に行うと、原因を調べるための手がかりが消えることがあります。まず記録を残し、変更は一つずつ試して、結果が変わらなければ元の状態へ戻せるようにします。

404でよくある判断ミス

Codexの404は、エラーを見た直後の行動で調査が難しくなることがあります。特に、版・モデル・入口を同時に変える、公開Issueの一文を全環境に当てはめる、アプリとCLIの結果を同じものとして扱う、という三つの判断は避けたいところです。直すことを急ぐほど、変更前の状態を残す意識が重要になります。

404は原因が複数あるため、最初の一手で環境を変えすぎないことが大切です。変更を一つに絞れば、問題がモデル、機能、接続、版のどこにあるかを後から説明できます。

いきなり再インストールする

再インストールで版が変わると一時的に改善することはありますが、モデルの公開差や処理先の問題は残る可能性があります。404が出た時刻、版、モデル、エラー全文を保存してから、公式リリースに修正内容があるかを確認します。導入状態が壊れている証拠がない段階では、再インストールを最初の手段にしないほうが原因を追いやすくなります。

最新版なら必ず直ると考える

0.149.1がLatestでも、リリースページに記載されていない個別のサーバー側問題まで解消したとは限りません。最新版を使うことは比較の基準になりますが、問題の発生条件を消す保証ではありません。更新後も同じ手順で再現するか、エラー本文が変わったかを記録し、修正済みという判断には公式の記載を求めます。

アプリとCLIを同じものとして扱う

同じ端末、同じアカウントでも、アプリとCLIは版や設定、処理経路が異なることがあります。アプリで404、CLIで成功という結果は、Codex全体が正常だという意味ではなく、入口の差を示す材料です。結果を比較するときは、入口、版、モデル、会話の状態を同じ記録欄に並べ、違う条件を見落とさないようにします。

まとめ

Codexの404エラーは、モデル名が解決できない場合、特定の処理経路が見つからない場合、一時的な公開差やサーバー側の問題がある場合に分けて考えます。2026年8月15日の Issue #38706 は、WindowsのCodexアプリで文脈の圧縮後にリモート処理が404になる具体例を示していますが、Issueの状態だけで全環境の修正を断定する資料ではありません。

2026年8月25日時点の基準版としては、8月24日にLatestで公開された Codex CLI 0.149.1 を確認し、手元の入口と版を分けて記録します。次にエラー全文、モデル名、発生時刻、会話の状態を残し、短い確認で再現性を調べます。モデルを変える場合も一項目ずつにし、公式の モデル資料 と公開Issueを照合してください。

404を見てすぐ設定を初期化したり、複数の入口を混ぜて再試行したりすると、原因の手がかりが薄くなります。版番号、入口、モデル、処理、時刻を固定して比べれば、利用者側で直せる問題か、公式の更新や処理側の案内を待つ問題かを判断しやすくなります。最初に残す記録が、最短の切り分けにつながります。