Failed to start codex app-server в Windows: 4 ошибки и что делать

У всех четырёх ошибок общий корень: настольное приложение не смогло запустить фоновый процесс codex.exe app-server или дождаться его ответа, а именно через этот процесс интерфейс работает с Codex. Причина почти всегда локальная, и её выдаёт точный текст сообщения:

• failed to start codex app-server: The system cannot find the path specified. (os error 3) — после автообновления в config.toml или в переменной CODEX_CLI_PATH остался путь к удалённой папке. Исправьте путь.
• Codex app-server manifest entry is missing required path nodePath (или resourcesPath) в боковой панели расширения — файл chrome-native-hosts-v2.json ссылается на старую версию. Запустите приложение, подождите 30–60 секунд, затем при необходимости поправьте пути.
• Codex app-server initialize handshake timed out — процесс не уложился в 30 секунд. Чаще всего мешают раздутый или повреждённый logs_2.sqlite, режим WSL или зависшие процессы.
• 0xC000001D (code=3221225501) — процессор получил недопустимую инструкцию. Если в «Просмотре событий» виновником указан ASProxy64.dll, уберите LSP-компонент Astrill VPN; если нет, локального исправления для настольной версии пока нет.

Перед любым шагом закройте приложение через значок в трее и сделайте копию папки %USERPROFILE%\.codex: в ней лежат история сессий и настройки, а сброс приложения через параметры Windows уже стоил одному пользователю локальных задач. По состоянию на 9 октября 2026 года OpenAI не назвала причину ни одного из четырёх сбоев и не указала версию с исправлением, поэтому всё ниже — обходные пути из отчётов пользователей с пометкой, сколько людей их подтвердили.

Четыре текста ошибки app-server: где видны и что сломано

