클로드 코드 비용과 한도 관리 (캐시, 컨텍스트, 모델 선택)

이 글은 앤트로픽이 운영하는 code.claude.com/docs의 Costs, Prompt caching, Model configuration, Statusline 문서를 한국어 사용자가 실무에 바로 옮길 수 있도록 정리한 글입니다. 명령과 수치는 2026년 9월 28일 공식 문서 기준이고, 원문 링크는 글 끝 참고 자료에 모았습니다.

🤔 같은 작업을 했는데 사용량이 빨리 닳는 날이 있을 때

어제와 비슷한 양의 작업을 했는데 오늘은 오후도 되기 전에 세션 한도에 닿는 날이 있습니다. 요금제 구조와 /usage 기본 사용법은 입문 코스의 클로드 코드 플랜과 사용량 한도에서 다뤘습니다. 같은 요금제에서 사용량이 달라지는 이유는 대부분 캐시, 컨텍스트 크기, 모델 선택 세 가지에서 나옵니다.

지금부터 프롬프트 캐시가 어떻게 작동하고 무엇이 캐시를 깨는지, /clear와 /compact와 /rewind를 언제 쓰는지, 모델과 추론 수준을 어떻게 고르는지, 사용량을 화면에서 계속 보는 방법을 정리합니다.

🔑 비용과 한도 관리의 정의

클로드 코드의 비용과 한도 관리는 프롬프트 캐시가 끊기지 않게 작업하고, 컨텍스트를 제때 비우거나 줄이며, 작업에 맞는 모델과 추론 수준을 골라 같은 한도로 더 오래 쓰는 방법입니다.

구독 요금제로 쓰면 달러 금액은 나오지 않지만 원리는 같습니다. API 요금을 많이 쓰는 행동은 구독 한도도 같은 비율로 빨리 줄입니다. 공식 비용 문서가 드는 첫 번째 권고도 "컨텍스트를 미리 관리하라"입니다.

🧊 프롬프트 캐시가 작동하는 방식

클로드 코드는 메시지를 보낼 때마다 시스템 프롬프트, 프로젝트 맥락, 지금까지의 대화와 도구 결과를 전부 다시 보냅니다. 이때 앞부분이 지난번과 정확히 같으면 그 부분은 캐시에서 싸게 읽습니다. 공식 문서는 이 앞부분을 세 층으로 설명합니다.

1. 시스템 프롬프트: 핵심 지시와 도구 정의
2. 프로젝트 맥락: CLAUDE.md, 자동 메모리, 경로 조건 없는 규칙
3. 대화: 주고받은 메시지와 도구 결과

대화 층이 바뀌어도 앞 두 층의 캐시는 살아 있지만, 시스템 프롬프트가 바뀌면 전부 새로 읽습니다. 캐시가 유지되는 시간은 요청 종류마다 다릅니다.

한 시간 넘게 쉬었다가 보낸 첫 메시지는 캐시 없이 전체를 다시 읽습니다. Pro와 Max에서 10만 토큰이 넘는 세션을 한 시간쯤 쉬었다 다시 열면 "요약에서 이어 가기"와 "그대로 이어 가기"를 고르는 창이 뜨는데, 대화가 길다면 요약 쪽이 덜 씁니다. 캐시는 사실상 한 기기, 한 폴더 단위라서 같은 저장소라도 다른 워크트리끼리는 캐시를 나누지 못합니다.

🔨 캐시를 깨는 행동과 유지하는 행동

공식 문서가 목록으로 정리해 둔 내용입니다.

여기서 착각하기 쉬운 것이 CLAUDE.md입니다. 세션 중에 CLAUDE.md를 고쳐도 캐시는 깨지지 않지만, 고친 내용도 바로 적용되지 않습니다. 세션을 시작할 때 읽은 판으로 계속 일하고, 새 내용은 다음 /clear, /compact, 재시작 때 들어갑니다. MCP 서버를 연결하거나 끊는 것도 기본값인 도구 검색 방식에서는 캐시를 건드리지 않습니다.

그래서 공식 팁은 간단합니다. 모델과 effort는 세션을 시작할 때 정하고 도중에 자주 바꾸지 않습니다. 플랜 모드에서는 Opus, 실행에서는 Sonnet을 쓰는 opusplan도 편리하지만, 플랜 모드를 켜고 끌 때마다 모델이 바뀌어 새 캐시로 시작한다는 점을 알고 씁니다.

🧹 /clear, /compact, /rewind를 고르는 기준

/compact는 캐시가 따뜻할 때 하면 앞부분을 캐시에서 읽어 비용이 작지만, 캐시가 식은 뒤에 하면 전체를 캐시 없이 다시 처리합니다. 공식 문서가 /compact를 작업 사이 자연스럽게 쉬는 시점, 즉 한 단계가 끝난 직후에 쓰라고 권하는 이유입니다. CLAUDE.md에 # Compact instructions 절을 두면 압축할 때 무엇을 남길지 정해 둘 수 있습니다.

자동 압축이 일어나는 크기는 /autocompact 500k처럼 직접 정할 수 있습니다(v2.1.221 이상, 100K에서 1M 사이). 압축 뒤에도 프로젝트 루트 CLAUDE.md는 디스크에서 다시 읽어 넣고, 최근 수정한 파일 다섯 개까지 다시 읽습니다. 지금 무엇이 컨텍스트를 차지하는지는 /context가 색 격자와 개선 제안으로 보여 줍니다.

🧠 모델과 추론 수준 고르기

