Claude 사용량과 남은 한도를 확인하세요.
Claude Code, claude.ai, Claude 앱은 모두 같은 요금제 한도를 함께 사용합니다. Claude Code 사용량 확인은 어디서 하는지, 얼마나 더 사용할 수 있는지, 5시간 한도와 주간 한도는 어떻게 적용되는지 알아보세요.
Claude Code에서 /usage를 입력하면 요금제 사용량 막대가 표시됩니다. claude.ai나 Claude 앱에서는 Settings > Usage를 여세요. 5시간 세션 한도와 주간 한도 중 얼마나 사용했는지, 세션 한도 초기화까지 얼마나 남았는지 확인할 수 있습니다. claude.ai, Claude Code, Claude 데스크톱 앱의 사용량은 모두 같은 한도에 합산됩니다.
Claude 사용량은 여기서 확인하세요.
확인할 수 있는 곳은 네 군데입니다. 처음 세 가지는 기본 제공 기능으로, 별도 설정이 필요 없습니다.
| 확인 위치 | 여는 방법 | 표시되는 정보 |
|---|---|---|
| 터미널의 Claude Code | /usage를 입력하세요. /cost와 /stats도 같은 화면을 엽니다. | 요금제 사용량 막대와 활동 통계. Pro, Max, Team, Enterprise 요금제에서는 한도에 반영된 사용량의 세부 내역도 표시됩니다. |
| claude.ai 또는 Claude 앱 | Settings > Usage | 현재 5시간 세션의 사용량 막대와 초기화까지 남은 시간, 주간 한도의 사용량 막대. |
| Claude 데스크톱 앱의 Code 탭 | 메시지 입력란 근처의 사용량 링 | 사용량 한도가 있는 요금제에서 해당 기간의 요금제 사용량을 보여 줍니다. Anthropic의 안내 페이지마다 링의 위치가 조금씩 다르므로 메시지 입력란 주변에서 찾아보세요. |
| 직접 설정한 상태 줄 | ~/.claude/settings.json에 짧은 명령 추가(아래 설명 참고) | Pro와 Max 요금제에서 세션의 첫 응답 이후, 5시간 및 7일 한도 중 사용한 비율을 표시합니다. |
/usage 안의 세부 내역은 추정치입니다. Anthropic에 따르면 이 컴퓨터의 세션 기록으로 계산하므로 다른 기기와 claude.ai에서 사용한 양은 빠집니다. 요금제 사용량 막대는 계정 전체의 사용량을 보여 줍니다.
Settings > Usage는 Pro, Max, Team 및 좌석 기반 Enterprise 요금제에서 사용할 수 있습니다. 사용량 기반 Enterprise 요금제에는 고정된 사용량 한도가 없습니다. 실제 사용량에 따라 요금이 청구되며, 이 사용량도 Settings > Usage에서 확인할 수 있습니다.
5시간 한도와 주간 한도는 이렇게 적용됩니다.
Anthropic 도움말 센터는 이를 한 문장으로 설명합니다. “유료 요금제에는 두 종류의 사용량 한도가 있습니다. 5시간마다 초기화되는 세션 한도와 매주 한 번 초기화되는 주간 한도입니다.”
- claude.ai의 채팅, Claude Code 세션, Claude 데스크톱 앱의 사용량은 모두 같은 한도에 합산됩니다. 코딩 세션을 오래 사용하면 채팅에 쓸 수 있는 양이 줄고, 반대도 마찬가지입니다.
- Settings > Usage에는 모든 모델의 주간 사용량 막대가 표시됩니다. 요금제에 Fable이 포함되어 있으면 Fable용 막대도 표시됩니다.
- Anthropic에 따르면 Max 요금제의 주간 한도는 계정마다 지정된 고정 시각에 매주 초기화됩니다.
- 어느 한도든 가까워지면 Claude Code가 경고 메시지를 표시합니다.
Anthropic이 표시하는 초기화 시각을 확인하세요. Settings > Usage에는 현재 세션의 남은 시간이 표시됩니다. Claude Code가 한도에 도달해 멈추면 메시지에 초기화 시각이 나옵니다. 예를 들면 다음과 같습니다.
You've hit your session limit · resets 3:45pm
Claude Code 상태 줄에 사용량을 표시하세요.
상태 줄은 Claude Code 하단에 있는 막대입니다. 사용자가 지정한 짧은 명령을 실행하고 그 명령의 출력 내용을 보여 줍니다. Claude Code는 rate_limits라는 필드로 5시간 및 7일 사용량을 이 명령에 전달합니다. 덕분에 작업 중에도 상태 줄에서 사용량을 볼 수 있습니다. 명령은 사용자의 Mac에서 실행되며 API 토큰을 사용하지 않습니다.
시작하기 전에 세 가지를 확인하세요.
- claude.ai의 Pro 또는 Max 구독으로 로그인해야 합니다. Anthropic 문서는 이 필드가 제공되는 요금제로 Pro와 Max만 명시합니다. API 키로 로그인하면 이 필드를 받지 못합니다.
- 이 필드는 세션에서 Claude가 처음 응답한 뒤에만 전달됩니다. 그전까지 상태 줄에는
5h: -% · 7d: -%가 표시됩니다. 한도가 초기화되면 해당 수치도 사라지고, 다음 응답까지-%로 표시됩니다. - 이 명령은 JSON을 읽는 작은 도구인
jq를 사용합니다. Terminal에서jq --version을 입력하세요. 도구를 찾을 수 없다고 나오면 먼저 설치하세요.
홈 폴더의 설정 파일인 ~/.claude/settings.json에 아래 statusLine 키를 추가하세요. 파일 전체를 덮어쓰지 말고 기존 최상위 객체 안에 추가하세요. statusLine 키는 하나만 있어야 합니다. 파일은 엄격한 JSON 형식을 유지해야 합니다. 주석이나 마지막 항목 뒤의 쉼표를 넣지 마세요.
{ "statusLine": { "type": "command", "command": "jq -r '\"5h: \\(.rate_limits.five_hour.used_percentage // \"-\")% · 7d: \\(.rate_limits.seven_day.used_percentage // \"-\")%\"'" } }
상태 줄에 표시되는 값은 남은 비율이 아니라 이미 사용한 비율입니다. 5h: 42.5% · 7d: 10%라면 5시간 세션 한도의 57.5%, 주간 한도의 90%를 더 사용할 수 있다는 뜻입니다. 각 상태 줄은 하나의 세션에 속하며 그 세션의 터미널에만 표시됩니다.
파일을 직접 수정하고 싶지 않다면 Claude Code에서 /statusline 뒤에 원하는 내용을 설명해 입력하세요. Claude Code가 대신 설정해 줍니다.
한도에 도달하면 이렇게 됩니다.
세션을 열어 두면 현재 버전의 Claude Code는 작업을 스스로 재개할 수 있습니다. Anthropic은 Claude Code가 “열린 세션에서 기다리다가 한도가 초기화되면 스스로 작업을 계속한다”고 설명합니다. claude.ai 구독으로 로그인한 대화형 세션에서는 autoContinueAtUsageLimit 설정을 통해 이 기능이 기본으로 켜져 있습니다. 주간 한도처럼 초기화까지 하루 넘게 남은 경우에는 자동으로 대기를 시작하지 않습니다. 이때는 /rate-limit-options에서 기다리도록 선택할 수 있습니다.
기다릴 수 없다면 Pro와 Max 요금제에서는 Settings > Usage에서 사용량 크레딧을 켤 수 있습니다. 한도를 넘어서도 계속 작업하고, 추가 사용량만큼 요금을 내는 방식입니다. Pro와 Max에서 Claude Code에 /usage-credits를 입력하면 claude.ai의 해당 페이지가 열립니다.
한 도움말 문서에서는 /status를 안내합니다.
Pro 또는 Max 요금제로 Claude Code를 사용하는 방법을 설명하는 Anthropic 도움말 문서에는 “/status 명령으로 남은 할당량을 확인하세요”라고 되어 있습니다. 현재 Claude Code 문서는 /status를 다르게 설명합니다. 버전, 모델, 계정, 연결 상태를 보여 주는 Status 탭을 여는 명령이며, 요금제 한도는 /usage에 있다고 안내합니다.
두 출처의 설명이 서로 다릅니다. /status에 한도가 표시되지 않으면 /usage를 사용하세요.
별도 설정 없이 확인하는 방법도 있습니다.
Cowork Island는 macOS 14 이상용 앱으로, 지원되는 도구의 AI 에이전트 세션을 노치 패널에 모아 두고 각 세션의 상태를 보여 줍니다. 세션이 언제 ‘확인 필요’ 상태가 되는지 알 수 있습니다. 기본적으로 이 상태가 되면 아일랜드가 자동으로 펼쳐집니다. 단, 해당 세션의 터미널이나 앱이 이미 맨 앞에 있으면 펼쳐지지 않습니다.
같은 패널에서 사용 중인 Claude와 Codex 요금제의 사용량 미터도 볼 수 있습니다. 앱 자체의 한도가 아니라 Anthropic과 OpenAI가 정한 5시간 한도와 주간 한도를 보여 줍니다. 수치는 Mac에 있는 파일에서 읽으며, API를 호출하거나 인증 정보를 읽지 않습니다. Claude의 경우 앱을 처음 열 때 안내되는 선택 항목인 ‘Claude Code 상태 줄에서 사용량 읽기’를 켜세요. Claude Code 상태 줄에 명령을 추가하고 기존 상태 줄도 함께 실행하므로, 위에서 설정한 상태 줄을 그대로 유지할 수 있습니다. Claude Code는 Pro와 Max 요금제에서 세션이 실행되는 동안에만 이 수치를 보냅니다. Codex 한도는 Mac에 있는 Codex 자체 세션 파일에서 읽으므로 따로 켤 항목이 없습니다.
무료 요금제는 패널 상단에 한 줄 사용량 요약을 표시하고, 세션 카드를 한 번에 하나씩 보여 줍니다. Pro는 초기화 시각을 포함한 계정별 상세 사용량 미터를 추가하고, 모든 세션을 보여 주며, 해당 세션으로 돌아갈 수 있게 해 줍니다. 결제 정보 없이 Pro 7일 체험이 자동으로 시작되며, Mac마다 한 번만 제공됩니다. 요금제를 확인하거나 Cowork Island 설치 및 설정 방법을 읽어 보세요.
무료 다운로드출처를 확인하세요.
- Claude Code 문서: 명령
- Claude Code 문서: 비용 및 사용량 관리
- Claude Code 문서: 상태 줄
- Claude Code 문서: 설정
- Claude Code 문서: 설정 참조
- Claude Code 문서: 대화형 모드
- Claude Code 문서: 오류
- Claude Code 문서: 데스크톱 앱
- Claude Code 문서: 에이전트 병렬 실행
- Claude 데스크톱 앱 변경 기록
- Claude 도움말 센터: 사용량 한도와 길이 제한은 어떻게 적용되나요?
- Claude 도움말 센터: 사용량 한도를 효율적으로 활용하는 방법
- Claude 도움말 센터: Pro 또는 Max 요금제로 Claude Code 사용하기
- Claude 도움말 센터: Max 요금제란 무엇인가요?
- Claude 도움말 센터: Claude 유료 요금제의 사용량 크레딧 관리
출처 확인일: 2026년 10월 18일. 이 가이드는 Cowork Island를 만든 사람이 작성했습니다. 수정할 내용이 있으면 support@coworkisland.com으로 메일을 보내거나 GitHub에 이슈를 등록하세요.