Claude Code 컨텍스트 관리, 이것만 알아도 토큰 절반 줄인다

 

 

같은 작업인데 어떤 날은 유독 크레딧이 많이 소모되는 경험, 다들 한 번쯤 해보셨을 겁니다.

사실 같은 버그 하나를 고치더라도 세션을 어떻게 운영하느냐에 따라 소모되는 토큰 양이 크게 달라진다고 합니다.

Anthropic이 최근 공식 블로그에 Claude Code 세션을 효율적으로 쓰는 방법을 자세히 정리했는데요, 개발자라면 알아두면 꽤 쓸모 있는 내용이라 정리해봤습니다.

 

 

토큰 가격은 뭐가 결정할까?

 

토큰 요금은 결국 GPU가 내 요청을 처리하는 데 걸리는 시간에 대한 대가입니다.

여기에 영향을 주는 요소는 크게 세 가지입니다.

 

- 모델 : 큰 모델일수록 입력/출력 토큰 모두에 더 많은 연산이 들어갑니다. 문제가 애매하고 어려울 때만 큰 모델을 쓰고, 반복적이고 단순한 작업은 작은 모델로 돌리는 게 좋습니다.

- 입력 vs 출력 : 입력 토큰은 시스템 프롬프트, CLAUDE.md, 대화 내용을 한 번에 읽어들이는 것이고, 출력 토큰은 한 글자씩 순차적으로 생성되기 때문에 입력보다 대략 5배 비쌉니다.

- 프롬프트 캐싱 : 이전 요청과 앞부분이 완전히 동일하면 서버가 그 부분을 다시 계산하지 않고 캐시에서 읽어옵니다. 캐시 읽기는 정가의 0.1배로 매우 저렴합니다.

 

 

캐시를 깨뜨리는 것들, 조심하세요

 

캐시는 요청의 맨 앞부분부터 정확히 일치해야 이어집니다.

그런데 다음과 같은 경우에는 캐시가 통째로 무효화되어 전체 대화가 다시 처리(=풀값 과금)됩니다.

 

- `/model`이나 `/effort`를 대화 중간에 바꾸는 경우

- 패스트 모드를 세션 중간에 켜는 경우

- `/compact`로 대화를 요약하는 경우 (요약 자체는 저렴하지만, 이후 대화는 새로 캐싱됨)

- 구독 기준 1시간, API 키 기준 5분이 지나 캐시가 만료된 경우

 

그래서 모델이나 이펙트 레벨을 바꾸려면 세션을 새로 시작하거나 `/clear` 직후처럼 "저렴한 타이밍"에 하는 게 좋습니다.

그리고 최근 몇 턴이 마음에 안 든다면 `/compact`보다 `/rewind`를 쓰는 게 낫습니다. rewind는 그냥 뒤쪽 턴만 잘라내기 때문에 앞부분 캐시는 그대로 살아있어 비용이 들지 않지만, compact는 대화 전체를 다시 쓰기 때문에 항상 비용이 발생합니다.

 

 

컨텍스트에 뭐가 쌓이는지가 진짜 핵심

 

한 번 대화에 들어간 내용(파일, 명령어 실행 결과 등)은 그 이후 모든 턴에 계속 다시 전송됩니다.

캐시 덕분에 재전송 자체는 싸지만, 그래도 공짜는 아니고 모델이 매 턴마다 처리해야 할 컨텍스트 양도 계속 늘어납니다.

 

몇 가지 실전 팁을 소개하면 다음과 같습니다.

 

1) 파일은 경로를 타이핑하지 말고 `@파일명`으로 멘션하세요. 이렇게 하면 메시지에 파일이 바로 첨부되어 별도의 Read 호출이 필요 없습니다.

2) 명령어 출력은 조용하게 만드세요. 테스트 결과가 수백 줄씩 출력되면 그게 전부 컨텍스트에 남아 이후 모든 턴에 따라다닙니다. 자주 쓰는 명령어는 조용한 옵션(예: `--reporter=dot`)까지 포함해서 CLAUDE.md에 미리 적어두는 걸 추천합니다.

3) 새 작업을 시작할 땐 `/clear`, 이전 단계가 끝났으면 `/compact`. 세션이 길어질수록 이전 턴들을 계속 다시 읽어들여야 하므로 비용이 눈덩이처럼 불어납니다.

4) 로그 분석처럼 결과물만 필요한 작업은 서브에이전트로 넘기세요. 서브에이전트는 별도의 컨텍스트 창에서 돌아가고, 끝나면 결과만 메인 세션으로 돌아오기 때문에 지저분한 중간 과정이 메인 대화를 오염시키지 않습니다.

5) 세션 시작 시 `/context`를 한 번 실행해보세요. 시작 시점에 이미 로드된 게 뭔지(CLAUDE.md, MCP 툴 정의 등) 확인할 수 있어, 불필요한 걸 줄이는 데 도움이 됩니다.

 

 

정리하자면

 

요약하면 이렇습니다.

 

- 작업 시작 전에 모델과 이펙트 레벨을 정해두고, 중간에 바꾸지 않기

- 파일은 `@멘션`으로 첨부하기

- 시끄러운 명령어는 조용한 옵션을 붙이거나 서브에이전트로 돌리기

- 새 작업엔 `/clear`, 자리를 비울 땐 `/compact`

 

Anthropic 측은 토큰을 "적게 쓰는 것"이 목표가 아니라, 쓰는 토큰이 실제로 내가 원하는 작업에 쓰이도록 하는 것이 핵심이라고 강조합니다.

매번 세션을 새로 열 때마다 위 습관들을 조금씩 챙기다 보면, 같은 작업을 하고도 체감되는 비용 차이가 꽤 클 것 같습니다.

 

 

원문: [Maximizing the value of your Claude Code sessions]

 

 

#Claude코드 #ClaudeCode #AI코딩툴 #토큰절약 #프롬프트캐싱 #컨텍스트관리 #개발생산성 #AI페어프로그래밍 #Anthropic #서브에이전트 #클로드코드팁 #개발자AI도구