[Claude Code] 클로드 코드 토큰 절약하는 10가지 방법(토큰 사용량 줄이기)

매달 정해진 토큰(사용량) 안에서 클로드코드를 쓰다 보면, 정작 중요한 작업 전에 토큰이 바닥나서 당황했던 경험 다들 한 번쯤 해보셨을 텐데요. 개인적인 생각에 클로드 코드는 토큰을 낭비하는(?) 방식으로 점차 진화하고 있는것 같아요. 이렇게 해서 돈을 더 벌려고 하는 엔트로픽의 목적일까요..? 하지만 방법은 있습니다. 알고 보면 대화창을 어떻게 관리하느냐에 따라 같은 작업을 하고도 쓰는 토큰량이 꽤 차이가 나는데요. 오늘은 공식 문서를 바탕으로, 클로드코드에서 토큰을 아껴 쓰는 실전 방법들을 정리해봤습니다.

 

---

 

 클로드코드(Claude Code) 토큰 절약하는 법 — 실전 팁 정리 

1. 컨텍스트는 쌓아두지 말고 그때그때 비우기

클로드코드는 대화(세션) 안의 모든 맥락을 매 요청마다 다시 API로 보내는 구조라서, 세션이 길어질수록 같은 질문 하나에도 점점 더 많은 토큰이 쓰입니다. 파일 내용, 도구 호출 결과, 이전 대화까지 전부 포함되기 때문인데요. 실제로 하루 종일 켜둔 세션은 체감 작업량보다 훨씬 많은 사용량을 잡아먹습니다.

• /clear로 새 세션 시작: 관련 없는 작업으로 넘어갈 때는 /clear로 맥락을 초기화 해보세요. 오래된 컨텍스트가 남아 있으면 이후 모든 메시지에서 그만큼 토큰을 낭비합니다. 나중에 다시 찾기 쉽게 /rename으로 세션 이름을 지어두고 /clear한 뒤, 필요할 때 /resume으로 돌아오면 됩니다.
• 압축(compact) 지시어 커스터마이징: /compact 코드 예시와 API 사용법 위주로 정리해줘처럼 무엇을 남길지 직접 지정할 수 있습니다. 프로젝트 루트의 CLAUDE.md에 압축 시 우선순위를 아예 적어두는 것도 방법입니다.
• /usage로 현재 사용량 확인: 세션 안에서 /usage를 입력하면 지금까지 쓴 토큰과 비용 추정치가 나옵니다. 상태 표시줄(statusline)에 컨텍스트 사용량을 띄워두고 실시간으로 확인하는 것도 좋습니다.

 

2. 작업에 맞는 모델 고르기

대부분의 코딩 작업은 Sonnet으로 충분하고, Opus보다 비용이 저렴합니다. 클로드에 /model로 세션 중간에 모델을 바꿀 수 있고, 서브에이전트를 쓸 때는 설정 파일에 model: haiku처럼 지정해서 단순 작업은 더 저렴한 모델에 맡길 수 있습니다. 복잡한 아키텍처 설계나 여러 단계를 거치는 추론이 필요할 때만 Opus를 아껴 쓰시면 좋을것 같아요.

 

3. MCP 서버 정리하기

MCP 도구 정의는 기본적으로 지연 로딩되어서 실제로 그 도구를 쓸 때만 컨텍스트에 올라오지만, 그래도 서버 개수가 많아지면 부담이 됩니다.

• /context로 지금 무엇이 컨텍스트를 차지하고 있는지 확인하세요.
• 가능하면 MCP 서버보다 gh, aws, gcloud 같은 CLI 도구를 쓰는 편이 더 효율적입니다. 도구 목록을 따로 로딩할 필요가 없기 때문입니다.
• /mcp로 연결된 서버 목록을 보고 실제로 안 쓰는 서버는 꺼두세요.

 

4. 타입 언어라면 코드 인텔리전스 플러그인 설치

코드 인텔리전스 플러그인을 쓰면 텍스트 검색 대신 정확한 심볼 탐색이 가능해져서, 낯선 코드를 파악할 때 불필요한 파일 읽기가 줄어듭니다. "정의로 이동" 한 번이면 grep 후 여러 후보 파일을 다 열어보는 과정을 대신할 수 있고, 언어 서버가 설치돼 있으면 편집 후 타입 오류도 자동으로 알려줘서 컴파일러를 따로 돌릴 필요가 줄어듭니다.

 

