Как вернуть боковую панель Codex в VS Code после ошибки “Codex could not start”
Исправьте ошибки VS Code “Codex could not start” и service worker: установите OpenAI.chatgpt 26.1007.21434 и закрепите эту версию, чтобы боковая панель Codex снова загружалась.
TL;DR: Для ошибки Codex в VS Code Codex could not start чаще всего сообщают такой обходной путь: установить OpenAI.chatgpt@26.1007.21434 вместо 26.1021.22027 и отключить автообновление этого расширения. Руководство основано на сообщениях пользователей и опубликованных логах в openai/codex#56691, а не на подтверждённой мейнтейнером первопричине.
Применимо к: расширению Codex для VS Code OpenAI.chatgpt, особенно 26.1021.22027 в VS Code 1.143.1 для Windows; похожие сообщения есть и от пользователей Linux. Последняя проверка: 2026-11-03.
| Что вы видите | Куда перейти |
|---|---|
Codex could not start / The extension could not start its user interface. | Codex could not start |
Could not register service worker / renderer_ready_timeout | Could not register service worker |
Codex could not start
Codex could not start
The extension could not start its user interface.
Codex показывает Codex could not start в VS Code, когда webview боковой панели Codex не удаётся инициализироваться; вероятный триггер, связанный с конкретной версией, — расширение OpenAI.chatgpt версии 26.1021.22027, потому что несколько пользователей сообщили, что откат до 26.1007.21434 восстановил боковую панель в той же среде VS Code (сообщалось в openai/codex#56691). Это ваш случай, если значок Codex виден на панели Activity Bar в VS Code, но при выборе боковой панели Codex вместо интерфейса Codex открывается панель с ошибкой.
-
Закройте все окна VS Code.
-
Установите версию расширения Codex, о которой сообщали как о рабочей, из терминала, где доступна команда
code:code --install-extension OpenAI.chatgpt@26.1007.21434 --force -
Если команда
codeнедоступна, используйте путь в интерфейсе VS Code, о котором сообщали пользователи: откройте Extensions, найдите Codex или OpenAI.chatgpt, выберите значок шестерёнки, выберите Install Specific Version…, затем выберите26.1007.21434(обходной путь, о котором сообщалось в openai/codex#56691). -
Отключите автоматические обновления для расширения Codex, чтобы VS Code не вернул расширение сразу обратно на
26.1021.22027: откройте Extensions, найдите Codex или OpenAI.chatgpt, выберите значок шестерёнки, затем выберите для этого расширения опцию отключения автообновления на уровне расширения (обходной путь, о котором сообщалось в openai/codex#56691). -
Перезапустите VS Code.
-
Откройте боковую панель Codex из Activity Bar.
Как проверить, что сработало: боковая панель Codex должна загрузить обычный интерфейс вместо панели Codex could not start. В пользовательских отчётах одни и те же установки Windows и Linux не работали на 26.1021.22027 и загружались нормально после установки 26.1007.21434 (сообщалось в openai/codex#56691).
Если ошибка остаётся: повторно выполните команду установки и подтвердите, что установленная версия расширения — 26.1007.21434, потому что один из описанных обходных путей включал отключение автообновления именно для того, чтобы VS Code не возвращался к 26.1021.22027 (сообщалось в openai/codex#56691). Если версия уже закреплена, но боковая панель всё равно не запускается, соберите ОС, версию VS Code, версию расширения Codex и любую строку вывода Codex с renderer_ready_timeout, затем добавьте эти данные в существующую issue на GitHub или в новую issue openai/codex. После того как боковая панель снова загрузится, используйте руководство по настройке model-provider для Codex для следующего шага настройки.
Could not register service worker
Error loading webview provided by 'openai.chatgpt':
Could not register service worker:
InvalidStateError: Failed to register a ServiceWorker:
The document is in an invalid state.
Codex может показывать Could not register service worker во время того же сбоя запуска боковой панели VS Code; пользовательские логи связали сбой с renderer webview Codex, который не успел перейти в состояние готовности до 30-секундного тайм-аута (сообщалось в openai/codex#56691). Это ваш случай, если видимая ошибка упоминает openai.chatgpt, ServiceWorker, InvalidStateError или строку лога Codex вроде reason=renderer_ready_timeout.
Одна из строк лога с ошибкой выглядела так:
[CodexWebviewProvider] Webview renderer did not become ready elapsedMs=29999 extensionVersion=26.1021.22027 reason=renderer_ready_timeout receivedWebviewMessage=false role=sidebar stage=renderer timeoutMs=30000
-
Не тратьте дополнительное время на очистку каталогов кэша VS Code как основной способ исправить этот симптом. Автор исходного отчёта для Windows сказал, что проблема сохранилась после очистки
Cache,CachedData,Code Cache,GPUCacheи данных Service Worker в%APPDATA%\Code(сообщалось в openai/codex#56691). -
Установите версию расширения, о которой сообщали как о рабочей:
code --install-extension OpenAI.chatgpt@26.1007.21434 --force -
Перезапустите VS Code.
-
Откройте Extensions, найдите Codex или OpenAI.chatgpt, выберите значок шестерёнки и отключите автоматические обновления для этого расширения, чтобы VS Code не переустановил автоматически семейство версий, на котором возникает сбой (обходной путь, о котором сообщалось в openai/codex#56691).
-
Снова откройте боковую панель Codex.
Как проверить, что сработало: ошибка service-worker должна исчезнуть, а боковая панель Codex — отрисоваться. В одном отчёте для Linux Mint сбой воспроизводился после ручного обновления обратно до 26.1021.22027; затем пользователь переустановил и закрепил 26.1007.21434 как обходной путь (сообщалось в openai/codex#56691).
Если ошибка остаётся: скопируйте точное сообщение service-worker и любую строку вывода Codex, где есть renderer_ready_timeout, elapsedMs, extensionVersion и timeoutMs. Укажите, используете ли вы локальный VS Code или Remote-SSH, потому что в одном отчёте для Windows говорилось, что тайм-аут также воспроизводился в окне VS Code Remote-SSH с отдельной установкой .vscode-server/extensions/openai.chatgpt-26.1021.22027-win32-x64 (сообщалось в openai/codex#56691). Используйте общее руководство по обработке ошибок, чтобы упорядочить текст ошибки, версии, результат повторной попытки и логи перед отправкой отчёта.
Источники
- Issue на GitHub: openai/codex#56691 — Codex 26.1021.22027 fails to start UI in VS Code 1.143.1 on Windows
- Связанная issue на GitHub, указанная автором отчёта: openai/codex#56617
Документация: Используйте общее руководство по обработке ошибок, чтобы упорядочить точный текст ошибки, версии, результаты повторной попытки и логи перед отправкой отчёта. → общее руководство по обработке ошибок
Связанные документы
Часто задаваемые вопросы
- Как исправить “Codex could not start” в VS Code?
- Откатите расширение OpenAI.chatgpt для VS Code до версии 26.1007.21434 и отключите автообновление для этого расширения. Несколько пользователей сообщили, что версия 26.1021.22027 не работала, а 26.1007.21434 восстановила боковую панель Codex.
- Почему Codex пишет “The extension could not start its user interface”?
- Вероятная причина — регрессия запуска webview в расширении Codex для VS Code: renderer не становится готовым до истечения тайм-аута. Пользовательские логи в openai/codex#56691 показывают
renderer_ready_timeoutна расширении 26.1021.22027. - Как исправить “Could not register service worker” для openai.chatgpt?
- Считайте сообщение о service worker тем же сбоем запуска webview Codex и сначала откатите расширение Codex до версии 26.1007.21434. Если расширение после отката всё ещё не запускается, сообщите версию VS Code, ОС, версию расширения и лог вывода Codex.


