Claude Code 세션 토큰 비용 아끼는 법: 캐시와 컨텍스트 관리

TL;DR Highlight

/clear, @-멘션, 캐시 유지만 지켜도 같은 작업을 더 적은 토큰으로 끝낸다

Who Should Read

Claude Code를 매일 쓰는데 토큰 한도나 비용이 빨리 소진돼 고민인 개발자

Core Mechanics

토큰 가격은 세 가지가 정한다
- 모델, 입력/출력 토큰 구분, 캐시 여부가 가격을 결정한다.
- 출력은 입력보다 대략 5배 비싸게 책정된다.
- 출력 토큰 상당수는 thinking 토큰이고, /effort가 그 양을 조절한다.
프롬프트 캐시 읽기는 입력가의 0.1배
요청 앞부분이 이전 요청과 똑같으면 서버가 저장해 둔 상태를 재사용한다(프롬프트 캐싱).
- 캐시에 쓸 때는 일반 입력보다 최대 2배까지 비싸다.
- 쓰기는 토큰당 한 번이고 이후 턴마다 0.1배 읽기가 발생한다.
모델·effort 변경은 캐시를 날린다
- /model과 /effort는 캐시 키의 일부라서 중간에 바꾸면 대화 전체를 다시 prefill한다.
- Fast mode도 키의 일부이며, 켤 때 재 prefill이 fast 요금으로 계산된다.
- 캐시는 구독에서 1시간, API 키에서 5분 뒤 만료된다(ENABLE_PROMPT_CACHING_1H=1이면 1시간).
컨텍스트에 들어간 건 매 턴 다시 전송된다
- 읽은 파일과 명령 출력은 이후 모든 턴에 다시 실려 간다.
- 캐시 덕에 재전송은 싸지만 공짜는 아니고, 모델이 생각할 맥락도 차지한다.
- 40번째 턴은 앞의 39턴을 다시 읽으므로 긴 세션이 더 비싸다.

Community Reactions

유용한 대안으로 /handoff 스킬을 쓴다는 경험
- 현재 세션의 핵심 맥락을 짧은 문서로 저장하고 /continue로 새 세션을 시작한다는 얘기다.
- 20메시지 정도마다 이렇게 하는 게 긴 세션보다 결과가 좋았다는 경험이다.
캐시가 effort에 묶인 이유를 모르겠다는 의문
- effort를 디코딩 단계에서만 조절하면 되지 않느냐는 의견이다.
- 어려운 분석 뒤 단순 질문엔 낮은 effort면 충분한데 캐시 때문에 바꾸기 어렵다는 불만도 있다.
@-멘션이 안티패턴이라는 반론
- 큰 파일은 전체가 컨텍스트에 들어가지만 Read는 필요한 부분만 읽을 수 있다는 의견이다.
- 데스크톱 앱에서는 @ 멘션 검색 결과가 CLI보다 엉뚱하다는 경험도 있다.
캐시 재작성이 설명 없이 커진다는 경험
- 1시간 TTL에 모델·effort도 안 바꿨는데 /btw나 코드 리뷰 요청 때 캐시 쓰기가 400K에서 800K, 2M까지 늘었다는 경험이다.
사용자에게 관리 부담을 떠넘긴다는 비판
- 하네스가 알아서 처리해야 한다는 의견이 여럿이다.
- 'You're holding it wrong'이라는 비꼼도 있었다.

How to Apply

오늘 /context와 /model, /effort 확인하기
- 새 세션을 열자마자 /context로 CLAUDE.md와 MCP 도구 정의가 차지한 양을 본다.
- 안 쓰는 MCP 서버는 /mcp로 끄고, /model·/effort가 의도한 값인지 확인한다.
작업 단위로 /clear 하고 나중에 쓸 세션은 /rename 하기
- 새 작업을 시작하기 전 /clear를 실행하고 필요하면 먼저 /rename 한다.
- 같은 작업 앞부분이 끝났으면 /compact에 남길 내용을 지정한다.
CLAUDE.md에 조용한 명령어 넣기
- 매일 쓰는 명령 2~3개를 quiet 플래그 포함해 적는다(예: npx vitest run <file> --reporter=dot).
- 로그 훑기처럼 출력이 큰 작업은 'subagent에서 처리해'라고 지시한다.
자리 비우기 전 /compact 하고 모델 변경은 세션 시작에
- 1시간 넘게 자리를 비울 거면 캐시가 살아 있을 때 /compact를 실행한다.
- 모델·effort·Fast mode는 세션 시작이나 /clear 직후에 바꾼다.

Try It

복사해서 바로 해보기

# Claude Code 새 세션에 그대로 붙여넣기 (원문 팁을 점검 프롬프트로 옮긴 간이 버전)

/context

위 결과를 보고 아래 형식으로 답해줘.
1. 시작 시점에 로드된 항목 중 이번 작업에 필요 없어 보이는 것(CLAUDE.md 섹션, MCP 서버)
2. CLAUDE.md에서 스킬로 옮기면 좋을 워크플로 전용 지침
3. 내가 하루 종일 쓰는 명령 {{자주 쓰는 명령 2~3개}}을 quiet 플래그와 함께 CLAUDE.md에 넣을 문구 초안

이어서 해 볼 것: /mcp로 불필요한 서버를 끄고, 다음 작업 전에 /clear 하기.

Terminology

prefill / decodeprefill은 요청 전체를 한 번에 읽는 단계이고, decode는 출력을 토큰 하나씩 쓰는 단계다. 책을 훑어 읽기와 손으로 한 글자씩 쓰기의 차이와 비슷하다.

프롬프트 캐시요청 앞부분이 이전과 같으면 계산 결과를 재사용하는 기능이다. 이전 계산 결과를 저장해 두고 새로 붙은 부분만 이어 계산하는 식이다.

subagent자체 컨텍스트 창을 가진 보조 에이전트다. 메인 대화는 모르고 최종 답만 돌려준다.

/compact긴 대화를 요약본으로 바꾸는 명령이다. 대화가 새로 쓰이므로 기존 캐시는 더 이상 맞지 않는다.

/rewind최근 몇 턴을 끝에서 잘라내는 명령이다. 앞부분 캐시가 그대로 남아 비용이 들지 않는다.