클로드 코드 토큰 절약 3가지 — 사용량 제한 탈출 실전 가이드

왜 토큰이 그렇게 빨리 닳는 걸까

클로드 코드를 처음 쓸 때 가장 당황스러운 게 뭔지 알아요? 뭔가 거창한 작업을 한 것도 아닌데 금방 사용량 한도에 부딪히는 거예요. 처음엔 내가 너무 길게 대화해서 그런가 싶었는데, 구조를 파고들어 보면 진짜 원인이 따로 있어요. 클로드가 코드를 찾으러 다니면서 파일을 뒤지는 그 과정, 즉 탐색 자체에서 토큰의 80~90%가 이미 증발하고 있다는 거예요. 내가 "이 함수 수정해줘"라고 한 마디 했는데, 클로드는 그 함수 찾으러 프로젝트 전체를 훑고 있었던 겁니다.

기법 1 — 읽는 양 자체를 줄여라

가장 먼저 할 일은 .claudeignore 파일을 만드는 거예요. node_modules, build, .next 같은 폴더는 클로드가 굳이 볼 필요가 없는데 기본적으로 다 읽어버려요. 이걸 무시 목록에 넣는 것만으로 꽤 의미 있는 절약이 돼요. 거기에 CLAUDE.md도 점검해볼 필요가 있어요. 이 파일이 클로드한테는 일종의 프로젝트 설계도인데, 내용이 길면 길수록 매 세션마다 전부 읽어 들여요. 200줄 이내로 유지하고 상세 규칙은 별도 파일로 빼두는 게 맞아요. 세션이 길어졌다 싶으면 /compact로 요약하거나 /clear로 깔끔하게 초기화하는 것도 습관처럼 들여놔야 해요.

기법 2 — 탐색 방식을 바꿔라 (91% 절감의 비밀)

이게 개인적으로 가장 충격적이었던 부분이에요. QMD 같은 도구로 프로젝트를 미리 인덱싱해두면, 클로드가 전체 파일을 훑는 대신 검색 엔진처럼 위치를 바로 찾아가요. 실제 사례를 보면 인증 로직 하나 탐색하는 데 2,700개 토큰이 쓰이던 게 250개로 줄었어요. 같은 작업인데 토큰은 91% 덜 쓴 거예요. 처음 인덱싱 설정에 약간의 시간이 들지만, 그 이후로는 계속 효과를 봐요. 큰 프로젝트일수록 이 차이가 더 극단적으로 벌어지고요.

기법 3 — 역할을 셋으로 나눠라

하나의 에이전트한테 "이거 다 해줘"라고 던지면 범위를 스스로 해석해서 요청하지 않은 파일까지 건드리는 경우가 생겨요. 이걸 막는 게 3-에이전트 구조예요. 아키텍트가 먼저 뭘 할지 브리프를 작성하고, 빌더는 그 브리프에 적힌 것만 정확히 구현해요. 리뷰어는 결과물을 검증하고 피드백을 돌려줘요. 각자 맡은 역할 밖으로 나가지 않으니까 불필요한 탐색 자체가 원천 차단돼요. 직접 써보니 "삽질"이라고 부를 만한 상황이 확실히 줄더라고요.

3가지 기법 효과 비교

마치며 — 적게 쓰는 게 아니라 잘 쓰는 것

토큰 절약이라고 하면 뭔가 아끼는 느낌이 들지만, 실제로는 클로드가 쓸데없는 곳에 에너지를 낭비하지 않도록 구조를 잡아주는 거예요. 어떻게 보면 클로드를 더 잘 쓰기 위한 환경 설계에 가깝고요. 세 가지 다 한꺼번에 적용하기 어렵다면, .claudeignore부터 시작해보세요. 파일 하나 만드는 데 5분도 안 걸리고, 체감은 꽤 바로 와요.