클로드 코드(Claude Code) 토큰 사용량을 줄이면 같은 요금제로 2배 이상 많은 작업을 처리할 수 있다. Anthropic 공식 데이터에 따르면 평균 개발자의 하루 토큰 비용은 약 6달러이며, 90%의 사용자가 12달러 이하로 유지한다. 이 글에서는 컨텍스트 관리, 모델 선택, 프롬프트 최적화까지 토큰을 아끼는 핵심 전략 7가지를 정리했다.
1. 컨텍스트 윈도우의 작동 원리를 이해하라
토큰 낭비의 근본 원인은 컨텍스트 윈도우 누적 구조에 있다. Claude Code는 매 요청마다 이전 대화 전체를 함께 전송한다. 첫 번째 메시지에서 1,000토큰을 사용했다면, 두 번째 메시지에서는 첫 번째 대화 내역까지 포함해 2,000토큰 이상이 입력으로 들어간다. 열 번째 요청 시점에는 1번부터 9번까지의 모든 대화가 입력 토큰에 포함되는 셈이다.
현재 Claude 모델의 컨텍스트 윈도우는 200K 토큰이다. 이 한계에 가까워지면 Claude가 이미 작성한 코드를 다시 생성하거나, 앞서 한 말을 잊어버리는 현상이 발생한다. 세션 초반에는 빠르고 정확하던 응답이 후반에 느려지는 이유가 바로 이것이다.
핵심은 간단하다. 컨텍스트를 작게 유지할수록 응답 속도와 정확도가 올라가고, 토큰 비용은 내려간다.
2. /compact와 /clear 명령어로 세션을 관리하라
세션 관리는 토큰 절약의 가장 즉각적인 방법이다. Claude Code는 두 가지 핵심 명령어를 제공한다.
1) /compact로 대화를 압축하라
/compact는 현재 대화 내역을 요약해서 컨텍스트 크기를 줄여준다. auto-compact 기능이 약 75% 지점에서 자동 트리거되지만, 그 전에 수동으로 실행하면 보존할 맥락을 직접 지정할 수 있다. /compact 뒤에 커스텀 지시를 추가하면 특정 정보를 우선 보존하도록 요청할 수도 있다.
2) /clear로 완전히 초기화하라
/clear는 대화 내역을 완전히 삭제하고 빈 상태로 시작한다. 작업 주제가 바뀌거나 이전 대화가 현재 작업에 방해될 때 사용한다. 관련 없는 작업으로 전환하면서 /clear를 사용하지 않으면, 오래된 컨텍스트가 이후 모든 메시지에서 토큰을 낭비한다.
3) 세션 단위를 PR 기준으로 나눠라
하나의 풀 리퀘스트가 될 수 있는 단위로 세션을 분리하면 자연스럽게 컨텍스트가 관리된다. 버그 수정, 기능 추가, 리팩터링 각각을 별도 세션으로 운영하는 것이 효율적이다. 전환 전에 /rename으로 세션 이름을 지정해두면 나중에 /resume으로 돌아올 수 있다.
3. CLAUDE.md 파일을 최적화하라
CLAUDE.md는 Claude Code가 세션 시작 시 자동으로 읽어들이는 프로젝트 설정 파일이다. 이 파일의 내용은 매 API 호출마다 시스템 프롬프트에 포함되므로, 파일이 길수록 매 요청의 토큰 비용이 올라간다.
Anthropic 공식 문서에서는 CLAUDE.md를 500줄 이하로 유지하라고 권장한다. 불필요한 내용 1,000토큰당 Sonnet 4.6 기준으로 메시지당 약 0.003달러가 추가되며, 하루 수백 개의 메시지에 걸쳐 누적되면 무시할 수 없는 금액이 된다.
최적화 방법은 다음과 같다.
필수 정보만 남기는 것이 첫 번째다. 빌드 명령어, 코딩 컨벤션, 아키텍처 핵심 사항만 포함한다. PR 검토 절차나 데이터베이스 마이그레이션 가이드처럼 특정 상황에서만 필요한 지침은 별도 파일로 분리한 뒤 @path/to/file 구문으로 참조한다. 이렇게 하면 해당 정보가 필요할 때만 로드되어 기본 컨텍스트가 작게 유지된다.
정기적으로 검토하는 것도 중요하다. 몇 주에 한 번씩 Claude에게 CLAUDE.md를 리뷰해달라고 요청하면, 중복되거나 오래된 내용을 정리할 수 있다.
4. 프롬프트를 구체적이고 한 번에 작성하라
모호한 프롬프트는 토큰 낭비의 주범이다. Anthropic 공식 문서에서도 구체적인 요청이 첫 시도 성공률을 크게 높인다고 강조한다.
나쁜 예시와 좋은 예시를 비교하면 차이가 명확하다. “이 코드베이스 개선해줘”라는 모호한 요청은 Claude가 전체 프로젝트를 광범위하게 스캔하도록 유도한다. 반면 “auth.ts의 로그인 함수에 입력 검증 추가해줘”라는 구체적인 요청은 최소한의 파일 읽기로 효율적인 작업을 가능하게 한다.
여러 개의 작은 질문으로 나누는 것도 피해야 한다. “함수 X가 뭐하는 거야?”와 “함수 Y가 뭐하는 거야?”를 따로 묻는 대신, “함수 X와 Y를 설명하고 상호작용 방식을 알려줘”라고 한 번에 요청하면 API 호출이 3번에서 1번으로 줄고 중복 컨텍스트 전송이 사라진다.
검증 기준도 함께 제공하면 효과적이다. 테스트 케이스, 스크린샷, 예상 출력을 프롬프트에 포함하면 Claude가 스스로 결과를 검증할 수 있어 수정 요청으로 인한 추가 토큰 소비를 막을 수 있다.
5. 모델과 확장 사고를 전략적으로 선택하라
모델 선택은 토큰 비용에 직접적인 영향을 미친다. Sonnet 4.6은 입력 100만 토큰당 3달러, 출력 100만 토큰당 15달러이며, Opus 4.6은 입력 5달러, 출력 25달러로 약 1.7배 비싸다. Haiku 4.5는 입력 1달러, 출력 5달러로 가장 경제적이다.
모든 작업에 최상위 모델을 사용할 필요는 없다. 탐색이나 코드 검색 같은 단순 작업에는 Haiku를, 실제 구현에는 Sonnet을 사용하면 전체 비용을 40~50% 절감할 수 있다.
확장 사고(Extended Thinking) 설정도 점검 대상이다. 기본값으로 31,999토큰의 사고 예산이 할당되어 있는데, 이 사고 토큰은 출력 토큰으로 청구된다. 깊은 추론이 필요 없는 단순 작업에서는 /effort 명령어로 노력 수준을 낮추거나, 환경변수 MAX_THINKING_TOKENS=8000 같은 설정으로 예산을 줄이면 출력 토큰을 상당히 아낄 수 있다.
6. 프롬프트 캐싱과 비용 모니터링을 활용하라
프롬프트 캐싱은 가장 과소평가된 토큰 절약 기법이다. Claude Code는 시스템 프롬프트와 같은 반복 콘텐츠의 비용을 자동으로 줄여주는 프롬프트 캐싱을 기본 제공한다. 캐시 히트 시 표준 입력 가격의 10%만 청구되므로, Sonnet 4.6 기준으로 100만 토큰당 3달러 대신 0.30달러만 발생한다.
실제 대량 사용자 데이터를 보면 소비 토큰의 90% 이상이 캐시 읽기에 해당한다. 캐시 효율을 극대화하려면 CLAUDE.md 내용을 세션 간에 안정적으로 유지하고, 변경되지 않는 컨텍스트가 프롬프트 앞쪽에 오도록 구성하는 것이 좋다.
비용 모니터링도 습관화해야 한다. /cost 명령어로 현재 세션의 토큰 소비량을 실시간으로 확인할 수 있고, /stats 명령어로 구독 플랜 대비 사용 패턴을 파악할 수 있다. 서드파티 도구인 ccusage를 설치하면 일별, 월별, 세션별 사용량을 더 상세하게 추적할 수 있다.
7. Plan 모드와 출력 제한으로 불필요한 실행을 막아라
복잡한 작업일수록 바로 구현에 들어가지 말고 계획 단계를 거쳐야 한다. Shift+Tab을 눌러 Plan 모드에 진입하면, Claude가 코드를 실행하지 않고 접근 방식만 제안한다. 초기 방향이 잘못되었을 때 비용이 큰 재작업을 방지할 수 있다.
Claude가 잘못된 방향으로 가기 시작하면 Escape를 눌러 즉시 중지하는 것도 중요하다. /rewind 명령어나 Escape 두 번으로 대화와 코드를 이전 체크포인트로 복원할 수 있어, 잘못된 경로에서 낭비되는 토큰을 최소화할 수 있다.
출력 토큰 자체를 제한하는 방법도 있다. 환경변수로 CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000을 설정하면 불필요하게 긴 응답을 방지할 수 있다. 또한 –max-turns 5 옵션으로 대화 턴 수를 제한하면 에이전트 루프가 무한정 이어지는 상황을 막을 수 있다.
8. 자주 묻는 질문 FAQ
Q1. /compact와 /clear 중 어떤 것을 먼저 사용해야 하나요?
같은 작업을 이어가면서 컨텍스트만 줄이고 싶다면 /compact를, 완전히 다른 작업으로 전환한다면 /clear를 사용한다. auto-compact가 75% 시점에 자동 실행되지만, 보존할 맥락을 직접 지정하려면 그 전에 수동으로 /compact를 실행하는 편이 낫다.
Q2. CLAUDE.md 파일 없이도 Claude Code를 사용할 수 있나요?
사용 자체는 가능하지만, 매 세션마다 프로젝트 배경을 반복 설명해야 해서 오히려 토큰이 더 소비된다. 빌드 명령어, 코딩 컨벤션, 아키텍처 요약 정도만 담은 간결한 CLAUDE.md를 만들어두면 반복 설명에 드는 토큰을 사실상 0으로 줄일 수 있다.
Q3. 구독 플랜과 API 과금 중 어떤 방식이 토큰 비용에 유리한가요?
Pro 플랜은 월 20달러 정액제로, API 환산 기준 약 180달러 상당의 사용량을 제공하기 때문에 대부분의 개인 개발자에게 유리하다. 다만 사용량 제한이 있으므로, 하루 종일 집중 작업하는 경우에는 Max 플랜이나 API 과금 방식이 적합할 수 있다.
클로드 코드 토큰 관리는 단순히 비용을 줄이는 기술이 아니라, AI 도구와 효율적으로 협업하는 역량 그 자체다. 컨텍스트를 작게 유지하고, 프롬프트를 구체적으로 작성하며, 모델과 설정을 상황에 맞게 조절하는 습관을 들이면 같은 요금제에서도 훨씬 많은 작업을 해낼 수 있다. 오늘 바로 /cost 명령어로 현재 사용량을 확인하고, 위 전략들을 하나씩 적용해보자.