5. 후크(hooks)와 스킬(skills)로 전처리 위임

후크를 이용하면 클로드가 보기 전에 데이터를 미리 걸러낼 수 있습니다. 예를 들어 만 줄짜리 로그 파일 전체를 읽게 하는 대신, 후크가 ERROR만 grep해서 넘겨주면 컨텍스트가 수만 토큰에서 수백 토큰으로 줄어듭니다. 테스트 실행 결과 중 실패 케이스만 걸러주는 PreToolUse 후크가 대표적인 예시입니다.

 

스킬은 클로드에게 도메인 지식을 미리 심어주는 역할을 합니다. "코드베이스 개요" 같은 스킬을 만들어두면, 여러 파일을 뒤져가며 구조를 파악하는 대신 스킬 호출 한 번으로 필요한 맥락을 바로 받을 수 있습니다.

 

6. CLAUDE.md는 가볍게, 세부 지침은 스킬로

CLAUDE.md는 세션 시작 시 통째로 컨텍스트에 로드됩니다. PR 리뷰나 DB 마이그레이션처럼 특정 작업에만 필요한 세부 지침을 여기 다 적어두면, 전혀 관련 없는 작업을 할 때도 그 토큰을 계속 물고 갑니다. 자주 쓰지 않는 세부 워크플로우는 스킬로 빼서 필요할 때만 로드되게 하고, CLAUDE.md는 핵심만 남겨 200줄 이내로 유지하는 걸 목표로 해보시는것 추천드립니다.

 

7. 익스텐디드 씽킹(extended thinking) 조절

씽킹 토큰은 출력 토큰으로 과금되고, 기본 예산만 해도 요청당 수만 토큰에 달할 수 있습니다. 복잡한 추론이 필요 없는 단순 작업이라면 /effort나 /model에서 effort 레벨을 낮추거나, /config에서 씽킹 자체를 끄거나, 고정 씽킹 예산을 쓰는 모델은 MAX_THINKING_TOKENS 환경변수(예: MAX_THINKING_TOKENS=8000)로 예산을 줄이는 방법이 있습니다.

 

8. 장황한 작업은 서브에이전트에 위임

테스트 실행, 문서 조회, 로그 파일 처리처럼 출력이 장황한 작업은 서브에이전트에 맡기세요. 상세 출력은 서브에이전트 안에만 남고, 메인 대화에는 요약본만 돌아오기 때문에 메인 컨텍스트가 깨끗하게 유지됩니다.

 

9. 프롬프트는 구체적으로

"이 코드베이스 개선해줘" 같은 막연한 요청은 광범위한 탐색을 유발합니다. "auth.ts의 로그인 함수에 입력값 검증 추가해줘"처럼 구체적으로 요청하면 파일 읽기를 최소화하면서 효율적으로 작업할 수 있습니다.

 

10. 복잡한 작업일수록 계획 → 실행 순서로

• 플랜 모드 활용: 구현 전에 Shift+Tab으로 플랜 모드로 전환하면, 클로드가 먼저 코드베이스를 탐색하고 접근 방식을 제안합니다. 방향이 잘못됐을 때 승인 전에 걸러낼 수 있어 값비싼 재작업을 막아줍니다.
• 일찍 방향 수정: 엉뚱한 방향으로 가는 것 같으면 즉시 Esc로 멈추고, /rewind나 Esc 두 번으로 이전 체크포인트로 되돌리세요.
• 검증 기준 제시: 테스트 케이스, 스크린샷, 기대 결과를 프롬프트에 포함하면 클로드가 스스로 작업을 검증할 수 있어 재요청 횟수가 줄어듭니다.
• 단계별 테스트: 한 파일 작성 → 테스트 → 다음 파일, 이런 식으로 진행하면 문제를 저렴할 때 빨리 잡을 수 있습니다.

 

---

 

한눈에 정리

토큰 사용량은 결국 "컨텍스트 크기"와 직결됩니다. 대화를 얼마나 깨끗하게 유지하고, 불필요한 정보를 얼마나 걸러내느냐가 곧 비용 절감의 핵심입니다. 개인적으로는 Snonnet으로 모델을 변경하고  /clear를 아까워하지 않는 습관 하나만 들여도 체감 절약 효과가 꽤 크더라고요.