Claude Code 토큰 사용량 확인·감사: /usage와 5시간·주간 한도 계획

Claude Code에서 남은 사용량을 보려면 /usage를 실행합니다. Pro, Max, Team, Enterprise 요금제라면 이 화면에 요금제 사용량 한도 막대와 초기화 시각, 현재 세션의 토큰 사용량, 최근 사용량이 어디에 쓰였는지 나눈 내역이 함께 나옵니다. /cost와 /stats는 /usage의 별칭입니다. /status는 버전, 모델, 계정, 연결 상태를 보여 주는 화면이라 남은 양을 확인하는 곳이 아닙니다.

Pro와 Max의 한도는 두 겹입니다. 세션 한도는 5시간마다 초기화되고, 주간 한도는 모든 모델에 공통으로 적용되며 계정마다 정해진 요일과 시각에 초기화됩니다. 한 번의 사용이 두 한도에 동시에 계산되므로, 대규모 병렬 작업 한 번이 5시간 창이 끝나기 전에 주간 한도를 바닥낼 수도 있습니다. 막대가 예상보다 빨리 줄면 절약 팁부터 적용하지 말고, 결제 경로·컨텍스트·캐시·MCP·서브에이전트 중 어디서 늘었는지 먼저 가려내세요.

아래 명령어와 동작은 2026년 10월 5일 기준 Claude Code 비용 관리 문서와 Claude 도움말 센터를 따릅니다. 화면 구성은 버전마다 달라지므로 내 화면이 다르면 claude --version으로 설치된 버전부터 확인하세요.

Claude Code 사용량 확인 명령어: 질문마다 보는 화면이 다릅니다

남은 양, 이번 세션의 소비량, 실제 청구액, 지금 쓰는 계정은 각각 다른 화면이 답합니다. 한 화면의 숫자로 다른 질문에 답하려 할 때 혼란이 생깁니다.

Session 블록은 현재 세션의 토큰을 모델별 input, output, cache read, cache write로 나누고, 정가로 로컬에서 계산한 달러 금액을 붙여 보여 줍니다. Pro와 Max는 사용량이 구독에 포함되어 있어 이 금액이 청구와 관계없고, API 키 사용자에게도 추정치일 뿐입니다. v2.1.211부터는 /clear로 새 세션을 시작하면 이 합계도 0부터 다시 셉니다.

Claude 도움말 센터의 Pro·Max용 Claude Code 안내에는 아직 /status로 남은 할당량을 보라는 문장이 남아 있습니다. 그러나 Claude Code 명령어 문서에서 /status는 Settings의 Status 탭을 열어 버전, 모델, 계정, 연결 상태를 보여 줍니다. 남은 양은 /usage로, 지금 구독으로 쓰는지 API 키로 쓰는지는 /status로 나눠 확인하면 됩니다. 두 명령어 모두 Claude가 응답하는 도중에도 바로 실행됩니다.

Claude Code 하루 사용량은 /usage의 24시간 보기로 봅니다

공식 한도에 '하루 한도'라는 단위는 없습니다. 하루 단위로 보고 싶다면 /usage 내역에서 d를 눌러 최근 24시간 보기로 바꾸고, w를 누르면 최근 7일 보기로 바뀝니다. 이 내역은 최근 사용량을 스킬, 서브에이전트, 플러그인, 개별 MCP 서버별 비중으로 나누고, 긴 컨텍스트나 캐시 미스처럼 최근 사용량의 10% 이상을 차지한 행동을 따로 표시합니다. v2.1.242부터는 /loop나 예약 작업 중 무거운 것이 Loops 행으로 나옵니다.

이 내역은 이 기기의 로컬 세션 기록으로 계산한 근사치라서 다른 컴퓨터나 claude.ai에서 쓴 양은 빠집니다. 한도 막대는 계정 한도 정보를 따로 받아 오므로, 막대는 크게 줄었는데 내역 합계가 작다면 다른 기기나 웹에서 쓴 사용량부터 의심하세요. 한도 정보 요청이 실패하면 /usage는 최근 60분 안에 받아 둔 막대를 Showing last-known usage 표시와 함께 보여 주고, r로 다시 시도할 수 있습니다.