v2.1.280부터 Pro, Max, Team, Enterprise 모두 기본 모델이 Opus 5.5입니다. 공식 비용 문서는 대부분의 코딩 작업에 Sonnet이면 충분하고 Opus는 복잡한 구조 결정과 여러 단계 추론에 쓰라고 권합니다.

• 모델 바꾸기: /model에서 Enter는 기본값으로 저장하고, s는 이 세션에만 적용합니다
• 추론 수준: /effort로 low, medium, high, xhigh, max를 고릅니다. 생각하는 데 쓴 토큰은 출력 토큰으로 계산되므로 높을수록 비쌉니다. Opus 5.5의 기본은 medium입니다
• 서브에이전트 모델: 주 대화를 Opus로 바꾸면 모델을 물려받는 서브에이전트도 Opus가 됩니다. 단순한 서브에이전트는 model: haiku로 둡니다
• fast mode: /fast는 Opus를 최대 2.5배 빠르게 하지만, 구독 요금제에서도 플랜 한도가 아니라 사용 크레딧에서 바로 과금됩니다
• Fable: 어느 플랜에서도 기본값이 아니고, 플랜에 따라 사용 크레딧으로 과금될 수 있어 /model 목록에 "Requires usage credits"가 표시됩니다

📊 무엇이 사용량을 쓰는지 확인하기

/usage(별칭 /cost, /stats)에는 v2.1.251부터 Prompt cache (main) 줄이 생겼습니다. 캐시에서 읽은 입력 비율과 캐시를 놓친 횟수가 나오고, v2.1.260부터는 "도구 정의가 바뀜" 같은 원인까지 표시합니다. 캐시 적중률이 낮게 나온다면 위의 캐시를 깨는 행동 가운데 무엇을 했는지부터 봅니다. 구독 요금제에서는 같은 화면에 스킬, 서브에이전트, MCP 서버별 사용량 비중도 나옵니다.

화면 아래 상태줄에 사용량을 늘 띄워 둘 수도 있습니다. /statusline 5시간 사용률과 주간 사용률을 보여 줘처럼 요청하면 스크립트를 만들어 설정까지 해 줍니다. 상태줄은 내 컴퓨터에서 돌아 토큰을 쓰지 않고, Pro와 Max 구독 계정은 rate_limits 필드로 5시간 창과 7일 창의 사용률, 다시 채워지는 시각을 받습니다. 상태줄을 직접 만든 사례는 클로드 코드 예상 시간 상태줄에 있습니다.

⚠️ 자주 하는 실수

• 작업 도중 모델을 자주 바꿉니다: 바꿀 때마다 새 캐시로 시작합니다
• 한 시간 넘게 쉰 긴 대화에 바로 이어서 묻습니다: 캐시가 식어 전체를 다시 읽습니다. 요약에서 이어 가거나 /clear 후 필요한 것만 다시 줍니다
• 캐시가 식은 뒤에 /compact를 합니다: 압축 자체가 비싸집니다. 한 단계가 끝난 직후에 합니다
• 세션 중 CLAUDE.md를 고치고 바로 반영됐다고 생각합니다: /clear나 재시작 뒤에 들어갑니다

❓ 자주 묻는 질문

한도에 걸린 뒤 다시 채워지면 작업이 알아서 이어지나요?

v2.1.234부터 구독으로 로그인한 대화형 세션에서는 기본으로 켜져 있습니다. 한도에 닿으면 몇 시에 이어 간다는 안내가 뜨고, 다시 채워지면 이어서 진행합니다. Esc로 취소할 수 있습니다.

병렬로 여러 세션을 돌리면 사용량이 몇 배가 되나요?

세션마다 따로 요청을 보내므로 대체로 세션 수만큼 늘어납니다. 서브에이전트도 자기 요청을 따로 보내 같은 한도에서 차감되고, 에이전트 팀 기능은 팀원이 플랜 모드로 돌 때 일반 세션의 약 7배를 쓴다고 공식 문서가 적습니다.

캐시를 1시간보다 오래 유지할 수 있나요?

구독 한도 안의 주 대화는 이미 1시간이 기본입니다. 사용 크레딧이나 API 키로 쓸 때 5분으로 줄어드는 캐시는 promptCacheTtl 설정으로 1시간을 지정할 수 있는데, 1시간 캐시는 쓸 때 단가가 더 높다는 점을 함께 봅니다.

📋 3줄 요약

1. 클로드 코드는 매 요청마다 대화 전체를 다시 보내고 앞부분이 같은 만큼 캐시에서 읽으며, 구독 한도 안의 주 대화 캐시는 1시간 유지되고 서브에이전트 요청은 5분입니다.

2. 모델 전환과 effort 변경, fast mode 켜기와 대화 압축은 캐시를 깨고 파일 편집과 권한 모드 변경, 스킬 호출과 세션 중 CLAUDE.md 편집은 캐시를 유지합니다.

3. 다른 일로 넘어갈 때는 비용이 들지 않는 /clear를, 같은 일을 이어 갈 때는 작업 사이 쉬는 시점의 /compact를 쓰고 버릴 경로는 /rewind로 되돌립니다.

📚 참고 자료

• 비용 관리 문서: https://code.claude.com/docs/en/costs
• 프롬프트 캐시 문서: https://code.claude.com/docs/en/prompt-caching
• 모델 설정 문서: https://code.claude.com/docs/en/model-config
• 상태줄 문서: https://code.claude.com/docs/en/statusline
• 컨텍스트 창 문서: https://code.claude.com/docs/en/context-window