Codexを使っていて、「エラーが出て動かない」「急に処理が進まなくなった」「昨日まで使えていたのに起動しない」と困ることがあります。
この場合、すぐに再インストールするのではなく、エラーが起きている場所を一つずつ確認することが大切です。
Codexが動かない主な原因としては、次の9つが考えられます。
| 原因 | 確認すること |
|---|---|
| 1. 一時的に処理が止まっている | Codexを再起動する |
| 2. ログイン・認証に問題がある | ChatGPTアカウントを確認する |
| 3. 利用上限に達している | 使用状況や/statusを確認する |
| 4. 古いモデル設定が残っている | 保存済みモデルを確認する |
| 5. config.tomlに古い設定がある | 設定ファイルを確認する |
| 6. 権限やサンドボックス設定が合っていない | 権限設定を確認する |
| 7. Windows・WSL環境に問題がある | 使用環境を確認する |
| 8. 通信環境でCodexの接続が遮断されている | VPN・プロキシ・WebSocketを確認する |
| 9. OpenAI側で障害が発生している | OpenAI Statusを確認する |
私もWindowsのデスクトップPCと3枚のモニターでCodexを使っていますが、エラーが出たときは設定を一度に変えず、原因を一つずつ切り分けるようにしています。
ここから、9つの原因と対処法を順番に確認していきます。
Codexがエラーで動かない9つの原因と対処法
Codexが動かない原因は一つとは限りません。まずは自分の症状に近い項目から確認してください。
原因1：一時的に処理が止まっている
まず試したいのが、Codexの再起動です。
Codexをいったん終了し、もう一度起動して同じ操作を試します。PowerShellやターミナルからCodex CLIを使っている場合も、一度終了して新しく開き直します。
この段階では、設定ファイルの削除や再インストールまで行う必要はありません。
WindowsでCodex CLIを利用している場合は、次のコマンドも確認に使えます。
codex doctorOpenAIでは、Codex Doctorを起動・接続・パフォーマンスに関する問題を診断するツールとして案内しています。
原因2：ログインや認証に問題がある
Codexを開けてもサインイン時に止まる場合は、使用しているChatGPTアカウントと認証状態を確認します。
Codexは、デスクトップアプリ、CLI、IDE拡張機能、Web版など利用方法が複数あります。
一度Codexを終了し、利用しているCodexクライアントに表示される案内に従ってChatGPTアカウントでサインインし直します。
複数のChatGPTアカウントを使っている場合は、普段Codexを利用しているアカウントかどうかも確認しておくとよいでしょう。
原因3：Codexの利用上限に達している
Codexそのものに不具合がなくても、利用上限に達すると新しい処理を続けられない場合があります。
OpenAIによると、Codexの利用上限はプランによって異なります。
Codex CLIを使用している場合は、次のコマンドで現在の状態を確認できます。
/statusまた、ChatGPTの設定や利用状況画面から、利用枠やリセット時刻が表示されていないか確認します。
利用上限を示す表示が出ている場合は、パソコンの設定を変更しても解決しません。まず利用状況を確認してください。
原因4：古いモデル設定が残っている
以前からCodexを使っている場合は、保存済みのモデル設定にも注意が必要です。
OpenAIは、ChatGPTアカウントでサインインして利用するCodexについて、2026年8月31日にGPT-5.4とGPT-5.4 miniの提供を終了しています。
そのため、以前のモデルをワークスペースのデフォルトや保存済み設定などに指定している場合は、現在利用できるモデルへ変更する必要があります。
アップデート後やモデル変更後から動かなくなった場合は、古いモデル名が設定に残っていないか確認してください。
原因5：config.tomlに古い設定が残っている
Codexの設定ファイルconfig.tomlに、現在サポートされていない設定が残っているとエラーにつながる場合があります。
特に注意したいのが、以前使用されていた次の設定です。
approval_policy = "untrusted"現在のCodexでは、この指定はサポートされていません。
該当するエラーが表示された場合は、Windowsでは次の設定ファイルを確認します。
%USERPROFILE%\.codex\config.toml設定を変更する場合は、先に元の内容をコピーして残しておくと戻しやすくなります。
原因6：権限やサンドボックス設定が合っていない
Codexは起動するものの、コマンド実行やファイル操作のところで止まる場合は、権限やサンドボックス設定を確認します。
Codexには、コマンド実行時の承認方法やサンドボックスに関する設定があります。
ここで避けたいのが、「動かないから」という理由だけで権限を大きく広げることです。
まず表示されたエラーメッセージを確認し、何の操作が止められているのかを確認してから設定を見直します。
設定を変更するときも、一度に複数箇所を変えず、1か所変更→Codexを再起動→動作確認の順で進めると原因を切り分けやすくなります。
原因7：WindowsやWSLの環境に問題がある
WindowsでCodexを利用している場合は、Windows側の実行環境も確認対象になります。
OpenAI公式では、Windows版Codexで複数のWSLディストリビューションがインストールされている場合、Codexで利用するLinuxディストリビューションを選択できると案内しています。
WSLを利用していて動作がおかしくなった場合は、想定している環境が選ばれているか確認してください。
一方、PowerShellなどWindows上で直接Codexを利用していてWSLを使用していない場合、この項目は飛ばして構いません。
原因8：ネットワークでCodexの通信が遮断されている
Codexが途中で止まる、接続が切れる、更新が進まない場合はネットワーク環境も確認します。
OpenAIによると、一部のCodex機能では通常のHTTPS通信に加えて、安全なWebSocket接続が使用されています。
そのため、VPN、プロキシ、ファイアウォール、会社や学校のネットワークなどでWebSocket通信が制限されていると、Codexが停止したり接続が切れたりする場合があります。
特に、別のネットワークでは動くのに特定の環境だけで止まる場合は、通信設定を確認する価値があります。
OpenAI公式｜ChatGPTとCodexのネットワーク推奨事項
原因9：OpenAI側で障害が発生している
自分のパソコンや設定に問題がなくても、OpenAI側の障害によってCodexが動かない場合があります。
何度試しても同じエラーが出る場合や、突然複数の機能が利用できなくなった場合は、設定を変更する前にOpenAI Statusを確認します。
OpenAI Statusでは、Codex Web、Codex API、CLI、VS Code extensionなどの稼働状況を確認できます。
OpenAI側で障害が発生している場合は、自分のconfig.tomlやWindows設定を変更しても解決しないため、先に確認しておくと不要な作業を避けられます。
Codexが動かないときはこの順番で確認する
原因が分からない場合は、9項目をやみくもに試すのではなく、簡単な確認から順番に進めます。
まずは焦らずChatGPTに相談して状況を整理する
Codexで突然エラーが出ると、「何か設定を変えないといけないのでは？」と考えてしまいがちです。
ただ、原因が分からないまま設定を変更すると、かえって問題を増やしてしまうことがあります。
私なら、まず表示されているエラーメッセージをそのままコピーしてChatGPTに伝えます。
その際は、「Codexでこのエラーが出ました。Windowsを使っています。設定を変更する前に、初心者でも確認できる順番を教えてください」のように聞くと、確認するポイントを整理しやすくなります。
可能であれば、次のような情報も一緒に伝えると原因を絞り込みやすくなります。
- 表示されたエラーメッセージ
- エラーが出る直前に行った操作
- Codex CLI・アプリなど、どの環境を使っているか
- 昨日までは動いていたのか、最初から動かないのか
一方で、ChatGPTから提示されたコマンドや設定変更をすべてそのまま実行する必要はありません。
特にconfig.tomlの変更やファイル削除などを案内された場合は、内容を確認し、必要に応じてOpenAI公式情報とも照らし合わせてから進めます。
また、APIキーやパスワードなどの秘密情報は入力しないようにしてください。
まず状況を整理する→安全に確認できるものから試す→必要な場合だけ設定を変更するという順番にすると、初心者でも原因を追いやすくなります。
再起動とCodex Doctorを確認する
最初はCodexを再起動し、WindowsでCodex CLIを使っている場合はcodex doctorを実行します。
codex doctorここで起動・接続・パフォーマンスに関する問題が表示されれば、その内容から原因を絞り込みます。
Codex CLIの基本操作そのものを確認したい場合は、Codex CLIの使い方をPowerShell初心者向けに8ステップで解説した記事も参考にしてください。
次にエラーメッセージと利用状況を確認する
再起動しても直らない場合は、表示されているエラーメッセージを残します。
スクリーンショットを撮るか、エラー文をコピーしておけば、設定を確認するときにも比較できます。
同時に、利用上限やログイン状態も確認します。
ここで利用上限や認証エラーだと分かれば、Windowsやconfig.tomlを変更する必要はありません。
最後に設定・通信・OpenAI側の状態を確認する
エラー内容から原因を特定できない場合は、config.toml、権限設定、Windows・WSL環境、ネットワークの順に確認します。
それでも原因が分からない場合は、OpenAI StatusでCodex側に障害が発生していないか確認します。
再起動→診断→エラー確認→利用状況→設定→通信→OpenAI側という順番にすると、必要のない設定変更を減らせます。
Codexのエラー対処で避けたいこと
Codexが動かないと焦って設定を変更すると、最初の原因とは別の問題を増やしてしまうことがあります。
いきなり再インストールしない
Codexが動かないからといって、最初から再インストールする必要はありません。
認証、利用上限、OpenAI側の障害、ネットワークなどが原因なら、再インストールしても状況は変わりません。
まず原因を確認してから必要な対処だけを行います。
設定をまとめて変更しない
config.tomlなどを複数箇所まとめて変更すると、どの設定で問題が解決したのか分からなくなります。
変更するときは、元の状態を残しながら一つずつ試します。
古い解決方法をそのまま使わない
Codexは更新が続いているため、以前の記事や解説で紹介されている設定が現在も有効とは限りません。
実際に、以前利用できたapproval_policy = “untrusted”は現在サポートされていません。
エラー対処では、現在のOpenAI公式情報と照らし合わせてから設定を変更することが重要です。
Codexを使い始めたばかりなら基本操作も確認しよう
エラーではなく、Codexの使い方や操作手順そのものが分からなくなっている場合もあります。
まだ基本操作に慣れておらず、エラーなのか操作方法の問題なのか判断しにくい場合は、Codexの始め方をWindows初心者向け7ステップで解説した記事から操作の流れを確認してみてください。
まずCodexで何ができるのか整理する
Codexを使い始めたばかりの場合は、エラー対処だけでなく、どのような流れで作業するのかを一度整理すると分かりやすくなります。
私は実際にCodexを使いながら、自分用のアクセス解析ツールを作成しました。
その過程については、Codexを使ってみた｜5日間で自分用アクセス解析ツールができるまでで詳しく紹介しています。
エラーが出た場所を切り分けて考える
「Codexが動かない」と考えるだけでは、原因を探す範囲が広すぎます。
起動できないのか、ログインできないのか、コマンドが実行できないのか、途中で止まるのかを分けて考えると、確認する場所を絞れます。
私のようにデスクトップPCと3枚のモニターを使っている場合は、エラー画面、設定画面、OpenAI公式情報を別々の画面に表示すると比較しやすくなります。
モニターが1枚の場合でも、エラーメッセージをメモ帳などへ残しておけば同じように確認できます。
特にSSHでリモート環境へ接続するときだけ問題が起きる場合は、CodexでSSH接続する4ステップと、うまくいかないときの確認ポイントも確認してください。
まとめ｜Codexがエラーで動かないときは9つの原因を確認しよう
Codexがエラーで動かないときは、いきなり再インストールするのではなく、原因を一つずつ確認します。
主な確認ポイントは、一時的な停止、ログイン・認証、利用上限、古いモデル設定、config.toml、権限、Windows・WSL環境、ネットワーク、OpenAI側の障害の9つです。
どこが原因か分からない場合は、まずCodexを再起動し、WindowsでCodex CLIを使っているならcodex doctorで診断します。
その後、エラーメッセージと利用状況を確認し、必要な場合だけ設定や通信環境へ進むと原因を切り分けやすくなります。
Codexの設定や利用できるモデルは更新されることがあります。以前と同じ対処法をそのまま使うのではなく、エラーが出た時点のOpenAI公式情報も確認しながら進めてください。
にほんブログ村
コメント