Codexが使えない・動かない時の対処法|エラー別に解決
Codexを使おうとしたら「コマンドが見つからない」「サインインできない」「急に使えなくなった」といったトラブルに遭遇することがあります。この記事では、Codexが動かないときによくある症状を7つに分類し、原因と対処法を解説します。まずは「まず試すこと」を確認し、それでも解決しなければ当てはまる症状の見出しを探してみてください。
この記事の要点
- Codexが動かないときは、まずアップデート・再起動・
codex --versionでのバージョン確認を試します。- 利用制限は数時間単位でリセットされる上限と週単位でリセットされる上限の組み合わせで管理されています。
- OpenAIは2026年6月12日、保存したリセットを好きなタイミングで使える「Saved Rate Limit Resets」機能をGo・Plus・Pro・Businessプラン向けに導入しました。
- 保存したリセットは購入・譲渡・売買できず、付与から30日以内に使わないと失効します。
- 2026年8月25日にはPlusプラン向けに5時間ごとの利用上限が復活し、8月21日には備えとして「Banked Reset」という使用量リセット権が有料ユーザー全員に配布されました(2026年8月時点)。
- Windowsではサンドボックス機能が発展途上のため、より安定した動作を求める場合はWSL2上での利用が案内されています。
- デスクトップアプリの長時間タスクでのログ肥大化・クラッシュや、モバイルアプリのセッション読み込みエラーも利用者から報告されています(2026年8月時点)。
次のような症状に心当たりがあれば、該当する見出しから先にご覧ください。
- codexコマンドが実行できない → 症状①「command not found: codex」と表示される
- サインインではじかれる → 症状②「403 Forbidden」でサインインできない
- 利用上限のメッセージが出る → 症状③「You’ve hit your usage limit.」と表示される
- Windowsで動作がおかしい → 症状④Windowsで「Sandbox setup error」が出る・動かない
- コマンドがブロックされる・毎回確認が出る → 症状⑤「command failed; retry without sandbox」と表示される
- デスクトップアプリが重い・落ちる → 症状⑥デスクトップアプリが反応しなくなる・クラッシュする
- スマホアプリでセッションが開けない → 症状⑦「Codex connection was invalidated」と表示される(モバイルアプリ)
まず試すこと
個別の症状を調べる前に、次の3点を確認しておくと解決が早くなります。
- 最新版へのアップデート: Codexは頻繁に更新されており、既知の不具合が新しいバージョンで修正されていることがよくあります。インストール方法や更新コマンドは「Codex CLIのインストール手順」で解説しています。
- アプリ・ターミナルの再起動: 認証情報やPATHの読み込みが更新されず、古い状態のまま動作していることがあります。再起動するだけで解消するケースは意外と多いです。
- バージョン確認: 手元の環境でどのバージョンが動いているかを確認します。極端に古い場合は、まずアップデートしてから以降の対処法を確認してください。
codex --version
codex-cli 0.x.x
症状①: 「command not found: 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 Forbidden」でサインインできない
ログインしようとして403 Forbiddenや401 Unauthorizedが表示される場合、いくつかの原因が考えられます。
- ChatGPTアカウントの状態: 対応したChatGPTアカウントでのサインインが必要です。組織管理下のアカウントでは、管理者側の設定でCodexの利用が許可されていないと同様のエラーになります。心当たりがある場合は管理者に確認してください。
- プランが対応していない: 利用しているプランがCodexに対応していない可能性があります。対応状況は変更されやすいため、公式サイトで最新情報を確認してください。
- 非対話環境でのサインイン: CI環境やSSH接続先などブラウザを直接開けない環境では、デバイスコードを使ったサインイン方法が用意されています。表示される案内に従ってコードを入力してください。
認証を含めた基本的な起動・操作の流れは「Codex CLIの使い方」でも触れているので、あわせて確認してみてください。
症状③: 「You’ve hit your usage limit.」と表示される
しばらく使っているとYou've hit your usage limit.と表示され、それ以上リクエストを送れなくなることがあります。なお429 Too Many Requestsやexceeded retry limitが出る場合は原因が異なるため、「Codexの429エラーの原因と対処法」を確認してください。
- Codexの利用枠は、数時間単位でリセットされる上限と、週単位でリセットされる上限の組み合わせで管理されています。上限に達した場合は、次のリセットまで待つのが基本の対処法です。
- プランによって上限の大きさは異なり、料金体系も変更されやすいため、正確な数値は公式サイトの料金ページで確認してください。プランによっては追加クレジットの購入で利用を継続できます。
- 現在の利用状況やリセットまでの残り時間は、セッション中にステータス確認用のコマンドで表示できます。頻繁に上限に達する場合は、タスクを小分けにする、非対話実行(
codex exec)で無駄なやり取りを減らすといった工夫も有効です。 - 利用上限に達したあとにProプランを再契約しても、上限がすぐにはリセットされないという事例が海外コミュニティで報告されています。断定はできませんが、まずは時間の経過とともに解消しないか様子を見つつ、課金画面で契約状態(プラン・支払い)が正しく反映されているかを確認し、それでも改善しない場合はOpenAIのサポート窓口に問い合わせるとよいでしょう。
X(旧Twitter)などでは「使用量リセットはお金で買える」という誤情報が広がっていますが、これは正確ではありません。OpenAIは2026年6月12日、保存しておいたレート制限リセットを好きなタイミングで使える「Saved Rate Limit Resets」機能を、Go・Plus・Pro・Businessプランの対象ユーザー向けに導入しました。対象者にはまず無料で1回分のリセットが付与され、Plus・Proユーザーはさらに友人をCodexに招待し、招待した相手が最初のメッセージを送信すると双方に追加のリセットが1回ずつ付与される仕組みです(招待の上限や実施期間はキャンペーンごとに異なるため、プロフィールメニューに表示される招待ダイアログで最新の条件を確認してください)。保存したリセットは購入・譲渡・売買することはできず、付与されてから30日以内に使わないと失効します。使う際はプロフィールメニューの利用状況(「1 reset available」のような表示)から選択でき、フルのリセットを1回使うと5時間・週次の両方の利用枠が同時にリセットされる点には注意してください(週次のリセット日もそこから約7日後に繰り下がります)。
また2026年8月25日には、一時的に緩和されていたPlusプラン向けの5時間ごとの利用上限が復活しました。Codexリードのティボ・ソティオー(Tibo Sottiaux)氏が8月24日にX(旧Twitter)で明らかにしたもので、計算リソースの平準化が理由とされています。5時間の上限は週次の上限を置き換えるものではなく両方が併存する形になるため、実質的に二重の上限がかかることになります。Pro($100/$200)プランについては「今後数ヶ月」は5時間上限の対象外とされています。日本語圏のXでも、復活直後の8月26日〜27日にかけて戸惑いや不満の声が数十件規模で見られました。あわせて2026年8月21日には、有料ユーザー全員に「Banked Reset」と呼ばれる使用量リセット権が1回分配布されています。上限を使い切った後に手動で発動して利用枠をリセットできるもので、上記のSaved Rate Limit Resetsと近い性質の、週次の上限に対する保険となる仕組みです。なお、以前は利用上限に到達したあとも無料トークンで長時間タスクを完走できる仕組みが一部で使われていましたが、悪用ツールの公開を機に撤去されており、現在は上限に達するとタスクがそこで停止する仕様になっています。いずれも2026年8月時点の情報のため、正式な適用条件は今後のアップデートで変更される可能性があります。
なお5時間上限の復活への反発を受け、2026年8月末にはCodexリードが有料ユーザー全員の利用上限をリセットしたうえ、ハーネス側の修正(compaction・メモリ管理・サブエージェント関連)により「同じ上限内でより多くの作業をこなせる」と説明しています。ただしこれは効率改善であり、上限自体を恒久的に引き上げたわけではありません。詳しくは「Codexの429エラーの原因と対処法」で解説しています。
症状④: Windowsで「Sandbox setup error」が出る・動かない
Windows環境では、macOSやLinuxと比べて発生しやすい問題がいくつかあります。
- Codexのサンドボックス機能は、Windowsでの対応が発展途上の位置づけとされています。
Sandbox setup errorやwindows sandbox failedといったメッセージとともに、サンドボックス関連のヘルパープロセスが起動できずに失敗することがGitHub Issuesでも報告されています。 - より安定した動作を求める場合は、WSL(Windows Subsystem for Linux)上でCodexを使う方法が公式に案内されています。WSL2の導入手順は「CodexをWindowsで使う方法」で解説しています。WSL上のLinux環境であれば、Linux版と同様の挙動が期待できます。プロジェクトをWindows側ではなくWSLのファイルシステム上に置くと、コマンド実行の失敗が改善することもあります。
- リモートのWindows環境にSSH接続してCodexを使おうとすると、失敗することがあります。Codex側の接続処理がUnix系シェルを前提にしているため、接続先が素のOpenSSH+PowerShell環境だとブートストラップ処理が途中で失敗するのが原因です。接続先のWindows側にWSLを導入し、WSL経由でSSH接続する構成に切り替えると回避できたという報告があります。WSLの導入手順は「CodexをWindowsで使う方法」で解説しています。
- Windows向けの挙動は今後のアップデートで変わりやすい部分です。公式サイトの最新情報もあわせて確認してください。
症状⑤: 「command failed; retry without sandbox」と表示される
command failed; retry without sandboxと表示され、サンドボックスの外で同じコマンドを再実行するか確認を求められることがあります。「毎回確認が出て作業が止まる」といった相談もよくあります。
- Codexはファイル編集やコマンド実行の範囲を「承認モード」で管理しています。読み取り専用に近いモードのままだと、簡単な操作でも都度確認が求められます。作業内容に応じて切り替えると、確認の頻度を調整できます。
- サンドボックスは実行環境自体を隔離し、ファイルシステムやネットワークへのアクセスを制限する仕組みです。承認モードを緩めていてもサンドボックスの制限でコマンドが失敗することがあり、ネットワークアクセスが必要な操作(
network_access)のエラーはこれが原因のことがあります。 - 承認モードやサンドボックスの切り替え方法は「Codex CLIの使い方」で解説しています。
- このほか2026年8月時点では、モデルにGPT-5.6 Lunaを指定した構成で、サブエージェントへの指示が拒否されるという報告もコミュニティで挙がっています。承認モードやサンドボックスの設定を見直しても解消しない場合は、モデルを一時的に切り替えて挙動が変わるか確認してみてください。モデルの切り替え方法は「Codexのモデル選択と切り替え方法」で解説しています。
症状⑥: デスクトップアプリが反応しなくなる・クラッシュする
長時間スレッドを動かし続けたデスクトップアプリが、途中から反応しなくなったり、突然クラッシュしたりするという利用者からの報告があります。海外のGitHub Issueでは、会話ログを記録するローカルのSQLiteデータベースが短時間で1GB超に膨れ上がりアプリのメモリ使用量も1GB前後に達した事例や、クラッシュ後の再起動でツール実行の子プロセス管理が壊れ、わずか数分でログがギガバイト単位で書き込まれ続けた事例が報告されています。
- 2026年8月時点で公式の恒久対策は示されていませんが、報告されている回避策として、長時間スレッドを適度な区切りで終了し新しいスレッドを開始する、動作が重くなったらアプリを完全に終了して再起動する、といった対処が挙げられています。
- 2026年8月時点では、Mac環境でアプリのメモリ使用量が時間とともに膨らみ、最終的にクラッシュしたという独立した報告も複数見られます。この場合も、スレッドを区切って新しく始める・アプリを定期的に再起動するといった上記の回避策が当面の対処になります。
- ログファイルの保存場所は後述の「ログ・詳細情報の確認方法」を参照してください。ログが異常に肥大化している場合は、アプリを終了したうえで古いログを削除すると改善することがあります(セッション自体を消すと会話履歴も失われるため、削除前にバックアップを取ることをおすすめします)。
- 同様の症状に遭遇した場合は、既存のGitHub Issueに情報を追記するか、新しく報告すると改善が進みやすくなります。
症状⑦: 「Codex connection was invalidated」と表示される(モバイルアプリ)
ChatGPTモバイルアプリ内のCodexでも、セッションの読み込みや通信に関するトラブルの報告があります。実行中のタスクを開こうとすると会話が読み込めずCodex connection was invalidatedというエラーが表示されるケースや、デスクトップ側のアプリが起動しているにもかかわらずモバイル側で「オフライン」と表示されたまま再接続操作が反応しないケースが報告されています。
- 明確な恒久対処は確立されていませんが、報告では対象スレッドを一度閉じて開き直す、デスクトップアプリ側を再起動する、モバイルアプリ自体を再起動するといった操作で復旧したケースがあるようです。
- 頻繁に発生する場合は、モバイルからの状況確認をあきらめてデスクトップアプリ側で直接進捗を確認する運用に切り替えるのも一案です。今後のアップデートで改善される可能性があるため、公式のリリースノートも確認してください。
ログ・詳細情報の確認方法
原因が特定しにくいときは、ログを確認すると手がかりが見つかることがあります。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の使い方完全ガイド」もあわせてご覧ください。Claude Codeで同様の症状が出た場合は「Claude Codeが動かない時の対処法」も参考にしてください。