클로드 코드 한도가 빨리 닳는다면: 모델 낮추기 전에 /context와 /usage부터

소개

Claude Code 한도가 빨리 닳을 때 가장 손대기 쉬운 것은 모델입니다. 그런데 Anthropic 공식 글이 제시한 비용 순서에서 모델은 세 번째입니다.

  • 긴 세션 — 매 턴 앞의 모든 것을 다시 보낸다

  • 컨텍스트에 너무 많이 담기 — 필요 없던 파일, 긴 명령 출력, 이전 작업 잔여물이 매 턴 다시 전송된다

  • 작업에 비해 큰 모델이나 높은 effort — 나머지 모든 비용이 여기에 곱해진다

  • 프롬프트 캐시 깨기 — 대화 전체를 다시 계산하고 캐시에 다시 기록한다

그림 1. 비용에 영향을 주는 순서

1번과 2번은 모두 컨텍스트의 양입니다. 요청마다 대화 전체가 다시 전송되기 때문이며, 40번째 턴은 앞의 39턴을 전부 다시 읽습니다. 중간에 컨텍스트를 줄이지 않았다면 그렇습니다.

짐작으로 줄이기 전에 기본 명령 두 개로 현재 상태를 재는 방법, 그리고 측정 결과에 따라 바로 쓸 수 있는 실행 팁을 정리했습니다. 설치하거나 설정 파일을 고칠 것은 없습니다. 기준 자료는 Anthropic 공식 글 Maximizing the value of your Claude Code sessions (2026-08-14, Lydia Hallie)와 Claude Code 공식 문서이고, 수치와 동작은 2026-10-21에 공식 문서 원문으로 확인했습니다.

진행 방법

측정 1. /context 로 시작 짐 확인하기

새 세션에서 아무것도 입력하지 않은 상태로 실행하면, 입력 전에 이미 실려 있는 내용이 항목별로 나옵니다.

그림 2. /context 실행 화면

이 예시의 측정값입니다. Opus 5.5 기준 총 33.7k 토큰입니다.

  • System tools 14.1k

  • Skills 73개 9.9k

  • System prompt 4k

  • Memory files, 즉 CLAUDE.md 3개 3.2k

  • Custom agents 6개 1.1k

  • MCP tools 80개 620, 서버 안내 717

읽을 때 참고할 점입니다.

  • MCP 도구 수는 토큰 양과 비례하지 않습니다. 기본 설정에서 도구 정의는 지연 로드되어, 시작할 때는 이름과 서버 안내만 실립니다. 위 예시에서 도구 80개가 620토큰인 이유입니다.

  • 스킬은 본문만 지연 로드됩니다. 이름과 설명 목록은 처음부터 상주하므로 개수가 늘면 시작 짐도 늘어납니다.

  • CLAUDE.md 는 Memory files 항목에 포함됩니다. 공식 문서 권장은 파일당 200줄 이하이고, 작업 전용 지시는 스킬로 옮기는 편이 낫습니다.

  • 세션 중 CLAUDE.md 를 고쳐도 /clear, /compact, 재시작 전까지 반영되지 않습니다. 하위 폴더 파일은 로드되기 전이면 즉시 반영됩니다.

  • MCP 서버는 첫 요청이 나가기 전에 꺼야 합니다. 기본 경로에서는 첫 요청의 도구 목록을 대화 끝까지 유지하므로, 도중에 꺼도 그 세션의 컨텍스트는 줄지 않습니다.

측정 2. /usage 로 사용 패턴 확인하기

최근에 토큰을 어디에 썼는지, 캐시가 실제로 먹히고 있는지 보여 줍니다.

그림 3. /usage 실행 화면

  • Usage by model — 예시는 1.0k input, 24 output, 275.0k cache read, 46.3k cache write 입니다. input 은 캐시에 읽히지도 기록되지도 않은 입력이고, 새로 캐시에 기록한 양은 cache write 로 따로 잡힙니다. 둘을 합쳐도 캐시에서 읽은 275.0k 가 훨씬 큽니다.

  • Prompt cache (main) — 예시는 4 requests, 78% of input tokens from cache, 1 miss, warm (1h TTL) 입니다. 캐시가 실제로 먹히는지 재는 줄입니다.

  • 플랜 사용량 아래 진단 — 구독 플랜에서 최근 사용량의 성격을 비율로 표시합니다. 예시 화면은 74%가 150k 넘는 컨텍스트, 23%가 40k 넘는 상시 컨텍스트였습니다. d 와 w 키로 24시간과 7일을 전환합니다.

최근 사용량은 이 컴퓨터 기록 기준 근사치입니다. 세션 블록의 달러 금액은 API 사용자를 위한 것이고, Max 와 Pro 구독자에게는 청구와 무관합니다. 구독자는 같은 화면의 플랜 사용량 바를 봅니다.

실행 팁 1. 파일은 @ 멘션으로 가리킨다