VS Code 확장에서는 Account & usage 대화 상자에 같은 비중과 행동 표시가 Day·Week 전환과 함께 나옵니다. Loops 행은 빠집니다. ccusage나 claude-monitor 같은 도구는 Anthropic이 제공하는 것이 아니므로, 한도 판단의 기준은 /usage 막대와 상태 표시줄 값으로 두세요.

상태 표시줄에 5시간·주간 사용률 띄우기

매번 /usage를 열지 않고 상태 표시줄에 두 창의 사용률을 계속 띄울 수 있습니다. 가장 쉬운 방법은 /statusline 5시간과 7일 사용률을 보여 줘처럼 원하는 내용을 말로 지시하는 것입니다. Claude Code가 ~/.claude/ 아래에 스크립트를 만들고 설정을 갱신합니다.

직접 만들려면 아래 스크립트를 ~/.claude/statusline.sh로 저장하고 chmod +x로 실행 권한을 줍니다. jq가 설치되어 있어야 합니다.

#!/bin/bash
input=$(cat)
# rate_limits가 없으면 "// empty"가 빈 문자열을 돌려줍니다
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
CTX=$(echo "$input" | jq -r '.context_window.used_percentage // empty')

OUT=""
[ -n "$FIVE_H" ] && OUT="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && OUT="${OUT:+$OUT }7d: $(printf '%.0f' "$WEEK")%"
[ -n "$CTX" ] && OUT="${OUT:+$OUT }ctx: $(printf '%.0f' "$CTX")%"
echo "$OUT"

~/.claude/settings.json에는 다음 항목을 추가합니다.

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

세 값이 모두 들어오면 5h: 23% 7d: 41% ctx: 37%처럼 표시됩니다. rate_limits는 claude.ai Pro·Max 구독자에게만, 그리고 세션의 첫 응답이 온 뒤에만 들어오며, 두 창 중 하나만 빠질 수도 있어 // empty로 없는 값을 건너뜁니다. 같은 객체의 resets_at은 초기화 시각을 Unix epoch 초로 담고 있습니다. ctx는 현재 컨텍스트 창 사용률로, 요금제 한도와는 다른 숫자입니다. Desktop 앱에서는 모델 선택기 옆 사용량 링을 누르면 세션별 컨텍스트 사용량과 Claude Code 전체에서 공유하는 요금제 사용량을 볼 수 있습니다.

5시간 세션 한도와 주간 한도는 동시에 줄어듭니다

Pro와 Max의 세션 한도는 5시간마다 초기화됩니다. 주간 한도는 모든 모델에 공통이고, 계정에 배정된 고정 요일·시각에 초기화됩니다. 언제 Claude를 쓰기 시작했는지, 구독을 언제 시작했는지와 관계없이 이 시각은 바뀌지 않으며, 다음 초기화 시각은 claude.ai Settings > Usage에서 볼 수 있습니다(Pro 요금제 안내, Max 요금제 안내). Max 5x와 Max 20x는 Pro 세션당 사용량의 5배와 20배입니다. 몇 시간, 몇 개 메시지라는 절대치는 공개되어 있지 않고, Anthropic은 용량 관리를 위해 주간·월간 상한이나 모델·기능별 제한을 추가로 걸 수 있다고 밝힙니다.

5시간 창이 첫 메시지를 보낸 시점부터 시작하는지는 공식 문서에 적혀 있지 않습니다. 계획은 추측 대신 /usage와 상태 표시줄에 표시되는 실제 초기화 시각으로 세우세요.

이 한도는 claude.ai, Claude Code, Claude Desktop, IDE 확장이 함께 씁니다. 낮에 웹에서 긴 대화를 했다면 저녁 Claude Code 세션은 이미 줄어든 막대에서 시작합니다. 소모량은 대화 길이와 복잡도, 사용하는 기능, 모델, effort 수준에 따라 달라집니다.

가장 놓치기 쉬운 점은 한 번의 사용이 세션 한도와 주간 한도에 동시에 계산된다는 사실입니다. 5시간 창은 초기화될 때마다 다시 채워지지만 주간 막대는 그동안 쓴 양을 계속 쌓아 갑니다. Claude Code 오류 문서는 대규모 워크플로 팬아웃처럼 짧은 시간에 몰아 쓴 작업이 5시간 창이 초기화되기 전에 주간 한도를 소진할 수 있다고 설명합니다. 5시간 막대만 보고 병렬 작업을 늘리면 주 중반에 며칠을 기다려야 하는 상황이 생기는 이유입니다.

