Claude Code가 처음 사용량 메시지와 함께 멈추는 때는 보통 최악의 순간입니다. 리팩터링 도중, 에이전트가 계획을 컨텍스트에 담고 있는데 이제 기다려야 합니다. 두 번째가 되면 한도가 실제로 어떻게 작동하는지, 얼마나 남았는지, 미리 알 방법이 있는지 궁금해지기 시작합니다.
이 가이드는 정확한 수치를 아는 척하지 않고 Claude Code 사용 한도의 모양을 설명합니다. Anthropic은 요금제별로 할당량을 정하며 이미 여러 번 바꿨습니다. 특정 수치를 인용하는 글은 모두 스냅숏입니다. 변하지 않는 것은 모델입니다. 윈도우, 리셋, 그리고 곤란해지지 않게 해 주는 습관입니다.
사용량 윈도우의 작동 방식
Claude 구독으로 Claude Code를 사용하면 사용량은 월간 묶음이 아니라 윈도우 단위로 계산됩니다. 실제로는 두 가지를 만나게 됩니다.
- 5시간 윈도우. 첫 요청과 함께 시작해 약 5시간 뒤에 리셋됩니다. 순간적인 몰림을 제한하므로, 한 주 전체는 괜찮아도 바쁜 오전 하나로 가득 찰 수 있습니다.
- 주간 윈도우. 더 긴 기간의 전체 사용량에 상한을 둡니다. 5시간 윈도우에 여유가 있어도 주간 몫을 다 썼다면 멈춥니다.
- 모델별 주간 한도. 일부 요금제는 가장 큰 모델에 별도의 주간 할당량이 있어서, 모델을 바꾸면 소비하는 윈도우가 바뀔 수 있습니다.
각 윈도우에 얼마나 들어가는지는 요금제, 사용하는 모델, 컨텍스트 길이에 따라 다릅니다. 큰 파일을 컨텍스트에 담은 긴 세션은 짧고 집중된 세션보다 메시지당 비용이 큽니다. 현재 수치는 Anthropic의 페이지가 기준입니다. 이 글을 포함한 나머지는 모두 모양에 대한 설명으로 보세요.
에이전트 워크플로가 한도에 더 빨리 닿는 이유
채팅과 에이전트는 서로 다른 작업 부하입니다. 에이전트는 내 프롬프트 하나 안에서 파일을 읽고, 명령을 실행하고, 출력을 읽고, 다시 반복합니다. 몇 가지 요인이 이를 키웁니다.
- 병렬 세션. worktree 세 개에서 에이전트 세 개를 돌리면 계정 하나를 세 배 빠르게 씁니다.
- 긴 컨텍스트. 아침부터 이어진 세션은 압축될 때까지 매 턴마다 기록을 끌고 다닙니다.
- 서브에이전트. 위임된 작업도 같은 계정에 계산됩니다.
- 재시도 루프. 실패하는 테스트에 갇힌 에이전트는 진전 없이 윈도우를 다 써 버릴 수 있습니다.
그렇다고 에이전트를 병렬로 돌리지 말라는 뜻은 아닙니다. 디스크 용량이나 CI 시간처럼 사용량이 운영 문제가 되고, 대시보드를 둘 가치가 있다는 뜻입니다. 병렬 에이전트 가이드에서 병렬화가 추가 소비만큼 가치 있는 경우를 설명합니다.
짐작하지 않고 사용량 추적하기
Claude Code 자체도 세션 안에서 사용량과 한도를 알려 줍니다. 세션 하나라면 충분합니다. 하지만 세션, worktree, 계정이 여러 개라면 정보가 각 터미널에 갇히고 상태 화면도 한 세션의 스냅숏일 뿐이라 잘 맞지 않습니다.
Nethür는 다른 방법을 씁니다. 각 에이전트가 디스크에 보관하는 로컬 사용량 상태를 읽어(Claude Code는 ~/.claude, Codex는 ~/.codex, Gemini CLI와 OpenCode 등도 각자 해당 위치) 상태 표시줄에 보여 줍니다. 추가 API 호출도, 추가 인증도 없습니다. 사용량 팝오버에는 추적 중인 각 공급자가 요금제, 윈도우별 막대, 다음 리셋과 함께 가장 빡빡한 한도가 먼저 오도록 정렬되어 표시되고, 어떤 윈도우든 80%를 넘으면 경고가 나타납니다.
에이전트가 기록한 내용을 읽기 때문에 표시가 에이전트 자신의 기록보다 최신일 수는 없습니다. 키를 누를 때마다가 아니라 에이전트가 사용량을 기록할 때 갱신됩니다. 표시되는 윈도우와 공급자의 세부 사항은 사용량 추적 문서에 있습니다.
리셋에 맞춰 계획하기
윈도우가 보이면 그에 맞춰 계획할 수 있습니다. 모양을 바꿀 수 있는 것은 5시간 윈도우입니다. 처음 사용하는 순간 시작되기 때문입니다. 하루의 첫 요청이 오전 11시라면 윈도우는 오후 중반에 리셋됩니다. 마침 가장 무거운 작업을 시작하고 싶은 시간일 수 있습니다.
- 윈도우 워밍업. 시간을 고르면 Nethür가 가장 저렴한 모델에 아주 작은 요청을 보내 각 Claude와 Codex 계정의 5시간 윈도우를 더 일찍 시작합니다. 그러면 정말 필요할 때 리셋됩니다.
- 정지 임계값. 5시간 윈도우와 주간 윈도우에 각각 비율을 정합니다. 채팅의 계정이 그 값을 넘으면 Nethür가 그 채팅을 일시 정지해 가장 중요한 작업을 위한 여유를 남깁니다.
- 리셋 시 재개. 한도에 걸리면 채팅이 내가 알아차리기를 기다리지 않고 가장 가까운 리셋에서 스스로 재개할 수 있습니다.
여러 계정과 공급자
많은 개발자가 구독을 둘 이상 가지고 있습니다. 개인용과 업무용 Claude 요금제, 또는 Claude 요금제와 Codex 요금제입니다. 로그아웃하고 다시 로그인해 전환하는 것은 느리고 실행 중인 세션도 끊습니다. Nethür는 각 계정을 따로 보관하고 클릭 한 번으로 활성 계정을 바꿉니다. 새 세션은 새 계정을 쓰고, 이미 실행 중인 세션은 다시 시작할 때까지 시작할 때의 계정을 유지합니다. 작동 방식은 계정 핫스왑에 설명되어 있으며 Claude Code에도 똑같이 적용됩니다.
구독에 우선순위를 매길 수도 있습니다. 한 공급자의 계정들이 한도에 걸리면 채팅이 전체 대화를 가지고 다음 공급자로 넘어갑니다. 모두 소진되면 가장 가까운 리셋에서 스스로 재개합니다. 사용할 권리가 있는 계정, 즉 내 개인용과 업무용 요금제만 쓰고 각 공급자의 약관을 지키세요.
한도를 다루는 방법 비교
| 방식 | 가시성 | 한도 전 | 한도에 걸렸을 때 |
|---|---|---|---|
| 메시지가 뜰 때까지 기다리기 | 멈출 때까지 없음 | 없음 | 리셋을 기다린 뒤 컨텍스트 다시 쌓기 |
| 세션마다 확인하기 | 한 번에 한 세션 | 수동 확인 | 로그아웃과 로그인으로 계정 전환 |
| 상태 줄이나 추적 스크립트 | 계정 하나, 컴퓨터 하나 | 화면의 숫자 | 여전히 수동 |
| Nethür | 추적 중인 모든 공급자와 계정을 팝오버 하나에 | 경고, 정지 임계값, 윈도우 워밍업 | 계정 핫스왑, 공급자 페일오버, 리셋 시 재개 |
피해야 할 함정
- 오래된 수치를 믿기. 요금제 한도는 바뀝니다. 지난 분기의 포럼 글 대신 현재 요금제를 확인하세요.
- 주간 윈도우 무시하기. 주간 몫을 다 썼다면 새 5시간 윈도우는 소용없습니다. 둘 다 지켜보세요.
- 막힌 에이전트를 계속 돌리기. 같은 실패를 반복하는 에이전트는 아무 대가 없이 사용량을 씁니다. 멈추고 오류를 읽은 뒤 더 나은 프롬프트를 주세요.
- 압축하지 않기. 긴 세션은 턴당 비용이 더 큽니다. 작업이 바뀌면 새 세션을 시작하거나 압축하세요.
- 비용 추정치를 청구서로 여기기. 로컬 상태에서 나온 비용 수치는 모두 추정치입니다. 기준은 공급자의 콘솔입니다.
팀을 위한 한마디
팀에서는 한도가 공유 키가 아니라 사람에게 속해야 합니다. Nethür에서는 각 구성원이 자기 구독으로 로그인하므로 사용량, 한도, 페일오버가 계정별이고, 한 사람의 바쁜 하루가 다른 사람을 멈추지 않습니다. Nethür는 모델 접근을 재판매하지 않습니다. 내 계정이 무엇을 하는지 보여 줄 뿐입니다. 누군가 팀원의 세션을 이어받아도 세션은 공급자와 계정을 유지하므로 어떤 사용량을 쓰는지 분명합니다. 나머지는 팀 가이드에서 설명합니다.
간단한 루틴
무거운 작업은 끝난 뒤가 아니라 시작하기 전에 사용량을 확인하세요. 내 작업이 윈도우를 얼마나 빨리 쓰는지 알기 전까지는 에이전트를 다섯 개가 아니라 두 개만 돌리세요. 가장 생산적인 시간 전에 윈도우를 워밍업하고, 급한 작업을 위한 여유를 남기는 정지 임계값을 정하고, 첫 계정이 바닥나는 날을 위해 두 번째 계정이나 공급자를 준비해 두세요. 한도는 보이는 순간 더 이상 놀라운 일이 아닙니다.



