비주얼 코드에서 클로드 코드 실행 안되는 원인

Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state..

 

결론부터 말씀드리면,  Claude Code 설정 문제가 아니라 VS Code 자체(정확히는 VS Code 속 크롬 엔진)의 오래된 고질 버그입니다. 2021년부터 마이크로소프트 공식 이슈로 열려 있고, 대부분 창 새로고침이나 VS Code 재시작으로 바로 해결됩니다.

왜 이런 오류가 나는가 

Claude Code 창은 VS Code 안에 작은 "웹 브라우저 창"(webview = VS Code 안에 끼워 넣는 미니 웹페이지)을 띄워서 동작합니다. 이 미니 웹페이지를 띄울 때 VS Code는 "서비스 워커"라는 심부름꾼 직원을 먼저 등록해야 하는데, 이 직원은 화면에 필요한 파일들을 가져다주는 역할을 합니다.

그런데 가끔 직원 등록을 하려는 순간에, 정작 일할 가게(웹페이지 문서)가 아직 준비가 안 됐거나 이미 문을 닫아 버린 상태가 됩니다. 그러면 크롬 엔진이 "가게가 이상한 상태라서 직원 등록 못 하겠다(The document is in an invalid state)"라고 거부하고, 그 결과 Claude Code 창이 빈 화면 또는 이 오류 문구만 보이게 됩니다.

이런 상황은 주로 아래 같은 타이밍에 일어난다고 합니다:

• VS Code가 방금 켜지거나 새로고침되는 중에 Claude Code 창이 같이 열리려고 할 때
• 창(패널)이 만들어지자마자 숨겨지거나 닫힐 때
• 즉, "운 나쁘게 타이밍이 겹치는" 경우라서 매번 나는 게 아니라 가끔 납니다

해결 방법 

1. VS Code 창 새로고침 — Ctrl+Shift+P → Developer: Reload Window 입력 후 실행. 대부분 여기서 끝납니다.
2. Claude Code 창만 닫았다가 다시 열기 — 패널을 닫고 다시 여는 것만으로도 풀리는 경우가 많습니다.
3. VS Code 완전히 종료 후 재실행 — 창을 닫는 것만으론 뒤에서 프로세스가 살아 있을 수 있으니, 작업 관리자에서 Code.exe가 다 꺼졌는지 확인하고 다시 켜세요.
4. 그래도 반복되면 VS Code 캐시 폴더 정리 후 재시작 (Windows 기준 %APPDATA%\Code\Cache, CachedData 등)을 권하는 글이 있습니다.
5. 참고 자료
   • microsoft/vscode#125993 — Webview Service Worker Error in registration due to invalid document state (근본 원인 추적 이슈, 2021년부터 열려 있음)
   • microsoft/vscode#224054 — 동일 오류 제보
   • microsoft/vscode#247035 — 확장 프로그램들이 이 오류로 안 뜨는 제보
   • bobbyhadz — Error loading webview: Could not register service workers 해결법