# Codex could not start VS Code 확장 오류: 원인별 해결, WSL은 1.141.2로

> 패널이 30초 안에 준비되지 않으면 뜨는 공통 화면입니다. 10월 13일 이후 WSL 창에서 생겼다면 VS Code 1.141.2 이상으로 올리고, 그 밖에는 Codex.log로 원인을 가립니다.

- URL: https://blog.laozhang.ai/ko/posts/codex-could-not-start-vscode
- Published: 2026-10-15
- Updated: 2026-10-15
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ko/about)
- Topic: 개발 도구·에이전트
- Tags: OpenAI Codex, VS Code, Codex IDE 확장, WSL, Remote-SSH, Dev Container, 문제 해결

---
VS Code에서 Codex 패널을 열었더니 로딩 아이콘만 돌다가 약 30초 뒤 "Codex could not start / The extension could not start its user interface."로 바뀐다면, 이것은 버그 하나의 이름이 아닙니다. Codex 확장(확장 ID `openai.chatgpt`)이 패널 화면에 30초를 주고, 그 안에 "준비됐다"는 신호가 오지 않으면 무조건 띄우는 공통 오류 화면입니다. 뒤쪽의 Codex 실행 프로세스(app-server)는 이미 떠 있고 패널 화면만 멈춘 경우가 많습니다.

그래서 해결책은 원인에 따라 갈립니다. 가장 최근 원인은 VS Code 쪽에 있습니다. Windows에서 WSL 창을 쓰고 있고 2026년 10월 13일 VS Code 1.141.1 업데이트 이후 갑자기 생겼다면, VS Code를 1.141.2(10월 14일 출시) 이상으로 올리는 것이 수정입니다. 이 경우 Codex 확장을 이전 버전으로 되돌려도 해결되지 않았습니다. 그 밖의 환경(프록시·VPN, Dev Container, Remote-SSH, 편집기 탭 여러 개)은 2026년 10월 15일 기준으로 관련 GitHub 이슈가 아직 열려 있어, 우회책을 쓰거나 터미널의 Codex CLI로 작업을 이어 가야 합니다.

아래 원인과 조치는 모두 GitHub 이슈의 사용자 보고, OpenAI Codex 팀원의 답변, VS Code 수정 커밋에서 나온 것입니다. Windows·WSL, Dev Container, Remote-SSH 환경에서 직접 재현해 본 결과는 아닙니다.

## "Codex could not start" 화면의 정체: 30초 준비 타이머가 끝났다는 뜻

