들어가며 

안녕하세요! 요즘 개발 효율을 극대화해준다는 Claude Code 다들 사용하고 계시죠?

저는  Pro 플랜($20/월)을 구독해서 사용 중인데요. 처음엔 그 성능에 감탄했지만, 기쁨도 잠시... 개발에 몰입하다 보니 어느 순간 토큰이 '순삭'되는 공포를 경험하게 되더군요. 분명 평소처럼 코딩했을 뿐인데 금세 사용량 한도 경고를 마주하니 당혹스러웠습니다.

 

상위 플랜인 Teams($110/월)로 가기엔 부담이 컸습니다. 결국  '전략적으로 잘 쓰는 법'을 찾기로 했습니다.

 

그래서 어떻게 하면 이 강력한 도구를 유지하면서도 내 소중한 토큰(과 지갑)을 지킬 수 있을지 고민하고 공부했습니다.

오늘은 제가 직접 부딪히며 깨달은 Claude Code 토큰 절약 실전 노하우를 아낌없이 공유해 보려고 합니다. 

1. 도대체 내 토큰은 어디로 증발했을까??

절약 방법을 알기 전에 우선 토큰(Token)이 무엇인지 그리고 왜 그렇게 빨리 소모되는지  간단하게 알아봅시다. 

1.1 토큰(Token)이란?

AI는 우리가 입력한 텍스트를 그대로 읽지 않고 '토큰'이라는 작은 단위로 쪼개서 처리합니다. 일종의 'AI 전용 화폐'라고 보시면 되는데요! 우리가 Claude에게 질문(Input)을 던지거나 답변(Output)을 받을 때마다 그 길이에 비례해서 이 화폐가 실시간으로 지불됩니다.

 

  • 입력할 때: 질문이 길수록 내 지갑에서 토큰이 빠져나감
  • 답변받을 때: Claude가 수다스러울수록 내 지갑에서 토큰이 빠져나감

결국 토큰을 아끼기 위해선 어떻게 하면 가장 적은 비용(토큰)으로 AI에게 정확한 답변을 얻어낼 것인가?"라는 고민이 자연스레 생겨서 토큰을 아끼기 위한 방법을 고민했습니다.

1.2 한글 유저가 더 빨리 토큰이 소모되는 이유  (토큰 값의 비밀)

제가 토큰 절약법을 공부하면서 주목했던 데이터는 바로 언어에 따른 토큰 소모량의 확연한 차이였습니다.

예전에 Elasticsearch를 다루면서 한글 형태소 분석이나 인덱싱이 영어보다 까다롭다는 걸 경험한 적이 있었는데요.

"AI 모델이 언어를 처리하는 방식도 이와 유사한 맥락이 있지 않을까?"라는 의문이 들어 조사해 보니 역시나 수치상으로 나타나는 효율 차이가 꽤 유의미했습니다.

  • 영어: 1토큰 ≈ 약 4글자 (단어 단위 처리에 최적화)
  • 한글: 1글자 ≈ 약 2.5~3토큰 (자음/모음이 결합된 복잡한 구조로 인해 토큰 발생량 증가)

한글은 자음과 모음의 조합이라 AI가 처리할 때 영어보다 훨씬 많은 토큰을 사용합니다. 실제로 같은 요청을 보냈을 때의 차이를 보실까요?

 

요청 내용 한글 프롬프트 영어 프롬프트 차이
"이 코드를 리팩토링해주세요" 약 197 토큰 약 39 토큰 약 5배!

Elasticsearch에서 한글 분석기를 따로 설정해야 성능이 나오듯, Claude Code에서도 한글로만 대화를 이어가는 것은 자원을 비효율적으로 사용하는 셈입니다. Pro 플랜 유저로서 제한된 자원 안에 최대한의 퍼포먼스를 뽑아내기 위해서는 프롬프트 구성 전략을 수정해야 할 확실한 근거를 발견한 것이죠.

2. Claude Code 토큰 아끼는 실전 꿀팁 6가지

자, 이제 원인을 알았으니 제가 공부하고 적용해서 효과를 본 실전 전략들을  알아보겠습니다.

2.1 명령어는 영어로! '하이브리드 프롬프트'

모든 프롬프트를 영어로 입력할 필요가 없습니다. 핵심 키워드만 영어로 바꿔도 토큰이 대폭 절약 됩니다.

영어가 서툴러도 괜찮습니다. 아래 패턴만 기억하세요. [명령어(영어) + 대상(영어) + 상세조건(한글/영어)]

 

  • 버그 수정: Fix bug in @AuthService.ts - 로그인 시 토큰 저장 안 됨
  • 기능 구현: Create @NotificationModal.tsx - Tailwind 사용, 3초 뒤 자동 닫기
  • 리팩토링: Refactor calculateTotal function - 중복 제거, JSDoc 추가
  • 꿀팁: 파일명 앞에 @를 붙이면 Claude가 해당 파일을 더 정확하고 빠르게 찾아내어 엉뚱한 파일을 읽는 토큰 낭비를 막아줍니다.

2.2 CLAUDE.md로 프로젝트 가이드라인 고정하기

