Codexが起動しない？Windows・CLIの症状別対処法

Codexが起動しないときは、使っている入口と、止まった段階を先に確認しましょう。アプリが開かない場合と、ログインや作業が進まない場合では、見る場所が異なります。

白い画面のまま。昨日まで使えたコマンドが見つからない。そんなときに設定をまとめて消すと、原因が分からないまま、残したいデータまで失うことがあります。

自分の症状に合う確認を、下の早見表から選んでみてください。再インストール前に残すデータと、直らない場合の相談メモもまとめています。

このブログは、AIツールを「むずかしいもの」から「自分の道具」に変えていく、その過程を一緒にたどる場所です。

もしもAIが、あなたの仕事の右腕になったら。その最初の一歩を、ここから始めましょう。

Codexが起動しないときは、使っている入口と症状を確認しよう

最初に、「何を開こうとしたか」と「どこまで進んだか」をメモします。画面が出ないのにログイン設定を変えても、確認したい問題から離れてしまいます。今の状態に近い行を選び、対応する見出しへ進んでください。

自分に関係する行だけで大丈夫です。全部の対処を順番に試す必要はありません。

アプリ・CLI・VS Codeのどこから開いているか

アイコンを押して独立した窓を開くのがアプリ。PowerShellなどの文字の画面でcodexを実行するのがCLI（コマンドで使う版）です。VS Codeの中で使う場合は、追加機能である拡張の状態を確認します。

たとえばアプリだけ開かず、CLIは動くなら、すべてを一度に入れ直すよりアプリ側から調べる手掛かりになります。ただし、片方が動くだけで原因を確定できるわけではありません。普段使っている入口を、まず一つに絞ります。

「開かない」「画面で止まる」「依頼後に止まる」を分ける

起動ボタンを押しても窓が出ない、窓は出るけれど中身が表示されない、チャットは開くのに返答が始まらない。この三つは見た目が似ていても別の段階です。

記録は「動かない」だけでなく、「アイコンを押すと窓は出るが、白いまま」のように書きます。エラーが出るならその文も残してください。修理の相談で「車が変なんです」より「エンジンはかかるけれど進まない」が役立つのと同じです。

窓が出ない場合は、Windowsアプリの確認から進めていきます。

WindowsでCodexアプリが開かないときに確認すること

Windowsでは、まず通常の終了と起動し直しを試し、前回使えたときとの違いを調べます。ここで挙げる再起動などは一般的な確認案です。原因ごとの修復を保証する手順ではないので、変化がなければ結果を残して次の確認へ進みます。

終了と起動し直し、更新前後の変化を確認する

アプリが開いているなら、保存できる作業を保存し、進行中の処理が終わってから通常の操作で閉じます。その後、普段のアイコンから開き直します。窓が出ない場合も、繰り返しクリックする前に、タスクマネージャーでアプリが残っているかを見ると状況を記録できます。

応答しない処理を強制終了すると未保存の作業を失うことがあります。まず他の作業を保存し、必要ならPCの再起動を検討してください。「更新直後から開かない」「特定のフォルダを選ぶと止まる」といった変化も控えます。更新がきっかけに見えても、それだけで原因とは言い切れません。

現在の公式アプリとWindowsの環境を確かめる

古い案内を見て別の配布ファイルを追加する前に、入手元と現在の公式案内を比べます。2026年10月10日に確認したOpenAIの資料では、デスクトップ版の配布案内はChatGPT desktop app名です。手元に表示される名前だけで、すぐ別製品だと判断しないようにします。

Windows版アプリの公式案内で、配布先と実行環境を確認できます。会社のPCでは、インストールや更新が管理されていることもあるため、個人判断で別の導入経路を重ねないでください。

PCの条件を確かめたい方は、Windows 11でCodexを使うための必要条件を先に確認してください。

Windows nativeとWSLの設定を混ぜない

公式資料では、エージェント（実際に作業する部分）は初期状態でWindows native、つまりWindows側のPowerShellで動きます。WSL2は、Windows内でLinuxの環境を使う仕組みです。WSLへ切り替えた場合はアプリの再起動後に反映されます。

文字の画面である統合ターミナルと、エージェントの実行環境は別々に選べます。ターミナルをWSLに変えただけで、作業する側も変わったとは限りません。また、Node.jsなどの開発道具の不足を、アプリの窓が出ない原因と一律に結び付ける説明は避けましょう。

窓は出るけれど中身が表示されないなら、止まった画面を確認しましょう。

白い画面・黒い画面・読み込みで止まるときの確認

