Claude Code, 토큰 낭비 없이 똑똑하게 쓰는 법!
Claude Code 사용 시, 토큰(Token) 개념을 이해하고 입력/출력 토큰의 합계가 비용에 미치는 영향을 파악해야 함
CLAUDE.md 문서 최적화를 통해 불필요한 토큰 낭비를 줄이고, MCP(Model Context Protocol) 설정을 통해 컨텍스트 공간을 확보
대화 이력 관리 및 명확한 요청을 통해 토큰 사용량을 절감하고, 멀티 세션 전략을 활용하여 효율성을 높임
/context 명령을 통해 토큰 사용량을 확인하고, 프롬프트 캐싱을 활용하여 비용을 절감
토큰 최적화 전략을 단계별로 적용하여 Claude Code의 효율적인 활용을 도모
토큰(Token) 개념과 컨텍스트 이해
Claude Code를 효과적으로 사용하려면 토큰(Token)의 개념을 정확히 이해해야 한다. AI 모델은 텍스트를 토큰 단위로 처리하며, 입력 토큰과 출력 토큰의 합이 총 사용 토큰이 된다.
입력 토큰: 사용자 요청, 대화 이력, 시스템 프롬프트, 도구 정의 등 모델에 전달되는 모든 텍스트
출력 토큰: Claude의 응답, 자동 생성 코드, 분석 결과 등 모델이 생성하는 텍스트
한글은 조사, 어미, 복합어 구조로 인해 영어보다 토큰 수가 많아지는 경향이 있으므로, 간결하고 명확한 문장을 사용하는 것이 중요하다.
CLAUDE.md 문서 최적화 전략
CLAUDE.md는 Claude Code가 요청마다 참조하는 핵심 문서이므로, 문서 크기를 최소화하는 것이 중요하다. 불필요한 정보는 제거하고, 헤딩, 리스트, 테이블을 활용하여 구조화해야 한다.
비효율적인 예시: 프로젝트 설명, 기술 스택 중복 표현, 코딩 규칙 장문 기술
개선된 예시: 기술 스택, 폴더 구조, 핵심 규칙만 요약, 불필요한 문장 제거
CLAUDE.md가 지나치게 길어지는 경우, 여러 보조 문서로 분리하여 필요할 때만 불러오는 방식을 사용하면 기본 컨텍스트를 가볍게 유지할 수 있다.
MCP(Model Context Protocol) 설정 최적화
MCP 서버를 설치하면 각 도구 정의가 컨텍스트에 로드되므로, 현재 작업에 필요한 MCP만 활성화하는 것이 중요하다. GitHub, Web Search, Database, Playwright 등 모든 MCP를 활성화하면 최대 1만 토큰 이상이 추가될 수 있다.
현재 작업에 필요한 MCP만 활성화: 프런트엔드 작업에는 Playwright만, 백엔드 작업에는 Database MCP만
프로젝트별 .config/claude/config.json 파일에서 불필요한 MCP 비활성화
정기적으로 MCP 목록을 점검해 미사용 항목 제거
이러한 설정을 통해 컨텍스트 공간을 5~7% 정도 확보할 수 있다.
대화 이력 관리 및 명확한 요청
대화 이력은 컨텍스트에서 가장 빠르게 증가하는 영역이므로, 불필요한 왕복을 줄이고, 비슷한 요청은 하나의 배치로 묶는 것이 중요하다. 또한, 모호한 요청을 피하고 명확하고 구조화된 요청을 사용하는 것이 토큰 절약에 효과적이다.
불필요한 왕복 줄이기: utils.py 파일을 읽어줘? → 수정해줘 (X) vs utils.py의 get_user 함수를 읽고 성능을 개선해줘 (O)
비슷한 요청은 하나의 배치로 묶기: Header, Footer, Sidebar에 다크 모드 적용 (X) vs components 폴더의 Header, Footer, Sidebar에 공통으로 다크 모드 적용 (O)
모호한 요청 피하기: 로그인 기능 수정해줘 (X) vs .auth.py에서 JWT 토큰 만료 시간을 1시간에서 24시간으로 늘려줘 (O)
토큰 사용량 점검 및 프롬프트 캐싱 활용
Claude Code의 토큰 사용량을 확인하고, 프롬프트 캐싱을 활용하여 비용을 절감할 수 있다. /context 명령을 통해 현재 세션의 토큰 사용량을 확인하고, 대규모 작업의 경우 /clear 명령으로 컨텍스트를 초기화하는 것이 좋다.
/context 명령: 시스템 프롬프트, 시스템 도구, 메모리 파일, 메시지 등 모든 컴포넌트별 토큰 사용량 표시
로그 파일 확인: ~/.claude/projects/ 폴더의 JSONL 형식 로그 파일에서 input_tokens, output_tokens 값 확인
웹 기반 토큰 계산기 활용: token-counter.app/anthropic, claude-tokenizer.vercel.app
Claude Code는 자동으로 프롬프트 캐싱을 활성화하여 반복되는 요청의 비용을 절감한다.
