Codex起動しない原因と確認順｜Astra対応・Windows CLI

Codex起動しないを4つの症状に分ける

最初に、目の前の状態を「起動」という一語でまとめないことが大切です。アプリのウィンドウが表示されない状態と、ウィンドウは表示されるものの会話が始まらない状態では、見るべきログも確認する場所も異なります。Windowsでは、デスクトップアプリ、ターミナル、エディターの拡張機能が別々の入口になるため、どの入口で止まったかを残してください。

この切り分けは、復旧操作の順番を決めるための地図です。表示の有無、コマンドの解決、依頼の受付、モデルの利用可否を別々に見れば、関係のない設定を変えずに済みます。まずは最も手前で止まった地点を特定します。

画面そのものが表示されない

ショートカットを押しても何も出ない、ロゴのあとに消える、白い画面のまま閉じるという場合は、アプリの起動処理や端末側の表示状態を疑います。ここでCLIの再インストールから始めても、デスクトップアプリだけの問題なら解決しません。タスクバーやタスク マネージャーにCodexが残っていないかを見て、起動を二重に試していないかも確認します。

ターミナルでコマンドが見つからない

PowerShellやコマンドプロンプトで「codex は認識されません」と表示される場合、モデルやアカウントではなく、実行ファイルの場所が端末から見えていない可能性が高い状態です。インストール済みでも別の場所にある版を呼び出していたり、ターミナルを開いたままで新しいPathが反映されていなかったりします。この症状では、まず where.exe codex と版表示を確認します。

作業画面は開くがタスクが始まらない

画面は開き、プロジェクトも選べるのに、依頼を送ったところで止まる場合は、サインイン、対象プロジェクト、利用枠、接続のいずれかを切り分けます。読み込み中の表示が長いだけなのか、エラー文が出ているのかでも対応は変わります。短い新規スレッドで同じ症状が出るかを比べると、特定の履歴や大きな作業対象に限った問題か判断しやすくなります。

モデルが一覧に出ない、または選べない

Astraが表示されないことは、必ずしもCodex全体が起動していない意味ではありません。提供が段階的で、プラン、ワークスペース、アプリ版、CLI版によって表示条件が変わるためです。画面が開き、別のモデルで短い依頼が動くなら、起動障害とモデル提供の問題を分けて扱えます。表示されるモデル名だけでなく、入口と版も一緒に記録してください。

2026年9月に版を確認する理由

2026年9月3日、OpenAIはGPT-6 Astraを発表し、コーディング、調査、コンピューター操作、複数段階の作業を含む改善を案内しました。Codexで新しいモデルを使えるかどうかを確認する人が増える一方、モデルの提供とCodexの実行ファイルの更新は同じものではありません。Astraが見えないときにアプリを壊れたと判断するのではなく、まず利用条件と版を照合します（出典: GPT-6 Astra公式発表）。

Codex CLIの公式リリース一覧では、0.153.4が安定版として掲載され、Astraのモデル選択欄での表示や案内に関する修正が記録されています。また、0.154.0-alpha.6のような先行版も並びます。番号の大きさだけで選ばず、通常利用は安定版、検証目的なら先行版というように役割を分けると、起動トラブルの原因を増やさずに済みます（出典: openai/codex公式リリース）。

Astraの提供と起動成功は別に判定する

Astraがまだ表示されない場合でも、Codexの画面や別モデルの処理が正常なら、起動そのものは成功しています。反対に、Astraが一覧にあっても、アプリが閉じる、CLIが見つからない、プロジェクトを開けないなら別の確認が必要です。モデルの有無、作業の開始、コード変更の完了を別々のチェック項目として扱い、同じ言葉で報告しないようにします。

安定版と先行版を混ぜない

Windowsのデスクトップアプリに内蔵されたCLIと、別途インストールしたCLIが異なる版になる場合があります。ターミナルで表示された版だけを見て、アプリも同じだと決めつけないでください。通常の作業は安定版を基準にし、先行版を試すときは別の確認対象として版、入口、発生時刻を控えます。公式リリースページでタグが「Latest」か「Pre-release」かを確認するだけでも、判断の取り違えを減らせます。

Windowsで最初に行う診断

ここでは設定を大きく変える前に、状態を短時間で記録します。目的は、その場で直すことだけではなく、直らなかった場合に同じ状況を再現できる情報を残すことです。次の順番で一つずつ確認し、途中で複数の版を削除したり、設定ファイルを移動したりしないでください。