한도가 거의 찼을 때는 You've used 85% of your session limit · resets 3:45pm 같은 경고가 먼저 뜰 수 있습니다. 표시되는 시각은 예시입니다.

숫자가 이상하면 결제 경로부터 확인하세요

막대가 비정상적으로 빨리 줄거나 예상하지 못한 청구가 생기면 토큰을 세기 전에 어떤 계정으로 쓰고 있는지부터 확인합니다. 환경에 ANTHROPIC_API_KEY가 설정되어 있으면 Claude Code는 구독 대신 이 API 키로 인증하고, 사용량은 구독에 포함된 몫이 아니라 API 요금으로 청구됩니다(도움말 센터). API 키, Bedrock, Vertex, Microsoft Foundry 경로는 토큰당 과금이라 멈추는 지점이 따로 없고, 쓴 만큼 해당 계정에 청구됩니다.

/status에서 계정을 확인하고, 셸의 환경 변수, ANTHROPIC_BASE_URL 같은 게이트웨이 설정, 클라우드 공급자 설정을 함께 봅니다. 경로가 불분명한 상태에서 계산한 비용은 엉뚱한 계량기를 읽은 결과일 수 있습니다. 경로별 판단은 Claude Code API 키와 구독 결제 가이드에 정리되어 있습니다.

경로가 맞는데도 사용량이 많다면, 그것이 정상적인 사용인지 보고할 이상인지는 아래 순서로 가릴 수 있습니다.

세션이 살아 있을 때 감사 원장을 만드세요

문제가 된 세션을 닫거나 /clear하기 전에 기록부터 남깁니다. /clear로 새 세션을 시작하면 Session 블록과 캐시 통계가 0부터 다시 집계되기 때문입니다. 한 표에 다음을 적으세요.

• 시간과 시간대, claude --version, 모델, effort, 인증 경로, 작업 디렉터리, session ID
• /usage의 Session 블록 토큰 구성, 5시간·주간 막대 값, 내역의 비중과 행동 표시, Loops 행
• /context의 큰 항목, /mcp의 활성 서버
• 정확한 한도 메시지나 오류 문구
• 그 사이 있었던 모델 변경, MCP 연결, /compact, 오래된 세션 재개, 긴 공백

v2.1.251부터 Session 블록에는 Prompt cache (main) 줄이 붙습니다. 요청 수, 캐시에서 읽은 입력 비율, 캐시 미스 횟수와 마지막 미스 시각, 다시 캐시에 쓴 토큰 수, 압축 등으로 생긴 예상된 재생성, 캐시가 아직 살아 있는지와 TTL이 한 줄에 나옵니다. 주 대화만 집계하고 서브에이전트는 포함하지 않습니다.

API 키, 개인 대화 전문, 고객 코드 전체는 기록에 넣지 않습니다. 지원 문의에 필요한 것은 같은 조건에서 다시 확인할 수 있는 숫자와 문구입니다.

컨텍스트 증가와 캐시 재생성을 따로 보세요

긴 세션의 사용량은 대부분 두 가지 중 하나로 설명됩니다. 대화가 커진 것인지, 캐시가 다시 만들어진 것인지입니다. 원인이 다르면 처방도 다릅니다.

Claude Code는 요청할 때마다 대화 전체를 보내고, 도구를 쓸 때마다 그 결과를 담은 요청을 한 번 더 보냅니다. 프롬프트 캐싱 덕분에 이전 기록은 캐시 요율로 다시 읽히지만 그래도 사용량에 포함됩니다. 하루 종일 열어 둔 세션에서 한 줄짜리 질문을 해도 대화 전체만큼 사용량이 나가는 이유입니다. /context에서 CLAUDE.md, 메모리, MCP 도구 이름, 읽어 둔 파일, 이전 작업 기록 중 무엇이 큰지 확인하세요. 관련 없는 이전 작업이 대부분이라면 목적이 분명한 새 세션이 가장 깨끗한 해결책입니다.

