Claude Code의 사용량은 메시지 횟수만으로 설명되지 않습니다. 짧은 질문을 여러 번 주고받은 세션과 파일·로그를 많이 읽은 디버깅 세션은 요청 한 번의 크기가 다릅니다.
여기에는 서로 다른 두 한도가 섞여 있습니다.
- 사용량 제한은 일정 기간 계정에서 Claude를 사용할 수 있는 한도입니다.
- 컨텍스트 한도는 현재 세션에서 Claude가 한 번에 참고할 수 있는 정보의 크기입니다.
둘은 같은 제한이 아닙니다. 다만 세션이 길어지면 이전 대화와 작업 결과가 다음 요청에도 포함되므로 컨텍스트가 커지고, 사용량도 더 빠르게 줄 수 있습니다.
메시지 한 번의 크기는 일정하지 않다
Anthropic은 Claude Code의 요청에 이전 대화, 프로젝트 컨텍스트, 새 프롬프트가 포함된다고 설명합니다. 프로젝트 컨텍스트에는 CLAUDE.md와 Claude가 읽은 파일 등이 들어갑니다.
세션 초반에는 포함할 내용이 적습니다. 같은 세션에서 파일을 계속 읽고, 빌드 로그를 확인하고, 수정을 반복하면 이후 요청이 참고할 내용도 늘어납니다.
첫 요청
= 시작 지침 + 첫 질문
작업이 길어진 뒤의 요청
= 시작 지침
+ 앞선 대화와 응답
+ 읽은 파일과 명령 출력
+ 새 질문같은 요금제라도 대화 길이, 작업 복잡도, 모델과 effort에 따라 체감 사용량이 달라지는 이유입니다. Claude 웹, Claude Code, Claude Desktop의 사용량도 같은 계정 한도에 함께 반영될 수 있습니다.
어떤 한도에 걸렸는지 먼저 구분한다
| 증상 | 의미 | 확인할 곳 | 대응 |
|---|---|---|---|
| 재설정 시간이 표시되며 사용할 수 없음 | 계정 사용량 제한 | Settings의 Usage | 재설정을 기다리거나 작업 방식을 조정 |
Prompt is too long |
현재 세션의 컨텍스트 초과 | /context |
/compact 또는 /clear |
| 자동 압축이 반복됨 | 컨텍스트가 빠르게 참 | /context |
큰 출력과 불필요한 지침 확인 |
| API 비용이 예상보다 큼 | 긴 세션이나 모델의 영향 가능 | /cost, API 대시보드 |
세션과 모델 사용 방식 점검 |
/compact는 계정 사용량을 되돌리지 않습니다. 현재 대화를 요약해 컨텍스트 공간을 확보하는 명령입니다. 이미 사용한 할당량을 환불하거나 재설정하지는 않습니다.
/context에서 무엇이 쌓였는지 본다
현재 세션의 컨텍스트 구성은 다음 명령으로 확인할 수 있습니다.
/context대화 기록 외에도 CLAUDE.md, 읽은 파일, 명령 출력, 메모리, 규칙과 도구 정보가 컨텍스트에 영향을 줍니다. 2026년 7월 Claude Code 문서 기준으로 MCP 도구 정의는 기본적으로 필요할 때 불러오지만, 사용한 도구와 반환 결과는 세션에 내용을 더합니다.
Prompt is too long이 발생했다면 큰 파일이나 출력이 들어왔는지 확인하는 것이 먼저입니다. 사용하지 않는 MCP 서버, 지나치게 긴 CLAUDE.md, 큰 빌드 로그도 함께 살펴볼 수 있습니다.
작업이 바뀌면 /clear
로그인 오류를 해결한 세션에서 바로 데이터베이스 마이그레이션을 시작할 이유는 많지 않습니다. 앞선 디버깅 기록이 새 작업에 필요하지 않다면 대화를 비우는 편이 낫습니다.
/clear/clear를 실행해도 프로젝트 파일이 삭제되지는 않습니다. 다만 이전 대화에서 읽은 파일 내용과 판단 과정이 새 대화에 그대로 이어지는 것은 아닙니다. 다시 필요할 결론은 코드나 문서에 남긴 뒤 세션을 바꾸는 것이 안전합니다.
같은 작업을 이어가면 /compact
하나의 버그를 계속 추적하고 있다면 앞에서 배제한 원인과 수정 내역을 버리기 어렵습니다. 이때는 대화를 요약해 공간을 확보할 수 있습니다.
/compact 로그인 리다이렉트 원인, 배제한 가설, 수정한 파일과 실패한 테스트를 보존무엇을 보존할지 함께 적으면 요약의 초점을 정할 수 있습니다. 다만 컨텍스트가 이미 가득 찼다면 /compact 자체가 실패할 수도 있습니다. Claude Code 오류 문서는 이 경우 최근 메시지 몇 개를 컨텍스트에서 제외한 뒤 다시 압축하거나, 새 세션을 시작하도록 안내합니다.
CLAUDE.md도 컨텍스트에 포함된다
프로젝트 루트의 CLAUDE.md는 반복해서 필요한 규칙을 전달하는 데 유용하지만, 매 요청의 컨텍스트에 계속 포함됩니다. 프롬프트 캐시가 비용을 낮추더라도 컨텍스트 공간까지 없애는 것은 아닙니다.
Anthropic은 현재 가이드에서 CLAUDE.md를 대략 200줄 아래로 유지하는 경험칙을 제시합니다. 200줄이 제품의 제한이라는 뜻은 아닙니다. 줄 수보다 중요한 것은 프로젝트 전체에 계속 필요한 규칙인지 여부입니다.
특정 작업에서만 필요한 설명, 오래되어 더는 맞지 않는 규칙, 한 번 발생한 실수를 모두 루트 CLAUDE.md에 쌓으면 이후 작업에도 따라다닙니다. 반복해서 필요한 규칙만 남기고 특정 경로의 규칙은 범위를 좁히는 편이 낫습니다.
지금 한도에 걸렸다면
확인 순서는 다음 정도면 충분합니다.
- Settings의 Usage에서 계정 사용량 제한인지 확인합니다.
- 세션을 계속 쓸 수 있다면
/context로 큰 항목을 찾습니다. - 같은 작업이면
/compact, 다른 작업이면/clear를 사용합니다. - 긴 로그, 큰 파일, 사용하지 않는 도구와 오래된 지침을 정리합니다.
API 키로 Claude Code를 사용한다면 /cost에서 세션 비용과 토큰을 확인할 수 있습니다. 구독 계정에서는 /cost를 남은 할당량으로 해석하지 말고 Usage 화면을 확인해야 합니다.
결론
Claude Code의 사용량을 메시지 수로 계산하면 실제 동작과 맞지 않습니다. 긴 세션에서는 이전 대화, 읽은 파일과 명령 출력이 다음 요청에도 영향을 줍니다.
계정 사용량 제한과 한 세션의 컨텍스트 초과를 먼저 구분해야 합니다. 작업이 끝났다면 /clear, 같은 작업을 이어가야 한다면 /compact를 사용합니다. 무엇이 공간을 차지하는지 모를 때는 /context가 출발점입니다.