Claude Code는 실행될 때마다 루트 디렉토리의 CLAUDE.md 파일을 읽습니다. 여기에 프로젝트 정보를 영어로 미리 정의해두면 불필요한 설명을 생략할 수 있습니다.

 

  • 설정 방법: 프로젝트 최상위 루트에 CLAUDE.md 파일 생성
  • 추천 템플릿 (복사해서 수정해 쓰세요):
# Project: StyleHub
## Tech Stack
- Java 17 / Spring Boot 3.x
- Build: Gradle
- DB: PostgreSQL / Spring Data JPA
- Test: JUnit 5, Mockito
- Docs: SpringDoc OpenAPI (Swagger)

## Coding Standards
- Use Constructor Injection instead of @Autowired.
- Follow Google Java Style Guide.
- Use Lombok (@Getter, @Setter, @RequiredArgsConstructor).
- Entity to DTO mapping: Use MapStruct or Manual mapping.
- Error Handling: Use @RestControllerAdvice.

## Key Commands
- Build & Run: `./gradlew bootRun`
- Test: `./gradlew test`
- Build Jar: `./gradlew clean build`

커스텀 명령어(Slash Commands) 만들기

반복적으로 내리는 긴 지시사항을 짧은 명령어로 등록해 보세요. 프롬프트를 영어로 미리 짜두면 한글로 길게 설명할 필요가 없습니다.

 

  • 설정 방법: 프로젝트 루트에 .claude/commands/ 폴더를 만들고 .md 파일을 생성합니다.
  • 예시: /fix 명령어 만들기 (.claude/commands/fix.md)
Analyze the current error and provide a fix:
1. Identify the root cause.
2. Implement the solution following the project style.
3. Add necessary error handling.
4. Explain the fix briefly in Korean.

사용법: 터미널에 /fix만 입력하면 위 지시사항이 영어로 전달되어 토큰을 아끼면서 정확한 작업을 수행합니다.

2.3 세션 최적화: /clear와 /compact 활용법

Claude는 이전 대화 맥락을 다 기억하려 합니다. 대화가 길어질수록 '복리'처럼 토큰 소모가 늘어납니다.

  • /clear (완전 초기화): 하나의 티켓이나 버그 수정을 완료했다면 주저 말고 입력하세요. "기억을 지우면 처음부터 설명해야 하지 않나?" 싶겠지만, 위에서 만든 CLAUDE.md가 있기 때문에 기본적인 맥락은 유지됩니다.
  • /compact (기억 압축): 현재 작업 맥락은 유지해야 하는데 대화가 너무 길어졌을 때 유용합니다. Claude가 지금까지의 내용을 스스로 요약하여 컨텍스트 용량을 줄여줍니다.

2.4 작업 단위를 '잘게' 쪼개기

전체 파일을 다 읽게 하지 마세요. Refactor UserService.js only 처럼 특정 파일만 타겟팅해서 요청하는 것이 훨씬 경제적입니다.

2.5 나만의 단축키, 커스텀 명령어

자주 쓰는 복잡한 지시는 .claude/commands/에 영어로 저장해 두고 슬래시 명령어(예: /fix)로 호출하세요. 오타도 줄고 토큰도 아낍니다.

2.6 실시간 사용량 확인 (/stats)

내가 지금 토큰을 얼마나 썼는지 실시간으로 확인하세요. (구버전은 /usage) 수치가 너무 높다면 지체 없이 /clear를 입력해서 사용랼을 확인해 보세요

마치며

Claude Code는 정말 좋은 도구이지만, 효율적으로 쓰는 법을 모르면 비용 효율이 떨어질 수밖에 없습니다.

제가 오늘 공유해 드린 '영문 키워드 활용'과  '세션 관리'만 잘 지켜도 토큰 소모량을 30~50% 이상 줄이실 수 있을 거예요.

 

사실 이번에 토큰 아끼는 법을 공부하면서 가장 크게 느낀 점은 '개발 지식의 연결성'이었습니다.

 

예전에 Elasticsearch를 공부하며 한글 형태소 분석의 복잡함에 골몰했던 경험이 엉뚱하게도 최신 AI 도구인 Claude의 토큰 비용을 분석하는 실마리가 되었습니다. 전혀 다른 영역의 지식 같아 보여도 결국 데이터를 처리하는 언어의 특성이라는 기본기는 어디서든 맞닿아 있다는 걸 다시 한번 체감한 순간이었습니다.

 

새로운 도구는 계속해서 쏟아지겠지만 이를 스마트하게 다루는 힘은 결국 우리가 쌓아온 탄탄한 기본기에서 나오는 것 같습니다.

여러분도 오늘 알려드린 팁을 통해 비용은 줄이고 생산성은 높이는 스마트한 개발 라이프를 즐기시길 바랍니다!

 

 

저작자표시 비영리 (새창열림)

'개발 알쓸신잡' 카테고리의 다른 글

Elasticsearch의 형태소 분석기와 역인덱스: 검색 엔진의 핵심  (0) 2026.02.13
프로그래밍의 역사 속에서 프로그래밍 사고법을 배울 수 있는 5가지 교훈  (0) 2025.11.03

티스토리툴바