캐시 쪽은 캐시 쓰기와 읽기를 비교합니다. /usage의 cache write와 cache read, 상태 표시줄 JSON의 cache_creation_input_tokens와 cache_read_input_tokens가 같은 구분입니다. read는 이미 만든 앞부분을 재사용한 양이고, write는 새로 쓰거나 다시 만든 양입니다. 다음 경우의 재생성은 원인이 설명되는 정상 동작입니다.

• 캐시 수명보다 긴 휴식 뒤 첫 메시지: 구독은 1시간, 사용 크레딧을 쓰는 동안과 API 키·클라우드 경로의 기본값은 5분입니다.
• 모델 전환: 모델마다 캐시가 따로라서 바꾼 직후 요청은 대화 전체를 캐시 없이 다시 읽습니다.
• effort 변경: 대부분의 모델은 effort 수준마다 캐시가 따로입니다. API 키나 Claude 구독으로 쓰는 Opus 5.5, Sonnet 5.5, Fable 5.1은 effort를 바꿔도 캐시가 유지되지만, Bedrock, Google Cloud Agent Platform, Claude apps 게이트웨이에서는 그렇지 않습니다.
• 처음부터 로드되는 도구 정의가 바뀐 경우, /compact나 오래된 도구 결과 정리 뒤의 재작성

모델과 effort는 세션을 시작할 때 정하고, /compact는 작업의 자연스러운 경계에서 쓰면 이런 재생성을 줄일 수 있습니다. 같은 조건의 비슷한 요청에서 write가 높고 read가 낮은 상태가 반복될 때 조사할 가치가 생깁니다. v2.1.260부터는 Prompt cache (main) 줄이 마지막 미스의 원인을 likely cause: tool definitions changed처럼 추정해 보여 주기도 합니다. 자세한 분석은 Claude Code 캐시 미스 토큰 비용 가이드를 참고하세요.

아무것도 하지 않았는데 막대가 줄었다면 유휴 중에 돌아가는 요청을 의심합니다. 예약 작업은 세션이 쉬는 동안에도 주기마다 전체 컨텍스트를 보내고, 다른 세션에서 온 메시지와 목표(goal) 확인 요청도 새 턴을 시작합니다. /compact는 요약할 대화 전체를 읽으므로 그 자체가 큰 요청이고, 이어서 할 필요가 없을 때의 /clear는 비용이 들지 않습니다. 대화 요약 같은 백그라운드 작업도 소량을 쓰지만, 공식 문서 기준으로 보통 세션당 $0.04 미만입니다.

MCP 사용량은 도구 정의와 반환값을 따로 재세요

연결된 MCP 서버 수에 임의의 토큰 수를 곱해 비용을 추정하면 틀립니다. MCP 도구 정의는 도구 검색(tool search) 덕분에 기본적으로 지연 로딩되어, Claude가 특정 도구를 쓰기 전까지는 도구 이름과 서버 안내문만 컨텍스트에 들어갑니다. 다만 사용자 지정 ANTHROPIC_BASE_URL, ENABLE_TOOL_SEARCH=false, Google Cloud Agent Platform에서 Claude 4.5 이전 세대 모델을 쓰는 구성에서는 도구 검색을 쓸 수 없으니, 정의가 처음부터 들어와 있는지 /context로 확인하세요(MCP 문서).

첫째 층은 정의입니다. /mcp와 /context로 활성 서버와 도구가 컨텍스트에서 차지하는 양을 확인합니다. 둘째 층은 반환값입니다. 정의가 작아도 전체 로그나 큰 테이블을 돌려주는 도구는 대화 기록을 빠르게 키웁니다. Claude Code는 MCP 도구 결과 하나가 10,000토큰을 넘으면 경고하고, 기본 최대값은 25,000토큰이며 MAX_MCP_OUTPUT_TOKENS로 바꿀 수 있습니다. 상한을 올리기 전에 필터, 페이지 나누기, 요약을 먼저 적용하세요.

/usage 내역의 MCP 서버별 비중은 그 서버의 도구 결과를 실제로 담은 요청만 셉니다. v2.1.222 이전에는 서버를 한 번 호출하면 이후 요청이 모두 그 서버 몫으로 잡혀 비중이 과장되었으니, 오래된 버전의 숫자는 그대로 믿지 마세요. 서버를 고르고 압축하는 방법은 Claude Code MCP 컨텍스트 과부하 가이드에 있습니다.

