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

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

핵심 요약

Claude Code가 생성한 stale Git worktree가 도구 스캔 범위를 8배 늘려 토큰 소모를 가속화하는 현상과 해결책 공유

배경

Claude Code 사용 중 갑작스러운 토큰 소모량 급증을 경험한 사용자가 프로젝트 내 .claude/worktrees 폴더에 남은 중복 사본들이 원인임을 발견하고 이를 공유했다.

의미 / 영향

Claude Code의 효율적인 사용을 위해서는 자동 생성되는 임시 작업 디렉토리 관리가 필수적이다. 도구들이 .gitignore를 완벽히 준수하지 않을 수 있으므로, 사용자는 파일 시스템 수준의 정리를 병행하여 불필요한 비용 발생을 막아야 한다.

커뮤니티 반응

작성자의 발견에 대해 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 지원 기능의 미흡한 정리 로직으로 인해 발생한 문제로 판단된다.

실무 Takeaway

Claude Code 사용 중 토큰이 비정상적으로 빠르게 소진된다면 .claude/worktrees/ 경로에 stale 사본이 있는지 확인해야 한다.
Grep, Glob 등 저장소 스캔 도구가 .gitignore 설정을 완벽히 따르지 않을 경우 중복된 파일들을 모두 읽어 들여 비용을 발생시킨다.
정기적으로 .claude 폴더 내의 불필요한 worktree를 삭제하여 검색 범위를 최적화하고 토큰 효율을 높이는 관리가 필요하다.

언급된 도구

Claude Code중립

AI 코딩 에이전트

jest중립

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