클로드 사용량 확인: 세션·주간 한도, 클로드 코드 /usage, 토큰 사용량 보는 법
클로드(Claude) 사용량은 claude.ai Settings > Usage에서, 클로드 코드는 /usage로, API 토큰 사용량은 Console Usage·Cost에서 봅니다. 세션·주간 한도 읽는 법과 한도에 걸렸을 때 할 일, 토큰을 덜 쓰는 습관을 실제 화면으로 정리했습니다.

클로드(Claude) 사용량은 claude.ai의 Settings > Usage 화면에서 확인합니다. 클로드 코드(Claude Code)에서는 터미널에 /usage를 치면 같은 한도 막대와 이번 세션의 토큰 수가 나와요. API로 쓰고 있다면 토큰 사용량은 Claude Console의 Usage·Cost 화면과 응답마다 오는 usage 필드에서 봅니다.
"방금까지 잘 되던 클로드가 갑자기 멈췄다", "이번 주에 얼마나 남았지?" 같은 상황에서 어디를 열고 무엇을 읽으면 되는지 정리했습니다. 요금제별 가격과 한도 비교는 클로드 가격·요금제 비교에 있으니, 이 글은 확인하는 곳과 한도에 걸렸을 때 할 일만 다룹니다. 내용은 2026년 11월 21일에 Claude 도움말과 Claude Code·Claude Platform 공식 문서로 확인했어요.
사용량을 확인하는 곳 한눈에 보기
| 쓰는 방식 | 확인하는 곳 | 보이는 것 |
|---|---|---|
| claude.ai 앱(웹·데스크톱) | Settings > Usage | 세션 한도, 주간 한도, 리셋 시각, 추가 사용량 |
| 클로드 코드 | /usage (/cost·/stats도 같은 화면) | 한도 막대, 이번 세션 토큰, 무엇이 많이 썼는지 |
| 클로드 코드 | /context, 상태줄 | 지금 대화가 차지하는 분량, 한도 % |
| API | Console Usage·Cost, 응답의 usage | 모델·날짜별 토큰과 비용, 요청마다 토큰 수 |
구독(Pro·Max·Ultra·Team·Enterprise)으로 쓰는 사람은 앱과 클로드 코드가 같은 한도를 나눠 씁니다. 도움말에 따르면 claude.ai, 클로드 코드, 클로드 데스크톱에서 쓴 양이 모두 같은 사용량 한도에서 빠져요. API는 구독과 결제가 따로라서 Console에서 따로 봅니다.
세션 한도와 주간 한도부터 알아 두기
메시지 하나를 보내면 세션 한도와 주간 한도가 같이 찹니다.
유료 플랜의 사용량 한도는 두 가지입니다.
- 세션 한도: 5시간 단위입니다. 첫 메시지를 보낸 때부터 5시간이 지나면 전부 다시 채워져요. 인증된 Ultra 계정에는 5시간 한도가 없습니다.
- 주간 한도: 모든 모델에 걸리는 한도입니다. 계정마다 정해진 요일·시각에 한 번 리셋되고, 언제 가입했는지와 상관없이 그 시각이 고정돼요. Max·Ultra에는 Fable 모델만 따로 세는 주간 한도가 하나 더 있습니다.
두 한도는 동시에 줄어듭니다. 클로드 코드 오류 문서에서는 큰 작업을 한꺼번에 돌리면 세션 창이 리셋되기 전에 주간 한도를 다 쓸 수도 있다고 해요. 세션 막대와 주간 막대를 같이 보세요.
얼마나 빨리 줄어드는지는 메시지 길이, 첨부 파일 크기, 대화 길이, 웹 검색 같은 도구, 모델, effort 단계에 따라 달라집니다(도움말). 같은 질문이라도 긴 대화 끝에서 보내면 더 많이 씁니다.
claude.ai 앱에서 확인하기
claude.ai에서 왼쪽 아래 계정 메뉴의 Settings를 열고 Usage를 누르면 됩니다. 주소창에 claude.ai/settings/usage를 넣어도 같은 화면이 열려요.
2026년 11월 21일 화면 기준, Team 플랜 계정의 예시 화면입니다.
화면은 위에서부터 이렇게 읽습니다.
- Current session: 5시간 세션 한도를 몇 % 썼는지와 리셋 시각입니다. 막대가 100%면 그 시각까지 새 메시지가 막혀요.
- Weekly limits: All models 막대가 주간 한도입니다. Fable 한도가 있는 플랜이면 막대가 하나 더 보여요.
- Usage credits(추가 사용량): 개인 유료 플랜에서는 이 칸에서 켜고 끄고, 잔액과 이번 달 지출을 봅니다. 위 화면은 결제 권한이 없는 Team 멤버 계정이라 이 칸이 보이지 않아요.
도움말에 없는 Limit resets 칸도 화면에 있었습니다. "지금은 리셋이 없고, 생기면 만료일과 함께 여기 표시된다"는 안내만 있어서 어떤 경우에 생기는지는 공식 문서로 확인하지 못했어요.
클로드 코드에서 확인하기: /usage
클로드 코드에서는 입력창에 /usage를 칩니다. /cost와 /stats도 같은 화면을 여는 별칭이고, Claude가 답하는 중에도 바로 열려요(명령어 문서).
2026년 11월 21일, Ultra 플랜 데모 계정으로 찍은 /usage 화면입니다.
이 화면에서 볼 곳은 네 군데예요.
-
한도 막대: 앱의 Usage 화면과 같은 세션·주간 한도와 리셋 시각입니다. 위 예시(Ultra 데모 계정)에는 5시간 세션 막대 없이 주간 막대 두 개만 나왔어요. 도움말에는 인증된 Ultra 계정에 5시간 한도가 없다고 나와요.
-
What's contributing to your usage?: 최근 사용량 가운데 스킬, 서브에이전트, 플러그인, MCP 서버가 차지한 몫과 고칠 점을 보여 줍니다.
d·w키로 지난 24시간과 7일을 바꿔 봐요. 이 컴퓨터의 세션만 센 대략값이라 claude.ai나 다른 기기에서 쓴 양은 빠집니다. -
Usage credits: 추가 사용량이 켜져 있는지, 이번 달 얼마나 썼는지입니다.
-
Session: 지금 세션의 입력·출력·캐시 토큰 수와 금액입니다. 비용 문서에 따르면 이 금액은 정가로 계산한 추정치라 구독자 청구액과는 관계가 없어요.
/clear로 새 세션을 시작하면 0부터 다시 셉니다.
문서 예시에는 금액 줄이 Total cost로 나오지만 실제 화면(v2.1.330)에서는 Estimated cost로 보였습니다.
추천 줄 옆에 f to fix 안내가 보이면 f를 눌러 클로드 코드가 고칠 수 있는 것부터 바꾸게 할 수 있어요(v2.1.305 이상). 바꾸기 전에 무엇을 바꿀지 먼저 보여 줍니다.
/context와 상태줄
/usage로 이번 주에 얼마나 썼는지 본다면, /context로는 지금 이 대화가 얼마나 찼는지 봅니다. 대화 분량(컨텍스트)을 색깔 칸으로 보여 주고, 무엇이 자리를 많이 차지하는지 알려 줘요. 대화가 길수록 메시지 하나에 드는 사용량도 커지니 /context가 많이 찼으면 정리할 때입니다.
한도를 계속 보고 싶으면 상태줄(statusline)에 넣을 수 있어요. 상태줄 문서에 따르면 Pro·Max·Ultra 구독자는 스크립트에서 rate_limits.five_hour.used_percentage(5시간)와 rate_limits.seven_day.used_percentage(7일) 값을 받아 쓸 수 있고, resets_at으로 리셋 시각도 받아요. 세션에서 첫 응답이 온 뒤부터 값이 들어옵니다. 상태줄을 직접 짜기 어렵다면 클로드 코드에 "상태줄에 5시간·7일 사용량 %를 보여 줘"라고 부탁하면 돼요.
Claude가 일하는 동안 스피너 옆에 뜨는 ↓ 5.5k tokens 같은 숫자는 이번 턴에 나온 출력 토큰만 센 값입니다. 보낸 대화 분량은 들어가지 않아서 /usage의 세션 합계와 맞지 않아요.
API 토큰 사용량 확인하기
API 키로 쓰는 경우에는 Claude Console에서 봅니다. 이 계정에는 Console 로그인이 없어서 화면 대신 공식 문서 기준으로 적었어요.
- Usage 화면 (
platform.claude.com/usage): 모델·날짜별 토큰 사용량 - Cost 화면 (
platform.claude.com/cost): 비용 - Rate limits 화면 (
platform.claude.com/usage/limits): 내 조직의 등급과 분당 한도
코드에서 바로 보려면 응답마다 오는 usage 객체를 읽습니다. input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens가 들어 있고, API 문서에 따르면 이번 요청의 입력 토큰 합계는 앞의 세 입력 값을 더한 수예요. 보내기 전에 토큰 수를 알고 싶으면 토큰 세기 기능(count_tokens)을 씁니다.
조직 전체를 정기적으로 집계하려면 Admin API의 사용량·비용 리포트를 씁니다. 개인 Console 계정은 먼저 조직을 만들어야 해요. 충전, 자동 충전, 지출 한도 설정은 클로드 API 가격과 결제에 정리했고, Max·Ultra에 딸린 월 API 크레딧은 클로드 맥스 API 크레딧에 있어요. 그 크레딧은 앱·클로드 코드의 추가 사용량에는 쓰이지 않습니다.
한도에 걸렸을 때 할 일
클로드 코드에서는 이런 문구가 뜹니다.
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
-
리셋까지 기다리기: 문구에 리셋 시각이 나옵니다. 클로드 코드(v2.1.234 이상)는 구독으로 로그인한 세션이면 창을 열어 둔 채 기다렸다가 리셋 뒤 하던 작업을 알아서 이어 가요. 화면 아래에
Continuing automatically at 3:45pm · Esc to cancel같은 줄이 보이고,Esc로 취소합니다. -
모델 바꾸기: 세션·주간 한도는 모든 모델이 함께 쓰는 한도라 모델을 바꿔도 풀리지 않습니다.
You've hit your Opus limit처럼 모델 이름이 붙은 한도일 때만/model로 다른 계열 모델로 바꾸면 계속 쓸 수 있어요. -
추가 사용량(usage credits) 쓰기: Pro·Max·Ultra는 Settings > Usage의 Usage credits를 켜고 크레딧을 사 두면 한도를 넘어도 API 정가로 계속 씁니다. 클로드 코드에서는
/usage-credits(예전 이름/extra-usage)가 그 설정 화면을 열어요. Team·Enterprise 멤버 가운데 결제 권한이 없으면 관리자에게 요청이 갑니다. -
플랜 올리기: 올린 플랜의 한도가 바로 적용됩니다. 플랜별 차이는 요금제 비교 글에서 보세요.
추가 사용량은 구독료와 따로 청구되고 환불되지 않습니다. 켤 때 월 지출 한도(Adjust limit)부터 정해 두세요. 도움말에 따르면 2026년 12월 7일 이후에 산 크레딧은 보통 구매일부터 12개월 뒤 만료돼요. /rate-limit-options를 치면 기다리기, 크레딧 추가, 플랜 올리기 중에서 골라 실행할 수 있습니다.
한도에 거의 다 왔을 때는 클로드 코드가 You've used 85% of your session limit · resets 3:45pm 같은 경고를 먼저 보여 줍니다. 이 줄이 보이면 긴 작업을 새로 시작하기 전에 /usage로 주간 막대도 확인하세요.
참고로 /usage에 rate limited until 3:14am이 뜨는 건 사용량 정보를 다시 불러오지 못한다는 뜻이지 클로드를 못 쓴다는 뜻이 아닙니다. 그 시각이 지나고 r을 누르면 새로 불러와요.
토큰을 덜 쓰는 습관 체크리스트
한도에 자주 걸린다면 아래부터 봅니다. 클로드 코드 쪽 방법은 클로드 코드 비용 줄이는 7가지에 더 자세히 있어요.
-
주제가 바뀌면 새 대화를 엽니다. 클로드 코드에서는
/clear입니다. 긴 대화는 메시지마다 앞 내용을 다시 읽어서 한 줄 질문에도 사용량이 커요. -
여러 질문은 한 메시지에 묶고, 필요한 배경을 처음에 다 적습니다. 주고받는 횟수가 줄어요.
-
단순한 일에는 effort를 낮추거나 Sonnet·Haiku를 씁니다. Opus 5.5·Sonnet 5.5처럼 생각을 끌 수 없는 모델은 effort 단계로 조절해요.
-
안 쓰는 커넥터·MCP 서버와 웹 검색은 끕니다. 도구는 토큰을 많이 써요.
-
자주 보는 문서는 매번 올리지 말고 프로젝트에 넣어 둡니다. 캐시된 내용은 한도에서 덜 빠져요.
-
클로드 코드의 CLAUDE.md는 짧게 두고, 특정 작업 지시는 스킬로 옮깁니다. 스킬 만드는 법에 예시가 있어요.
-
오래 켜 둔 세션의 예약 작업(
/loop)과 서브에이전트가 쉬는 동안에도 쓰고 있지 않은지/usage의 분석 칸에서 봅니다.
대화가 길어져 답이 흐려질 때 정리하는 방법은 AI 코딩 대화가 길어질 때에 따로 적었습니다. 코덱스(Codex)를 같이 쓴다면 코덱스 사용량 확인과 초기화도 함께 보세요.
자주 묻는 질문
앱에서 쓴 양과 클로드 코드에서 쓴 양은 따로인가요?
같은 한도입니다. 구독 계정으로 로그인했다면 claude.ai, 데스크톱 앱, 클로드 코드 사용량이 모두 같은 세션·주간 한도에서 빠져요. API 키로 쓰는 클로드 코드는 구독 한도가 아니라 Console 쪽에서 과금됩니다.
주간 한도는 언제 리셋되나요?
계정마다 정해진 요일과 시각에 리셋되고, 그 시각은 바뀌지 않습니다. 정확한 시각은 Settings > Usage나 /usage의 "Resets" 줄에서 봅니다.
/usage의 금액만큼 돈이 나가나요?
구독자에게는 아닙니다. 세션 금액은 토큰 수를 정가로 환산한 추정치예요. 실제 청구는 구독료와, 켰다면 추가 사용량 지출입니다.
출처와 확인 (2026-11-21)
- How do usage and length limits work? (Claude 도움말)
- Usage limit best practices (Claude 도움말, Settings > Usage 항목 설명)
- Manage usage credits for paid Claude plans (추가 사용량 켜기·만료·환불)
- Manage costs effectively (
/usage화면 설명, 토큰 줄이기) - Commands (
/usage·/cost·/stats·/context·/usage-credits·/rate-limit-options) - Errors (한도 오류 문구와 대처)
- Interactive mode (리셋 뒤 자동으로 이어 가기)
- Customize your status line (
rate_limits필드) - Usage and Cost API, Rate limits, Token counting (Claude Platform 문서)
- 화면: claude.ai Settings > Usage, 클로드 코드 v2.1.330
/usage(2026년 11월 21일 확인)



