Windows에서 Codex helper_unknown_error: setup refresh had errors 해결하기
Windows에서 Codex helper_unknown_error: setup refresh had errors를 해결하려면 샌드박스 로그에서 os error 32를 확인하고 unelevated sandbox로 전환합니다.
TL;DR: 번들 CLI 0.162.0-alpha.2가 포함된 26.1002.x 전후 Windows Codex 빌드에서 보고된 helper_unknown_error: setup refresh had errors는 대개 elevated 샌드박스의 공유 위반 회귀일 가능성이 크며, 업데이트된 빌드를 설치할 때까지 [windows] sandbox = "unelevated"로 설정하는 임시 우회 방법이 보고되었습니다. 이 가이드는 openai/codex 이슈의 GitHub 사용자 보고, 샌드박스 로그, 사용자가 인용한 OpenAI Windows 샌드박스 문서를 바탕으로 합니다.
적용 대상: Windows 10 및 Windows 11의 Codex Desktop / ChatGPT Desktop 로컬 실행, 특히 보고된 패키지 버전 26.1002.6548.0 및 26.1002.7124.0, About 버전 26.1002.51308 및 26.1002.52244, 번들 CLI/helper 0.162.0-alpha.2. 마지막 확인: 2026-11-03.
| 보이는 증상 | 이동할 곳 |
|---|---|
helper_unknown_error: setup refresh had errors | helper_unknown_error: setup refresh had errors |
trusted Node process exited unexpectedly 또는 node_repl kernel exited unexpectedly | trusted Node process exited unexpectedly |
elevated sandbox에서 helper_unknown_error: setup refresh had errors
exec-server rejected request (-32603): helper_unknown_error: setup refresh had errors
windows sandbox failed: helper_unknown_error: setup refresh had errors
Windows에서 Codex가 helper_unknown_error: setup refresh had errors를 표시하는 경우, elevated 샌드박스 설정이 활성 cua_node 파일에 대한 런타임 읽기/실행 ACL 검증 중 실패했을 가능성이 큽니다. 샌드박스 로그에는 Windows os error 32 / ERROR_SHARING_VIOLATION이 보고되었습니다(openai/codex#51601, openai/codex#51634, openai/codex#51590에서 보고됨). PowerShell이 시작되기 전 Get-Location 같은 일반 샌드박스 명령이 실패하고, 로그가 %LOCALAPPDATA%\OpenAI\Codex\runtimes\cua_node\... 아래의 node_repl.exe, node.exe, 또는 VCRUNTIME140_1.dll을 가리킨다면 이 경우에 해당합니다(openai/codex#51601에서 보고됨).
- 치명적인 런타임 검증 줄이 있는지 Codex 샌드박스 로그를 검색합니다.
Select-String -Path "$env:USERPROFILE\.codex\.sandbox\sandbox.*.log" ` -Pattern "runtime read/execute validation failed","os error 32","helper_unknown_error" ` -Context 0,3 - 로그에
cua_node런타임 파일의runtime read/execute validation failed와os error 32가 포함되어 있으면, Windows 샌드박스 설정이 들어 있는 Codexconfig.toml파일을 찾습니다.Get-ChildItem -Path $env:USERPROFILE -Filter config.toml -Recurse -ErrorAction SilentlyContinue | Select-String -Pattern '^\s*sandbox\s*=\s*"(elevated|unelevated)"' -List | Select-Object -ExpandProperty Path - 보고된
config.toml파일을 열고 Windows 샌드박스 블록을 보고된 임시 우회 설정으로 변경합니다.[windows] sandbox = "unelevated" - 샌드박스 설정이 다시 로드되도록 Codex Desktop 또는 ChatGPT Desktop을 완전히 종료한 뒤 앱을 다시 엽니다. 설정을 바꾸지 않고 앱만 재시작하는 것으로는 elevated 샌드박스 실패가 해결되지 않았다고 보고되었습니다(openai/codex#51601 및 openai/codex#51590에서 보고됨).
- 빌드, 테스트, Browser Use, 또는 Computer Use 워크플로를 다시 시도하기 전에 Codex에서
Get-Location같은 최소한의 샌드박스 명령 하나를 실행합니다.
작동 여부 확인 방법: 요청한 명령이 프로세스 생성 전에 실패하지 않고 시작 및 완료되어야 합니다. 성공한 우회 사례에서는 unelevated로 전환한 뒤 샌드박스 PowerShell 명령이 완료되고 Browser Control이 초기화되었습니다(openai/codex#51590에서 우회 방법으로 보고됨).
그래도 실패하는 경우: %USERPROFILE%\.codex\.sandbox\sandbox.<date>.log와 %USERPROFILE%\.codex\.sandbox\setup_error.json을 수집한 다음, Codex 패키지 버전, About 버전, 번들 CLI/helper 버전, Windows 버전, 샌드박스 설정, 실패한 런타임 경로, 정확한 runtime read/execute validation failed 줄을 기존 GitHub 이슈에 보고합니다. 다음 해결책으로 수동 ACL 사전 부여에 의존하지 마세요. 재귀적 (RX) ACE를 적용해도 실패가 달라지지 않았다는 보고가 있었습니다(openai/codex#51634에서 보고됨). 로컬 실행이 작동한 뒤 다음 오류가 API/provider 오류라면 일반 오류 처리 가이드를 사용해 재시도 가능한 API 실패와 이 로컬 Windows 샌드박스 시작 실패를 구분합니다.
Computer Use에서 trusted Node process exited unexpectedly
trusted Node process exited unexpectedly
node_repl kernel exited unexpectedly
windows sandbox failed: helper_unknown_error: setup refresh had errors
Computer Use, Browser Use, 또는 Node REPL이 먼저 같은 Windows 샌드박스 설정 refresh 실패로 실패하는 경우, Codex가 trusted Node process exited unexpectedly 또는 node_repl kernel exited unexpectedly를 표시할 수 있습니다(openai/codex#51590, openai/codex#51601, openai/codex#51634에서 보고됨). await cua.getState(), sky.list_apps(), 또는 브라우저/앱 검색이 탭이나 앱을 반환하기 전에 실패하고, 일반 샌드박스 셸 명령도 실행 전에 실패한다면 이 경우에 해당합니다(openai/codex#51590에서 보고됨).
- Node 오류가 같은 샌드박스 설정 실패에 의해 뒷받침되는지 확인합니다.
Select-String -Path "$env:USERPROFILE\.codex\.sandbox\sandbox.*.log" ` -Pattern "node_repl.exe","VCRUNTIME140_1.dll","runtime read/execute validation failed","setup refresh had errors" ` -Context 0,3 - 로그에 같은 런타임 읽기/실행 검증 실패가 표시되면 같은 임시 샌드박스 설정을 적용합니다.
[windows] sandbox = "unelevated" - Codex Desktop 또는 ChatGPT Desktop을 완전히 종료했다가 다시 엽니다.
node_repl.exe만 종료하는 것은 지속적인 복구를 제공하지 않는다고 보고되었습니다. 실패가VCRUNTIME140_1.dll처럼 사용 중인 다른 런타임 파일로 옮겨갈 수 있기 때문입니다(openai/codex#51601 및 openai/codex#51634에서 보고됨). - 영향을 받은 작업 중 가장 작은 작업부터 다시 시도합니다. 샌드박스
Get-Location을 실행한 다음 Browser Use 또는 Computer Use 초기화를 다시 시도합니다.
작동 여부 확인 방법: Computer Use 또는 Browser Use가 브라우저나 앱 인벤토리 전에 실패하지 않고 초기화되어야 하며, 재시도에 대해 샌드박스 로그에 치명적인 runtime read/execute validation failed 줄이 더 이상 표시되지 않아야 합니다. 이후 한 사용자 보고에서는 최신 확인과 함께 PowerShell, node_repl, Computer Use, sky.list_apps()가 작동했고 샌드박스 refresh가 errors=[]를 보고했다고 했지만, 해당 자료에는 그 복구에 대한 maintainer 릴리스 노트가 포함되어 있지 않았습니다(openai/codex#51590에서 보고됨).
그래도 실패하는 경우: 업데이터가 더 새로운 Codex Windows 빌드를 제공하면 설치한 뒤 같은 최소 명령으로 다시 테스트합니다. 업데이터가 앱이 이미 최신이라고 보고하면 런타임 디렉터리를 반복해서 재설정하는 대신 샌드박스 로그와 버전 세부 정보를 GitHub 이슈에 첨부합니다. 재설치 또는 롤백 후 로컬 실행이 다시 작동하지만 provider 설정이 누락되어 있다면 Codex model-provider configuration을 사용해 Codex 측 provider 설정을 다시 구성합니다.
검증 방법
- elevated Windows 샌드박스 ACL 공유 위반 가능성: 2026-10-07 및 2026-10-08의 여러 사용자 보고에 활성
cua_node파일에서runtime read/execute validation failed,open ACL target for root-only update,os error 32샌드박스 로그 줄이 포함되어 있었습니다(openai/codex#51601, openai/codex#51634, openai/codex#51590). unelevated우회 방법: 한 사용자가 2026-10-08에config.toml을[windows] sandbox = "unelevated"로 변경하자 Codex Desktop26.1002.7124.0에서 샌드박스 PowerShell과 Browser Control이 복구되었다고 보고했습니다. 같은 보고는unelevated를elevated보다 격리가 약한 fallback으로 설명한 OpenAI 문서를 인용했습니다(openai/codex#51590).- 다운그레이드는 사용자 우회 방법일 뿐, 여기서의 주요 해결책은 아님: 사용자들은 패키지
26.930.7945.0및 번들 CLI0.160.1같은 이전의 완전한 desktop 빌드로 다운그레이드한 뒤 복구되었다고 보고했지만, 해당 자료는 공식 롤백 절차나 maintainer 권장 사항을 제공하지 않았습니다(openai/codex#51590 및 openai/codex#51601).
문서: 로컬 명령 실행이 다시 작동한 뒤 Codex provider 설정을 복구하거나 업데이트하려면 Codex model-provider configuration을 사용하세요. → Codex model-provider configuration
관련 문서
로컬 명령 실행을 복구한 Codex 사용자는 provider 설정과 샌드박스가 아닌 오류 처리를 위해 다음 문서를 사용할 수 있습니다.
출처
이 글의 Codex Windows 샌드박스 관련 내용은 공개 GitHub 이슈 보고와 그 보고 안에서 인용된 공식 Windows 샌드박스 문서에서 가져왔습니다.
- openai/codex#51601: Windows 앱
26.1002.51308/ 빌드13417에서 활성 런타임 파일을 검증하는 동안 공유 위반으로 샌드박스 설정이 실패함. - openai/codex#51634:
cua_node런타임 파일이 사용 중일 때 Windows 샌드박스 provisioning이os error 32로 실패하며,0.162.0-alpha.2에 대해 보고됨. - openai/codex#51590: Windows 샌드박스가 실행 중인
node_repl.exe를 ACL 업데이트 대상으로 열지 못함.unelevated우회 방법 및 이후 복구 확인 보고를 포함함. - openai/codex#51590에서 사용자들이 인용한 OpenAI Windows 샌드박스 문서:
https://learn.chatgpt.com/docs/windows/windows-sandbox.
자주 묻는 질문
- Windows에서 Codex helper_unknown_error: setup refresh had errors가 발생하나요?
- 보고된 Windows 사례 대부분은 elevated sandbox 런타임의 ACL 공유 위반일 가능성이 큽니다. 임시 우회책으로 Codex Windows sandbox 설정을 unelevated로 바꾸거나, 업데이터에서 제공한다면 더 최신의 수정된 빌드를 설치하세요.
- Windows 업데이트 후 Codex가 trusted Node process exited unexpectedly라고 표시하는 이유는 무엇인가요?
- 이 Node 오류는 같은 Windows sandbox 설정 실패의 2차 증상일 수 있습니다. Codex가 Computer Use 또는 Browser Use를 초기화하기 전에 실패하는 경우입니다.
- os error 32가 같은 Codex sandbox 버그인지 어떻게 확인하나요?
- Codex sandbox 로그에서 node_repl.exe, node.exe 또는 VCRUNTIME140_1.dll에 대한 runtime read/execute validation failed와 os error 32를 함께 검색하세요.


