Codex のよくあるエラーと解決方法

1. 進捗を保存し、別のモデルに切り替えるか時間をおいて再試行し、OpenAI のサービス状況を確認します。
2. 古いスレッドだけ失敗する場合は引き継ぎメモで新規作成します。全モデルで続く場合は /feedback で時刻・バージョン・エラー種別を送ります。

/model

1. 現在のアカウント、workspace、利用状況ページの5時間・週間枠の回復時刻を確認します。
2. 枠が残っている場合は進捗を保存し、正しいアカウントで再ログインします。不一致が続く場合は個人情報を隠した画像と時刻を記録します。

API Key は ChatGPT の Codex 枠ではなく OpenAI Platform の課金と制限を使います。独自 provider の規則も確認してください。

codex login status

codex logout
codex login

1. ログイン方式を確認します。ChatGPT 利用者はまず再認証し、dummy だけを理由に API Key を作成する必要はありません。
2. 独自 provider や API Key の場合は提供元の認証設定を確認します。dummy はローカルの仮値の場合もあります。

codex login status

codex logout
codex login

1. ログイン状態と送信先 provider を確認し、ChatGPT ログインか API Key かを確かめます。
2. ChatGPT 利用者は進捗を保存して再ログインします。API Key 利用者はキーの状態・組織・接続先を確認します。

API Key は ChatGPT の Codex 枠ではなく OpenAI Platform の課金と制限を使います。独自 provider の規則も確認してください。

codex login status

codex logout
codex login

1. Doctor で VPN・プロキシ・DNS・ファイアウォール・独自 CA を確認し、スマートフォンのテザリングと比較します。
2. 同じアカウント・ネットワークで CLI と Desktop を比較します。両方失敗する場合はサービス状況と独自 provider を確認します。

codex doctor --summary

1. Doctor を実行して別のネットワークと比較し、プロキシやファイアウォールが WSS を許可しているか確認します。
2. 現在のネットワークだけ失敗する場合は DNS・証明書・IPv4/IPv6 経路を調べます。IPv6 の恒久的な無効化を標準対処にしません。

codex doctor --summary

1. 実際に有効なユーザー設定の openai_base_url、model_provider、provider の base_url を確認します。
2. 接続先と待受プロセスが必要か確認します。設定をバックアップし、古い上書きを修正して再起動します。共有前にキーや非公開 URL を除去してください。

printenv CODEX_HOME

$env:CODEX_HOME

1. 保存した引き継ぎメモで新規スレッドを開始し、リポジトリの状態を確認してから未完了の作業を続けます。
2. 段階ごとに docs/codex-handoff.md を更新し、ツール出力を短くして、継続的なルールを AGENTS.md に保存します。

1. 同じログ付近の server_overloaded、context_window_exceeded、接続エラーを探し、それぞれの対処を確認します。
2. クライアントを更新します。古いスレッドが動かない場合は /compact を繰り返さず、リポジトリとメモから新規スレッドで再開します。

1. /permissions と実際の作業ディレクトリを確認し、対象ファイルが書き込み可能範囲にあるか確かめます。
2. チャットは正常でも依存関係のインストールや curl が失敗する場合、コマンドの network_access を確認し、必要な権限のみ変更します。

/permissions

1. リポジトリのルート、worktree、Git の状態を確認し、失敗したパスが Git メタデータか確かめます。
2. 編集とテスト後、該当 Git 操作に許可された承認を使うか、自分の端末でコミットします。ロック削除では権限エラーは直りません。

git rev-parse --show-toplevel
git status --short
git worktree list

1. IDE・Git クライアント・端末で実行中の Git 操作を確認し、まず完了を待ちます。
2. Git プロセスがなく、残留ロックだと確認してから該当ファイルを手動で処理します。.git 全体は削除しません。

git rev-parse --show-toplevel
git status --short
git worktree list

1. MCP サーバーの有効状態・ツール一覧・認証状態を確認します。OAuth サーバーは mcp login を再試行できます。
2. 続く場合は環境変数・プロセス・サーバーログを確認してからプロトコルを調べます。Codex 本体と MCP のログインは別です。

codex mcp list

codex mcp login SERVER_NAME

1. /status、CODEX_HOME、CLI 引数、選択中の profile を確認します。プロジェクト設定は信頼済みの場合のみ読み込まれます。
2. CLI → プロジェクト → profile → ユーザー → 管理／システム → 既定値の順に確認し、provider・認証がプロジェクトで上書き可能かも調べます。

printenv CODEX_HOME

$env:CODEX_HOME

1. 全体設定と作業ディレクトリまでの AGENTS.md／AGENTS.override.md を確認します。既定の結合上限は 32 KiB です。
2. 変更後は新しいセッションで読み込まれたルールを要約させ、作業ディレクトリと CODEX_HOME を確認します。

printenv CODEX_HOME

$env:CODEX_HOME

1. バージョンと全コマンドパスを比較し、npm・Homebrew・standalone が重複していないか確認します。
2. 主に使うインストールを特定して更新します。npm EACCES はディレクトリ所有者を確認し、安易に sudo で再インストールしません。

codex --version
command -v codex
type -a codex

codex --version
Get-Command codex -All
where.exe codex

1. 該当クライアントを完全終了して開き直し、更新後に新規スレッドで試します。
2. CLI との比較結果・バージョン・時刻を記録します。Windows 拡張が無応答ならネイティブランタイムも確認します。

codex doctor --summary

1. サンドボックス起動失敗時は Codex を再起動し、公式手順で elevated／unelevated モードと .sandbox/sandbox.log を確認します。
2. 拡張の無応答や DLL 不足は C++ Build Tools と x64 Redistributable を確認します。.sandbox-secrets は共有しません。

codex doctor --summary

1. Setup は依存関係のインストールで通信できます。Agent のインターネットは既定で無効なため、環境設定で必要に応じて許可します。
2. Secrets は setup のみです。通常の export は別 shell に残りません。非機密変数は環境設定へ置き、secret をリポジトリに保存しません。