깨끗한 대조 세션으로 재현되는지 확인하세요

원장만으로 원인이 갈리지 않으면 같은 작업을 깨끗한 조건에서 한 번 더 돌려 봅니다. 프로젝트, 버전, 인증 경로, 모델, effort는 그대로 두고, 새 세션을 열어 필요한 MCP만 남긴 뒤 시작 전 /usage와 /context를 저장합니다. 완료 조건이 분명한 작은 작업 하나를 수행하고 같은 항목을 다시 기록하세요.

대조 세션이 가볍다면 원래 세션은 오래된 기록, 큰 도구 결과, 섞인 작업, 서브에이전트나 에이전트 팀의 컨텍스트를 들고 있었을 가능성이 큽니다. 이 경우는 이상이 아니라 세션 관리 문제이므로 아래 절감책으로 해결됩니다.

대조 세션에서도 같은 증가가 재현되면 반복 실험으로 사용량을 더 태우지 마세요. 동일한 조건, 시각, 토큰 구성, MCP 상태, 정확한 메시지를 갖춘 재현 한 번이 좋은 지원 자료입니다. 계정별 청구 문의는 Claude Code 문서가 안내하는 대로 제품 안 메신저로 Anthropic 지원팀에 보냅니다.

원인별 Claude Code 사용량 절감책: 증거에 맞는 첫 조치

절감책은 원장에서 확인한 원인에 맞춰 고를 때 효과가 있습니다. 원인을 모른 채 모든 팁을 한꺼번에 적용하면 무엇이 효과가 있었는지 알 수 없습니다. 아래 조치는 Claude Code 비용 관리 문서와 도움말 센터의 모델·사용량 안내에 근거합니다.

몇 가지는 조건을 알아야 제대로 씁니다. 파일을 언급할 때 @ 접두사를 붙이면 파일 전체와 관련 CLAUDE.md가 컨텍스트에 들어가므로, 토큰을 아끼려면 경로만 적습니다. Opus 5.5, Sonnet 5.5, Fable 모델은 확장 사고를 끌 수 없으니 effort를 낮추는 쪽으로 조절합니다. 사고 토큰은 출력 토큰으로 계산됩니다. 서브에이전트에 장황한 작업을 맡기면 주 대화는 요약만 받아 가벼워지지만, 서브에이전트 자신의 요청은 여전히 사용량에 포함됩니다. 에이전트 팀은 팀원이 plan mode로 일할 때 일반 세션보다 약 7배 많은 토큰을 씁니다.

529 과부하는 Claude Code 529 과부하 오류 가이드에서, API 경로의 429는 Claude Rate Exceeded 오류 가이드에서 다룹니다. 둘 다 Pro·Max 사용량 막대와는 다른 문제입니다.

Claude Code 사용량 한도에 도달했을 때 생기는 일

한도에 걸리면 Claude Code는 메시지에 표시된 초기화 시각까지 요청을 막습니다. 메시지 종류에 따라 계속할 방법이 다릅니다.

모델 계열을 바꾸면 모델마다 캐시가 따로라서 바로 다음 요청은 대화 전체를 캐시 없이 다시 읽습니다. 계속 일할 수는 있지만 그 한 번은 비쌉니다.

자동 대기 후 이어서 실행

v2.1.234부터 claude.ai 구독으로 로그인한 대화형 세션에서는 작업 중 한도에 걸리면 Claude Code가 열린 세션에서 기다렸다가 초기화 뒤 작업을 이어 갑니다. 기본으로 켜져 있고, 대기 중에는 화면 아래에 Usage limit reached · limit resets 3:45pm과 Continuing automatically at 3:45pm · esc to cancel이 표시됩니다. 마지막 메시지를 다시 보내는 것이 아니라 Claude에게 멈춘 지점부터 이어 가라고 지시하는 방식입니다.

