Claude Code의 윈도우/WSL 환경 줄바꿈 버그로 인한 토큰 고갈 문제와 해결책

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

TL;DR

Windows와 WSL 혼용 환경에서 Claude Code가 줄바꿈 차이를 코드 수정으로 오인해 컨텍스트 윈도우를 과다 점유하는 버그와 .gitattributes를 통한 해결 방법이 공유됐다.

배경

Windows와 WSL 환경을 혼용하여 사용하는 개발자가 Claude Code 사용 중 발생한 비정상적인 토큰 소모 현상의 원인을 파악하고 이를 해결한 경험을 공유했다.

의미 / 영향

AI 코딩 에이전트가 로컬 개발 환경의 인프라 설정(줄바꿈, 인코딩 등)에 민감하게 반응하며, 이는 단순한 불편함을 넘어 토큰 비용 폭증과 세션 마비로 이어질 수 있다. 개발자는 AI 도구 도입 시 Git 환경 정규화와 같은 전통적인 협업 설정을 더욱 엄격하게 관리해야 한다.

커뮤니티 반응

작성자가 구체적인 수치(84% 소모, 69개 파일)와 해결 코드를 함께 제시하여 실용적인 정보로 평가받고 있습니다.

주요 논점

01찬성다수

Claude Code의 diff 흡수 로직에 공백 무시 기능이 없어 발생하는 명백한 도구적 결함이다.

합의점 vs 논쟁점

합의점

혼합 OS 환경에서 .gitattributes 설정은 AI 도구 사용 시 필수적인 선행 작업이다.
Claude Code의 현재 토큰 관리 로직은 대규모 diff 발생 시 매우 취약하다.

실용적 조언

Claude Code 사용 전 프로젝트 루트에 .gitattributes 파일을 만들고 * text=auto를 입력하세요.
설정 적용을 위해 git add --renormalize . 명령어를 실행하여 기존 파일들을 정리하세요.

섹션별 상세

Windows와 WSL 환경에서 Git을 사용할 때 발생하는 CRLF/LF 줄바꿈 불일치가 Claude Code의 오작동을 유발한다. Claude Code가 git diff 명령을 실행할 때 실제 코드 변경이 없어도 모든 줄바꿈 차이를 수정 사항으로 인식하여 방대한 양의 diff 데이터를 생성하기 때문이다. 이로 인해 69개 파일의 줄바꿈 변경만으로도 컨텍스트 윈도우의 약 84%가 단 1분 만에 소모되는 현상이 확인됐다.

text

* text=auto

.gitattributes 파일에 추가하여 줄바꿈 형식을 자동 정규화하는 설정

bash

git add --renormalize .

설정 변경 후 기존 파일들의 줄바꿈 형식을 일괄 정규화하는 명령어

과도하게 생성된 공백(whitespace) 위주의 diff 데이터가 컨텍스트 윈도우에 캐싱되면서 세션 전체가 오염되는 문제가 발생한다. Claude Code는 이후 간단한 정보 요청 시에도 이 거대한 diff 데이터를 계속 참조하게 되어 사실상 세션 사용이 불가능한 '벽돌(bricking)' 상태가 된다. 작성자는 Anthropic이 공백만 있는 diff를 무시하거나 절삭하는 로직을 도입해야 한다고 지적했다.

이 문제를 해결하기 위해 저장소 루트에 .gitattributes 파일을 생성하고 '* text=auto' 설정을 추가하는 방법이 제시됐다. 설정 후 'git add --renormalize .' 명령어를 실행하면 Git이 줄바꿈 형식을 일관되게 정규화하여 환경 차이로 인한 허위 수정 보고를 중단한다. 이 조치를 통해 Claude Code가 불필요한 데이터를 컨텍스트에 주입하는 것을 원천적으로 차단할 수 있음이 입증됐다.

실무 Takeaway

Claude Code는 git diff 결과를 필터링 없이 컨텍스트에 주입하므로 줄바꿈 설정 오류가 치명적인 비용 및 성능 저하를 야기한다.
Windows와 WSL을 혼용하는 환경에서는 .gitattributes 설정을 통해 줄바꿈 형식을 반드시 정규화해야 AI 코딩 에이전트의 오작동을 막을 수 있다.
현재 Anthropic의 지원팀은 이 도구적 결함을 사용자 사용량 문제로 치부하고 있어 개발자의 직접적인 환경 설정 최적화가 필수적이다.

언급된 도구

Claude Code중립

AI 기반 코딩 에이전트 및 CLI 도구

Git추천

버전 관리 시스템 및 diff 생성