Codex 확장은 패널(사이드바나 편집기 탭)을 열 때 화면 쪽 코드가 "준비 완료" 메시지를 보내기를 30초 동안 기다립니다. 시간이 지나도 메시지가 없으면 패널 내용을 지우고 오류 화면으로 바꿉니다. 사용자 입장에서는 이 30초가 "무한 로딩", "패널이 안 뜸"으로 보이고, 끝에 오류 문구가 나타납니다. 이 동작은 OpenAI 문서에는 설명이 없고, 사용자들이 확장 코드와 로그를 직접 열어 확인한 내용입니다([openai/codex #40532](https://github.com/openai/codex/issues/40532), [#43080](https://github.com/openai/codex/issues/43080)).

이때 Codex.log에는 보통 다음 순서로 기록이 남습니다.

```text
[info] [CodexMcpConnection] Spawning codex app-server
[info] [CodexMcpConnection] Initialize received id=1
[error] [CodexWebviewProvider] Webview renderer did not become ready elapsedMs=30003 extensionVersion=26.1007.21434 reason=renderer_ready_timeout receivedWebviewMessage=false role=sidebar stage=renderer timeoutMs=30000
```

앞의 두 줄은 Codex 실행 프로세스가 정상적으로 시작됐다는 기록입니다. 마지막 줄의 `receivedWebviewMessage=false`는 패널 화면에서 아무 메시지도 받지 못했다는 뜻이고, `role=sidebar`는 사이드바, `role=panel`은 편집기 탭으로 연 Codex 대화입니다. 즉 이 줄만으로는 원인을 알 수 없고, "화면이 왜 준비되지 못했는가"를 따로 찾아야 합니다.

![Codex 패널을 열면 app-server가 먼저 시작되고 패널 화면의 준비 신호를 30초 기다린 뒤 신호가 없으면 renderer_ready_timeout과 함께 Codex could not start 화면으로 바뀌는 순서](https://blog.laozhang.ai/posts/ko/codex-could-not-start-vscode/img/codex-30s-ready-timer.webp)

같은 화면의 예전 문구는 "The extension couldn't load its resources."였습니다. 2026년 8월 7일 무렵 확장 26.803.x의 회귀로 나타났고, OpenAI Codex 팀의 alexr-oai는 8월 13일 26.810.41047(프리릴리스 26.5810.41047)에서 이 감시 타이머 문제를 고쳤다고 밝혔습니다. 초기화가 30초를 넘는다는 이유만으로는 더 이상 이 화면이 뜨지 않게 됐지만, 같은 답변에서 "네트워크나 인증 문제 때문에 초기화가 끝나지 않는 경우는 그대로일 가능성이 높다"고 덧붙였습니다([#37458의 OpenAI 답변](https://github.com/openai/codex/issues/37458#issuecomment-5287557175)). 지금의 "could not start its user interface" 문구는 그 뒤 버전(26.818.61809, 26.901.22334, 26.1007.21434)에서 보고된 것입니다.

## 원인을 가르는 두 곳: Codex.log와 Webview 개발자 도구

원인을 고르기 전에 두 군데를 열어 봅니다. 둘 다 VS Code 명령 팔레트(Windows `Ctrl+Shift+P`, macOS `Cmd+Shift+P`)에서 실행합니다.

1. `Developer: Open Extension Logs Folder`를 실행하고 `openai.chatgpt` 폴더의 `Codex.log`를 엽니다. 출력(Output) 패널에서 Codex 채널을 골라도 같은 내용을 볼 수 있습니다. `renderer_ready_timeout` 앞뒤 줄을 봅니다.
2. Codex 패널을 연 상태에서 `Developer: Open Webview Developer Tools`를 실행하고 Console과 Network 탭을 봅니다. 패널 화면이 자기 로그를 시작하기도 전에 실패하면 그 오류는 Codex.log로 넘어가지 않으므로, 이쪽에서만 보입니다.

버전도 함께 적어 둡니다. VS Code 버전은 Windows PowerShell에서 `code --version`, 확장 버전은 `code --list-extensions --show-versions`로 확인합니다. WSL·SSH·컨테이너 같은 원격 창에서는 Codex 확장이 원격 쪽(예: `~/.vscode-server/extensions/openai.chatgpt-26.1007.21434-linux-x64`)에 설치되므로, 원격 창 안의 확장 목록에서 버전을 봐야 합니다.

## 환경과 로그로 원인 고르기: 2026년 10월 15일 기준 현황

| 사용 환경과 단서 | 원인 | 현황 | 먼저 할 일 | 소용없던 조치 |
| --- | --- | --- | --- | --- |
| Windows + WSL 창, VS Code 1.141.1, Webview 개발자 도구에 `webview/assets/` 파일 401 | VS Code 1.141.1 회귀 | VS Code 1.141.2에서 수정 | VS Code 업데이트 | Codex 확장 롤백·재설치, 캐시 삭제, 새 프로필 |
| 프록시·VPN·사내망, Codex.log에 계정 조회 완료 기록이 없음 | 계정 조회 요청이 응답 없이 멈춤 | [#37521](https://github.com/openai/codex/issues/37521) 미해결 | 프록시를 정상화하거나 끄고 다시 열기 | 확장 업데이트만 하기 |
| Dev Container 창 | 시작 단계가 끝나지 않음(원인 미확정) | [#40532](https://github.com/openai/codex/issues/40532) 미해결 | 컨테이너 설정에 navigator 호환 옵션 추가(사용자 보고) | 재설치, 옛 서버 버전 삭제 |
| Remote-SSH 창, 터미널 `codex`는 정상 | 원인 여러 갈래 | [#26951](https://github.com/openai/codex/issues/26951) 미해결 | 로컬 설정 두 줄 추가 후 VS Code 완전 재시작(사용자 보고) | VS Code 1.141.2 업데이트 |
| 로컬 Windows, Codex 편집기 탭 여러 개, 로그에 `role=panel` | 일부 탭의 화면만 시간 초과 | [#43080](https://github.com/openai/codex/issues/43080) 미해결 | 남는 Codex 탭을 닫고 창 다시 불러오기 | 알려진 바 없음 |

표의 "소용없던 조치"는 해당 이슈의 보고자가 시도했지만 해결되지 않았다고 적은 것들입니다. 자기 갈래가 아닌 조치에 시간을 쓰지 않도록 이 칸부터 확인하는 것이 좋습니다.

## WSL 창에서 10월 13일부터 안 뜬다면: VS Code 1.141.2 이상으로 업데이트

2026년 10월 13일 배포된 VS Code 1.141.1에는 원격 창의 Webview 리소스 경로 검사를 강화한 커밋이 들어갔습니다. 창 왼쪽 아래에 보이는 원격 이름(예: `WSL: Ubuntu-24.04`)에 대문자가 있으면, 브라우저가 리소스 주소 속 이 이름을 소문자로 바꾸는 바람에 VS Code 서버가 이름이 일치하지 않는다고 보고 요청을 401로 거부합니다. 그 결과 Codex만이 아니라 Markdown 미리 보기, Claude Code 패널 같은 모든 확장의 Webview가 빈 화면이 됐습니다([microsoft/vscode #341396](https://github.com/microsoft/vscode/issues/341396), [#341475](https://github.com/microsoft/vscode/issues/341475)).

Codex에서는 이렇게 나타났습니다([openai/codex #53738](https://github.com/openai/codex/issues/53738), [#53840](https://github.com/openai/codex/issues/53840)).

- 30초 뒤 "Codex could not start" 화면, Codex.log에 `renderer_ready_timeout`
- Webview 개발자 도구에서 `~/.vscode-server/extensions/openai.chatgpt-26.1007.21434-linux-x64/webview/assets/` 아래 JS·CSS 파일이 HTTP 401
- WSL 안에서 `codex login status`는 `Logged in using ChatGPT`로 정상, 터미널의 Codex CLI도 정상
- 같은 컴퓨터에서 VS Code를 Windows 로컬 창으로 열면 Codex가 정상 작동

Microsoft는 10월 14일 "webview: fix mixed-case remote resource authorities" 수정을 1.141 릴리스 브랜치에 병합해 1.141.2로 내보냈고, 같은 날 나온 1.142.0에도 같은 수정이 들어 있습니다([PR #341508](https://github.com/microsoft/vscode/pull/341508)). VS Code 이슈에는 "verified" 표시가 붙어 Microsoft가 Webview 전반에 대해 수정을 확인했습니다. 다만 1.141.2로 올린 뒤 Codex 패널이 다시 열렸다는 Codex 사용자의 보고는 10월 15일 기준 아직 올라오지 않았습니다.

![WSL: Ubuntu-24.04처럼 대문자가 든 원격 이름이 소문자로 바뀌어 VS Code 1.141.1 서버가 401로 거부하는 흐름과, VS Code 1.141.2 업데이트 또는 소문자 이름으로 창 열기라는 해결책, 효과가 없던 확장 롤백과 재설치 등의 조치](https://blog.laozhang.ai/posts/ko/codex-could-not-start-vscode/img/wsl-uppercase-name-401.webp)

해결 순서는 다음과 같습니다.

1. `code --version`으로 VS Code 버전을 봅니다. 1.141.1이면 Help > Check for Updates로 1.141.2 이상을 설치합니다.
2. VS Code를 완전히 닫았다가 WSL 폴더를 다시 엽니다.
3. Codex 패널을 열고, 그래도 오류가 나면 Webview 개발자 도구에 401이 남아 있는지 봅니다. 401이 사라졌는데도 오류가 나면 다른 갈래입니다.

업데이트를 바로 할 수 없는 환경이라면, 수정 전에 사용자들이 쓰던 우회책이 있습니다. Windows PowerShell에서 배포판 이름을 소문자로 적어 창을 여는 방법입니다.

```powershell
code --new-window --remote wsl+ubuntu-24.04 /home/YOUR_USER/YOUR_PROJECT
```

WSL 터미널 안에서는 다음처럼 PowerShell을 거쳐 실행해야 합니다. Ubuntu 터미널에서 그냥 `code .`를 실행하면 대문자 이름(`wsl+Ubuntu-24.04`)으로 창이 열려 1.141.1에서는 다시 실패합니다.

```bash
powershell.exe -NoProfile -Command "code --new-window --remote wsl+ubuntu-24.04 '$PWD'"
```

`ubuntu-24.04` 부분은 자신의 배포판 이름을 소문자로 바꿔 넣어야 합니다. 배포판 이름은 PowerShell의 `wsl -l -v`로 확인합니다. 또 다른 방법으로, 한 보고자는 VS Code를 1.141.0으로 되돌려 해결했습니다. 반대로 Codex 확장을 26.1002.51308로 내려 보는 것은 1.141.1에서 효과가 없었습니다. 확장 재설치, VS Code Server 재설치, 캐시와 프로필 초기화, `wsl --shutdown`도 해결하지 못했다고 보고됐습니다.

WSL 원격 창을 고집할 필요가 없다면, Windows 로컬 창에서 Codex만 WSL 안에서 돌리는 설정도 있습니다. OpenAI의 [Codex IDE 설정 문서](https://developers.openai.com/codex/ide/settings)에 있는 `chatgpt.runCodexInWindowsSubsystemForLinux`(기본값 false)를 true로 바꾸면 되고, 바꾸면 VS Code가 다시 로드됩니다. #53840 보고자는 이 방식으로 WSL2 안의 명령을 실행했습니다. 이것은 1.141.1 문제의 수정이 아니라 작업 방식을 바꾸는 선택지입니다.

## 프록시·VPN 환경에서 확장을 업데이트해도 30초 뒤 같은 오류가 날 때

8월의 감시 타이머 수정 이후에도 남은 대표 원인이 네트워크입니다. Codex 패널은 처음 열릴 때 ChatGPT 계정 정보를 조회하는데, 이 요청이 어떻게 실패하느냐에 따라 결과가 갈립니다([#37521](https://github.com/openai/codex/issues/37521)).

| 네트워크 상태 | 보고된 결과 |
| --- | --- |
| 정상 작동하는 프록시 | 정상 시작 |
| 프록시 없이 요청이 곧바로 실패 | 계정 조회 오류를 남기고 기능이 줄어든 오프라인 상태로 패널이 열림 |
| 프록시가 연결은 받고 응답을 보내지 않음 | 계정 조회가 끝나지 않아 30초 뒤 오류 화면 |

이 갈래에서는 Codex.log에 `React root render requested`까지는 찍히지만 `[chatgpt-account-lookup] completed`나 `app routes mounted` 같은 줄이 나오지 않습니다. OpenAI는 8월 13일 "감시 타이머 수정은 계정 요청에 시간 제한을 추가하지 않는다"며 이 이슈를 열어 두었고, 10월 15일 기준으로도 열려 있습니다. 확장을 최신으로 올리는 것만으로는 해결되지 않는다는 뜻입니다.

할 수 있는 일은 프록시를 "정상 작동" 또는 "아예 없음" 쪽으로 옮기는 것입니다.

- VPN이나 시스템 프록시를 잠시 끄고 VS Code를 완전히 재시작한 뒤 패널을 열어 봅니다.
- 사내 프록시를 써야 한다면 `chatgpt.com`, `api.openai.com`, `ab.chatgpt.com`으로 가는 HTTPS 연결이 실제로 통과하는지 확인합니다.
- VS Code `settings.json`의 `http.proxySupport`가 `off`로 바뀌어 있다가 `on`으로 되돌리자 해결됐다는 사용자 보고가 있습니다([#37458 댓글](https://github.com/openai/codex/issues/37458)).

같은 이슈에는 확장 내부의 요청이 Codex 설정의 `network_proxy`를 따르지 않고, Node.js의 fetch가 기본적으로 `HTTP_PROXY`·`HTTPS_PROXY` 환경 변수를 무시한다는 사용자 분석도 있습니다. 환경 변수만 설정해 두고 프록시가 적용됐다고 가정하지 않는 편이 안전합니다.

## Dev Container에서 renderer_ready_timeout이 계속될 때

Dev Container 창에서는 확장 26.818.61809로 자동 업데이트된 뒤 같은 오류가 난다는 보고가 2026년 8월 25일 올라왔습니다([#40532](https://github.com/openai/codex/issues/40532)). Codex 실행 프로세스는 시작되지만 패널 화면이 시작 단계에서 멈춥니다. 보고자는 확장 재설치와 옛 확장·VS Code Server 버전 삭제로는 해결되지 않았다고 적었고, 10월 15일 기준 OpenAI의 답변은 없습니다. 보고자가 확장 번들 파일을 직접 고쳐 우회한 방법도 함께 올렸지만, 업데이트마다 다시 적용해야 하는 임시 처치라서 일반 사용에는 맞지 않습니다.

시도해 볼 만한 것은 다른 이슈의 사용자 보고입니다. Windows·WSL2 Docker 호스트에서 같은 버전의 Dev Container 두 개를 비교했더니, `extensions.supportNodeGlobalNavigator`를 켠 컨테이너는 Codex가 열리고 켜지 않은 컨테이너는 시간 초과가 났다는 내용입니다([#26951의 Dev Container 비교 댓글](https://github.com/openai/codex/issues/26951)). 켜기 전 로그에는 `PendingMigrationError: navigator is now a global in nodejs`가 있었습니다. 원격 설정은 컨테이너마다 따로 저장되므로, 보고자는 `devcontainer.json`에 넣어 두는 방식을 지속적인 우회책으로 제시했습니다.

```json
"customizations": {
  "vscode": {
    "settings": {
      "extensions.supportNodeGlobalNavigator": true
    }
  }
}
```

설정을 넣은 뒤에는 컨테이너를 다시 빌드하거나 창을 다시 불러와야 반영됩니다. 로그에 `PendingMigrationError`가 없다면 이 설정과 무관한 원인일 수 있습니다.

## Remote-SSH에서 VSCode Codex 무한 로딩: CLI는 되는데 패널만 안 뜰 때

Remote-SSH 창에서 패널이 로딩만 하거나 30초 뒤 오류로 바뀌고, 같은 서버의 터미널에서 `codex`는 잘 되는 증상은 2026년 6월 8일부터 [#26951](https://github.com/openai/codex/issues/26951)에 모이고 있습니다. 10월 15일 기준 열려 있고, 아래 우회책은 모두 한 명 또는 몇 명의 사용자가 효과를 봤다고 적은 것이라 결과가 제각각입니다.

- **로컬 설정 두 줄**: Windows 쪽 VS Code 사용자 설정(JSON)에 `"extensions.supportNodeGlobalNavigator": true`와 `"http.electronFetch": true`를 넣고, 모든 VS Code 창을 닫았다가 SSH 호스트에 다시 연결해 해결했다는 10월 14일 보고가 있습니다. 보고자는 두 설정을 함께 넣어 어느 쪽이 필요한지는 모른다고 밝혔고, VS Code 1.141.2 업데이트와 Codex 이전 버전은 효과가 없었다고 적었습니다.
- **이전 확장 버전 + 자동 업데이트 끄기**: 직전 버전을 설치하고 자동 업데이트를 끈 뒤 열렸다는 보고가 있습니다.
- **임시 프로필 시험**: `code --user-data-dir` 등으로 새 프로필을 만들어 Codex가 열린다면, 기존 프로필의 Webview 저장소가 문제일 수 있습니다. 한 사용자는 모든 창을 닫고 `Service Worker`·`Cache` 등 캐시 폴더를 백업 후 지운 뒤, VS Code를 몇 번 다시 시작하자 안정적으로 열렸다고 적었습니다. 이 사용자는 Webview 개발자 도구에서 `does not provide an export named` 같은 모듈 로딩 오류를 봤습니다.
- **`codex features disable remote_plugin`**: 바로 해결됐다는 보고와, 창을 다시 불러오자 증상이 돌아왔다는 보고가 함께 있습니다.
- **서버 쪽 정리**: 명령 팔레트의 `Remote-SSH: Kill VS Code Server on Host...`로 원격 서버의 VS Code Server를 내리고 다시 연결하는 방법도 쓰입니다.

패널은 열리지만 브라우저가 없는 서버에서 로그인이 안 되는 경우는 다른 문제입니다. 이때는 [Codex 로그인: 브라우저 없는 SSH 서버에서 쓰는 방법 3가지와 선택 기준](https://blog.laozhang.ai/ko/posts/codex-headless-login)을 보세요.

## Codex 편집기 탭을 여러 개 열었을 때 일부 탭만 오류가 나는 경우

로컬 Windows에서 Codex 대화를 편집기 탭으로 여러 개 열어 두었더니, 하나는 열리고 나머지 두 탭이 거의 동시에 오류 화면으로 바뀌었다는 보고가 있습니다(확장 26.901.22334, [#43080](https://github.com/openai/codex/issues/43080)). 로그에는 `role=panel`로 시간 초과가 찍힙니다. 보고자도 탭 몇 개부터 문제가 되는지는 밝히지 못했고, OpenAI의 답변은 아직 없습니다.

이 갈래라면 남는 Codex 탭을 닫고 `Developer: Reload Window`로 창을 다시 불러온 뒤 필요한 대화만 여는 방법을 먼저 써 볼 수 있습니다. 보고된 해결책이 아니라 증상에서 추론한 방법입니다. 사이드바(`role=sidebar`)까지 오류가 난다면 다른 갈래를 의심합니다.

## 수정을 기다리는 동안: 확장 버전 되돌리기와 Codex CLI

확장 버전을 되돌리는 것은 확장 빌드 자체가 원인일 때만 효과가 있습니다. 8월의 26.803.x 회귀가 그런 경우였고, 10월의 WSL 문제처럼 VS Code가 원인일 때는 소용이 없었습니다. VS Code Marketplace 기준(2026년 10월 15일) 현재 안정판은 26.1007.21434(10월 9일), 그 전 안정판은 26.1002.51308(10월 6일)입니다. 26.51007.21434처럼 두 번째 숫자가 5로 시작하는 버전은 프리릴리스입니다. 버전은 일주일에 여러 번 바뀌므로 설치 전에 목록을 다시 보세요.

```bash
# 설치된 Codex 확장 버전 확인
code --list-extensions --show-versions

# 특정 버전으로 되돌리기(예시는 #53738 보고자가 쓴 버전)
code --install-extension openai.chatgpt@26.1002.51308 --force
```

화면에서 하려면 확장 보기에서 Codex를 열고 제거 버튼 옆 메뉴의 Install Specific Version을 고릅니다. 이 확장의 자동 업데이트를 끄지 않으면 VS Code가 다시 최신 버전을 설치합니다. 원격 창이라면 원격 쪽에 설치된 확장을 바꿔야 합니다. 확장을 처음 설치하고 설정하는 절차는 [VS Code Codex 설정: API 키와 타사 모델을 검증하는 방법](https://blog.laozhang.ai/ko/posts/codex-vscode-extension-api-key-custom-models)에, Cursor에서 쓰는 경우는 [Cursor에서 Codex 쓰기: 공식 확장 설치와 첫 작업 검토](https://blog.laozhang.ai/ko/posts/codex-cursor-extension-guide)에 정리돼 있습니다.

위의 보고들(#53738, #53840, #26951)에서는 패널이 실패하는 동안에도 터미널의 `codex` 명령은 계속 작동했습니다. 수정을 기다리는 동안 같은 프로젝트 폴더에서 CLI로 작업을 이어 갈 수 있습니다. 다만 CLI도 같은 로그인 정보와 네트워크를 쓰므로, 프록시 갈래에서는 CLI까지 막힐 수 있습니다. 설치 방법은 [Codex CLI 설치와 설정: Windows·macOS·Linux에서 바로 시작하기](https://blog.laozhang.ai/ko/posts/codex-cli-install)를 참고하세요.

## 해결되지 않을 때 GitHub 이슈에 남길 정보

OpenAI의 [Codex 문제 해결 문서](https://developers.openai.com/codex/reference/troubleshooting)에는 2026년 10월 15일 기준 이 오류 항목이 없습니다. 위 갈래 중 어디에도 맞지 않거나 조치가 듣지 않으면, 가장 가까운 이슈에 다음을 덧붙이는 것이 수정을 앞당기는 길입니다.

- VS Code 버전과 확장 버전, 사용 환경(로컬/WSL/SSH/Dev Container, 창 왼쪽 아래의 원격 이름)
- Codex.log에서 `Spawning codex app-server`부터 `renderer_ready_timeout`까지의 줄(계정·경로는 가림)
- Webview 개발자 도구 Console과 Network의 오류(401, 모듈 로딩 오류 등)
- 터미널의 `codex`가 되는지, `codex login status` 결과
- 이미 시도했고 효과가 없던 조치

## 자주 묻는 질문

### VSCode Codex 무한 로딩, 안 뜸도 같은 오류인가요?

대부분 같은 흐름입니다. 패널이 준비 신호를 보내지 못하는 동안이 로딩 화면이고, 30초가 지나면 "Codex could not start" 화면으로 바뀝니다. 오래된 확장 빌드나 일부 Remote-SSH 보고처럼 오류 화면 없이 로딩만 계속되는 경우도 있으므로, Codex.log에 `renderer_ready_timeout`이 있는지로 확인합니다.

### VSCode Codex 로그인 안 됨 문제와 관계가 있나요?

반드시 그렇지는 않습니다. WSL 갈래에서는 `codex login status`가 정상인데도 이 오류가 났습니다. 반면 프록시 때문에 계정 조회가 멈추는 갈래는 로그인 정보와 엮여 있습니다. 패널이 열린 뒤 401·429 같은 오류가 나는 것은 별개 문제이니 [Codex 401·429·Stream Disconnected: 실패한 계층부터 찾기](https://blog.laozhang.ai/ko/posts/codex-exceeded-retry-limit-429)를 보세요.

### Codex 확장을 다시 설치하면 해결되나요?

이 오류에서 재설치는 효과가 낮습니다. WSL, Dev Container, Remote-SSH 보고자 모두 재설치를 해 봤지만 해결되지 않았습니다. Codex 실행 프로세스는 이미 정상적으로 떠 있는 경우가 많기 때문입니다. 재설치보다 Webview 개발자 도구와 Codex.log로 갈래를 먼저 정하는 편이 빠릅니다.

## 참고 자료

이 글이 링크한 외부 페이지를 본문에 나온 순서대로 정리했습니다. 마지막 업데이트: 2026-10-15.

- [openai/codex #40532](https://github.com/openai/codex/issues/40532) (github.com)
- [#43080](https://github.com/openai/codex/issues/43080) (github.com)
- [#37458의 OpenAI 답변](https://github.com/openai/codex/issues/37458) (github.com)
- [#37521](https://github.com/openai/codex/issues/37521) (github.com)
- [#26951](https://github.com/openai/codex/issues/26951) (github.com)
- [microsoft/vscode #341396](https://github.com/microsoft/vscode/issues/341396) (github.com)
- [#341475](https://github.com/microsoft/vscode/issues/341475) (github.com)
- [openai/codex #53738](https://github.com/openai/codex/issues/53738) (github.com)
- [#53840](https://github.com/openai/codex/issues/53840) (github.com)
- [PR #341508](https://github.com/microsoft/vscode/pull/341508) (github.com)
- [Codex IDE 설정 문서](https://developers.openai.com/codex/ide/settings) (developers.openai.com)
- [Codex 문제 해결 문서](https://developers.openai.com/codex/reference/troubleshooting) (developers.openai.com)