Claude 가 스스로 찾아야 할수록 많이 읽고, 그 결과는 쓸모가 없어진 뒤에도 대화에 남습니다. 원글 그림 기준으로 지시에 따라 수정 전에 쌓이는 턴이 이렇게 달라집니다.

  • 테스트가 실패해 — 6턴. 검색 2회 후 파일 3개를 열고 읽습니다.

  • utils.test.ts 의 실패한 테스트 고쳐줘 — 1턴. Read 한 번입니다.

  • @utils.test.ts 의 실패한 테스트 고쳐줘 — 0턴. 메시지에 첨부되어 전송됩니다.

  • @ 로 첨부한 파일은 Read 호출 자체가 없습니다.

  • 대화당 한 번이면 됩니다. 파일은 대화에 계속 남습니다.

  • 다시 멘션하면 보통 사본이 하나 더 붙습니다. 두 번째부터는 파일 이름만 씁니다.

실행 팁 2. 명령 출력을 짧게 받는다

  • 정상 종료한 출력이 약 30,000자를 넘으면 파일로 빠지고 미리보기만 남습니다. 문제는 그 아래입니다. 통과한 테스트 400줄 같은 것은 치울 때까지 매 턴 따라다닙니다.

  • 자주 쓰는 명령 두세 개는 출력을 줄이는 옵션까지 CLAUDE.md 에 적어 둡니다. git log --oneline -5, git status --short, npx vitest run 파일명 --reporter=dot 처럼 적습니다.

실행 팁 3. 세션을 나눈다

  • 작업이 바뀌면 /clear 합니다. 공식 문서 기준으로 비용이 없습니다.

  • 같은 작업 3개를 한 세션에서 이어 하면 /clear 로 나눌 때보다 약 1.9배 전송합니다. 원글 그림 기준입니다.

  • 나중에 볼 세션은 /clear 이름 형태로 비우면서 직전 대화에 이름을 붙입니다.

  • /loop 는 다른 터미널의 새 세션에서 돌립니다. 설정한 세션의 대화 전체를 매번 싣고 갑니다.

실행 팁 4. /compact 는 지시와 타이밍이 전부다

  • 남길 내용을 지시합니다. /compact 결정된 내용과 파일 경로는 남겨줘 처럼 씁니다.

  • 매번 같은 지시면 CLAUDE.md 에 Compact instructions 섹션을 둡니다.

  • 캐시가 살아 있을 때 하면 싸고, 오래 쉰 뒤가 가장 비쌉니다.

  • 긴 세션은 idle compaction 이 자동 실행되기도 합니다. 조건은 인터랙티브 터미널, 실제 1시간 캐시 TTL, feature flag 조회 가능, 컨텍스트가 기본 임계값 200k 이상, 마지막 요청 후 약 54분 시점에 컴퓨터가 깨어 있을 것 다섯 가지입니다.

  • 다만 /compact 도 요약을 만드는 요청이라 비용이 듭니다. 작업을 더 이어 갈 예정이고 치울 이력이 많을 때 실행하고, 그냥 끝낼 세션이면 하지 않아도 됩니다.

  • 1M 모델에서 자동 압축 시점을 당기려면 /autocompact 200k 를 씁니다.

실행 팁 5. 엇나간 턴은 /rewind 로 되돌린다

/compact 는 대화를 새로 써서 항상 비용이 들지만, /rewind 는 뒤쪽 턴만 잘라내 앞부분 캐시를 유지합니다.

  • 실행은 /rewind 또는 입력창이 빈 상태에서 Esc 두 번입니다.

  • 코드와 대화, 대화만, 코드만 중에서 고릅니다. 코드 복원은 추적된 변경이 있을 때만 표시됩니다.

  • 복원되지 않는 것은 Bash 명령으로 바뀐 파일, 서브에이전트가 손댄 파일 중 메인에서 편집하지 않은 것, 심볼릭과 하드 링크 파일입니다. 단 포그라운드로 도는 context: fork 스킬의 편집은 통상 복원됩니다.

  • 같은 메뉴의 Summarize from here 와 up to here 는 되돌리기가 아닌 별개 동작이라 비용 없음이 적용되지 않습니다.

실행 팁 6. 과정이 긴 일은 서브에이전트에 맡긴다

서브에이전트는 자기 컨텍스트에서 일하고 결과만 메인으로 돌려줍니다. 과정은 내 대화에 남지 않습니다. 이 로그는 서브에이전트로 살펴봐줘 처럼 요청하면 됩니다.

  • 읽을 게 많고 결과는 짧은 일에 이득입니다. 로그 훑기가 대표적이고, 작은 일에는 오버헤드입니다.

  • 메인은 서브에이전트가 보고하기로 고른 것만 받으므로, 무엇을 가져올지 정해서 요청합니다.

  • 반복되는 시끄러운 작업은 전용 정의에 model: haiku 또는 sonnet 을 지정합니다. 지정하지 않으면 메인 세션 모델로 돕니다.

  • 서브에이전트의 캐시 수명은 구독이어도 기본 5분입니다.

  • /subtask 로 띄우는 fork 는 성격이 반대입니다. 지금 대화를 그대로 물려받아 배경 설명이 필요 없는 대신 보낼 양은 줄지 않습니다. 다만 첫 요청은 메인의 캐시를 읽습니다.

