Codex「Selected model is at capacity」の対処法と待ち時間

Codexの容量エラーと利用枠の使い切りを区別し、クライアントの更新、別モデルのテスト、特定アカウントで続く障害の切り分けを進めます。Retry-Afterの変更を理解し、回数を限定した再試行と別課金の代替APIで、長時間の処理やCIの作業結果を保ちます。

目次
Codex「Selected model is at capacity」の対処法と待ち時間

CodexのSelected model is at capacity. Please try a different model.は、処理容量に関するエラーであり、利用枠を使い切った証拠ではありません。CLI、デスクトップアプリ、IDE拡張機能で開発作業を進めていて、このエラーで手が止まった場合は、該当するクライアントを更新し、別の利用可能なモデルを試してください。Codexがサーバーの指示に従って再試行を待っている場合は、新しいリクエストを送る前に、その待機を終わらせてください。

処理容量の問題と利用上限をどう見分けますか?

CodexはこのメッセージをServerOverloadedに分類します。APIエラーの変換処理では、server_is_overloadedをこのエラーに対応付けています。一方、利用上限を表す別の型UsageLimitReachedは、クライアントに渡すプロトコルではUsageLimitExceededになります。

エラー定義にはPolicyCapacityUnavailableもあります。表示されるメッセージはPolicy-restricted capacity is unavailable. Please try again later.です。容量エラーと同じ再試行方針を使いますが、別のエラーです。どちらのメッセージも、それだけでアカウントが利用停止されたとは判断できません。

利用状況ダッシュボードで利用枠の残量を確認してください。実際のエラーが利用枠の使い切りを示す場合は、Codexの利用上限とリセットのガイドに従います。容量エラーを調べる際に、利用枠の追加購入から始める必要はありません。

最初に何を試しますか?

エラーが起きたクライアントを更新します

2026-11-17時点で、OpenAIのCodex CLIの最新安定版は0.169.0です。古いバージョンを使っている場合は、再試行の挙動を調べる前に更新してください。

npmでインストールしたCLIでは、次のコマンドをBashで実行します。

codex --version
npm install -g @openai/codex
codex --version

最後のコマンドは、インストールされたバージョンを再度表示します。更新後のバージョンになっていることを、この出力で確認してください。別の方法でインストールした場合は、該当する公式の更新手順に従ってください。Remote SSHを使っている場合は、手元の端末だけでなく、実際に処理を実行するリモートホスト側のCLIのバージョンも確認します。

デスクトップアプリやIDE拡張機能でエラーが起きた場合は、そのクライアントを別途更新して再起動してください。組織がデスクトップアプリの更新を管理している場合は、管理者が承認した配布手順が必要なこともあります。CLI、アプリ、拡張機能の比較で、どのインターフェースを確認すべきか整理できます。

別の利用可能なモデルを試すか、再試行を待ちます

CLIで/modelを使い、一覧にある別のモデルを選びます。続けて、コマンドリファレンスの説明どおり、/statusで選択結果を確認してください。中断した作業に戻る前に、Reply with OK.のような短いリクエストを送ります。

応答が完了すれば、そのリクエストでは選択したモデルと接続先が動作したと確認できます。元のモデルが復旧したことまでは確認できません。複数のモデルで失敗する場合は、モデルを次々に切り替えるのをやめ、後述のアカウント確認に進んでください。

クライアントがすでに再試行中なら、サーバーが指定した時間だけ待ちます。同じリクエストを何度も最初から実行したり、並列で重複実行したりしないでください。OpenAIの稼働状況ページで障害情報も確認します。ただし、そこに表示される情報は、複数のプランやモデルを含む全体の稼働状況です。それだけで、特定のアカウントでも利用できるとは判断できません。

待機後にエラーが再発した場合は、すぐに/feedbackで報告してください。サポートへの問い合わせに備え、発生時刻、選択したモデル、クライアントのバージョン、発行された報告IDを保存します。

処理容量が回復するまで、どの接続方法を使いますか?

待ち時間が作業の期限に収まるなら、現在の接続方法を維持します。ローカル作業で代替手段が必要な場合は、別課金のAPI経由での利用を検討してください。

