Windows용 Claude Code VSCode 확장 프로그램의 Ripgrep 검색 오류 해결 방법

커뮤니티 반응

작성자가 직접 겪은 불편함을 해결하기 위해 만든 도구에 대해 긍정적인 반응이 예상되며, 특히 로그 스팸 문제 해결에 공감하는 분위기이다.

주요 논점

01찬성다수

공식 업데이트 전까지 검색 성능 저하와 로그 오류를 막기 위해 외부 패치나 수동 설치가 필요하다.

합의점 vs 논쟁점

합의점

현재 Claude Code v2.1.113 이상의 Windows 버전에서 ripgrep 관련 버그가 실재한다
VSCode의 기본 findFiles API는 ripgrep 네이티브 실행보다 성능이 떨어진다

실용적 조언

터미널에서 'scoop install ripgrep'을 실행하여 즉시 오류를 해결할 수 있다
수동 관리가 귀찮다면 작성자의 GitHub에서 패치용 VSIX 파일을 다운로드하여 설치한다

섹션별 상세

Claude Code v2.1.113 버전부터 아키텍처가 JavaScript CLI에서 단일 정적 컴파일 바이너리인 claude.exe로 변경됐다. 이 과정에서 기존에 포함되어 있던 rg.exe가 누락되었으나 확장 프로그램은 여전히 이를 호출하려고 시도한다. 결과적으로 spawn rg.exe ENOENT 에러가 발생하며, 시스템은 더 느린 VSCode findFiles API로 대체 작동하게 된다.

bash

scoop install ripgrep
# 또는
winget install BurntSushi.ripgrep.MSVC

시스템 PATH에 ripgrep을 수동으로 설치하여 에러를 해결하는 방법

가장 간단한 수동 해결책은 scoop이나 winget 같은 패키지 매니저를 통해 ripgrep을 시스템 PATH에 직접 설치하는 것이다. 설치 후 execFile 호출이 정상적으로 rg.exe를 찾게 되면 오류 로그가 사라지고 검색 속도가 회복된다. 하지만 이는 모든 사용자가 수동으로 환경 변수를 설정해야 한다는 번거로움이 있다.

작성자가 개발한 'claude-code-rg-patcher'는 Claude Code의 리소스 폴더에 rg.exe가 없을 경우에만 자동으로 파일을 복사해 넣는다. 이 도구는 Claude Code의 버전 업데이트(예: 2.1.120에서 2.1.121로 변경)를 감시하여 새로운 설치 본에도 자동으로 패치를 적용한다. Anthropic이 공식적으로 rg.exe를 다시 포함할 경우 기존 파일을 덮어쓰지 않도록 설계되어 안전성을 확보했다.

용어 해설

립그렙(ripgrep): — Rust로 작성된 고성능 텍스트 검색 도구로, 정규 표현식을 사용하여 파일 내 패턴을 매우 빠르게 찾아낸다. Claude Code와 같은 코딩 에이전트가 파일 컨텍스트를 검색할 때 핵심 엔진으로 사용되며, 실행 파일 이름은 rg.exe이다.
파일 없음 에러(ENOENT): — Error No Entity의 약자로, 시스템이 지정된 경로에서 파일이나 디렉토리를 찾을 수 없을 때 발생하는 운영체제 에러 코드이다. 이 아티클에서는 Claude Code가 실행에 필요한 rg.exe를 찾지 못해 발생하는 오류를 의미한다.
VSCode 확장 프로그램 패키지(VSIX): — Visual Studio Code 확장 기능을 배포하기 위한 패키지 파일 형식이다. 확장 프로그램의 코드, 메타데이터, 리소스를 하나로 묶어 사용자가 오프라인에서도 설치할 수 있게 한다.

언급된 도구

ripgrep추천

고성능 텍스트 검색 엔진

scoop추천

Windows용 커맨드라인 패키지 매니저

winget추천

Windows 패키지 관리 도구

언급된 리소스

GitHubclaude-code-rg-patcher GitHub Releases