실행 팁 7. 모델과 effort, fast mode 는 세션 시작에 정한다

  • /model 과 /effort 값은 다음 세션으로 이어집니다. 새 세션에서 두 명령으로 현재 설정부터 확인합니다.

  • 출력 단가는 입력의 5배입니다. 단순 작업 세션은 /effort 를 낮추는 것이 직접적인 절감입니다.

  • 모델 변경은 세션 시작이나 /clear 직후에만 합니다. 긴 대화 중간은 캐시가 깨집니다. opusplan 은 plan mode 에 들어가고 나올 때마다 모델이 바뀝니다.

  • fast mode 는 켤 거면 시작할 때 켭니다. 처음 켤 때만 캐시가 깨지고, 이 캐시 재구축 비용은 대화당 한 번입니다. 토큰 단가는 켜 둔 동안 계속 높습니다.

  • fast mode 는 플랜에 사용량이 남아 있어도 usage credits 에서 바로 빠집니다.

실행 팁 8. 캐시 수명을 알고 자리를 비운다

별도 설정이 없을 때의 기본값입니다. promptCacheTtl 과 subagentPromptCacheTtl 로 바꿀 수 있습니다.

  • 구독이면서 플랜 포함 사용량 안의 메인 대화는 1시간입니다.

  • API 키로 쓰는 메인 대화는 5분입니다.

  • 서브에이전트와 compact 요청은 구독이어도 5분입니다.

  • 구독 한도를 넘어 usage credits 를 쓰는 중이면 메인 대화도 5분이 됩니다.

수명은 마지막 요청이나 응답부터 재고, 대화를 주고받을 때마다 리셋됩니다. 이 시간이 지나면 다음 요청에서 대화 전체를 다시 읽습니다.

결과와 배운 점

원글과 현재 공식 문서가 다른 부분

원글은 2026-08-14 글이고, 그 뒤 동작이 바뀐 항목이 있어 공식 문서를 같이 봐야 했습니다.

  • 원글은 effort 를 바꾸면 캐시가 깨진다고 썼지만, 현재 문서 기준으로 Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.1 은 API 키나 구독 사용 시 캐시가 유지됩니다. 단 Bedrock, Google Cloud Agent Platform, Claude apps gateway, CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 설정, HIPAA 구성은 제외됩니다.

  • 원글은 MAX_THINKING_TOKENS=0 으로 thinking 을 끌 수 있다고 썼지만, 현재 주력 모델에서는 끌 수 없습니다. /effort 를 낮추는 방법이 유효합니다.

  • 원글은 자리를 비우기 전에 /compact 하라고 했는데, 지금은 조건을 만족하는 긴 세션이면 idle compaction 이 자동으로 합니다.

명령어 정리

  • /context — 시작 짐과 컨텍스트 점유 확인

  • /usage — 사용 패턴, 캐시 적중률, 플랜 사용량 확인

  • /model 과 /effort — 세션 시작 시 확인하고 설정. 다음 세션으로 이어집니다.

  • /mcp — 안 쓰는 MCP 서버 끄기. 첫 요청 전에 합니다.

  • @파일 — 파일을 메시지에 첨부. 대화당 한 번입니다.

  • /clear 이름 — 새 작업 시작. 비용이 없고 이름을 주면 직전 대화에 라벨이 붙습니다.

  • /compact 지시 — 같은 작업을 이어 가며 대화 축소

  • /rewind — 최근 몇 턴 되돌리기. Esc 두 번으로도 열립니다.

  • /subtask — 지금 대화를 물려받은 fork 에게 곁가지 작업 위임

  • /loop — 반복 작업. 별도 새 세션에서 돌립니다.

  • /autocompact 200k — 1M 모델의 자동 압축 시점 조정

정리하며

  • 한도가 빨리 닳으면 모델이 아니라 세션 길이와 컨텍스트 양부터 봅니다.

  • 재보기 전에 짐작하지 않습니다. /context 는 시작 짐을, /usage 는 최근 사용 패턴을 보여 줍니다.

  • 전부 기본 명령이라 설치하거나 설정할 것이 없습니다.

  • 수치와 동작은 바뀌는 항목이므로, 인용하기 전에 공식 문서를 한 번 더 확인하는 편이 안전합니다.

도움 받은 글

  • Anthropic, Maximizing the value of your Claude Code sessions — https://claude.com/resources/articles/maximizing-the-value-of-your-claude-code-sessions

  • Claude Code 공식 문서, 프롬프트 캐싱 — https://code.claude.com/docs/en/prompt-caching

  • Claude Code 공식 문서, 비용 관리 — https://code.claude.com/docs/en/costs

  • Claude Code 공식 문서, 체크포인트 — https://code.claude.com/docs/en/checkpointing

  • Claude Code 공식 문서, 메모리 — https://code.claude.com/docs/en/memory

  • Claude Code 공식 문서, 서브에이전트 — https://code.claude.com/docs/en/sub-agents

2
1개의 답글
지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

매주 월요일 오후,
읽고 바로 써먹을 AI 소식만