MENU

VS CodeでCodexが使えないときの確認方法|ログイン・接続・権限を切り分ける

VS CodeでCodexが動かないときは、まず「画面が開かない」「ログインが完了しない」「送信後に返答がない」「特定の作業だけ止まる」のどこで止まったかを分けます。すべてを接続エラーとして扱うと、不要な再インストールや設定変更が増えてしまいます。

最初に、止まった時刻、表示された文言、VS CodeとCodex拡張のバージョンを控えてください。その記録を残してから、以下の順で確認します。まだ導入していない場合は、先にVS CodeへのCodex導入・設定手順で入口を確認できます。

目次

どこまで動くかで、次に見る場所を決める

止まる場所 最初の確認 次の判断
Codexの画面を開けない 公式拡張が有効か、今のウィンドウで使えるか 拡張の問題と通信の問題を分ける
ブラウザで認証後、VS Codeに戻れない 選んだアカウント、ローカルかリモートか 認証の往復が完了しているか調べる
送信しても応答が来ない 稼働状況、利用上限、ネットワークの表示 共通障害か、この環境だけの問題か調べる
説明はできるが編集やコマンドが止まる 対象フォルダと権限、実行内容 通信復旧ではなく操作の許可が必要か判断する
普通のチャットは動くが、案件の作業だけ失敗する 作業に必要なPHPやテスト環境 Codexへの接続と開発環境の不足を分ける

たとえば「コードの説明は返ってくるが、テストが失敗する」なら、少なくとも会話は成立しています。PHPの実行ファイルや必要な拡張がない問題を、ログインし直すだけで解決しようとしないことが大切です。

Codexの画面が開かない場合

拡張機能の一覧で、提供元がOpenAIのCodexを探します。インストール済みでも、そのウィンドウで無効になっていないかを確認してください。VS Codeでは拡張を全体またはワークスペースごとに無効化できるため、別のプロジェクトで使えたことだけでは判断できません。S2

アイコンだけが見当たらない場合は、コマンドパレットから Codex: Open Codex Sidebar を実行します。Macのコマンドパレットは Command + Shift + P、Windowsは Ctrl + Shift + P で開けます。これは公式に案内されている入口です。S1S3

それでも開けなければ、未保存のファイルを保存し、VS Codeを終了して開き直します。改善しない場合は、拡張の詳細に表示される版と、問題が始まった時期を確認します。版を戻したり、設定ファイルを一括削除したりする前に、該当する版の公式案内や不具合情報を調べてください。別の人に有効だった操作が、同じ原因への対処とは限りません。

ログイン画面から先に進まない場合

まず、ChatGPTでのログインとAPIキーでのログインのどちらを使っているかを確認します。公式のIDE拡張には両方の方法があります。APIキーによる利用はOpenAI Platform側の課金となるため、ChatGPT契約で使いたい人の一時的な接続対策として選ぶ方法ではありません。S4

ChatGPTでログインする場合は、ブラウザで選んだアカウントと、利用したいワークスペースを確認します。仕事用と個人用を使い分けているなら、ブラウザの別アカウントで認証を進めていないかも見てください。利用できる機能や上限は契約・管理者設定などによって異なります。

ローカルのVS Code、Remote SSH、コンテナ、WSLでは、画面を操作する端末とCodexが動く場所が一致しない場合があります。「ブラウザでは完了した」という結果だけで、拡張側も認証済みと判断しないようにします。リモート環境の認証方法は、その接続方式に合う公式手順を確認してください。CLI向けのコマンドを、IDE拡張の操作と混ぜない方が調査しやすくなります。

ログインをやり直す場合も、表示されたアカウントとエラーを記録した後に行います。認証用ファイルの中身をコピーしたり、ログインURLを他人に送ったりする必要はありません。

ログイン後、送信しても応答が来ない場合

先にOpenAIの稼働状況を確認し、問題が発生した時刻の情報と照合します。全体の表示が正常でも、個々の接続が正常だと保証されるわけではありません。逆に障害が公表されている間は、ローカル設定を次々に変更すると復旧後の状態を分かりにくくします。

利用上限についての案内が画面に出ているなら、通信エラーと分けて扱います。待機時間や追加利用の条件は、表示されている案内で確認してください。無制限に再送したり、別の課金方式へ切り替えたりする前に、どの制限に当たったかを確かめます。

会社のネットワークでだけ失敗する場合は、プロキシや証明書の制約も調査対象です。OpenAI公式資料には、企業の独自CAを使うネットワーク向けの設定が案内されています。証明書の検証を無効にするのではなく、必要な接続先や証明書を管理者へ確認します。S4

状況の確認用には、顧客コードを含まない短い質問を一度だけ送ってみます。これが成功し、特定の作業だけ止まるなら、その作業の権限や実行環境へ確認対象を移します。

読めるのに変更できない場合は、許可の範囲を調べる

Codexは、ファイルへのアクセスやコマンド実行について、設定された境界の中で動きます。読み取りだけを許す設定、作業フォルダに書き込める設定、組織による制限などが関係します。許可待ちや拒否は、接続できていない状態とは別です。S5

変更してよいフォルダが正しいか、止まった操作が何かを確認します。「テストを実行する」だけに見えても、テストがデータベースを初期化したり外部サービスへ接続したりすることがあります。理由が分からないまま広い権限へ変更せず、その操作に必要な範囲を調べます。

Windowsでは、ネイティブ環境で作業しているのか、WSL内で作業しているのかも記録します。WSLを使う場合は、VS CodeがWSL接続のウィンドウになっていることと、統合ターミナルの環境を確認します。Windows側にPHPがあることと、WSL側でPHPが使えることは同じではありません。S6

解決しないときに残す情報

相談時は、再現のために必要な情報を絞ると、原因を伝えやすくなります。

  • 問題が起きた日時とタイムゾーン
  • OS、VS Code、Codex拡張のバージョン
  • ローカル・WSL・Remote SSH・コンテナのどれか
  • ログイン前か、送信後か、コマンド実行時か
  • 短い質問への応答の有無と、変更した設定
  • 秘密情報を除いたエラー文

ログを共有する前には、トークン、認証URL、顧客名、端末上の個人名を含むパス、ソースコードを確認してください。画面全体の共有が必要とは限りません。

Codexへの接続が戻っても、コードの正しさは別に確認する必要があります。改修を再開する際は、PHP・WordPress改修で変更範囲と検証を決める方法も参考に、止まっていた作業だけを小さく再開します。

確認日:2026年11月17日。公式資料の操作・仕様を照合しています。Mac・Windows・WSLそれぞれで障害を再現した検証結果ではありません。画面名や対応条件は更新で変わるため、使っている版の案内も確認してください。

出典

  1. https://learn.chatgpt.com/docs/codex/ide OpenAI「Codex IDE extension」(確認日: 2026-11-17) ↩1
  2. https://code.visualstudio.com/docs/configure/extensions/extension-marketplace Microsoft「Extension Marketplace」(確認日: 2026-11-17) ↩1
  3. https://code.visualstudio.com/docs/editing/getting-started/userinterface Microsoft「User interface」(確認日: 2026-11-17) ↩1
  4. https://learn.chatgpt.com/docs/auth OpenAI「Authentication」(確認日: 2026-11-17) ↩1 ↩2
  5. https://learn.chatgpt.com/docs/permissions OpenAI「Permissions」(確認日: 2026-11-17) ↩1
  6. https://learn.chatgpt.com/docs/windows/wsl OpenAI「WSL」(確認日: 2026-11-17) ↩1
よかったらシェアしてね!
  • URLをコピーしました!
目次