С 9 июля 2026 года приложение Codex для Windows входит в настольное приложение ChatGPT: окна и диалоги называются ChatGPT, процесс — ChatGPT.exe, но пакет в системе по-прежнему OpenAI.Codex. Поэтому «Codex Desktop», «приложение Codex» и «ChatGPT failed to start» относятся к одной программе. Отдельный пакет ChatGPT Classic (OpenAI.ChatGPT-Desktop) app-server не содержит, и переустановка через общую ссылку «скачать ChatGPT» может поставить именно его (#32706).

По документации OpenAI, app-server — это интерфейс, через который Codex обслуживает полноценные клиенты вроде настольного приложения и расширения VS Code. Обмен идёт по JSON-RPC, по умолчанию через stdio, и каждое подключение начинается с запроса initialize. Любой обрыв этой цепочки и даёт строки из таблицы.

Если вашей строки в таблице нет, загляните в раздел о похожих ошибках ниже: у program not found, Unable to locate the Codex CLI binary или вечного логотипа другие причины.

Перед исправлением: выйдите из ChatGPT через трей и сохраните .codex

Закрытие окна не завершает приложение. В отчёте #39015 после закрытия окна оставались около десяти процессов, включая codex.exe с app-server, и они держали открытыми все базы данных. Приложение остаётся в области уведомлений и после закрытия последнего окна, так что выходите через значок в трее (пункт выхода в его меню) и закройте расширения Codex в редакторах кода.

Проверка, что ничего не осталось:

Get-Process ChatGPT, codex, node_repl -ErrorAction SilentlyContinue

Пустой вывод означает, что можно трогать файлы; если параллельно открыт Codex CLI в терминале, его codex тоже попадёт в список — завершите и его. Затем сделайте копию папки Codex:

$src = "$env:USERPROFILE\.codex"
$dst = "$env:USERPROFILE\codex-backup-$(Get-Date -Format yyyyMMdd-HHmm)"
Copy-Item $src $dst -Recurse

В %USERPROFILE%\.codex хранятся state_5.sqlite (индекс бесед), папка sessions с локальной историей, config.toml, auth.json, память и состояние плагинов. Переустановка приложения эту папку не трогает: она лежит вне пакета MSIX. История сессий может занимать десятки гигабайт — у одного пользователя Reddit было 64 файла на 22,24 ГБ, так что проверьте свободное место заранее.

Сотрудник поддержки OpenAI на форуме прямо пишет, что %USERPROFILE%\.codex лучше не удалять без резервной копии, потому что там конфигурация, данные входа и состояние сессий (тема 1379497). Сброс через «Параметры → Приложения → Дополнительные параметры → Сбросить» у одного пользователя удалил локальные задачи и разлогинил его (тема 1400979); «Исправить» безопаснее, но при os error 3 и 0xC000001D не помогает ни то, ни другое.

failed to start codex app-server (os error 3): устаревший путь после обновления

os error 3 — это код Windows ERROR_PATH_NOT_FOUND: программа пыталась запустить файл по пути, которого нет. Ошибка всплывает, когда Browser Use, встроенный браузер или плагин Chrome вызывает node_repl, а тот запускает codex app-server --listen stdio://. Вкладки при этом могут отображаться, но открыть страницу, снять DOM или сделать скриншот не получается (#19187, #20206, #20048).

Механизм восстановили сами пользователи (#26011, #28474). Приложение копирует вспомогательные программы из C:\Program Files\WindowsApps\OpenAI.Codex_...\app\resources\ в папки с хешем версии: %LOCALAPPDATA%\OpenAI\Codex\bin\<hash>\ и %LOCALAPPDATA%\OpenAI\Codex\runtimes\cua_node\<hash>\bin\. Пути к этим папкам записываются в нескольких местах:

• %USERPROFILE%\.codex\config.toml — command в секции [mcp_servers.node_repl] и CODEX_CLI_PATH в [mcp_servers.node_repl.env];
• пользовательская переменная среды CODEX_CLI_PATH;
• chrome-native-hosts-v2.json (поле codexCliPath).

Обновление удаляет старую папку с хешем, а записанные пути остаются. Первая же попытка запустить app-server по такому пути и даёт os error 3.

Найдите актуальные файлы и сравните с записанными путями

# Где сейчас лежат codex.exe и node_repl.exe
Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\bin" -Recurse -Include codex.exe, node_repl.exe |
  Select-Object FullName

# Что записано в переменной пользователя
[Environment]::GetEnvironmentVariable("CODEX_CLI_PATH", "User")

# Что записано в config.toml
Select-String -Path "$env:USERPROFILE\.codex\config.toml" -Pattern "node_repl|CODEX_CLI_PATH"

Каждый найденный в config.toml и переменной путь проверьте через Test-Path "<путь>". False — это и есть причина.

Исправьте config.toml и переменную CODEX_CLI_PATH

1. Выйдите из приложения через трей и скопируйте config.toml рядом, например в config.toml.bak.

2. В config.toml замените устаревшие пути на папку, где реально лежат файлы. Пишите пути в одинарных кавычках, как в отчёте #26011:

   toml

   [mcp_servers.node_repl]
   command = 'C:\Users\<имя>\AppData\Local\OpenAI\Codex\bin\<актуальный-hash>\node_repl.exe'
   
   [mcp_servers.node_repl.env]
   CODEX_CLI_PATH = 'C:\Users\<имя>\AppData\Local\OpenAI\Codex\bin\<актуальный-hash>\codex.exe'

   Путь Windows в двойных кавычках TOML читает как набор escape-последовательностей, и приложение может зависнуть при запуске с ошибкой missing escaped value (#37616). Одинарные кавычки или прямые слеши этого избегают.

3. Если пользовательская переменная CODEX_CLI_PATH указывает на несуществующий файл, удалите её: [Environment]::SetEnvironmentVariable("CODEX_CLI_PATH", $null, "User"). Направлять её на старую копию codex.exe рискованно: в #40700 так запускалась старая версия CLI, и позже ломались беседы.

4. Запустите приложение заново.

Это исправление подтвердили несколько пользователей. Признак успеха: Browser Use открывает страницу, а предупреждение о node_repl при старте не появляется. После следующего автообновления хеш может смениться, и проверку придётся повторить.

Если папки OpenAI\Codex\bin нет совсем

В сборках апреля–мая 2026 года папка %LOCALAPPDATA%\OpenAI\Codex\bin иногда не создавалась, а файлы лежали только в %LOCALAPPDATA%\Packages\OpenAI.Codex_2p2nqsd0c76g0\LocalCache\Local\OpenAI\Codex\bin. Несколько пользователей создавали на неё ссылку (junction) или копировали туда codex.exe, node.exe, node_repl.exe и остальные вспомогательные файлы (#19562). На чистой виртуальной машине это сменило ошибку на CreateProcessAsUserW failed: 5 из песочницы (#20661), а один пользователь на сборке 26.506 сообщил, что папка снова создаётся сама. На свежих сборках сначала проверьте, есть ли папка, и только потом думайте о ссылке.

Что не помогает при os error 3

По словам нескольких пользователей: «Исправить» и «Сбросить» в параметрах Windows, переустановка, перезагрузка, запуск от имени администратора и установка npm-версии CLI. Все эти действия не меняют записанные в профиле пути.

missing required path nodePath или resourcesPath в расширении Chrome

Сообщение Unable to start ChatGPT с Codex app-server manifest entry is missing required path nodePath появляется в боковой панели браузерного расширения ChatGPT (раньше называлось Codex for Chrome) в Chrome, Edge и Brave. Варианты с resourcesPath и codexCliPath устроены так же (#35705, #32706, #40357).

Слово «missing» сбивает с толку: поле в файле есть, но указанного в нём пути больше нет. Цепочка такая: расширение вызывает нативный хост com.openai.codexextension (манифест %LOCALAPPDATA%\OpenAI\extension\com.openai.codexextension.json), тот запускает extension-host.exe из кэша плагинов в %USERPROFILE%\.codex\plugins\cache\openai-bundled\chrome\latest\, а хост читает chrome-native-hosts-v2.json. Обновление удаляет старую среду cua_node\<hash> и старую папку пакета, а записи в этом файле не обновляет. Пользователи сообщали о повторных поломках после обновлений 3 и 8 октября 2026 года.

Порядок действий — от безопасного к ручному:

1. Откройте настольное приложение и подождите 30–60 секунд, затем повторите в расширении. Один-два пользователя отмечают, что расширение работает только при запущенном приложении.

2. Пройдите официальный список из справки по расширению: обновите приложение (если установлено несколько копий ChatGPT или Codex, обновите каждую или удалите лишние), перезапустите браузер, проверьте в «Settings → Computer Use», что рядом с браузером написано Manage, а не Install, работайте в том профиле браузера, где стоит расширение, начните новый чат, перезапустите приложение, а если не помогло — переустановите расширение через «Settings → Computer Use». Этот список не упоминает nodePath, но первые пункты дешёвые.

3. Попросите Codex в настольном приложении подключиться к Chrome («connect to Chrome»). У одного пользователя это пересоздало состояние.

4. Поправьте пути вручную (подтвердили несколько пользователей):

   powershell

   $m = "$env:LOCALAPPDATA\OpenAI\Codex\chrome-native-hosts-v2.json"
   Copy-Item $m "$m.bak"
   
   # Текущий пакет: к InstallLocation добавьте \app\resources
   Get-AppxPackage *Codex* | Select-Object Name, Version, InstallLocation
   
   # Среды Node, в которых node.exe ещё существует
   Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\runtimes\cua_node" -Directory |
     ForEach-Object { "{0}  {1}" -f $_.FullName, (Test-Path "$($_.FullName)\bin\node.exe") }

   В JSON-файле замените nodePath на ...\runtimes\cua_node\<hash>\bin\node.exe из живой среды, nodeModuleDirs — на ...\cua_node\<hash>\bin\node_modules, resourcesPath — на <InstallLocation>\app\resources пакета OpenAI.Codex (или OpenAI.CodexBeta, если вы на бете). В JSON обратный слеш удваивается: C:\\Users\\.... Закройте приложение и браузер, запустите сначала приложение, потом браузер (пошаговый отчёт в #35705).

Признак успеха: Test-Path возвращает True для всех трёх новых путей, а боковая панель открывает чат без «Unable to start ChatGPT».

Те же правки автоматизирует сторонний скрипт Repair-CodexChromeManifest.ps1 от пользователя CherryDT (gist): он делает копию файла и поддерживает -WhatIf для пробного прогона. Это не программа OpenAI, работу подтвердил один человек; прочитайте код перед запуском. Для запущенных случаев с битой ссылкой latest в кэше плагинов несколько пользователей восстанавливали кэш из app\resources\plugins пакета и пересобирали оба файла v2 (#42520) — это уже ручная хирургия, к которой стоит переходить последней.

Поддержка OpenAI отдельно просит не переустанавливать плагин раз за разом, не удалять его и не чистить кэш: приложение может просто показывать неверный статус уже установленного плагина (тема 1384864).

Codex app-server initialize handshake timed out: 30 секунд на запуск

Окно ChatGPT failed to start с текстом Codex app-server initialize handshake timed out и кнопками Check for Updates и Quit означает, что app-server не ответил на первый запрос initialize вовремя. Срок жёсткий: в логах из #39015 видно durationMs=30012 и причину initialize_handshake_timeout. В документации этого лимита нет, он виден только в логах. Обновление приложения тут обычно не помогает, хотя кнопка подталкивает именно к нему: процесс убивают на 30-й секунде, и следующий запуск повторяет ту же работу.

Причины в порядке проверки:

1. Огромный или повреждённый logs_2.sqlite. Это служебная база логов в %USERPROFILE%\.codex. У пользователей она дорастала до 6,7 ГБ (#27741), а в #39015 файл на 2,27 ГБ оказался повреждён: запуск занимал 32,1 секунды, и на 30-й процесс убивали. После того как файл отодвинули, окно открылось за 1,7 секунды. Бесед, памяти и настроек в этом файле нет. После выхода через трей:

$h = "$env:USERPROFILE\.codex"
$dst = "$h\logs-aside-$(Get-Date -Format yyyyMMdd-HHmm)"
New-Item -ItemType Directory $dst | Out-Null
Move-Item "$h\logs_2.sqlite*" $dst

Перемещайте logs_2.sqlite, logs_2.sqlite-wal и logs_2.sqlite-shm вместе, шаблон выше захватывает все три. При следующем запуске приложение создаст новую базу. state_5.sqlite на этом шаге не трогайте: это индекс бесед. Сотрудник OpenAI в #23917 написал, что новые сборки распознают повреждение и что команда работает над автоматическим восстановлением базы, но версию с ним не назвал.

2. Зависшие процессы держат базу состояния. Один пользователь сталкивался с этим больше десяти раз (#32160) и лечил так:

Get-Process *codex*, *chatgpt*, *node_repl*, *codex-computer-use* -ErrorAction SilentlyContinue |
  Stop-Process -Force

Команда завершит и отдельные сессии Codex CLI или расширения IDE, так что сохраните работу в них.

3. Агент работает в WSL. При включённом режиме WSL заполнение базы состояния через /mnt/c не укладывается в 30 секунд (#38345). Обходы от отдельных пользователей: выставить в config.toml

[desktop]
runCodexInWindowsSubsystemForLinux = false

или дать первому неудачному запуску поработать ещё около 40 секунд, а потом перезапустить. У отключения WSL есть цена: беседы, привязанные к WSL, станут недоступны (#39169). Переключение между нативным режимом и WSL есть и в настройках приложения, после него нужен перезапуск (документация).

4. Очень большая история сессий. В случае с Reddit перенос одного logs_2.sqlite* не помог, а помогло перемещение sessions, archived_sessions и state_5.sqlite* во временную папку после полной резервной копии. Двое комментаторов при этом нашли настоящую причину в переключателе WSL, поэтому проверьте пункт 3 раньше. Без state_5.sqlite беседы не видны в приложении, пока вы не вернёте файлы на место, поэтому только перемещать, не удалять.

5. Прокси. Одному пользователю помогла смена узла прокси (#29040); это единичный отчёт.

Признак успеха: окно появляется за несколько секунд, а в .codex возникает новый небольшой logs_2.sqlite.

Не путайте эту ошибку с timed out waiting for cloud config bundle after 15s: там Codex не успел загрузить управляемую конфигурацию рабочего пространства, и порядок проверки другой — он разобран в статье «Codex не загрузил cloud config bundle за 15 секунд: что проверить».

0xC000001D (code=3221225501): Astrill VPN или инструкции процессора

3221225501 — десятичная запись кода 0xC000001D, STATUS_ILLEGAL_INSTRUCTION: процесс codex.exe выполнил инструкцию, которую процессор не принимает. В интерфейсе это выглядит как ChatGPT failed to start. (code=3221225501, signal=null). Most recent error: Codex app-server websocket closed (code=3221225501) или как Codex app-server process is not available (#24408, #30884, #32675). Ни в одном из этих обсуждений сотрудники OpenAI не ответили.

Шаг 1: посмотрите «сбойный модуль» в журнале Windows

Откройте «Просмотр событий → Журналы Windows → Приложение» и найдите событие «Ошибка приложения» с codex.exe в момент падения. Нужна строка «Имя сбойного модуля» (Faulting module name). То же из PowerShell:

Get-WinEvent -FilterHashtable @{ LogName = 'Application'; Id = 1000 } -MaxEvents 30 |
  Where-Object Message -match 'codex' |
  Select-Object TimeCreated, Message | Format-List

Если сбойный модуль ASProxy64.dll: уберите LSP Astrill

ASProxy64.dll — компонент Winsock LSP из Astrill VPN, который внедряется в сетевые процессы, в том числе в codex.exe. Это самая подтверждённая причина для настольной версии: о ней писали многие пользователи с современными процессорами (Zen 5, Core Ultra, i7-14700KF), так что возраст процессора здесь ни при чём (#30884, #24408). Варианты, проверенные несколькими людьми:

1. В Astrill удерживайте Ctrl и откройте меню Help: появится скрытый пункт LSP Uninstall. Подтвердите и перезагрузите компьютер.
2. Либо в терминале администратора проверьте netsh winsock show catalog | findstr ASProxy, выполните netsh winsock reset и перезагрузитесь. Эта команда сбрасывает все LSP в системе, а не только Astrill.
3. Либо удалите Astrill.

Проверка: tasklist /m ASProxy64.dll не находит ни одного процесса, приложение запускается. Чтобы LSP не вернулся, один из пользователей советует пользоваться протоколами OpenWeb или WireGuard, которые его не устанавливают. Про другие VPN подтверждённых случаев нет: не удаляйте свой VPN, пока журнал не указал на его DLL. Тот же Astrill в #45597 вызывал цикл входа с «ChatGPT hit a snag».

Если сбойный модуль сам codex.exe: это базовый набор инструкций

Вторая известная причина — сборка codex.exe требует инструкций, которых у вашего процессора нет. Для npm-версии CLI 0.135.0 на Xeon поколения Haswell сотрудник OpenAI ответил «This will be fixed in the next release», а временным решением была версия 0.134.0 (#25367); к настольному приложению этот ответ не относится. Для codex.exe из расширения VS Code в открытом #17410 пользователи на Zen 3 и Raptor Lake видят HW capability requested: 0x200000 и сообщают, что работает только Linux-сборка в WSL2.

Какую именно инструкцию требуют текущие настольные сборки, публично не описано. По отчётам не помогают переустановка, повторная регистрация пакета, распространяемые пакеты Visual C++, удаление баз SQLite и чистая папка .codex (#30339). Здесь остаётся собрать данные (раздел ниже) и подписаться на issue; для CLI и расширения VS Code пользователи в таком случае переходят на Linux-сборку в WSL2.

Соседние коды падения

Похожие ошибки запуска Codex, которые лечатся по-другому

Для вечного логотипа точечная команда выглядит так (её запускают при открытом зависшем окне; завершать все codex.exe подряд нельзя — прервутся другие сессии):

Get-CimInstance Win32_Process |
  Where-Object { $_.Name -eq "codex.exe" -and $_.CommandLine -like "* app-server *" } |
  ForEach-Object { Stop-Process -Id $_.ProcessId -Force }

Ошибки после того, как сессия уже началась, — обрывы и повторные подключения — описаны в статье «Codex постоянно переподключается: сохраните задачу и найдите причину», а корпоративный прокси с подменой сертификата — в «Codex: как исправить self signed certificate in certificate chain».

Чего не делать: Reset, удаление .codex и «патчи» из комментариев

• Не удаляйте %USERPROFILE%\.codex. У одного пользователя это стёрло историю бесед (#49265), а при 0xC000001D не помогло вовсе (#30884). Если нужно убрать конкретный файл, перемещайте его после резервной копии. Для старой проблемы с вечной заставкой поддержка OpenAI советовала переименовать %APPDATA%\Codex в %APPDATA%\Codex.backup, а не удалять.
• Не начинайте со «Сбросить». Сброс приложения в параметрах Windows удаляет локальные данные пакета и выходит из учётной записи, а пути в профиле не исправляет. Remove-AppxPackage удаляет вместе с пакетом его логи и дампы сбоев, которые понадобятся для отчёта.
• Не оставляйте запуск от имени администратора как решение. По документации агент Codex наследует права приложения, то есть все его команды тоже будут выполняться с правами администратора. Для разовой проверки можно, для работы — нет.
• Не отключайте защиту Windows. Поддержка OpenAI на форуме прямо просит не отключать средства защиты в качестве обходного пути.
• Не скачивайте «исправленные» сборки и утилиты из комментариев. В одной из веток новый аккаунт выложил архив с «патчем», который другой участник опознал как шифровальщик. Там же ходят правка browser-client.mjs, отключающая проверку разрешённых сайтов, и неофициальная утилита «восстановления». OpenAI к ним отношения не имеет.

Что собрать для OpenAI, если ни одна ветка не помогла

Если исправление вашей ветки не сработало или журнал показывает сбой в самом codex.exe, дальше нужен отчёт в OpenAI. Перед ним соберите:

• версию приложения (в «Параметры → Приложения» или Get-AppxPackage *Codex* | Select-Object Name, Version) и номер сборки Windows (winver);
• точный текст ошибки и код выхода;
• логи приложения: %LOCALAPPDATA%\Packages\OpenAI.Codex_2p2nqsd0c76g0\LocalCache\Local\Codex\Logs\<год>\<месяц>\<день>\codex-desktop-*.log, а у старых сборок — %LOCALAPPDATA%\Codex\Logs;
• дампы сбоев из ...\LocalCache\Roaming\Codex\web\Codex\Crashpad\reports;
• событие «Ошибка приложения» из журнала Windows с именем сбойного модуля;
• для проблем с расширением — ID чата и отчёт через /feedback в приложении, как советует справка по расширению.

Логи могут содержать пути и имена проектов: просмотрите их перед публикацией в открытом issue. Подписаться на обновления удобно в основных обсуждениях: #19187 для os error 3, #35705 для nodePath, #39015 для тайм-аута handshake и #30884 для 0xC000001D. В журнале изменений с июля по октябрь 2026 года эти строки не упоминаются, так что о «версии с исправлением» пока можно узнать только из этих веток.

Частые вопросы о запуске Codex в Windows

Почему Codex не запускается после обновления?

Чаще всего обновление удаляет папку прежней версии, а пути к ней остаются в config.toml, переменной CODEX_CLI_PATH или chrome-native-hosts-v2.json. Это даёт os error 3 и nodePath/resourcesPath. Тайм-аут handshake сразу после обновления тоже встречается, но в подробном отчёте #39015 его причиной была база логов, повреждённая ещё до обновления. Точный текст сообщения показывает, какой файл проверять.

Как установить Codex не через Microsoft Store?

Настольное приложение распространяется только как пакет MSIX: через Microsoft Store (ID 9PLM9XGG6VKS, команда winget install --id 9PLM9XGG6VKS -s msstore) или как официальный подписанный MSIX из раздела о развёртывании в документации OpenAI. Установка через npm даёт только Codex CLI — она не восстановит приложение и не исправит ошибки app-server в нём.

Поможет ли запуск ChatGPT от имени администратора?

Для os error 3 несколько пользователей отметили, что нет. Кроме того, агент Codex получает те же права, что и приложение, поэтому постоянный запуск от администратора делает каждую команду агента привилегированной. Используйте его только как однократную проверку.

Это сбой на стороне OpenAI или у меня на компьютере?

Все четыре ошибки связаны с запуском локального процесса или чтением локальных файлов, поэтому страница статуса OpenAI их не объясняет, а исправления меняют файлы в вашем профиле. При этом первопричину — то, что обновления оставляют устаревшие пути, — может устранить только OpenAI, и на 9 октября 2026 года версии с исправлением нет.