Claude Code 공식 토큰 절약 가이드: 11가지 팁으로 할당량을 더 오래 사용하는 방법
동차 Beating 모니터링에 따르면, Anthropic이 Claude Code 토큰 절약 가이드를 발표했습니다. 핵심은 한 문장입니다: 컨텍스트가 길어질수록 이후 각 라운드가 더 비쌉니다. 채팅, 파일, 명령 출력은 계속 토큰을 차지하며, 그만큼 할당량이 더 빨리 소진됩니다.
정리해보면, 가장 실용적인 팁 11가지가 있습니다:
1. 작업이 바뀌면 /clear를 사용하세요. 하나의 작업이 끝나면 컨텍스트를 비우세요. 아직 같은 작업을 진행 중인데 이전 내용이 더 이상 필요 없다면 /compact로 압축하세요. 긴 세션은 뒤로 갈수록 더 비쌉니다. 매 라운드마다 이전 내용을 다시 포함하기 때문입니다.
2. 모델과 effort는 시작부터 선택하세요. 중간에 /model이나 /effort를 실행하면 prompt cache(프롬프트 캐시)가 무효화되어 다음 라운드에서 전체 컨텍스트를 다시 처리해야 합니다. Fast mode도 마찬가지로 처음부터 켜는 것이 좋습니다.
3. 떠나기 전에 /compact를 사용하세요. 구독 사용자의 캐시는 약 1시간 후 만료되고, API Key는 기본적으로 약 5분 후 만료됩니다. 캐시가 만료된 후 돌아오면 다음 라운드에서 보통 전체 컨텍스트를 다시 처리해야 합니다. 캐시가 아직 유효할 때 압축하는 것이 더 저렴합니다.
4. 최근 몇 라운드가 잘못되었다면 /rewind를 사용하세요. 이는 뒤쪽 몇 라운드만 삭제하고 앞쪽 캐시는 계속 사용할 수 있습니다. /compact는 전체 대화를 다시 작성하므로 비용이 더 높습니다.
5. 파일은 직접 @파일명을 사용하세요. Claude가 첫 라운드에서 바로 파일을 받아 Read나 검색을 한 번 줄일 수 있습니다. 파일은 보통 한 번만 @하면 되며, 반복 @하면 같은 파일이 컨텍스트에 또 들어갈 수 있습니다.
6. Prompt는 최대한 구체적으로 말하세요. "테스트가 실패했다"고 말하는 대신 어떤 테스트, 어떤 파일인지 Claude에게 직접 알려주세요. 그렇지 않으면 먼저 grep, 검색, 여러 파일 읽기를 수행할 수 있고, 그 결과가 이후 매 라운드마다 계속 컨텍스트를 차지합니다.
7. 테스트와 로그 출력은 최소화하세요. Build, 테스트, git log의 출력은 모두 컨텍스트에 남습니다. quiet 파라미터를 추가하거나 오류만 출력하거나 tail로 잘라낼 수 있습니다. Claude Code는 3만 자를 초과하는 명령 출력을 자동으로 파일에 기록하고 요약과 경로만 세션에 남깁니다.
8. /context로 시작 부담을 확인하세요. 새 세션 시작 시 CLAUDE.md, MCP, 도구 정의가 컨텍스트를 얼마나 차지하는지 확인할 수 있습니다. CLAUDE.md에는 일반 규칙만 넣고, 특정 프로세스는 필요 시 로드되는 Skill에 넣으며, 사용하지 않는 MCP는 /mcp로 끄세요.
9. 간단한 작업에는 더 작은 모델과 낮은 effort를 사용하세요. 대형 모델은 입력과 출력 모두 더 비싸고, thinking도 출력 토큰에 포함됩니다. 순수 실행형 작업에는 항상 최고 사양 모델과 최고 추론 강도를 사용할 필요가 없습니다.
10. 큰 로그는 subagent에 맡기고, 작은 작업에는 남용하지 마세요. Subagent는 독립적인 컨텍스트를 가지며 최종 결과만 메인 세션으로 가져오므로 대량 로그 읽기, 문서 검색에 적합합니다. 하지만 파일을 다시 읽고 자체적으로 여러 라운드를 실행해야 하므로 작은 작업에는 오히려 더 비쌀 수 있습니다. 검색, 로그 읽기 같은 작업은 Haiku나 Sonnet을 지정할 수도 있습니다.
11. /loop는 별도 세션을 여는 것이 좋습니다. 매 루프는 완전한 한 라운드로 현재 세션의 전체 컨텍스트를 반복적으로 포함합니다. 간격이 캐시 시간을 초과하면 캐시 무효화가 한 번 더叠加될 수 있습니다. 공식 권장은 별도 터미널을 열어 깨끗한 세션에서 루프를 전용으로 실행하는 것입니다.
Anthropic의 조언은 결국 다음과 같습니다: 쓸모없는 내용을 적게 넣고, 작업이 끝나면 즉시 정리하며, 세션을 너무 길게 끌지 마세요.