診断の段階では、直すことより観察することを優先します。版、入口、停止地点、発生時刻を先にそろえると、更新や再起動をした後でも変化を比較できます。記録があれば、公式の案内やサポートへ相談するときも説明が短くなります。

Step 1: 表示された症状をそのまま書き留める

「起動しない」と要約する前に、画面が出ない、ロゴで止まる、ウィンドウがすぐ閉じる、コマンドが見つからない、サインイン画面に戻る、依頼後に待ち続ける、モデルが表示されないのどれかを選びます。エラー文がある場合は短くても原文を残し、発生した入口がアプリかPowerShellかエディターかも記録します。表現を正確にするだけで、次に見る場所が絞れます。

Step 2: アプリ側とCLI側の版を別々に確認する

アプリが開くなら、設定またはAbout画面でデスクトップアプリの版を確認します。ターミナルを使えるなら、codex --version を実行し、表示されたCLI版を控えます。コマンドが見つからない場合は、失敗したという結果自体が診断材料です。OpenAIの案内が求めるCLI 0.153.0以上と照合し、Astraが見えない理由と、起動できない理由を混同しないようにします。

Step 3: 実行ファイルの場所を確認する

PowerShellでは where.exe codex を実行し、複数のパスが返るか、何も返らないかを見ます。複数の結果があるときは、意図したインストール先が先に選ばれているとは限りません。Get-Command codex も併用すれば、現在のセッションがどのコマンドを解決しているかを確認できます。結果を残したまま、すぐにPathの編集や削除へ進まないことが重要です。

Step 4: 起動中の残ったプロセスを一度だけ整理する

ウィンドウが閉じたように見えても、バックグラウンドにアプリのプロセスが残ると、次の起動が反応しないことがあります。タスク マネージャーでCodexに関係するプロセスが残っているかを確認し、作業中の別スレッドがないことを確かめてから終了します。終了後に同じショートカットを一度だけ押し、二重起動を重ねず、表示の変化を記録します。

Step 5: 入口を変えて同じ症状か比べる

デスクトップアプリだけが開かないならCLI、CLIだけが見つからないならアプリというように、別の入口を一度試します。片方が動けば、アカウント全体ではなく特定の入口、インストール場所、アプリの状態に絞れます。ただし、入口を変えた結果を「直った」と即断せず、同じプロジェクトで短い確認を行い、変更結果が残るところまで確認します。

CLIが見つからないときの確認順

CLIの起動失敗は、モデルの不調よりも、コマンドの解決先やインストール方法の混在で起こることが多い症状です。公式の配布ページや現在使っている導入方法を基準にし、別の方法を上から重ねて入れる前に、いま何が呼び出されているかを確認します。特にWindowsでは、古いターミナルが更新前のPathを保持していることがあります。

ここで大事なのは、CLIが存在しないのか、存在するが別の版を呼んでいるのかを分けることです。場所と版が分かれば、更新すべき対象を一つに絞れます。確認前に複数の導入方法を試すと、同じ名前の実行ファイルが増えて原因が見えにくくなります。

where.exe codex が何も返さない場合

何も返らない場合は、そのターミナルから実行ファイルが見えていません。アプリ版を使う予定なら、CLIが別に必要なのかを公式の製品案内で確認し、不要な導入を増やさないでください。CLIを使う予定なら、公式の導入手順でインストール状態を確認し、完了後にPowerShellを閉じて新しく開きます。同じ画面で再試行を繰り返しても、読み込まれたPathは変わりません。

複数のパスが返る場合

複数のパスが返ったら、ファイルの存在だけでなく版も確認します。先頭のパスにある実行ファイルが古い版なら、Astraを使える条件を満たしていても古いCLIが呼ばれます。不要な版をいきなり削除せず、現在の作業が止まっていないことを確かめたうえで、公式の更新方法に沿って一つの導入先へ整理します。変更後は新しいターミナルで where.exe codex と codex --version を再確認します。

アプリ内CLIと外部CLIを取り違えない

デスクトップアプリが正常でも、外部のPowerShellが同じ内蔵CLIを使うとは限りません。アプリのAbout画面、ターミナルの版、実行ファイルの場所を別々の値として記録します。アプリから作業できるなら、まずその入口で起動を確認し、CLIの整理は別の作業として行う方が安全です。入口を一度に変更すると、問題がどこで解消したのか追えなくなります。

