Claude Code 토큰 절약하는 방법 (실전 가이드)

Claude Code를 사용하다 보면 가장 먼저 체감하는 것이 바로 토큰(사용량) 소모 속도입니다. 특히 장시간 세션, 대규모 코드 분석, 로그 분석 등을 반복하면 세션 한도가 빠르게 차는 경험을 하게 됩니다. 이 글에서는 Claude Code를 사용할 때 토큰 사용량이 증가하는 원인과 실제로 효과적인 절약 방법을 정리합니다.

1. 비싼 모델 사용을 줄이기

Claude 모델은 크게 다음과 같이 구분됩니다.

Haiku: 빠르고 저비용
Sonnet: 일반 작업 및 코딩 기본 모델
Opus: 복잡한 추론 및 고난도 작업

일반적으로 코딩 작업은 Sonnet 모델로 충분한 경우가 많습니다.

상위 모델(Opus)을 계속 사용하면 같은 작업이라도 사용량이 훨씬 빠르게 소모됩니다.

2. 컨텍스트 누적 관리

Claude Code는 대화를 계속 이어가면서 이전 대화와 읽은 파일들을 컨텍스트로 유지합니다.

문제는 대화가 길어질수록 매 요청마다 다음이 다시 처리된다는 점입니다.

이전 대화 내용
이전 코드 수정
읽은 파일 요약
작업 맥락

따라서 세션이 길어질수록 토큰 사용량이 크게 증가합니다.

해결 방법

작업이 끝나면 다음 명령어를 활용합니다.

/clear

또는 대화를 요약합니다.

/compact

3. /compact 명령어 활용

/compact는 긴 대화를 핵심만 남기고 요약하는 기능입니다.

예를 들어 긴 디버깅 세션 이후

문제 원인
수정된 파일
현재 상태

만 남기고 나머지 컨텍스트를 줄입니다.

이는 토큰 사용량을 크게 줄이는 가장 효과적인 방법 중 하나입니다.

OpusPlan

OpusPlan은 Claude Code에서 설계와 실행을 분리해 토큰 사용을 효율적으로 관리하는 전략을 의미합니다. 이 방식은 복잡한 작업을 진행할 때 먼저 상위 모델인 Opus로 계획(Plan)을 세우고, 이후 실제 코드 수정이나 실행 단계는 Sonnet 같은 가벼운 모델로 처리하도록 하는 접근법입니다. 이렇게 하면 모든 작업을 무거운 모델로 수행하지 않아도 되어 전체 토큰 사용량을 크게 줄일 수 있습니다.

예를 들어 새로운 기능을 개발할 때 먼저 “코드는 수정하지 말고 어떤 파일을 어떻게 수정할지 계획만 세워줘”라고 요청하면 Opus가 설계를 담당합니다. 이후 “방금 계획대로 main.py만 수정해줘”처럼 실행 단계는 Sonnet으로 진행합니다. 이 방식의 장점은 복잡한 문제 해결 능력은 유지하면서도 비용과 토큰 소모를 줄일 수 있다는 점입니다. 특히 대규모 코드베이스 분석, 아키텍처 설계, 전략 수립 같은 작업에서는 Opus로 계획을 세우고 실제 구현은 Sonnet으로 수행하는 것이 가장 효율적인 Claude Code 활용 방법 중 하나로 알려져 있습니다.

4. /clear로 세션 초기화

작업 단위가 끝났다면 세션을 초기화하는 것이 좋습니다.

/clear

이 명령은 다음을 수행합니다.

대화 기록 제거
컨텍스트 초기화
새로운 작업 시작

5. 구체적인 프롬프트 작성

Claude에게 요청할 때 범위를 좁히는 것이 중요합니다.

비효율적인 요청

"이 프로젝트 전체를 분석해줘"

효율적인 요청

"main.py의 로그인 함수에서 입력값 검증 로직을 추가해줘"

이렇게 하면

읽는 파일 감소
탐색 범위 감소
응답 길이 감소

결과적으로 토큰 사용량이 크게 줄어듭니다.

Claude Code에서는 작업 중인 세션(대화 컨텍스트)을 저장하고 나중에 다시 불러오는 기능을 사용할 수 있습니다. 세션을 저장하려면 /rename 명령어를 사용합니다. 이 명령을 입력하면 현재 대화에 이름을 지정할 수 있으며, 예를 들어 crypto-bot-debug 같은 이름으로 저장할 수 있습니다.

이렇게 저장된 세션은 이후 /resume 명령어로 다시 불러올 수 있습니다. /resume을 입력하면 이전에 저장한 세션 목록이 표시되고, 원하는 세션을 선택하면 이전 대화와 작업 맥락을 그대로 이어서 진행할 수 있습니다.

긴 작업을 마친 뒤에는 /compact 명령으로 대화를 요약한 후 /rename으로 저장하면 토큰 사용량을 줄이면서 중요한 맥락만 보존할 수 있습니다. 이후 새로운 세션을 시작하거나 작업을 이어갈 때 /resume으로 불러오면 이전 코드 수정 내용이나 프로젝트 상태를 다시 설명하지 않아도 되어 작업 효율이 크게 높아집니다.

6. 로그 분석은 일부만

로그 파일은 토큰을 가장 많이 사용하는 원인 중 하나입니다.

전체 로그를 붙여넣기보다 다음과 같이 요청하는 것이 좋습니다.

logs/agent.log 최근 30줄만 분석해줘

7. 프로젝트 메모리 파일 관리

Claude Code에서는 프로젝트 정보를 저장하기 위해 보통 CLAUDE.md 파일을 사용합니다.

이 파일에는 다음과 같은 내용을 포함합니다.

프로젝트 개요
주요 실행 파일
개발 규칙
로그 위치
환경 변수

하지만 파일이 너무 길면 매 요청마다 읽게 되어 비용이 증가할 수 있습니다.

8. 작업을 작은 단위로 나누기

한 번에 모든 작업을 요청하는 것은 토큰 사용량을 크게 증가시킵니다.

예:

"프로젝트 전체 분석하고 수정하고 테스트까지 해줘"

대신 다음과 같이 나눕니다.

설계
코드 수정
테스트

9. Claude Code에서 자주 사용하는 명령어

토큰 관리에 유용한 명령어

/compact
/clear
/model
/rate-limit-options
/help

클로드 코드 비싸?

Claude Code는 매우 강력한 개발 도구이지만 세션 관리와 요청 방식에 따라 토큰 사용량 차이가 크게 발생합니다.

다음 원칙만 기억해도 사용량을 크게 줄일 수 있습니다.

긴 세션은 정리하기
/compact 적극 활용
/clear로 작업 단위 분리
구체적인 요청 작성
필요한 파일만 분석

이 방법들을 활용하면 Claude Code 사용량을 효율적으로 관리하면서 생산성을 높일 수 있습니다.

엔돌슨의 IT이야기

Claude Code 토큰 절약하는 방법 (실전 가이드)