Codex エラー索引：15 症状と検証済みの修正
再現できた Codex エラーを、症状ではなく本当の原因と修正ページに対応づけた索引。app-server os error 3、リソース読み込み失敗、401、利用上限、サンドボックス。
Ofox 
TL;DR：Codex のエラーはたいてい分類を間違えられています。メッセージが名指しするのは症状であって原因ではないので、本当の問題が Windows ストア版のインストールパスや bubblewrap の入れ忘れなのに、午後いっぱい API キーを差し替えて過ごすことになります。このページはその索引です。再現できた 15 の失敗を、実際に壊れている箇所と、検証済みの修正が載っているページに対応づけました。まずバージョン、次にあなたのエラー文字列。
Last updated 2026-08-31。本ページのバージョン番号と issue の状態は、同日に npm・GitHub・OpenAI 公式ドキュメントから読み取ったものです。
修正に入る前に何を確認すべきか？
この一覧で最大の 3 系統は、修正済みビルドが判明している退行です。壊れたビルドに乗っているなら、修正は更新そのもので、このページの他の内容は当てはまりません。
codex --version # CLI
npm view @openai/codex version # 最新公開版：0.151.0エディタ拡張は独自のバージョンを持ち、リソース読み込み失敗の系統で効くのはそちらです。問題は 26.803.41515 で入り、修正は 26.810.41047 で入りました。シンボリックリンク配下での AGENTS.md 読み込みは CLI v0.138 で修正済みです。先に更新、再現はその後。
どの Codex を動かしているか？
同じ名前で 5 つの入口が出荷されており、壊れる場所が違います。ここを取り違えることが、修正がきかない最も多い理由です。
| 入口 | 実体 | エラーの出どころ |
|---|---|---|
| CLI | @openai/codex、Rust バイナリ + npm ラッパー | PATH、~/.codex/config.toml、サンドボックス、認証 |
| エディタ拡張 | VS Code とその派生の Codex パネル | リソース読み込み、app-server のハンドシェイク、native host |
| Chrome 拡張 | ブラウザ操作、ChatGPT デスクトップアプリから導入 | native host のバージョン、権限、ブラウザ対応 |
| ChatGPT モバイル | スマホアプリ内の Codex | ローカルには何もない。リモートセッション |
| デスクトップアプリ | 上記をホストする ChatGPT デスクトップ本体 | モデルピッカー、model_catalog_json |
エラーにリソース・native host・app-server が出てきたら、CLI も併用していても拡張側の領域です。config.toml・サンドボックス・provider が出てきたら CLI の領域です。
あなたのエラーはどれか？
以下の文字列はすべて表示されるとおりに引用しています。自分のものを見つけて、再現手順と修正はリンク先へ。
なぜ Codex がインストールできない・起動しないのか？
| エラーメッセージ | 実際に壊れているもの | 修正 |
|---|---|---|
zsh: command not found: codex | npm が PATH 上にない場所に入れた。NVM、Volta、独自の npm prefix -g が原因のことが多い | codex: command not found |
failed to start codex app-server (os error 3) | 渡されたパスを Windows が解決できない。多くは WindowsApps\ 配下の Microsoft Store 版 | Windows で app-server が起動しない |
manifest entry is missing required path nodePath/resourcesPath | ランチャーが読んだインストールマニフェストの記録済みパスがもう存在しない | 同じページの Fix 6 |
unable to locate the codex cli binary | 拡張が、入れていない CLI か別ユーザー配下の CLI を探している | Windows で app-server が起動しない |
Codex could not start the extension. Codex couldn't load its resources. | 26.803.41515 の退行。1 つのメッセージの裏に 5 通りの壊れ方がある | リソース読み込み失敗 |
codex chrome native host is out of date | ブラウザ拡張とデスクトップアプリのビルドが噛み合っていない | リソース読み込み失敗 |
Windows は別立てで触れておきます。WSL2 が必須という説明がいまだに多いからです。必須ではありません。プロジェクトの README は Windows 用の一行を用意しています。
Run the following on Windows to install Codex CLI:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
このインストーラーは Node をまったく必要としません。WSL2 は前提ではなく選択肢ですが、両者はサンドボックスが異なります。ネイティブか WSL2 か にトレードオフが、インストールガイド に Node 不要のスタンドアロンインストーラーを含む全経路があります。
なぜ Codex が認証を通らないのか？
| エラーメッセージ | 実際に壊れているもの | 修正 |
|---|---|---|
Missing bearer or basic authentication in header | キーがまったく送られていない。環境変数が Codex の実行 shell に届いていないことが多い | Codex CLI 401：検証済みの 9 原因 |
Incorrect API key provided | キーは送られて拒否された。別の問題であり修正も別 | Codex CLI 401：検証済みの 9 原因 |
| リクエストが固まり、接続でタイムアウトする | Codex が発見できない PAC/WPAD 企業プロキシ、または CA 証明書の不足 | 企業プロキシ配下の Codex |
401 と読まれる失敗は 9 種類あり、そのうち文字どおり 401 なのは一部だけです。ステータスコードではなく本文を読んでください。
なぜ Codex の利用枠が尽きたのか？
| エラーメッセージ | 実際に壊れているもの | 修正 |
|---|---|---|
You've hit your usage limit | サブスクのウィンドウが閉じた。リセットは時計のルールではなくサーバー側の resetsAt | Codex のリセット：上限が空くタイミング |
従量課金キーでの 429 Too Many Requests | API 側のレート制限または支出上限。サブスクのウィンドウとは別系統 | 従量 API で支出に上限をかける |
Codex 関連の検索で最も量が多いのがこれで、ネット上の説明の多くは間違っています。決まった待ち日数などなく、ウィンドウはちょうど 2 つ、獲得したリセットは待つ日付ではなく引き換えられるクレジットです。従量課金キーの 429 はまったく別の事象で、各社でこのコードが何を意味するかは LLM API エラーコード にまとめました。
なぜ Codex がコマンド実行やファイル読み取りを拒むのか？
| エラーメッセージ | 実際に壊れているもの | 修正 |
|---|---|---|
command failed; retry without sandbox | Linux では bubblewrap が無いか必要なパスを開けない。どの OS でも sandbox_mode がタスクより厳しい可能性 | command failed; retry without sandbox |
| AGENTS.md が無視される。エラーは一切出ない | ワークスペースのパスがシンボリックリンクを経由している。v0.138 より前の CLI | シンボリックリンク配下で AGENTS.md が読まれない |
サンドボックス側には知っておく価値のある罠があります。Codex が出す bubblewrap の警告は、その照合文字列が一部のディストリビューションには存在せず、サンドボックスが壊れていても無言で通ることがあります。修正ページに 5 ディストリビューションでの実測があります。
なぜモデルや provider が出てこないのか？
| エラーメッセージ | 実際に壊れているもの | 修正 |
|---|---|---|
| Codex デスクトップのピッカーにカスタムモデルが出ない | model_catalog_json の不具合。モデルをインラインで指定するとピッカーに出す情報が無い | デスクトップにカスタムモデルが出ない |
| 未登録のモデルが黙って 258K コンテキストで頭打ちになる | カタログに無いモデルには既定のコンテキスト長が適用される | Codex CLI で Qwen 3.8 Max を使う |
OpenAI 以外の provider に向けるのは裏技ではなく正規の経路ですが、設定できる場所が 3 つあり挙動が違います。config.toml リファレンス が設定面の全体像、[model_providers] ブロック が複数 provider を並存させる書き方、カスタムエンドポイント設定 が 1 つで済ませる 2 変数版です。よく引っかかる制約が 1 つ。カスタム provider で Codex は wire_api = "responses" しか受け付けないので、chat completions しか持たないゲートウェイは他をどう設定しても動きません。
原因ではないことがほとんどなのは何か？
時間を最も食うので、名指ししておきます。
API キー。 差し替えで直るのは Incorrect API key provided です。Missing bearer or basic authentication in header には効きません（キーが shell から出ていない）。429 にも効きません（キーは通っている）。
再インストール。 codex が PATH に無いなら、再インストールは今あるのと同じ場所に戻すだけです。代わりにプレフィックスを探してください。npm prefix -g を実行し、<npm-prefix>/bin が $PATH にあるか確認します。
open のままの GitHub issue。 issue が open であることは、機能が無いことの証拠になりません。Codex の issue #22638 は Chromium 系ブラウザ対応の要望で今も open ですが、ドキュメントは対応ブラウザを 5 つ挙げており機能は出荷済みです。トラッカーより先に製品を確認してください。
ゼロから Codex を用意するには？
まだ何も壊れておらず、修理ではなく設定が目的なら：
- インストールする。npm、Homebrew、スタンドアロンインストーラー、生バイナリのいずれでも。
config.tomlを書く。どちらかを緩める前に、3 つの承認モードと 3 つのサンドボックス段階を理解しておきます。- 使いたいモデルに向ける。OpenAI のモデルでも、OpenAI 互換ゲートウェイ経由の別モデルでも。
- 作業ループを覚える。AGENTS.md、プランモード、worktree、そして最初の一週間を無駄にする 7 つの失敗。
他ツールからの移行なら、Claude Code からの移行 が 12 の設定面すべてを対応づけ、唯一の行き止まりを名指ししています。移行ではなく選定中なら、Claude Code / Codex / Cursor / DeepSeek TUI 比較 と OpenCode と Codex CLI が正面からの比較です。
ブラウザ・モバイル・デスクトップの入口は？
Chrome 拡張 は現在 Chrome、Edge、Brave、Opera、Vivaldi に対応し、ChatGPT デスクトップアプリから導入します。iPhone と Android の Codex はリモートセッションなので、PATH やサンドボックスの話は当てはまりません。Goal Mode とリモートのコンピュータ操作 は長時間動く自律モードで、独自の安全モデルを持ちます。
参考情報源
よくある質問
- なぜ Windows と macOS で Codex のエラーがまったく違うのですか？
- Windows 側の失敗はほぼすべて Codex 本体ではなくインストール位置の問題だからです。Microsoft Store 版はバイナリを C:\Program Files\WindowsApps\ 配下にサンドボックス付きで置くため、ランチャーが読むマニフェストのパスが解決できず os error 3 や manifest entry is missing required path になります。macOS と Linux の失敗は PATH、Node のバージョン管理ツール、Linux サンドボックスに集中します。
- Codex の不具合を調べるとき、最初に確認すべきものは何ですか？
- バージョンです。CLI は
codex --version、エディタ拡張はエディタ側で拡張のバージョンを見ます。2026 年に最も多く報告されたエラーのいくつかは、修正済みビルドが判明している退行です。リソース読み込み失敗の系統は 26.803.41515 で発生し 26.810.41047 で修正、シンボリックリンク配下のワークスペースで AGENTS.md が読まれない問題は CLI v0.138 で修正されました。この系統は更新するだけで直ります。 - Codex の 401 は必ず認証の問題ですか？
- いいえ。401 に見える失敗は 9 種類あり、修正方法の異なる 3 グループに分かれます。キーがまったく送られていない（
Missing bearer or basic authentication in header）、キーは送られたが拒否された（Incorrect API key provided）、キー自体は正しいが shell の export で末尾に改行が付いている、の 3 つです。ステータスコードは同じで、見分けるのは本文です。 - Codex の週次上限に達したら、決まった日数を待つしかないのですか？
- いいえ。リセットはアカウントに紐づくサーバー側の
resetsAtタイムスタンプで、自分で計算できる時計のルールではありません。ウィンドウは主・副の 2 つだけです。実際のタイムスタンプは推測せずに読み取れますし、獲得済みのリセットは前倒しで引き換えられます。 - 自分が使っているのはどの Codex ですか？
- 入口は 5 つあり、壊れる場所がそれぞれ違います。CLI（npm の
@openai/codex、現在 0.151.0）、エディタ拡張、ChatGPT デスクトップアプリが駆動する Chrome 拡張、ChatGPT モバイルアプリ内の Codex、そしてデスクトップアプリ本体です。リソースや native host が出てくるエラーは拡張の問題、config.tomlやサンドボックスが出てくるエラーは CLI の問題です。
