Git Worktree가 Claude Code의 토큰 소모 문제의 원인일까?

커뮤니티 반응

작성자의 발견에 대해 Claude 에이전트가 기술적 메커니즘을 확인하며 동의했고, 많은 사용자가 겪는 토큰 소진 문제의 구체적인 원인으로 지목됐다.

주요 논점

01찬성다수

오래된 worktree 사본이 검색 도구의 부하를 늘려 토큰을 낭비하게 만든다는 주장에 대해 AI 에이전트도 그 메커니즘을 인정했다.

합의점 vs 논쟁점

합의점

.claude/worktrees/ 폴더 내의 중복 사본이 검색 도구의 부하를 8배 이상 늘릴 수 있다.
이러한 사본들은 수동으로 정리하거나 향후 관리 로직 개선이 필요하다.

논쟁점

해당 현상이 최근 업데이트된 네이티브 Git worktree 지원 기능의 버그인지 아니면 특정 설정 환경에서의 예외 상황인지에 대한 논의가 있다.

실용적 조언

.claude/worktrees/ 디렉토리를 주기적으로 확인하여 오래된 프로젝트 사본을 수동으로 삭제한다.
jest 설정 등 테스트 러너의 설정에서 .claude 폴더를 스캔 대상에서 제외(exclude)하도록 구성한다.

섹션별 상세

Claude Code가 프로젝트 내 .claude/worktrees/ 디렉토리에 여러 개의 Git worktree 사본을 생성하여 토큰 소모를 급증시키는 현상이 발견됐다. 사용자는 jest 테스트 실행 시 평소 4,000개 수준이던 테스트가 37,000개로 늘어난 것을 보고 8개의 오래된 프로젝트 사본이 잔류하고 있음을 확인했다. Grep이나 Glob 같은 파일 검색 도구가 이 모든 사본을 중복 스캔하면서 검색 결과에 포함되는 텍스트 양이 8배로 늘어나 토큰이 낭비되는 방식이다. 이는 최근 도입된 네이티브 Git worktree 지원 기능의 미흡한 정리 로직으로 인해 발생한 문제로 판단된다.

용어 해설

깃 워크트리(Git Worktree): — 하나의 Git 저장소에서 여러 개의 작업 디렉토리를 동시에 관리할 수 있게 해주는 기능이다. Claude Code는 병렬 작업이나 컨텍스트 분리를 위해 이를 활용하지만, 사용 후 제대로 삭제되지 않으면 프로젝트 내에 중복된 코드 사본이 쌓이게 된다.
토큰 사용량(Token Usage): — LLM 서비스 이용 시 입력과 출력 텍스트 양에 따라 계산되는 비용 및 할당량 단위이다. 검색 도구가 불필요한 파일 사본까지 읽어 들여 프롬프트에 포함할 경우 사용자의 할당량이 예상보다 훨씬 빠르게 소진되는 원인이 된다.
그렙 및 글로브(Grep/Glob): — 특정 패턴을 가진 파일을 찾거나 텍스트를 검색하는 유틸리티이다. Claude Code 에이전트가 코드베이스를 파악할 때 이 도구들을 호출하는데, 제외 설정이 미비하면 숨겨진 폴더 내의 중복 파일까지 모두 스캔 대상으로 삼아 토큰 소모를 가속화한다.

언급된 도구

Claude Code중립

AI 코딩 에이전트

jest중립

자바스크립트 테스트 프레임워크