Claude Code VS Code 확장 프로그램 v2.1.128/129 버전의 사이드바 오류 및 해결 방법

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Claude Code VS Code 확장 프로그램 최신 버전에서 사이드바 UI가 작동하지 않는 회귀 버그가 발생하여 이전 버전으로의 다운그레이드가 권장된다.

배경

2026년 5월 6일 배포된 Claude Code VS Code 확장 프로그램 v2.1.128 및 v2.1.129 버전에서 사이드바 아이콘을 클릭해도 패널이 열리지 않는 오류가 발생하여 이에 대한 원인과 해결책이 공유되었다.

의미 / 영향

Claude Code와 같은 활발히 업데이트되는 도구에서 빌드 환경 설정 오류로 인한 회귀 버그가 반복될 수 있음을 보여준다. 개발자는 자동 업데이트에 의존하기보다 안정적인 버전을 고정하여 사용하는 워크플로우를 고려할 필요가 있다.

커뮤니티 반응

많은 사용자가 동일한 증상을 겪고 있으며, 윈도우 환경에서의 경로 인식 문제가 주요 원인이라는 점에 동의하고 있습니다.

주요 논점

01중립다수

최신 업데이트의 버그 발생 사실을 알리고 구체적인 다운그레이드 절차를 안내함

합의점 vs 논쟁점

합의점

v2.1.128 및 v2.1.129 버전은 현재 사용이 불가능한 수준의 UI 결함이 있음
이전 버전으로의 다운그레이드가 현재로서는 유일하고 확실한 해결책임

실용적 조언

VS Code 확장 탭에서 Claude Code의 설정(톱니바퀴)을 눌러 'Install Another Version...'을 선택하고 v2.1.119를 설치하세요.
설치 후 반드시 'Auto Update'를 비활성화하여 자동으로 버그 버전으로 복구되지 않도록 설정하세요.

섹션별 상세

Claude Code 확장 프로그램의 사이드바 아이콘을 클릭할 때 내부 명령어인 claude-vscode.editor.openLast가 등록되지 않아 패널이 열리지 않는 문제가 발생했다. 이는 확장 프로그램이 시작될 때 활성화 단계에서 실패하기 때문이며, 터미널에서 사용하는 CLI 명령어는 영향을 받지 않고 정상 작동한다.

해당 버그의 원인은 확장 프로그램 패키지 내부에 리눅스 환경의 빌드 경로가 하드코딩되어 포함되었기 때문으로 분석됐다. /home/runner/work/claude-cli-internal/와 같은 경로가 윈도우 환경에서 해석되지 않아 전체 확장의 활성화를 차단하며, 주로 윈도우 11 사용자들에게서 집중적으로 보고되었다.

가장 확실한 해결책으로 제시된 방법은 확장 프로그램을 안정적인 이전 버전인 v2.1.49 또는 v2.1.119로 다운그레이드하는 것이다. VS Code 확장 관리자에서 '다른 버전 설치' 메뉴를 통해 버전을 변경한 후, 자동 업데이트 기능을 해제하여 버그가 있는 버전으로 다시 업데이트되는 것을 방지해야 한다.

실무 Takeaway

Claude Code v2.1.128/129 버전에서 사이드바 UI가 먹통이 되는 현상은 개별 환경 문제가 아닌 확장 프로그램 자체의 빌드 경로 오류로 인한 공통 버그이다.
VS Code의 그래픽 인터페이스가 작동하지 않더라도 터미널의 claude CLI는 정상적으로 사용할 수 있어 긴급한 작업 수행은 가능하다.
문제 해결을 위해 v2.1.119 이하 버전으로 다운그레이드하고 설정에서 Auto Update 체크를 해제하는 조치가 즉각적으로 필요하다.

언급된 도구

Claude Code중립

VS Code 내에서 사용하는 AI 코딩 보조 도구