Ошибки Codex: 15 симптомов и проверенные решения
Воспроизведённые нами ошибки Codex с настоящей причиной и страницей решения: app-server os error 3, ресурсы, 401, лимит, песочница.
Ofox 
Кратко: большинство ошибок Codex разложены не по тем полкам. Сообщение называет симптом, а не причину, поэтому люди полдня меняют API-ключ, когда настоящая проблема — путь установки из Windows Store или недостающий пакет bubblewrap. Эта страница и есть указатель: 15 воспроизведённых нами сбоев, каждый сопоставлен с тем, что сломано на самом деле, и со страницей, где решение проверено. Сначала версия, потом ваша строка ошибки.
Last updated 2026-08-31. Номера версий и статусы issue на этой странице прочитаны в тот же день из npm, GitHub и официальной документации OpenAI.
Что проверить до начала любого ремонта?
Три крупнейших семейства ошибок в этом списке — регрессии с известной исправленной сборкой. Если вы на сломанной сборке, всё исправление сводится к обновлению, и остальная часть страницы к вам не относится.
codex --version # CLI
npm view @openai/codex version # последняя опубликованная: 0.151.0У расширения для редактора своя версия, и именно она важна для семейства «не удалось загрузить ресурсы»: поломка приехала в 26.803.41515, исправление — в 26.810.41047. Загрузку AGENTS.md через символические ссылки починили в CLI v0.138. Сначала обновление, потом воспроизведение.
Какой именно Codex у вас запущен?
Под одним именем выходит пять поверхностей, и ломаются они в разных местах. Ошибка на этом шаге — самая частая причина, почему решение не срабатывает.
| Поверхность | Что это | Откуда берутся её ошибки |
|---|---|---|
| CLI | @openai/codex, бинарник на Rust с обёрткой из npm | PATH, ~/.codex/config.toml, песочница, аутентификация |
| Расширение редактора | панель Codex в VS Code и его форках | загрузка ресурсов, рукопожатие с app-server, native host |
| Расширение Chrome | управление браузером, ставится из десктопного ChatGPT | версия native host, разрешения, поддержка браузера |
| Мобильный ChatGPT | Codex внутри приложения на телефоне | локально ничего нет, это удалённая сессия |
| Десктопное приложение | клиент ChatGPT, внутри которого живёт всё выше | выбор модели, model_catalog_json |
Если в ошибке фигурируют ресурсы, native host или app-server — это территория расширения, даже если вы параллельно пользуетесь CLI. Если config.toml, песочница или provider — это территория CLI.
Какая у вас ошибка Codex?
Каждая строка ниже приведена ровно в том виде, в каком она появляется. Найдите свою и переходите по ссылке за воспроизведением и решением.
Почему 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 не может разрешить переданный путь, чаще всего установку из Microsoft Store в WindowsApps\ | app-server не стартует на Windows |
manifest entry is missing required path nodePath/resourcesPath | лаунчер прочитал манифест установки, чьи записанные пути больше не существуют | та же страница, Fix 6 |
unable to locate the codex cli binary | расширение ищет CLI, который не устанавливали или который стоит под другим пользователем | app-server не стартует на Windows |
Codex could not start the extension. Codex couldn't load its resources. | регрессия 26.803.41515, за одним сообщением скрыто пять разных поломок | не удалось загрузить ресурсы |
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 | ключ вообще не отправлен, обычно переменная окружения не дошла до того shell, где работает Codex | 401 в Codex CLI: 9 проверенных причин |
Incorrect API key provided | ключ отправлен и отклонён — это другая проблема с другим решением | 401 в Codex CLI: 9 проверенных причин |
| запросы зависают и отваливаются по таймауту на соединении | корпоративный прокси PAC/WPAD, который Codex не обнаруживает, либо отсутствующий сертификат CA | Codex за корпоративным прокси |
Девять сбоев читаются пользователем как 401, и лишь часть из них действительно 401. Читайте тело ответа, а не код статуса.
Почему у Codex закончилась квота?
| Сообщение об ошибке | Что сломано на самом деле | Решение |
|---|---|---|
You've hit your usage limit | закрылось окно подписки; сброс — это серверная метка resetsAt, а не правило по часам | Сброс Codex: когда освобождается лимит |
429 Too Many Requests на тарифицируемом ключе | ограничение частоты или лимит расходов на стороне API — отдельная система от окна подписки | ограничить расходы через API с оплатой по факту |
Это самый массовый источник поисковых запросов про Codex, и большая часть советов в сети здесь ошибается. Фиксированного числа дней ожидания нет, окон ровно два, а заработанный сброс — это кредит, который активируют, а не дата, которую ждут. 429 на тарифицируемом ключе — вообще другое событие: что этот код значит у каждого провайдера, см. коды ошибок LLM API.
Почему Codex отказывается выполнять команды или читать файлы?
| Сообщение об ошибке | Что сломано на самом деле | Решение |
|---|---|---|
command failed; retry without sandbox | на Linux отсутствует bubblewrap или он не может открыть нужные пути; на любой ОС sandbox_mode может быть строже задачи | command failed; retry without sandbox |
| AGENTS.md игнорируется, ошибки нет вообще | путь рабочего каталога проходит через символическую ссылку, на сборках CLI до v0.138 | AGENTS.md не загружается через символические ссылки |
У истории с песочницей есть ловушка, о которой стоит знать: Codex печатает предупреждение про bubblewrap, а строка, по которой он его ищет, существует не в каждом дистрибутиве, так что сломанная песочница на части установок Linux падает молча. На странице с решением есть проверка на пяти дистрибутивах.
Почему ваша модель или provider не появляются?
| Сообщение об ошибке | Что сломано на самом деле | Решение |
|---|---|---|
| кастомные модели не видны в выборе моделей Codex Desktop | баг model_catalog_json: когда модель задана инлайн, списку нечего показывать | Codex Desktop не показывает кастомные модели |
| неизвестная модель молча упирается в 258K контекста | для моделей вне каталога Codex подставляет размер контекста по умолчанию | Qwen 3.8 Max в Codex CLI |
Направить Codex на provider, отличного от OpenAI, — поддерживаемый путь, а не хак, но настроить это можно в трёх местах, и ведут они себя по-разному. Справочник по config.toml — полная поверхность настроек. Блок [model_providers] — способ держать несколько провайдеров рядом. Руководство по кастомной точке входа — вариант на две переменные, если 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.
Открытый issue на GitHub. То, что issue всё ещё открыт, не означает, что функции нет. Issue Codex #22638 просит поддержку браузеров на Chromium и открыт до сих пор, тогда как документация перечисляет пять поддерживаемых браузеров, и функция уже вышла. Сначала смотрите на продукт, потом на трекер.
Как настроить Codex с нуля?
Если ничего ещё не сломалось и вы пришли настраивать, а не чинить:
- Установите его — через npm, Homebrew, автономный установщик или готовый бинарник.
- Напишите
config.tomlи разберитесь в трёх режимах подтверждения и трёх уровнях песочницы прежде, чем ослаблять любой из них. - Направьте его на нужную модель — на модель OpenAI или на что-то другое через OpenAI-совместимый шлюз.
- Освойте рабочий цикл: AGENTS.md, режим плана, worktree и семь ошибок, которые съедают первую неделю.
Если переходите с другого инструмента, миграция с Claude Code сопоставляет все 12 точек конфигурации и называет единственный тупик. Если пока выбираете, а не мигрируете, Claude Code против Codex, Cursor и DeepSeek TUI и OpenCode против Codex CLI — прямые сравнения.
А браузер, мобильный и десктоп?
Расширение Chrome теперь охватывает Chrome, Edge, Brave, Opera и Vivaldi и ставится из десктопного приложения ChatGPT. Codex на iPhone и Android — удалённая сессия, поэтому ничего из истории с PATH и песочницами там не применимо. Goal Mode и удалённое управление компьютером — режим длительной автономной работы со своей моделью безопасности.
Источники
Часто задаваемые вопросы
- Почему на Windows Codex падает с другой ошибкой, чем на macOS?
- Потому что почти все сбои на 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. В этих случаях всё исправление — это обновление. - Всегда ли 401 в Codex означает проблему с аутентификацией?
- Нет. Девять разных сбоев выглядят как 401, и они делятся на три группы с разными решениями: ключ вообще не был отправлен (
Missing bearer or basic authentication in header), ключ отправлен и отклонён (Incorrect API key provided), и ключ верный, но получил завершающий перевод строки при экспорте в shell. Код статуса один и тот же — различает их тело ответа. - Если исчерпан недельный лимит Codex, придётся ли ждать фиксированное число дней?
- Нет. Сброс — это серверная метка времени
resetsAt, привязанная к вашему аккаунту, а не правило по часам, которое можно вычислить; окон всего два, основное и дополнительное. Реальную метку можно прочитать, а не угадывать, а заработанный сброс можно активировать досрочно. - Каким Codex я вообще пользуюсь?
- Их пять, и ломаются они в разных местах: CLI (
@openai/codexв npm, сейчас 0.151.0), расширение для редактора, расширение Chrome, которым управляет десктопное приложение ChatGPT, Codex внутри мобильного приложения ChatGPT и само десктопное приложение. Ошибка про ресурсы или native host — это расширение; ошибка проconfig.tomlили песочницу — это CLI.