편리하지만, 자리를 비운 사이 새로 열린 5시간 창을 무인으로 쓰기 시작한다는 뜻이기도 합니다. 권한 확인이 필요한 단계에서는 평소처럼 멈추고, 다시 한도에 걸리면 연속 두 번까지만 대기를 재설정합니다. 초기화가 24시간 이상 남은 경우, 예를 들어 며칠 뒤에 초기화되는 주간 한도에서는 대기가 자동으로 시작되지 않습니다. 끄려면 /config에서 Continue automatically at usage limit를 끄거나 사용자 설정에 autoContinueAtUsageLimit: false를 넣습니다. /rate-limit-options를 실행하면 기다렸다 이어서 실행, 사용 크레딧 추가, 요금제 업그레이드 중에서 고를 수 있습니다. Desktop 앱의 세션 한도 카드에 있는 Auto-continue when limits reset 체크박스는 CLI 설정과 별개이므로 따로 꺼야 합니다. API 키나 클라우드 경로는 요청마다 과금되어 기다릴 초기화가 없으므로 이 기능이 없습니다.

사용 크레딧과 한도 초기화

사용 크레딧은 이전에 extra usage, 추가 사용이라고 불리던 기능으로, Pro와 Max에서 포함된 한도를 넘긴 뒤에도 API 표준 요금으로 계속 쓰게 해 줍니다. claude.ai Settings > Usage에서 켜고, 월 지출 한도를 정하거나 무제한으로 둘 수 있으며, 크레딧은 미리 충전합니다. Claude Code에서 /usage-credits를 실행하면 이 설정 화면이 열립니다. claude.ai 구독으로 로그인했을 때만 쓸 수 있고 API 키 인증에서는 쓸 수 없습니다. 크레딧을 쓰는 동안에도 세션 한도는 평소처럼 5시간마다 초기화됩니다(사용 크레딧 안내).

크레딧을 쓰는 동안에는 프롬프트 캐시 수명이 1시간에서 5분으로 줄어듭니다. 큰 세션에서 5분 넘게 쉬었다가 돌아오면 첫 메시지가 전체 컨텍스트를 다시 처리하고, 그 비용이 크레딧에서 나갑니다. 크레딧으로 이어 갈 계획이라면 세션을 작게 유지하는 편이 낫습니다. 비용 계산은 Claude 추가 사용 요금 가이드에서 볼 수 있습니다.

한도 초기화(limit reset)는 자격이 되는 요금제에 가끔 주어지는 혜택으로, 5시간 세션 한도나 주간 한도 중 하나를 즉시 가득 채웁니다. 주간 초기화 요일은 그대로이고, 한도에 걸리기 전에도 쓸 수 있으며, 쓰고 나면 되돌릴 수 없습니다. 웹이나 Claude Desktop의 Settings > Usage에서 Reset for free를 누르는데, 터미널이나 IDE의 Claude Code에서는 이 버튼을 쓸 수 없습니다(한도 초기화 안내). 세 가지의 차이는 Claude 클라우드 세션 크레딧·사용 크레딧·한도 초기화 차이에 정리되어 있습니다.

지금 떠 있는 오류를 바로 복구해야 한다면 Claude Code Rate Limit Reached 해결 가이드가 더 빠릅니다.

5시간·주간 한도에 맞춰 하루와 한 주의 작업을 배분하는 법

한도 계획의 기준은 5시간 막대가 아니라 주간 막대입니다. 5시간 창은 하루에도 여러 번 다시 채워지지만 주간 한도가 먼저 바닥나면 초기화까지 며칠을 기다려야 하기 때문입니다.

