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

실용적 조언

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가 불필요한 데이터를 컨텍스트에 주입하는 것을 원천적으로 차단할 수 있음이 입증됐다.

용어 해설

줄바꿈 문자 (CRLF/LF)(CRLF/LF): — Windows(CRLF)와 Unix/Linux(LF) 시스템 간의 서로 다른 줄바꿈 처리 방식이다. 운영체제 간 파일을 공유할 때 이 형식이 일치하지 않으면 실제 코드 변경 없이도 Git이 모든 줄이 수정된 것으로 인식하여 불필요한 차이점을 생성한다.
토큰 고갈(Token Exhaustion): — LLM이 한 번에 처리할 수 있는 최대 정보량인 컨텍스트 윈도우가 가득 차서 더 이상 새로운 입력을 받거나 정상적인 추론을 할 수 없는 상태이다. 불필요한 데이터가 컨텍스트를 점유하면 모델의 성능이 급격히 저하되거나 세션이 중단된다.
깃 속성 설정 파일(.gitattributes): — Git 저장소의 경로별 속성을 정의하는 설정 파일이다. 줄바꿈 자동 변환(text=auto) 설정을 통해 서로 다른 운영체제 환경에서도 일관된 줄바꿈 형식을 유지하도록 강제하여 환경 차이로 인한 불필요한 diff 발생을 방지한다.

언급된 도구

Claude Code중립

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

Git추천

버전 관리 시스템 및 diff 생성