アプリは開くが作業が始まらないとき

画面表示まで進んでいるなら、起動障害から次の層へ切り替えて考えます。ここで再インストールを続けるより、サインイン状態、対象プロジェクト、利用可能なモデル、接続状態を順に確認する方が効率的です。公式のCodex案内は、プランに含まれる利用枠とAPIを使う場合の扱いが異なることも説明しているため、同じアカウントでも入口によって表示が変わる点に注意します（出典: ChatGPT Work and Codex公式案内）。

サインイン状態を確認する

画面が開いていても、サインインが期限切れになっていたり、別のアカウントで開いていたりすると、依頼を送った後に止まることがあります。表示されているアカウント、ワークスペース、利用プランを確認し、必要なら公式画面から一度サインアウトして、正しいアカウントで入り直します。認証画面を何度も開くより、いま表示されているアカウント情報を一つずつ見比べる方が原因を絞れます。

プロジェクトを小さく開く

大きなリポジトリや依存関係の準備が重い対象では、最初の読み込みに時間がかかります。新しい小さなフォルダー、または読み取りだけで確認できるサンプル対象を開き、短い質問が返るかを比べます。小さい対象では動き、大きい対象だけで止まるなら、Codexの起動ではなく、対象の準備、権限、読み込み量の問題として切り分けられます。

モデルを一つ下げて応答を比べる

Astraだけで止まる場合は、別の利用可能なモデルで短い質問を試します。別モデルが返れば、アプリやCLIの起動は成功しており、モデルの提供条件、混雑、選択状態に焦点を移せます。逆にどのモデルでも同じ場所で止まるなら、サインインや接続、対象プロジェクトを確認します。モデルの変更は一度に一つだけ行い、開始時刻と結果を残してください。

Astraが表示されないときの見方

OpenAI Help Centerは、Astraの提供が段階的で、Chat、Work、Codexで利用可能になる時期が一致しない場合があると案内しています。Plusを含む対象プランでも、アカウントやワークスペースによって見え方が異なることがあります。したがって、Astraの名前がないだけでインストール失敗と判断するのは早すぎます。まずアプリ版を更新し、CLIが0.153.0以上かを確認し、それでも表示されないなら提供状況を確認します。

CLI 0.153.0未満なら先に版をそろえる

Astraを使う前提として、公式案内はCodex CLI 0.153.0以上を示しています。codex --version がそれより古い場合は、現在の導入方法に対応した公式手順で更新します。更新後は新しいターミナルを開き、版表示が変わったことを確かめます。アプリ内のCLIと外部CLIが別なら、両方を同じ値にする必要があるのか、利用する入口に必要な方だけを更新するのかを先に決めます。

0.153.4と先行版を読み分ける

公式リリースでは、0.153.4が安定版としてAstraの表示や案内を整えた版として説明され、0.154.0-alpha.6は先行版として公開されています。先行版へ変えて表示が出たとしても、起動問題が解消したと直ちに判断しないでください。安定版で短い作業が完了するか、更新前と同じプロジェクトを開けるか、タスク終了まで応答が続くかを比べます。変更の目的を「表示確認」と「日常利用」に分けると判断が安定します。

利用枠と接続の表示を確認する

Astraは利用枠を早く消費することがあると公式案内に記載されています。モデルを選べても、利用枠や接続状況によって依頼が進まない場合があります。利用量の画面、エラー文、別モデルでの結果を同時に確認し、モデル名だけを根拠にしないようにします。短い質問で動作を確かめた後、コード変更を伴う長いタスクへ進むのが安全です。

再インストール前に確認すること

再インストールは分かりやすい対処に見えますが、古いPath、複数の導入先、アカウント状態、プロジェクトの問題は残ることがあります。版を入れ替える前に、いまのファイルや設定をむやみに消さず、必要な情報を記録します。特に、アプリは開くがCLIだけが見つからないケースでは、アプリ全体を削除する必要がない場合があります。

削除を伴う操作は、最後の選択肢として扱います。現在の版と導入先を確認し、再起動や新しいターミナルで改善しないことを確かめてから、公式の手順に進みます。先に記録を残しておけば、更新後に戻す判断もしやすくなります。

記録を残してから更新する

