Codexが動かないときに確認したい原因と対処の手順を解説
Codex に指示を出しても起動しない、コマンドを打っても応答が返らない——「動かない」という症状は、原因がインストール・ログイン・ネットワーク・サービス側のどこにあるかで対処がまったく変わる。2026年6月の大型アップデートで構成が新しくなった直後だけに、古いバージョンやログイン期限切れによる不具合も起きやすい時期だ。本記事では、Codex が動かないときに確認すべき原因を層ごとに切り分け、復旧までの手順を整理する。
Codex が「動かない」と一口に言っても、止まっている場所はいくつもある。まず押さえたいのは、症状を層で切り分けるという発想だ。起動そのものができないのか、起動はするが応答が返らないのか、途中で止まるのか——この区別だけで、疑うべき原因がインストール・ログイン・ネットワーク・サービス側のどれなのかが大きく絞り込める。
実際に頻度が高いのは、ログイン認証の期限切れとバージョンの古さの二つだ。2026年6月に Codex が大きく刷新されたこともあり、以前のサインイン状態が切れていたり、古いバージョンのまま動かそうとして噛み合わないケースが目立つ。多くの場合は再サインインと最新安定版への更新だけで復旧する。
それでも直らないときは、プロキシやサンドボックスによる遮断、レート制限や利用上限、そしてOpenAI 側の一時的な障害を順に疑っていく。やみくもに再インストールを繰り返すより、層ごとに一つずつ確認するほうが速い。本記事の手順と公式の情報源をたどれば、問い合わせ前に自分で切り分けられる範囲は大きい。
目次 (16)
- 「Codexが動かない」をどの層で切り分けるか — 症状の分類から始める
- 症状を三つに分けて当たりをつける
- 「インストールできない」との違いを押さえる
- 最も多い原因①ログイン・認証の期限切れ — 再サインインで直る
- まずは一度サインインし直す
- アカウントを切り替えて使っている場合の注意
- 最も多い原因②バージョンの古さと alpha / stable の混在
- 最新の安定版へ更新する
- プレリリース版を入れている場合は安定版に戻す
- ネットワーク・プロキシ・権限で止まるケース
- プロキシ・ファイアウォールを確認する
- 権限設定で実行がブロックされていないか
- レート制限・利用上限・サービス側の障害を疑う
- レート制限や利用上限に達していないか
- OpenAI 側の障害を確認する
- それでも動かないときのチェックリスト
「Codexが動かない」をどの層で切り分けるか — 症状の分類から始める
「動かない」という言葉は、まったく異なる状態をひとまとめにしてしまう。そのまま再インストールに走ると、本当は別の場所が原因だったときに時間を浪費する。最初にやるべきは、症状を三つに分類することだ。第一に、コマンドを打っても何も起きない・コマンド自体が見つからないという「起動しない」状態。第二に、起動はするが入力に対して応答が返ってこない・延々と待たされる「応答しない」状態。第三に、動き始めたのに途中でエラーを出して止まる「中断する」状態だ。この三分類は、そのまま疑うべき層に対応する。起動しないならインストールやパス設定、応答しないならログインやネットワーク、中断するなら権限・利用上限・サービス側というように、原因の当たりがつけやすくなる。Codex の全体像や提供形態は公式ドキュメントにまとまっているので、自分が使っているのが CLI なのか、デスクトップアプリなのか、IDE 拡張なのかをまず確認しておきたい(出典: https://developers.openai.com/codex/)。
症状を三つに分けて当たりをつける
起動しないのか、応答が返らないのか、途中で止まるのか——この区別を最初に固定するだけで、確認すべき項目が一気に減る。たとえば「起動はするがずっと考え込んだまま結果が出ない」なら、インストールをやり直しても意味はなく、ログイン状態やネットワーク経路を見るほうが近道だ。逆に「コマンドが見つからないと出る」なら、それは実行ファイルやパスの問題で、認証は関係しない。症状を言語化してから原因を探す習慣をつけたい。
「インストールできない」との違いを押さえる
「動かない」と「インストールできない」は混同されやすいが、対処の入り口が違う。インストール段階でつまずく場合は導入そのものを見直す必要があり、それは別の切り口で扱うべきテーマだ。一方で本記事が対象にするのは、いったん導入は済んでいるのに起動・実行の段階で止まるケースである。すでに一度は動いていた、あるいはインストール自体は完了している——そう感じるなら、まずはこの記事の流れで層を切り分けていくとよい。
最も多い原因①ログイン・認証の期限切れ — 再サインインで直る
実務で最も頻度が高いのが、ログイン状態が切れているケースだ。Codex は ChatGPT アカウントでのサインインを前提に動くため、サインイン情報の有効期限が切れたり、アカウント側の状態が変わったりすると、起動はしても処理に進めず応答が返らなくなる。とくに 2026年6月のアップデート以降は、以前のサインイン状態が引き継がれずに切れている例が見られる。症状としては「起動はするが反応がない」「認証を促すメッセージが出る」「権限がないと表示される」といった形で現れる。心当たりがあれば、再インストールより先に一度サインインし直すのが最短だ。ログインや接続まわりの仕様は公式の手順にまとまっているので、自分の利用形態に合った方法を確認しておきたい(出典: https://developers.openai.com/codex/)。
まずは一度サインインし直す
CLI を使っているなら、いったんログアウトしてからログインし直すことで、古くなったサインイン情報を入れ替えられる。手順はおおむね次の流れになる。
- 現在のバージョンと状態を確認する(
codex --versionなどで導入が生きているかを見る)。 - 一度サインアウトする。
- 改めて
codex loginを実行し、画面の案内に沿って ChatGPT アカウントでサインインし直す。 - サインイン完了後、簡単な指示を一つ送って応答が返るかを確認する。
この入れ替えだけで「応答しない」が解消することは珍しくない。サインインの導線はバージョンや提供形態で多少異なるため、迷ったら公式ドキュメントの該当ページを参照するとよい。
アカウントを切り替えて使っている場合の注意
複数のアカウントを使い分けている場合、いま動かそうとしている環境がどのアカウントでサインインしているかを取り違えていると、「権限がない」「利用できない」といった形で止まって見えることがある。仕事用と個人用を併用しているなら、想定どおりのアカウントで入っているかを必ず確認したい。意図しないアカウントのままだと、いくら再起動しても症状は変わらない。アカウントの切り替えそのものでつまずく場合は、切り替え手順を扱った内容を別途参照すると整理しやすい。
最も多い原因②バージョンの古さと alpha / stable の混在
次に多いのが、バージョンに起因する不具合だ。Codex CLI は更新が速く、2026年6月時点では安定版が 0.139.0、その先にプレリリースの 0.140.0 系 alpha が並ぶ状況にある(出典: https://github.com/openai/codex/releases)。古いバージョンのまま放置していると、刷新後の挙動と噛み合わずに起動直後で止まることがある。逆に、試しに入れた alpha などのプレリリース版で不安定さを踏んでいるケースもある。「最近まで動いていたのに急に動かなくなった」というときは、まずバージョンを疑うのが定石だ。2026年6月3日には「新しい Codex」として土台モデルが GPT-5.5 へ刷新されるなど構成が大きく変わっており、この前後で更新を挟んでいないと不整合が起きやすい(出典: https://openai.com/index/codex-for-almost-everything/)。
最新の安定版へ更新する
まずは安定版を最新へ揃えるのが基本だ。導入方法によって更新コマンドは異なるが、npm でグローバル導入している場合は最新版を指定して入れ直すことで揃えられる。
codex --versionで現在のバージョンを確認する。- リリースページで最新の安定版番号を確認する(出典: https://github.com/openai/codex/releases)。
- 導入経路に合わせて最新版へ更新する(npm 経由なら
npm install -g @openai/codex@latestなど)。 - 更新後にもう一度バージョンを確認し、簡単な指示で起動と応答を確かめる。
更新の細かな手順は導入形態で変わるため、自分が CLI を入れた方法に合わせて進めたい。
プレリリース版を入れている場合は安定版に戻す
検証目的で alpha などのプレリリースを入れていて挙動が不安定なら、いったん安定版に戻すのが安全だ。プレリリースは新機能の先行確認のための位置づけで、日常的に使う環境には安定版を据えるのが基本になる。「最新を追いたい」気持ちと「安定して動かしたい」要求は別物なので、業務で使う環境では安定版、試したい機能があるときだけ切り分けて確認する、という使い分けを意識するとトラブルを減らせる。
ネットワーク・プロキシ・権限で止まるケース
サインインもバージョンも問題ないのに応答が返らない場合は、通信経路や実行権限を疑う。Codex は処理の過程で外部と通信するため、社内プロキシやファイアウォール、VPN の設定によって通信が遮られると、起動はしても処理が前に進まなくなる。また、実行時の権限設定が厳しすぎると、コマンドの実行やファイルの読み書きがブロックされ、途中で止まったように見えることがある。「特定のネットワークでだけ動かない」「自宅では動くのに会社では動かない」といった条件付きの症状は、この層が原因である可能性が高い。
プロキシ・ファイアウォールを確認する
会社や学校のネットワークでは、外部との通信が制限されていることがある。次の点を順に確認したい。
- 別のネットワーク(モバイル回線など)につなぎ替えて、症状が変わるかを試す。
- プロキシ設定が必要な環境なら、その設定が正しく反映されているかを確認する。
- VPN を使っている場合は、いったん切って挙動が変わるかを見る。
ネットワークを変えた途端に動くなら、原因は Codex 本体ではなく経路側にある。その場合はネットワーク管理者に必要な接続先の許可を相談するのが筋道だ。
権限設定で実行がブロックされていないか
Codex は安全のため、コマンドの実行やファイル変更に対して確認や制限をかける仕組みを持つ。この制限が強い設定になっていると、本来動くはずの操作が止まって見える。意図せず制限を厳しくしていないか、実行のたびに承認待ちで止まっていないかを確認したい。安全側に倒すのは正しい設計だが、「止まっている」のか「承認を待っている」のかを取り違えると、原因を見誤る。実行の制限まわりはサンドボックスや権限の設定として用意されているので、自分の設定がどうなっているかを把握しておくとよい。
レート制限・利用上限・サービス側の障害を疑う
ここまで確認しても直らない場合は、自分の環境の外側に原因があることを考える。短時間に多くのリクエストを送るとレート制限がかかり、一時的に応答が返らなくなることがある。「429」といった表示が出るなら、これは過剰なリクエストに対する制限のサインで、しばらく待つか利用ペースを落とすことで回復する。あわせて、プランごとの利用上限に達していないか、クレジットや残量が尽きていないかも確認したい。さらに、自分側に問題が見当たらないときは、OpenAI 側で一時的な障害が起きている可能性もある。
レート制限や利用上限に達していないか
短時間に集中して使ったり、長時間タスクを並行で走らせたりすると、制限に触れて止まることがある。次の順で確認するとよい。
- エラー表示にレート制限や上限を示すメッセージがないかを読む。
- 数分から十数分ほど待ってから、もう一度試す。
- 自分のプランの上限や残量を確認し、必要なら利用ペースを調整する。
待つだけで回復するなら、それは故障ではなく制限だ。慌てて再インストールする必要はない。
OpenAI 側の障害を確認する
自分の環境にまったく心当たりがないのに、同じ時間帯に広く動かないようなら、サービス側の一時的な不具合を疑う。公式のステータスページで稼働状況を確認すれば、障害が起きているかどうかを切り分けられる(出典: https://status.openai.com/)。障害が原因なら、利用者側でできるのは復旧を待つことだけだ。むやみに設定をいじると、復旧後にかえって別の不具合を抱え込みかねないので、この場合は手を止めて待つのが正解になる。
それでも動かないときのチェックリスト
最後に、問い合わせる前に自分で押さえておきたい確認項目を順にまとめる。上から順にたどれば、原因がどの層にあるかを自力で絞り込める。
- 症状を「起動しない / 応答しない / 中断する」のどれかに分類する。
- 一度サインインし直し、想定どおりのアカウントで入っているかを確認する。
- バージョンを確認し、最新の安定版へ更新する(出典: https://github.com/openai/codex/releases)。
- 別のネットワークで試し、プロキシや VPN の影響を切り分ける。
- 権限や実行の制限が強すぎないか、承認待ちで止まっていないかを見る。
- レート制限や利用上限、残量を確認し、必要なら少し待つ。
- 公式ステータスでサービス側の障害有無を確認する(出典: https://status.openai.com/)。
ここまで確認しても解消しないときは、どの手順で何が起きたか(表示されたメッセージ、使っているバージョン、利用形態)を整理したうえで、公式ドキュメントや提供元の窓口に相談すると話が早い(出典: https://github.com/openai/codex)。「動かない」を層で切り分けておけば、再現条件と試したことを具体的に伝えられ、解決までの距離はぐっと縮まる。