白や黒の画面は症状であって、原因の名前ではありません。今回確認した公式資料では、それらを一律に直す手順は確認できませんでした。通信や起動し直しを確認する際も、設定を削除する前に、止まったタイミングを記録します。

画面が止まるタイミングとエラー文を残す

アプリを開いた直後なのか、サインインから戻った後なのか、特定のチャットを開いたときなのかを確かめます。エラー文が出る場合は、番号だけでなく前後の文も記録してください。

たとえば「起動直後は表示されるが、昨日のチャットを開くと読み込みが続く」なら、アプリ全体の起動失敗とは違う相談内容になります。スクリーンショットを共有するときは、名前、メールアドレス、ファイル内容などが写っていないかも確認します。

通信と再起動で変わるか、1つずつ確かめる

普段使うWebページが開くかを確認し、PC全体の通信とCodexだけの問題を分けます。Webページが開いても、Codexに必要な通信がすべて通るとは限りません。会社のネットワークや通信を中継するプロキシでは、サービスごとの制限があることもあります。

許可された環境で通信を確認した後、アプリを開き直して変化を記録します。接続と設定を同時に変えると、何が影響したか分からなくなります。障害が気になるときは公式の状況案内も確認し、画面の色だけでサービス障害だと決めつけないでください。

原因が分からないままキャッシュや設定を削除しない

検索で見つけた削除手順は、同じ画面の色でも、対象の版や環境が違う場合があります。「白いからキャッシュ破損」「黒いから描画の問題」と決めつけず、手順の対象と、消すデータを確認します。

設定を消すと、元の状態と比べる材料も減ります。直前に設定を変えた心当たりがなければ、まず症状と試した結果を残しましょう。一通り確かめても変わらない場合は、この記事の保管・相談の項目へ進めます。削除を重ねるほど正解に近づく、というわけではありません。

ログインの前後で止まるなら、ブラウザとCodex側の状態を比べます。

ログイン画面から進まないときは、認証と通信を確認しよう

サインインが終わったように見えるのにCodexが進まない場合は、ブラウザ側の完了と、Codex側の受け取りを分けます。アプリ・CLI・拡張のどれで認証しているかを控え、エラーの案内に合わせて確認するのが出発点です。

ブラウザのサインイン完了とCodex側の状態を確認する

ブラウザが開いた場合は、意図したアカウントでサインインしているかを見ます。ブラウザの案内を最後まで確認した後、Codex側へ戻り、ログイン済みになっているか確かめてください。複数のアカウントを使う人は、普段のブラウザのアカウントと混同しやすい所です。

OpenAIのCodexの公式認証ガイドでは、ブラウザから認証情報をCodexへ返す流れを確認できます。途中のエラーを消さず、どちらの画面で止まったかを残すと、相談する内容が絞れます。

CLIでは認証状態を確認してから入り直す

CLIがコマンドを受け付ける場合は、認証方式を確認します。以下はCLI用であり、アプリの窓が出ない問題を直すコマンドではありません。

codex login status

認証が必要と分かった場合は、導入した環境でcodex loginからサインインを進めます。入り直すためにログアウトすると、CLIと拡張が共有する認証にも影響し得るので、作業中の利用がないか先に確認します。

CLIのブラウザ認証が通信制限で戻れない場合には、公式ガイドにデバイスコード認証の選択肢があります。利用設定や組織の許可が必要で、誰でも使える万能な修復策ではありません。認証ファイルを相談文へ貼り付ける方法も使わないでください。

社内ネットワークやプロキシの制限は管理者に相談する

会社のPCで同じ所から進まない場合は、組織の認証方式やネットワーク制限も確認対象です。セキュリティ機能を無効にしたり、管理者権限で毎回起動したりする前に、表示されたエラーを管理者へ伝えます。

たとえば「サインインは完了したが、CLIへの戻り先で接続エラーになる」と伝えると、認証そのものと戻りの通信を分けて相談できます。個人の設定で組織の制限を上書きできるとは限りません。ここまで変化がなければ、利用環境とエラー文をそろえて相談へ進みます。

コマンドが見つからない場合や、VS Codeの入口がない場合も分けて確認します。

CLI・VS CodeでCodexが起動しないときの確認

CLIでは起動するプログラムの場所、VS Codeでは拡張の有効状態から調べます。アプリ版の更新とCLI版の更新は同じ操作ではありません。普段の導入方法を確認してから、必要な更新や再導入の手順を選びましょう。

codexコマンドが見つからない・違う版が起動する

WindowsのPowerShellなら、次の二つで起動するコマンドと版を確認できます。これは設定を削除する操作ではありません。