更新前に、アプリ版、CLI版、where.exe codex の結果、サインイン先、症状が始まった時刻を保存します。公式リリースページで更新日も確認し、安定版か先行版かを書き添えます。更新後に症状が変わっても、更新前の情報があれば、版による変化なのか、別の操作が効いたのかを比べられます。

公式の配布元を基準にする

Codexの入手先や更新方法は、公式の製品案内と公式リリースページを基準にします。検索結果に出た第三者の配布物や、内容が分からない実行ファイルを追加すると、起動問題の原因を増やします。公式ページで対象OS、対応入口、安定版の位置付けを確認し、現在の導入方法と合う手順だけを選びます。

更新後は新しいターミナルで確認する

更新が終わったら、開いたままのPowerShellを使い続けず、新しいウィンドウで版を確認します。where.exe codex が意図した場所を指し、codex --version が記録した版になっているかを見ます。アプリを使う場合もAbout画面を確認し、短い新規スレッドを開いて、プロジェクト選択、モデル表示、返答の三つを順に確かめます。

起動を確認する安全な短いテスト

復旧したかどうかは、画面が表示されたことだけで判断しません。最小の対象で、依頼を受け取り、内容を返し、必要なら小さな読み取り結果を示せるところまで確かめます。いきなり本番の大きなリポジトリで変更を依頼すると、起動問題と対象の準備時間を区別しにくくなります。

次の順序で確認します。

1. 新しいターミナル、または新しいCodexスレッドを開き、表示される入口と版を記録する。
2. 小さな作業対象を選び、「このフォルダーの構成を短く説明してください」と依頼する。
3. 返答が届いたら、モデル名、利用量表示、エラーの有無を確認する。
4. 変更を伴わない確認が終わってから、テスト対象が明確な小さな修正を一つだけ依頼する。
5. 差分とテスト結果を読み、起動成功と作業成功を別々に記録する。

このテストで、最初の質問には返答するがファイル変更で止まる場合は、起動ではなく権限や対象の確認に移ります。質問にも返答しない場合は、サインイン、モデル、接続を再確認します。結果を分けて残すと、次回に「開くが作業が始まらない」という正確な報告ができます。

それでも起動しないときの相談材料

ここまで確認しても直らない場合は、同じ操作を何度も繰り返すより、公式の案内やサポートへ渡せる情報をそろえます。報告には、個人情報やプロジェクトの中身をそのまま貼らず、OSの版、アプリ版、CLI版、入口、発生時刻、表示された文言、再現する最小手順を書きます。機密性のあるパスやトークンは伏せ、必要な範囲だけを共有してください。

相談前に、直った入口と直らない入口を分けて書くと、問題の範囲が伝わります。たとえばアプリでは短い質問が返るがPowerShellではコマンドが見つからない、という差は有力な手がかりです。推測した原因ではなく、確認できた事実を先に並べます。

症状を一行で言える形にする

「Codexが動かない」ではなく、「Windowsのデスクトップアプリはロゴ後に閉じる」「PowerShellで codex が見つからない」「0.153.4でサインイン後にAstraだけ選べない」のように、入口、版、停止地点を一行にします。これだけで一般的な起動障害、コマンド解決、モデル提供のどれを先に見るべきかが伝わります。発生する対象と発生しない対象も添えると、再現条件が明確になります。

公式ページと照合してから問い合わせる

まずCodex公式チェンジログと公式リリース一覧で、使っている版の公開日と位置付けを確認します。サービス側の状況が疑われる場合は、OpenAI Statusも見ます。記事や投稿だけで断定せず、公式情報と自分の症状を分けて記録することが、復旧までの遠回りを防ぎます。

まとめ

Codexが起動しないときは、まず画面が開かない、CLIが見つからない、作業が始まらない、モデルが表示されないという四つの状態に分けます。2026年9月はGPT-6 Astraの段階提供とCLI更新が重なっているため、Astraが見えないこととCodexが起動しないことを同じ問題として扱わないことが重要です。

Windowsでは、症状の原文、アプリ版、codex --version、where.exe codex、サインイン先、対象プロジェクトを順に記録します。安定版と先行版を混ぜず、変更は一つずつ行い、最後は小さな対象で質問と変更を分けて確認します。公式のOpenAI Help Center、GPT-6 Astra公式発表、Codex公式リリースを基準にすれば、再インストールへ急がず、原因に合った復旧手順を選べます。