選択肢必要なものと課金選ぶ条件
待って再試行する現在のアカウントとアクセス権を使います。新しい課金設定は不要です。サーバーが待ち時間を指定した場合は従います。現在のモデルを使う必要があり、待機できる場合です。
別のモデルを選ぶアカウントとワークスペースで利用でき、/modelに表示されるモデルが必要です。現在のアクセス条件は引き続き適用されます。短いテストが成功し、代替モデルが作業に対応できる場合です。
OpenAI APIAPIキー、APIの課金設定、対応する国または地域からのアクセスが必要です。ローカルのCodex利用にはAPIのトークン料金が適用されます。サブスクリプションではなく、従量課金で直接利用したい場合です。
BetterToken API自分のBetterTokenアカウント、APIキー、コンソールに表示される支払い方法で入金した残高が必要です。文書に記載されたCodexのカスタムプロバイダー設定はResponsesを使います。料金はモデルのトークン課金ルールに従います。従量課金のAPIゲートウェイを使いたく、実際の作業に使う前に設定とテストができる場合です。

APIの課金は、ChatGPTサブスクリプションの利用枠とは別です。APIへの切り替えは別の課金経路を使うことであり、そのサブスクリプションの利用枠を補充する操作ではありません。代替手段に入金する前に、予定する処理量をBetterToken APIの現在の料金と照らし合わせてください。

これらのAPIの選択肢は、ローカルでCodexを使う場合のものです。OpenAIの認証ドキュメントによると、Codex CloudにはChatGPTでのサインインが必要です。ローカルのプロバイダー変更によって、実行中のクラウドタスクも移行するとは考えないでください。

設定はCodexのカスタムプロバイダー接続ガイドに従ってください。リポジトリの未完了タスクを引き継がせる前に、選んだエンドポイントへ短いリクエストを送り、動作を確認します。

OpenAIは何を変更し、なぜ待ち時間が延びるのですか?

報告された改善は、ターン(応答処理の一区切り)が容量エラーで終わる回数が減ったというものです。待機せずに処理を受けられるという保証ではありません。

Tiboの11月16日の投稿で、@thsottiauxは、繰り返し発生していたエラーをチームが修正できたかもしれないと述べました。添付のグラフは、容量エラーで終わったターンがその日に少なくとも一度あった、日間アクティブユーザーの割合を示しています。対象期間は2026年10月15日から11月12日までのUTCで、割合は**10月19日の6.82%から11月12日の0.085%**へ下がっています。全リクエストのうち何%が失敗したかを示す数値ではありません。

グラフには、再試行のタイミングを伝えるRetry-Afterに関する六つの変更が記されています。10月15日には、WebSocketの再試行を修正したデスクトップ版が公開されました。10月22日には通常の過負荷に待ち時間が追加され、10月23日にはサービス階層の過負荷に再試行時刻が追加されました。

10月24日には、Codexが再試行と停止の指示を転送するようになりました。10月30日にはNO_MORE_RETRYに待ち時間が追加されました。11月6日の変更では、WebSocketエラーでもその待ち時間を保持するようになりました。

現在のソースコードは、ServerOverloaded、PolicyCapacityUnavailable、RetryLimitにRetryPolicy::ServerDirectedを割り当てています。公開済みの0.169.0のコードも、これらのエラーに対してサーバー指定の待ち時間を使います。サーバーから再試行の指示が渡されている場合、リクエストは即座に終了する代わりに、指定された時間を待ってから再び試行できます。

そのため、ターンを終了させるエラーが減る一方で、待ち時間が延びることはあり得ます。このグラフは、95%のターンが完了するまでの時間であるp95を測定していません。作業全体が完了したかどうかも示していません。

Codexの再試行処理には、試行回数の上限も残っています。サーバーの指示は待機時間を制御しますが、無制限の再試行や最終的な成功を約束するものではありません。

一つのアカウントだけで失敗が続く場合はどうしますか?

アカウントと認証の状態を調べてください。ただし、アカウントへの制限が原因だと断定しないことが大切です。

2026-11-17時点で、issue #60767はまだクローズされていません。報告者のxiaogu12138は、利用枠が残っているPlusアカウントで、CLIとVS Code Remote SSHの両方が失敗すると説明しています。同じサーバー上の別のPlusアカウントは動作したとのことです。

