Claude Code 사용량이 금방 바닥나는 이유: 짧은 질문에도 긴 대화가 통째로 다시 읽힙니다
확인 기준일: 2026년 10월 12일 · Claude Code 공식 문서와 Claude 도움말을 직접 열어 확인한 내용 기준입니다.
아침부터 Claude Code를 열어 둔 채 일하다가 점심 무렵 “변수 이름 하나만 바꿔 줘” 같은 한 줄짜리 부탁을 했는데, 사용량 막대가 생각보다 많이 줄어 있었다고 가정해 보겠습니다. 원인은 질문이 아니라 그때까지 길어진 대화입니다. 다른 일로 넘어갈 때 /clear로 새로 시작하고, 모델은 세션 처음에 정하고, 한참 쉬었다 돌아왔을 때 이어갈 필요가 없으면 새로 여는 것이 먼저 바꿀 습관입니다.
한 줄 질문이 한 줄로 끝나지 않는 이유
Claude Code는 요청을 보낼 때마다 지금까지의 대화 전체를 함께 보냅니다. 파일을 읽거나 명령을 실행하는 도구를 쓸 때마다 그 결과를 실은 요청이 또 나갑니다. AI가 글을 처리하는 단위를 토큰이라고 하는데, 보내는 내용이 길수록 토큰이 많이 쓰입니다.
이미 처리한 앞부분은 캐시(처리 결과를 잠시 저장해 두는 기능) 덕분에 더 낮은 단가로 다시 읽습니다. 그래도 공식 문서는 하루 종일 열려 있던 세션에서는 한 줄짜리 질문도 대화 전체에 해당하는 사용량이 든다고 설명합니다. 사용량은 질문 길이가 아니라 대화가 얼마나 길어졌는가에 비례해 늘어납니다.
Pro·Max 플랜에는 5시간 단위 세션 한도와 주간 한도가 있고, 이 한도를 Claude(웹·앱)와 Claude Code가 함께 씁니다. 한쪽에서 많이 쓰면 다른 쪽 여유도 줄어듭니다. 허용량도 고정된 질문 횟수가 아니라 대화 길이와 복잡도, 쓰는 기능, 모델과 노력 수준에 따라 달라집니다.
이럴 땐 이렇게: 사용량이 불어나는 다섯 장면
| 장면 | 왜 많이 드나 | 이렇게 하세요 |
|---|---|---|
| 대화가 길어진 채 계속 사용 | 요청마다 전체 대화를 다시 보냄 | 관련 없는 일로 넘어갈 때 /clear |
| 오래 쉬었다가 돌아옴 | 캐시 수명이 지나면 전체를 처음부터 다시 처리함. 수명은 구독에서 1시간, 사용량 크레딧을 쓰기 시작하면 5분 | 이어갈 필요가 없으면 새로 시작. Pro·Max에서 큰 세션을 재개하면 요약으로 재개할지 물어봄 |
대화 요약(/compact) |
요약 작업 자체가 큰 대화를 읽는 큰 요청 | 작업과 작업 사이 자연스러운 끊김에서 실행 |
| 예약 작업, 하위 에이전트, 에이전트 팀 | 메인 대화와 별도로 각자 요청을 보냄. 팀은 계획 모드에서 표준 세션의 약 7배 | 에이전트 팀은 작게 유지하고, 일이 끝난 팀원은 종료 |
| 깊이 생각하는 기능(확장 사고) | 생각에 쓴 토큰도 출력 토큰으로 계산됨 | 단순한 작업은 /effort로 수준을 낮춤 |
세 번째 줄은 의외일 수 있습니다. 캐시가 살아 있을 때의 /compact는 대화 크기에서 짐작하는 것보다 훨씬 적게 듭니다. 반대로 한참 쉰 뒤에 옛 세션을 이어서 요약하면 캐시가 없어 전체를 다시 읽어야 하므로 가장 비쌉니다. 완전히 새로 시작하는 /clear는 비용이 들지 않습니다.
오늘 바로 바꿀 수 있는 습관
- 나중에 돌아올 대화라면
/clear전에/rename으로 이름을 붙여 두고/resume으로 다시 엽니다. - 모델은 세션 처음에 고릅니다. 모델마다 캐시가 따로여서
/model로 바꾸면 다음 요청이 대화 전체를 캐시 없이 다시 읽습니다. 비용 문서는 대부분의 코딩 작업은 Sonnet으로, Opus는 복잡한 설계 판단처럼 꼭 필요한 때만 쓰라고 권합니다. /context로 무엇이 공간을 차지하는지 보고,/mcp에서 쓰지 않는 외부 연결(MCP 서버)을 끕니다.- 프로젝트 설명 파일(CLAUDE.md)은 세션 시작 때마다 읽히므로 200줄 아래로 두고, 특정 작업에만 필요한 지침은 스킬로 옮깁니다.
- “이 코드베이스를 개선해 줘”보다 “auth.ts의 로그인 함수에 입력 검증을 추가해 줘”처럼 대상을 짚어 주면 불필요한 파일 읽기가 줄어듭니다.
- 복잡한 일은 Shift+Tab으로 계획 모드를 먼저 쓰고, 방향이 틀어지면 Esc로 멈춘 뒤
/rewind로 되돌립니다. - 테스트 결과처럼 긴 출력은 하위 에이전트에 맡기면 메인 대화가 덜 길어집니다. 다만 하위 에이전트의 요청도 사용량에서 빠지므로 공짜는 아닙니다.
내 사용량이 어디로 갔는지 확인하기
Pro·Max·Team·Enterprise 플랜에서 /usage를 열면 스킬, 하위 에이전트, 플러그인, MCP 서버별로 최근 사용량의 비율이 나옵니다. 긴 컨텍스트나 캐시 미스(캐시를 못 써서 다시 처리한 경우)가 최근 사용량의 10% 이상을 차지하면 따로 표시해 줍니다. 이 수치는 그 컴퓨터의 기록으로 계산한 근사치라서 다른 기기나 claude.ai 사용량은 들어 있지 않습니다.
남은 사용량은 Pro·Max 도움말이 /status로, 비용 문서가 /usage로 안내하니 버전에 따라 화면 이름이 다를 수 있다고 보고 두 명령을 모두 열어 보시기 바랍니다.
ANTHROPIC_API_KEY 환경 변수가 설정되어 있으면 Claude Code는 구독 대신 그 키를 사용하고, 그 경우 구독 사용량이 아니라 API 요금이 청구됩니다.
9월 14일부터 바뀐 주간 한도
Claude 도움말 기준으로 Claude Code 주간 한도를 50% 높인 프로모션은 2026년 9월 13일 오후 11시 59분(태평양 시간)에 끝났고, 9월 14일부터 Pro, Max, Team, 좌석형 Enterprise 플랜의 주간 한도는 프로모션 이전보다 25% 높은 수준으로 유지됩니다. 5시간 한도는 이 프로모션의 대상이 아니었습니다. 해외 IT 매체 BleepingComputer는 8월 29일 같은 변화를 “현재와 비교하면 17% 감소”로 보도했는데, 프로모션 중 한도와 비교한 기준 차이로 보이며 17%라는 표현은 도움말에는 없어 보도 기준으로만 적습니다.
이 글에서 확인하지 못한 것
- 플랜별 5시간·주간 한도의 구체적인 수치: 확인한 도움말에는 숫자가 없었습니다.
- 위 습관들이 사용량을 얼마나 줄여 주는지: 문서에 비율이 없고 직접 측정하지도 않았습니다.
- 10월의 새 발표: 검색에서 Claude Code 사용량 한도에 관한 10월 공식 발표를 찾지 못했습니다. 찾지 못했다는 것이 없다는 뜻은 아닙니다.
출처
- Anthropic · Claude Code Docs, Manage costs effectively(2026-10-12 확인) · 원문 링크
- Anthropic · Claude Code Docs, How Claude Code uses prompt caching(2026-10-12 확인) · 원문 링크
- Anthropic · Claude 도움말, Using Claude Code with your Pro or Max plan(2026-10-12 확인) · 원문 링크
- Anthropic · Claude 도움말, How do usage and length limits work(2026-10-12 확인) · 원문 링크
- Anthropic · Claude 도움말, Claude Code May-August 2026 weekly limits promotion(2026-10-12 확인) · 원문 링크
- BleepingComputer · Anthropic is cutting Claude Code’s current weekly limits by 17 percent, 2026-08-29 보도(2026-10-12 확인, 보도 기준) · 원문 링크
