VS Code에서 “Codex could not start”가 뜰 때 OpenAI.chatgpt 다운그레이드로 해결하기

OpenAI.chatgpt 26.1007.21434를 설치하고 고정해 VS Code의 “Codex could not start” 및 service-worker 오류를 해결하고 Codex 사이드바가 다시 로드되게 합니다.

Codex Startup Fix라는 제목이 있는 고무도장 선화

요약: Codex VS Code 오류 Codex could not start의 경우, 가장 많이 보고된 우회 방법은 26.1021.22027 대신 OpenAI.chatgpt@26.1007.21434를 설치하고 해당 확장 프로그램의 자동 업데이트를 끄는 것입니다. 이 가이드는 관리자 측에서 확인한 근본 원인이 아니라, openai/codex#56691에 공유된 사용자 보고와 로그를 바탕으로 합니다.

적용 대상: Codex VS Code 확장 프로그램 OpenAI.chatgpt, 특히 Windows용 VS Code 1.143.1에서의 26.1021.22027. 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_timeoutCould not register service worker

Codex could not start

Codex could not start
The extension could not start its user interface.

Codex 사이드바 webview 초기화에 실패하면 VS Code에서 Codex가 Codex could not start를 표시합니다. 여러 사용자가 같은 VS Code 환경에서 26.1007.21434로 다운그레이드한 뒤 사이드바가 복구됐다고 보고했기 때문에, 가능성이 높은 버전별 트리거는 OpenAI.chatgpt 확장 프로그램 26.1021.22027입니다(openai/codex#56691에서 보고됨). VS Code Activity Bar에 Codex 아이콘은 보이지만, Codex 사이드바를 선택했을 때 Codex UI 대신 오류 패널이 열린다면 이 경우에 해당합니다.

  1. 모든 VS Code 창을 닫습니다.

  2. code 명령을 실행할 수 있는 터미널에서 정상 동작이 보고된 Codex 확장 프로그램 버전을 설치합니다.

    code --install-extension OpenAI.chatgpt@26.1007.21434 --force
  3. code 명령을 사용할 수 없다면, 사용자들이 보고한 VS Code UI 경로를 사용합니다. Extensions를 열고 Codex 또는 OpenAI.chatgpt를 찾은 다음, gear icon을 선택하고 Install Specific Version…을 선택한 뒤 26.1007.21434를 고릅니다(openai/codex#56691에서 보고된 우회 방법).

  4. VS Code가 확장 프로그램을 곧바로 26.1021.22027로 되돌리지 않도록 Codex 확장 프로그램의 자동 업데이트를 끕니다. Extensions를 열고 Codex 또는 OpenAI.chatgpt를 찾은 다음, gear icon을 선택하고 해당 확장 프로그램에 대한 확장 프로그램 단위 자동 업데이트 비활성화 옵션을 선택합니다(openai/codex#56691에서 보고된 우회 방법).

  5. VS Code를 다시 시작합니다.

  6. Activity Bar에서 Codex 사이드바를 엽니다.

정상 동작 확인 방법: 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에서 보고됨). 버전이 이미 고정돼 있는데도 사이드바가 계속 실패한다면, OS, VS Code 버전, Codex 확장 프로그램 버전, 그리고 renderer_ready_timeout이 포함된 Codex 출력 줄을 수집한 다음, 기존 GitHub 이슈나 새 openai/codex 이슈에 해당 정보를 추가합니다. 사이드바가 다시 로드된 뒤에는 다음 구성 단계로 Codex model-provider 설정 가이드를 사용합니다.

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.

같은 VS Code 사이드바 시작 실패 과정에서 Codex가 Could not register service worker를 표시할 수 있습니다. 사용자 로그에서는 Codex webview 렌더러가 30초 제한 시간 안에 준비 상태가 되지 않은 것과 이 실패가 연결됐습니다(openai/codex#56691에서 보고됨). 보이는 오류에 openai.chatgpt, ServiceWorker, InvalidStateError가 나오거나, reason=renderer_ready_timeout 같은 Codex 로그 줄이 있다면 이 경우에 해당합니다.

보고된 실패 로그 줄은 다음과 같습니다.

[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
  1. 이 증상의 주된 해결책으로 VS Code 캐시 디렉터리를 지우는 데 더 많은 시간을 쓰지 마세요. 최초 Windows 보고자는 %APPDATA%\Code 아래의 Cache, CachedData, Code Cache, GPUCache, Service Worker 데이터를 지운 뒤에도 문제가 지속됐다고 밝혔습니다(openai/codex#56691에서 보고됨).

  2. 정상 동작이 보고된 확장 프로그램 버전을 설치합니다.

    code --install-extension OpenAI.chatgpt@26.1007.21434 --force
  3. VS Code를 다시 시작합니다.

  4. Extensions를 열고 Codex 또는 OpenAI.chatgpt를 찾은 다음, gear icon을 선택하고 해당 확장 프로그램의 자동 업데이트를 꺼서 VS Code가 실패하는 버전 계열을 자동으로 다시 설치하지 않게 합니다(openai/codex#56691에서 보고된 우회 방법).

  5. Codex 사이드바를 다시 엽니다.

정상 동작 확인 방법: service-worker 오류가 사라지고 Codex 사이드바가 렌더링돼야 합니다. 한 Linux Mint 보고에서는 수동으로 다시 26.1021.22027로 업그레이드한 뒤 실패가 재현됐고, 이후 우회 방법으로 26.1007.21434를 다시 설치하고 고정했습니다(openai/codex#56691에서 보고됨).

그래도 실패한다면: 정확한 service-worker 메시지와 renderer_ready_timeout, elapsedMs, extensionVersion, timeoutMs가 포함된 Codex 출력 줄을 복사합니다. 로컬 VS Code를 쓰는지 Remote-SSH를 쓰는지도 포함합니다. 한 Windows 보고에서는 별도의 .vscode-server/extensions/openai.chatgpt-26.1021.22027-win32-x64 설치가 있는 VS Code Remote-SSH 창에서도 같은 timeout이 재현됐다고 했습니다(openai/codex#56691에서 보고됨). 보고서를 제출하기 전에 일반 오류 처리 가이드를 사용해 오류 텍스트, 버전, 재시도 결과, 로그를 정리합니다.

출처

문서: 보고서를 제출하기 전에 일반 오류 처리 가이드를 사용해 정확한 오류 텍스트, 버전, 재시도 결과, 로그를 정리하세요. → 일반 오류 처리 가이드

관련 문서

자주 묻는 질문

VS Code에서 “Codex could not start”를 어떻게 해결하나요?
OpenAI.chatgpt VS Code 확장 프로그램을 26.1007.21434로 다운그레이드하고 해당 확장의 자동 업데이트를 비활성화하세요. 여러 사용자가 26.1021.22027에서는 실패했지만 26.1007.21434에서는 Codex 사이드바가 복구됐다고 보고했습니다.
Codex가 “The extension could not start its user interface”라고 표시하는 이유는 무엇인가요?
가능성이 큰 원인은 렌더러가 제한 시간 전에 준비 상태가 되지 않는 Codex VS Code 확장 프로그램 webview 시작 회귀입니다. openai/codex#56691의 사용자 로그에는 확장 프로그램 26.1021.22027에서 renderer_ready_timeout이 표시됩니다.
openai.chatgpt의 “Could not register service worker”는 어떻게 해결하나요?
service-worker 메시지를 같은 Codex webview 시작 실패로 보고, 먼저 Codex 확장 프로그램을 26.1007.21434로 다운그레이드하세요. 다운그레이드한 확장 프로그램에서도 여전히 실패하면 VS Code 버전, OS, 확장 프로그램 버전, Codex 출력 로그를 보고하세요.