報告には、自動再試行まで約314–317 seconds(秒)の待ち時間があったと記されています。その後の401 Unauthorized応答と、別のtoken_revokedエラーにも触れています。ただし、これらの認証エラーが容量エラーの原因だったとは確認されていません。調査したログからも、問題のアカウントに属する記録かどうかは独立に確認できていません。

同じ原因だと決めつけず、この事例を手掛かりに証拠を整理してください。

  1. 比較条件をそろえます。 アカウントとワークスペース、クライアントのバージョン、モデル、ホスト、タイムゾーン付きの発生時刻を非公開で記録します。CLIと拡張機能で同じ短いプロンプトを試してください。権限のある同僚は、自分のアカウントで別途テストできますが、認証情報を交換してはいけません。
  2. 認証の問題を示す証拠がある場合だけ、サインインをやり直します。 保存済みのChatGPTログインで401やtoken_revokedが出た場合は、codex logout、続けてcodex loginを実行します。その後、同じ短いリクエストを再送してください。容量エラーの表示だけを理由に、認証ファイルを削除する必要はありません。
  3. 繰り返す障害はサポートに問い合わせます。 再び失敗した直後に/feedbackを実行します。報告ID、再現手順、再試行の待ち時間、取得できたリクエストIDをOpenAIサポートへ送ってください。

認証情報、認証ファイル、非公開リポジトリの内容をGitHubのissueに公開しないでください。一度の再試行成功も判断材料になりますが、断続的な問題では、繰り返し発生した際の時刻が必要です。

長時間の処理を容量エラーで無駄にしないには?

タスクを、結果を確認できる区切りに分け、ターンが失敗したときも作業状態を保存します。デプロイ、支払いなど、外部に影響を与える処理は、無条件に繰り返すループに含めないでください。

次のBashの例は、読み取り専用で診断を実行し、イベントを記録してCLIの終了コードを保存します。この診断は、そのジョブのために用意した、専用のリポジトリ作業コピーで実行してください。

umask 077
status=0
codex exec --json --sandbox read-only \
  "Inspect the repository and report the next unfinished step. Do not edit files." \
  >codex-events.jsonl 2>codex-stderr.log || status=$?
printf '%s\n' "$status" >codex-exit-code.txt
exit "$status"

ステップが失敗してもこれらのファイルを保持するよう、CIを設定してください。非対話モードは、thread.started、turn.completed、turn.failed、errorイベントを出力します。後続の処理は、プロセスが正常に終了し、ターンの完了を確認できた場合にだけ進めてください。さらに、そのタスクに固有の検証が成功していることも条件にします。

作業コピーと、Codexの非公開のセッション保存領域も保持してください。コマンドが出力したイベントログは、再開に使う保存済みセッションそのものではありません。イベントログだけを残しても、セッションの保存領域の代わりにはなりません。再開する予定のジョブでは--ephemeralを使わないでください。また、認証情報を含むCodexのホームディレクトリ全体を、公開の成果物としてアップロードしてはいけません。

再試行の待機が終わるか、根本の問題が解消したら、記録したセッションを再開します。単に最後に動いたジョブを選ばないでください。jqがインストールされている環境で、元の作業コピーから次のBashコマンドを実行します。

session_id=$(jq -ers \
  '[.[] | select(.type == "thread.started") | .thread_id] | first // empty' \
  codex-events.jsonl) &&
codex exec --sandbox read-only resume "$session_id" \
  "Inspect the existing work and report the next unfinished step. Do not edit files."

ジョブの実行基盤には、実際の経過時間に基づく期限と、回復処理の試行回数の上限を設定します。一時的な障害と判断した場合だけ再試行し、サーバーが待機時間を指定していれば従ってください。認証、権限、利用枠の使い切りに関するエラーでは、同じ処理を繰り返さず停止します。

期限までに作業を終えるために別のプロバイダーへ切り替える場合は、保存したチェックポイントを出発点にします。すでに完了した作業と、まだ残っている検証内容を説明した引き継ぎ情報も渡してください。続行前に既存のdiffを確認し、代替プロバイダーが完了済みの外部操作を繰り返さないようにしてください。

LLM ワークフローを最適化しませんか?

単一 API でモデルを接続し、キーと AI コストを管理できます。

無料で始める