1. 주간 초기화 시각을 기준점으로 잡습니다. Settings > Usage나 /usage에서 내 계정의 초기화 요일과 시각을 확인합니다. 이 시각은 계정마다 고정이라 한 번 확인하면 매주 같은 기준으로 계획할 수 있습니다.
2. 남은 주간 비율을 남은 작업일로 나눕니다. 공식 일일 한도는 없지만, 계획용 기준으로는 쓸 만합니다. 예를 들어 주간 막대가 40% 찼고 초기화까지 작업일이 3일 남았다면 남은 60%를 3으로 나눠 하루 약 20%를 기준으로 삼습니다. /usage 내역의 24시간 보기와 비교하면 오늘 기준을 넘었는지 알 수 있습니다.
3. 무거운 작업은 주간 여유를 보고 시작합니다. 워크플로 팬아웃, 에이전트 팀, 여러 서브에이전트를 동시에 돌리는 작업은 5시간 창보다 주간 한도를 먼저 소진할 수 있습니다. 시작 전에 주간 막대를 보고, 남은 양이 부족하면 작업을 쪼개 며칠에 나눕니다. 사용 크레딧 안내에서도 집중 작업을 5시간 창에 맞춰 계획하라고 권합니다.
4. Opus는 계획과 어려운 판단에만 씁니다. Opus는 같은 작업에 사용량을 눈에 띄게 더 씁니다. /model opusplan이면 계획은 Opus로, 실행은 Sonnet으로 처리됩니다.
5. 경고가 뜨면 마무리 모드로 바꿉니다. 85% 경고나 상태 표시줄의 높은 5시간 값이 보이면 새 탐색을 시작하지 말고 커밋, 메모 정리, /rename으로 다음 창을 준비합니다.
6. 긴 휴식 전에는 세션을 정리합니다. 구독의 캐시 수명은 1시간입니다. 점심이나 회의로 그보다 오래 자리를 비우면 돌아와서 보내는 첫 메시지가 전체 컨텍스트를 다시 처리합니다. 큰 세션을 오랜만에 재개할 때 Pro·Max에서는 요약에서 재개하는 선택지가 제시되니 그것을 고르세요.
7. 자리를 비울 때는 자동 대기 여부를 정합니다. 밤새 켜 둔 세션이 한도에 걸리면 다음 창이 열리자마자 이어서 작업합니다. 다음 날 아침 작업에 5시간 창을 온전히 쓰고 싶다면 자동 대기를 꺼 두세요.

계획을 세워도 매주 주간 한도에 걸린다면 선택지는 세 가지입니다. 가끔 넘치는 정도라면 월 지출 한도를 정한 사용 크레딧, 거의 매주 부족하다면 Claude Pro vs Max 비교를 보고 Max로 올리는 것, 집중 작업이 특정 기간에 몰린다면 그 기간만 API 키 경로로 쓰는 것입니다. 요금제별 가격은 Claude Code 가격 가이드에, 무료와 Pro의 한도 차이는 Claude 무료 vs Pro 사용 한도 비교에 있습니다.

Claude Code 사용량 확인에 대해 자주 묻는 질문

Claude Code에서 남은 토큰은 어떻게 확인하나요?

Pro·Max 요금제의 남은 양은 토큰 수가 아니라 5시간 창과 주간 한도의 사용 비율로 표시됩니다. /usage의 막대와 초기화 시각, 또는 상태 표시줄의 rate_limits 값으로 확인하세요. 현재 대화가 컨텍스트 창을 얼마나 채웠는지는 /context나 상태 표시줄의 context_window 값으로 따로 봅니다.

/cost와 /usage는 다른 명령어인가요?

현재 Claude Code에서 /cost는 /usage의 별칭이라 같은 화면이 열립니다. /stats도 별칭이며 Stats 탭에서 열립니다. 구독자에게 Session 블록의 달러 금액은 청구액이 아니라 정가로 계산한 추정치입니다.

Claude Code와 claude.ai 사용량은 따로 계산되나요?

아닙니다. claude.ai, Claude Code, Claude Desktop, IDE 확장의 사용량은 같은 한도를 함께 씁니다. 다만 /usage 내역은 이 기기의 기록만 집계하므로 웹에서 쓴 양은 막대에만 반영되고 내역에는 나오지 않습니다.

VS Code에서 Claude Code 사용량은 어디서 보나요?

VS Code 확장의 Account & usage 대화 상자에서 스킬, 서브에이전트, 플러그인, MCP 서버별 비중과 행동 표시를 Day·Week로 전환해 볼 수 있습니다. 터미널 /usage의 Loops 행은 나오지 않습니다.

주간 한도가 먼저 바닥나는 이유는 무엇인가요?

모든 사용이 5시간 창과 주간 한도에 동시에 계산되기 때문입니다. 5시간 창은 초기화될 때마다 다시 채워지지만 주간 막대는 그 주에 쓴 양을 모두 쌓습니다. 병렬 서브에이전트나 에이전트 팀처럼 짧은 시간에 많이 쓰는 작업이 반복되면 5시간 막대에는 여유가 있어도 주간 한도가 먼저 끝납니다.