Codexが動かない時の対処法｜エラー原因別まとめ

Codexを使おうとしたら「コマンドが見つからない」「サインインできない」「急に使えなくなった」といったトラブルに遭遇することがあります。この記事では、Codexが動かないときによくある症状を5つに分類し、原因と対処法を解説します。まずは「まず試すこと」を確認し、それでも解決しなければ当てはまる症状の見出しを探してみてください。

まず試すこと

個別の症状を調べる前に、次の3点を確認しておくと解決が早くなります。

• 最新版へのアップデート: Codexは頻繁に更新されており、既知の不具合が新しいバージョンで修正されていることがよくあります。インストール方法や更新コマンドは「Codex CLIのインストール手順」で解説しています。
• アプリ・ターミナルの再起動: 認証情報やPATHの読み込みが更新されず、古い状態のまま動作していることがあります。再起動するだけで解消するケースは意外と多いです。
• バージョン確認: 手元の環境でどのバージョンが動いているかを確認します。極端に古い場合は、まずアップデートしてから以降の対処法を確認してください。

codex --version

codex-cli 0.x.x

症状①: codexコマンドが見つからない

command not found: codex のようなエラーが出る場合、多くはnpmのグローバルインストール先にPATHが通っていないことが原因です。

• npmのグローバルインストールディレクトリを確認し、そのパスがシェルのPATHに含まれているか確認します。含まれていなければ設定ファイル(.zshrcや.bashrcなど)にパスを追記して再読み込みします。
• Node.jsのバージョンが古いとインストール自体が完了しないことがあります。比較的新しいNode.jsが前提のため、古い環境では事前にアップデートしてから入れ直してください。
• zshで補完機能を使う場合、command not found: compdef というエラーが出ることがあります。.zshrcにautoload -Uz compinit && compinitをCodexの補完設定より前に追加し、シェルを再起動すると解消します。

インストール手順を見直したい場合は「Codex CLIのインストール手順」を最初から確認するのが近道です。

症状②: サインイン・認証エラー

ログインしようとして403 Unauthorizedのようなエラーが表示される場合、いくつかの原因が考えられます。

• ChatGPTアカウントの状態: 対応したChatGPTアカウントでのサインインが必要です。組織管理下のアカウントでは、管理者側の設定でCodexの利用が許可されていないと同様のエラーになります。心当たりがある場合は管理者に確認してください。
• プランが対応していない: 利用しているプランがCodexに対応していない可能性があります。対応状況は変更されやすいため、公式サイトで最新情報を確認してください。
• 非対話環境でのサインイン: CI環境やSSH接続先などブラウザを直接開けない環境では、デバイスコードを使ったサインイン方法が用意されています。表示される案内に従ってコードを入力してください。

認証を含めた基本的な起動・操作の流れは「Codex CLIの使い方」でも触れているので、あわせて確認してみてください。

症状③: 使用制限に達した

しばらく使っていると「利用上限に達しました」と表示され、それ以上リクエストを送れなくなることがあります。

• Codexの利用枠は、数時間単位でリセットされる上限と、週単位でリセットされる上限の組み合わせで管理されています。上限に達した場合は、次のリセットまで待つのが基本の対処法です。
• プランによって上限の大きさは異なり、料金体系も変更されやすいため、正確な数値は公式サイトの料金ページで確認してください。プランによっては追加クレジットの購入で利用を継続できます。
• 現在の利用状況やリセットまでの残り時間は、セッション中にステータス確認用のコマンドで表示できます。頻繁に上限に達する場合は、タスクを小分けにする、非対話実行(codex exec)で無駄なやり取りを減らすといった工夫も有効です。

症状④: Windowsで動かない

Windows環境では、macOSやLinuxと比べて発生しやすい問題がいくつかあります。

• Codexのサンドボックス機能は、Windowsでの対応が発展途上の位置づけとされています。ファイル編集を伴う操作で、サンドボックス関連のヘルパープロセスが起動できずに失敗することがあります。
• より安定した動作を求める場合は、WSL(Windows Subsystem for Linux)上でCodexを使う方法が公式に案内されています。WSL上のLinux環境であれば、Linux版と同様の挙動が期待できます。プロジェクトをWindows側ではなくWSLのファイルシステム上に置くと、コマンド実行の失敗が改善することもあります。
• Windows向けの挙動は今後のアップデートで変わりやすい部分です。公式サイトの最新情報もあわせて確認してください。

症状⑤: サンドボックス・承認関連のつまずき

「コマンドがブロックされた」「毎回確認が出て作業が止まる」といった相談もよくあります。

• Codexはファイル編集やコマンド実行の範囲を「承認モード」で管理しています。読み取り専用に近いモードのままだと、簡単な操作でも都度確認が求められます。作業内容に応じて切り替えると、確認の頻度を調整できます。
• サンドボックスは実行環境自体を隔離し、ファイルシステムやネットワークへのアクセスを制限する仕組みです。承認モードを緩めていてもサンドボックスの制限でコマンドが失敗することがあり、ネットワークアクセスが必要な操作のエラーはこれが原因のことがあります。
• 承認モードやサンドボックスの切り替え方法は「Codex CLIの使い方」で解説しています。

ログ・詳細情報の確認方法

原因が特定しにくいときは、ログを確認すると手がかりが見つかることがあります。Codexはアプリのログとセッションの記録を別の場所に保存しており、macOSではアプリログが~/Library/Logs/com.openai.codex/以下に日付ごとのフォルダで保存されます。セッションのやり取りは$CODEX_HOME/sessions(既定では~/.codex/sessions)に記録されています。OSによって保存場所は異なるため、見つからない場合は公式ドキュメントで確認してください。エラー報告の際もログを添えると原因の特定がスムーズになります。

解決しないときの窓口

ここまでの対処法を試しても解決しない場合は、既に同じ症状が報告されていないかを確認します。CodexはGitHub上でオープンに開発されており、GitHub Issuesで既存の報告を検索できます。似た事例が見つからない場合は、再現手順やログを添えて新しくIssueを作成すると対応してもらいやすくなります。ちょっとした要望であれば、メッセージ入力欄で「/」から始まるフィードバック送信用のコマンドを使う方法もあります。

よくある質問

アップデートしたらエラーが増えた気がします。元のバージョンに戻せますか?

パッケージマネージャー経由でインストールしている場合、旧バージョンを指定して入れ直せば一時的にロールバックできます。ただし古いバージョンはサポート対象外になっていく可能性があるため、根本的にはGitHub Issuesで不具合の状況を確認し、最新版での修正を追うのがおすすめです。

エラーメッセージが英語で内容がよくわかりません。

翻訳ツールにかけるのも一つの方法ですが、まずはこの記事の症状別の見出しに近いキーワードがないか確認してください。多くの場合「command not found」「unauthorized」「rate limit」「sandbox」といった単語で症状を分類できます。

会社のアカウントで使っているのですが、個人アカウントと対処法は違いますか?

組織管理下のアカウントでは、管理者側の設定でCodexの利用範囲や承認モードの既定値が制限されていることがあります。個人アカウントと同じ手順で解決しない場合は、まず管理者に利用可否を確認してください。

まとめ

Codexが動かないときは、まずアップデートとバージョン確認で最新の状態にそろえ、「コマンドが見つからない」「サインインできない」「使用制限に達した」「Windowsで動かない」「サンドボックス・承認でブロックされる」のどれに近いかで切り分けると、原因にたどり着きやすくなります。それでも解決しない場合は、ログを確認したうえでGitHub Issuesを検索してみてください。基本的な使い方から見直したい方は「Codexの使い方完全ガイド」もあわせてご覧ください。