Get-Command codex -All
codex --version

Get-Commandは、PowerShellが見つけたコマンドの場所を表示します。見つからない場合は、未導入か、コマンドを探す場所に導入先が入っていない可能性があります。複数見つかる場合は、以前と別の導入先を起動していないか確認します。

専用インストーラやnpmなど、方式ごとの更新方法はCodex CLIの公式導入・更新手順にまとまっています。別の方式を追加する前に現在の導入先を控え、更新した後は新しいPowerShellの窓で確認してください。

導入経路が分からない場合は、CodexのWindows向けインストール手順で、アプリとCLIのどちらを使っているか確認できます。

PowerShellとWSLのどちらで実行しているかを確認する

WindowsのPowerShellで入れたCLIと、WSLのLinux側で入れたCLIは、同じ場所のプログラムとは限りません。アプリでは使えるのにWSLで見つからない場合も、インストールした環境と実行する環境が違う可能性があります。

WSL側で調べる場合は、Linuxのコマンドであるcommand -v codexとcodex --versionを使います。Windows用のGet-Commandを、そのままWSLへ貼り付けないでください。設定やログイン情報も初期状態では別のホームフォルダを使うため、片方の設定変更がもう片方へ反映されるとは限りません。

VS Codeは拡張の有効状態とサイドバーの入口を確認する

VS Codeでは、拡張一覧でOpenAIのCodexが導入・有効化されているかを見ます。アイコンが見当たらない場合は、コマンドパレットを開き、Codex: Open Codex Sidebarを実行します。これは公式資料にあるサイドバーの開き方です。

Codex拡張の開き方で入口を確認できます。サイドバーが開いた後にサインインが止まるなら認証の問題、拡張自体がエラーを出すならその文を記録します。アイコン非表示と、起動後のエラーを同じ不具合として扱わないのがポイントです。

入口は開くのに返答が始まらない場合は、作業する側の状態を見ます。

アプリは開くのに作業が始まらない場合も分けて確認しよう

チャットや入力欄が見えているなら、アプリの起動後で止まっている状態です。承認待ち、選んだフォルダ、作業環境の準備、利用上限など、画面に示された内容から確認します。待ち続ける前に、表示を一つずつ読んでみましょう。

承認待ち・選んだ作業フォルダ・表示されたエラーを見る

まず、操作の許可を求める表示がないか確認します。承認待ちなら内容を読んで判断します。返答を急ぐために何でも許可するのではなく、依頼した範囲の操作かを見てください。

フォルダにアクセスできない、ネットワークに接続できない、利用上限に達したなどの表示も、起動失敗とは別に扱います。上限と書かれていない症状を、プラン変更だけで直そうとしないようにします。公式のトラブル対処でも、止まったチャットでは承認待ちの確認を最初に挙げています。

サンドボックスの初回設定と会社PCの制限を確認する

サンドボックスは、Codexが操作できる範囲を区切る仕組みです。画面が開いていても、その作業環境の準備でエラーが出ていれば、依頼が進まないことがあります。まず設定画面やエラーに、何の準備が必要と書かれているか確認します。

会社のPCでは、組織の設定が優先される場合があります。権限を広げれば必ず直るわけではなく、必要な準備や許可を管理者に確認する場面もあります。エラーの記録には、Windows側かWSL側か、選んだ作業フォルダも添えると状況を伝えやすくなります。

新しいチャットで、ファイルを変えない小さな依頼を試す

特定のチャットだけ止まる場合は、進行中の処理と変更済みファイルを確認してから、新しいチャットで短い依頼を試します。公式の対処にも、小さく絞った依頼で新しいチャットを始める方法があります。

たとえば練習用フォルダで「このフォルダのファイル名だけ確認してください。変更・削除・送信はしないでください」と頼みます。返答があれば、大きな依頼や特定のチャットとの差を調べる材料になります。返答がない場合は、待っている表示やエラーを記録して、保管と相談の準備へ進んでください。

確認しても変わらない場合は、データを残してから次の手段を考えます。

再インストールやリセットの前に、必要なデータを残そう

再インストールと設定のリセットは、同じ操作ではありません。アプリやCLIを入れ直しても設定が残る場合があり、設定を消すと履歴や自作の仕組みに影響することもあります。対象の手順で何が変わるかを読み、必要なデータを保管してから判断します。

作業ファイルがアプリの外に保存されている場合も、保存先を実際に確認します。アプリを入れ直す操作と、作業フォルダを消す操作は分けて考えましょう。

削除を伴う作業へ進む場合は、Codexをアンインストールする前に残すデータと手順を確認してから進めましょう。

