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

커뮤니티 반응

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

주요 논점

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 확장 관리자에서 '다른 버전 설치' 메뉴를 통해 버전을 변경한 후, 자동 업데이트 기능을 해제하여 버그가 있는 버전으로 다시 업데이트되는 것을 방지해야 한다.

용어 해설

회귀 버그(Regression Bug): — 이전에 수정되었던 버그가 소프트웨어 업데이트 과정에서 다시 발생하는 현상이다. 본문에서는 Claude Code의 특정 명령어가 실행되지 않는 문제가 과거 버전들에 이어 최신 버전에서 다시 나타난 상황을 의미한다.
확장 프로그램 활성화(Extension Activation): — VS Code가 실행될 때 설치된 확장 기능의 코드를 메모리에 로드하고 초기화하는 과정이다. 빌드 경로 오류 등으로 인해 활성화에 실패하면 해당 확장이 제공하는 사이드바 UI나 명령어를 사용할 수 없게 된다.
명령줄 인터페이스(CLI): — 텍스트 터미널을 통해 사용자가 컴퓨터와 상호작용하는 방식이다. 이번 장애에서 VS Code의 그래픽 UI는 작동하지 않지만, 터미널에서 직접 실행하는 claude 명령어는 정상적으로 동작하는 차이를 보인다.

언급된 도구

Claude Code중립

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