設定・Skills・作業ファイルの保存場所を控える

Windows版は通常、個人のCodexデータに%USERPROFILE%\.codexを使います。WSL側のCLIは初期状態でLinux側のホームを使うため、同じ保存先とは限りません。保存先を変えている場合もあるので、普段の環境に合わせて確認します。

SkillsはCodexへ作業手順を教えるファイルです。自作のものや自分で編集した設定は、読み取れる形で別の場所へ保管します。ただし、.codexを丸ごと他人へ渡す方法は避けてください。認証情報はauth.jsonやOSの認証保管機能に保存されることがあり、パスワードと同じように扱います。

直前の設定変更があれば、変更した箇所だけ確認する

起動しなくなる直前にconfig.tomlを編集したなら、保存していた元の設定と比べます。心当たりのある変更を確認する方が、フォルダ全体を削除するより元の状態を追いやすくなります。設定エラーが表示される場合は、指摘された行とファイルを控えてください。

Codex設定ファイルの優先順位によると、個人の~/.codex/config.tomlだけでなく、信頼済みプロジェクトの.codex/config.tomlなども読みます。個人設定だけ直しても、別の層に設定が残ることがあります。ここでは一括削除ではなく、変更した範囲を確認します。

解決しないときに相談する情報をまとめる

相談には、OS、アプリ・CLI・拡張のどれか、分かる範囲の版、止まった操作、エラー文、直前に変えたこと、試した内容と結果を添えます。版を調べるためにアプリが開けない場合は、その事情も書けば大丈夫です。

仮の相談メモなら「Windowsでアプリを起動すると窓は出るが白いまま。更新後から発生。通常終了とPC再起動では変化なし」のように整理できます。CLIの場合は起動するコマンドの場所も手掛かりです。公式の報告先へログを共有する前に、認証情報や仕事の機密が含まれていないか確認してください。

最後に、今の症状から選ぶ一歩と、起動できた後の確認を整理します。

まとめ｜自分の症状に合う確認を1つから始めよう

Codexが起動しないときは、入口と止まった段階を整理すると、確認する場所を選びやすくなります。試した結果が変わらないなら、設定削除を重ねず、保管と相談へ進めます。まずは今の状態を、具体的な一文で書いてみてください。

• 入口を特定する：アプリ・CLI・VS Codeで見る場所が違います。
• 症状を記録する：窓が出ないのか、ログインや依頼の後なのかを分けます。
• 確認は一つずつ：変わった点が分かるよう、結果をメモします。
• 削除前に保管する：作業ファイル・自作Skills・設定を確認します。

起動できたら、いきなり元の大きな仕事へ戻る前に、練習用フォルダで読み取りだけの短い依頼を試します。画面が開くことと、必要な作業ができることの両方を確認するためです。

起動できた後は、Codexの初期設定で確認する作業フォルダと権限を見直し、読み取りだけの依頼から再開すると確認しやすくなります。

一度で原因が見つからなくても、症状と結果が残れば次の確認につながります。今の画面に合う一歩を、自分のペースで試してみてください。

一問一答（Codexが起動しないとき）

👉 使う入口と止まる段階を分け、設定を消す前に症状とデータを確認しましょう。

Codexが起動しないとき、最初に何を確認すればいい？

アプリ・CLI・VS Codeのどれを使っているかと、どの段階で止まるかを確認します。窓が出ない場合、ログインで止まる場合、依頼後に止まる場合を分け、症状に合う確認を一つずつ進めてください。

WindowsではWSLやNode.jsを入れないとCodexが開かない？

Windows版のエージェントは初期状態でWindows側を使うため、WSLは一律の必須条件ではありません。Node.jsなどの開発道具を、アプリの窓が出ない問題の必須対処と決めつけず、CLIの導入方式や作業内容に合わせて確認します。

白い画面や読み込みが続いたら、すぐ再インストールしていい？

先に、止まったタイミング、エラー文、通信、アプリを開き直した結果を確認します。再インストールを検討するときは、その手順で変わるデータと、残したい設定や作業ファイルを確かめてください。

Codexのリセットと再インストールは同じ？

同じ操作ではありません。再インストールはプログラムの入れ直し、設定のリセットは設定を初期状態へ戻す操作です。手順や環境によって残るデータが異なるので、削除対象を先に確認します。

Codexが直らないとき、どの情報を添えて相談すればいい？

OS、使う入口、分かる範囲の版、止まった操作、エラー文、直前の変更、試した内容と結果を添えます。認証情報や仕事の機密は相談文や共有ログに含めないでください。