클로드 코드 토큰 사용량 확인｜/usage·/status·/cost 차이 한눈에 정리

클로드 코드 토큰 사용량과 비용 확인 방법

 클로드 코드 토큰 사용량 확인 방법을 찾다 보면 /usage, /status, /cost, /context 같은 명령어가 함께 나와 처음에는 무엇을 써야 할지 헷갈릴 수 있습니다.

결론부터 말하면 네 명령어는 같은 정보를 보여주는 기능이 아닙니다.

/usage → 플랜 사용량과 제한 상태

/status → 현재 계정과 모델·환경 정보

/cost → API 사용자의 현재 세션 토큰과 비용

/context → 현재 대화 컨텍스트가 어디에 쓰이고 있는지 확인

따라서 “남은 Claude Pro 사용량이 궁금한지”, “API 토큰 비용이 궁금한지”, “대화가 너무 길어진 원인이 궁금한지”에 따라 명령어를 다르게 사용해야 합니다.

이번 글에서는 Claude Code 사용량과 토큰을 확인할 때 어떤 명령을 써야 하는지 초보자 기준으로 구분해보겠습니다.

클로드 코드 토큰 사용량 확인, 먼저 한눈에 보면.

Claude Code usage status cost context 명령어 차이

가장 먼저 네 가지를 구분해두면 쉽습니다.

/usage

내 플랜의 사용 한도와 현재 사용 상태를 확인합니다.

/status

현재 로그인한 계정, 사용 모델, 작업 디렉토리, Claude Code 버전 등을 확인합니다.

/cost

현재 세션에서 사용한 토큰과 비용을 확인합니다.

다만 이 기능은 API 과금 방식에서 특히 중요합니다.

/context

현재 컨텍스트 윈도우에 어떤 정보가 들어가 있고 어디에서 공간을 많이 사용하고 있는지 확인합니다.

즉, “사용량”이라는 한 단어 안에 서로 다른 정보가 들어 있기 때문에 먼저 무엇을 알고 싶은지를 정해야 합니다.

/usage는 언제 사용할까.

Claude Code에서 내 플랜 사용량이 얼마나 남았는지 확인하고 싶다면 /usage를 먼저 보는 것이 좋습니다.

공식 Claude Code 치트시트에서는 /usage를 플랜 사용 한도와 현재 rate-limit 상태를 확인하는 명령으로 안내하고 있습니다.

Pro나 Max처럼 구독 플랜을 이용하는 사용자에게 특히 유용합니다.

예를 들어 Claude Code를 오랫동안 사용하다가

“오늘 사용량이 얼마나 남았지?”

“곧 제한에 걸리는 건 아닐까?”

가 궁금하다면 /usage가 가장 직접적인 명령입니다.

다만 표시되는 세부 항목은 계정과 Claude Code 버전에 따라 조금 달라질 수 있습니다.

/status는 사용량만 보는 명령일까.

아닙니다.

/status는 단순한 토큰 사용량 확인 명령이 아닙니다.

공식 치트시트에서는 /status가 현재 계정, 모델, 작업 디렉토리와 버전 등을 보여주는 명령으로 안내됩니다.

따라서 다음과 같은 상황에서 유용합니다.

어떤 계정으로 로그인했는지 확인할 때

현재 어떤 모델을 쓰고 있는지 확인할 때

어느 프로젝트 폴더에서 작업 중인지 확인할 때

Claude Code 환경 정보를 확인할 때

Pro·Max 구독 사용자의 경우 현재 계정과 사용 상태를 확인하는 데도 도움이 되지만, 플랜의 구체적인 사용 한도를 확인하는 목적이라면 /usage와 역할을 구분해보는 것이 좋습니다.

/cost는 언제 사용하는 명령일까.

/cost는 이름 그대로 비용 확인에 가깝습니다.

공식 안내에 따르면 /cost는 현재 세션의 토큰 사용량과 비용을 보여줍니다.

특히 API 키를 이용해 Claude Code를 사용하는 사람에게 중요합니다.

API 사용자는 정액 구독이 아니라 사용한 토큰에 따라 비용이 발생할 수 있기 때문입니다.

예를 들어 API 키 방식으로 Claude Code를 사용하면서

“이 세션에서 토큰을 얼마나 썼지?”

“현재까지 비용이 얼마나 발생했지?”

가 궁금하다면 /cost를 확인할 수 있습니다.

반대로 Pro나 Max 구독 사용자에게는 /cost보다 /usage로 플랜 사용량을 보는 것이 더 직접적인 경우가 많습니다.

Pro를 쓰는데 /cost 금액이 나온다면 확인할 점.

Pro나 Max를 결제했는데 예상하지 못한 API 비용이 보인다면 인증 방식을 확인해야 합니다.

Anthropic 공식 안내에 따르면 시스템에 ANTHROPIC_API_KEY 환경변수가 설정되어 있으면 Claude Code가 구독 계정 대신 API 키를 이용할 수 있습니다.

이 경우 Pro·Max에 포함된 사용량이 아니라 API 사용료가 발생할 수 있습니다.

따라서 Pro를 결제했다고 해서 무조건 모든 Claude Code 사용이 구독 사용량으로 처리된다고 생각해서는 안 됩니다.

API 키를 예전에 설정해둔 적이 있다면 한 번 확인해보는 것이 좋습니다.

/context는 토큰 확인과 어떻게 다를까.

/context는 돈이나 플랜 사용량을 직접 확인하는 기능과는 다릅니다.

이 명령은 현재 Claude Code의 컨텍스트 윈도우에 어떤 정보가 들어가 있고 어느 부분에서 공간을 사용하고 있는지를 보여줍니다.

쉽게 말하면 Claude가 현재 대화와 프로젝트를 이해하기 위해 가지고 있는 ‘작업 메모리’를 확인하는 기능에 가깝습니다.

대화가 길어지고 파일을 많이 읽히다 보면 컨텍스트가 커질 수 있습니다.

이때 /context를 사용하면 어떤 정보가 많은 공간을 차지하는지 파악하는 데 도움이 됩니다.

사용량 한도와 컨텍스트 한도는 같은 것일까.

Claude Code 사용량 한도와 컨텍스트 한도 차이

같지 않습니다.

이 부분은 Claude Code를 사용할 때 반드시 구분해야 합니다.

사용량 한도

일정 시간 동안 Claude를 얼마나 사용할 수 있는지와 관련된 제한입니다.

Pro, Max 등 플랜에 따라 사용할 수 있는 양이 달라질 수 있습니다.

컨텍스트 한도

현재 하나의 대화가 얼마나 많은 내용을 기억하면서 작업할 수 있는지와 관련된 제한입니다.

따라서 사용량이 남아 있어도 대화가 너무 길어지면 컨텍스트가 가득 찰 수 있습니다.

반대로 컨텍스트가 충분해도 플랜 사용량 제한에 먼저 도달할 수도 있습니다.

두 문제는 해결 방법도 다릅니다.

컨텍스트가 너무 길어졌다면 어떻게 할까.

Claude Code 공식 안내에서는 컨텍스트가 가득 찬 경우 /compact 또는 /clear를 활용할 수 있다고 설명합니다.

/compact

기존 대화 내용을 요약해 필요한 문맥은 유지하면서 컨텍스트 공간을 확보합니다.

/clear

기존 대화를 정리하고 새로운 대화를 시작합니다.

현재 작업을 계속 이어가야 한다면 /compact가 유용할 수 있습니다.

반대로 작업 주제가 완전히 달라졌다면 /clear로 새로 시작하는 편이 더 깔끔할 수 있습니다.

Claude와 Claude Code 사용량은 따로일까.

Pro와 Max에서는 Claude와 Claude Code 사용량을 완전히 별개의 서비스라고 생각하면 안 됩니다.

Anthropic 공식 안내에 따르면 Claude 웹, Claude Code 등 여러 Claude 서비스에서 발생한 사용량은 동일한 플랜의 사용 한도에 함께 영향을 줄 수 있습니다.

예를 들어 Claude 웹에서 긴 문서 분석을 많이 한 뒤 Claude Code를 사용한다면 남은 사용량에 영향을 받을 수 있습니다.

반대로 Claude Code에서 많은 작업을 했다면 일반 Claude 사용에도 영향을 줄 수 있습니다.

그래서 Claude Code만 보고 사용량을 계산하기보다 Claude 전체 사용 패턴을 함께 보는 것이 좋습니다.

API 방식과 구독 방식은 사용량을 어떻게 다르게 볼까.

Claude Code Pro Max 구독과 API 키 사용량 확인 차이

Claude Code의 사용량 측정은 로그인 방식에 따라 달라집니다.

API 키 기반 사용자는 토큰 사용량에 따라 비용이 발생하기 때문에 /cost가 중요합니다.

반면 구독 플랜 사용자는 일정한 플랜 사용 한도 안에서 Claude와 Claude Code를 이용하므로 /usage가 더 중요한 정보가 됩니다.

정리하면 다음처럼 생각하면 쉽습니다.

Pro·Max 구독 → /usage 중심

API 키 사용 → /cost 중심

현재 계정·모델 확인 → /status

대화 컨텍스트 확인 → /context

사용량이 빨리 줄어드는 이유는 무엇일까.

Claude Code 사용량은 단순히 질문 횟수만으로 결정되지 않습니다.

대화가 길수록 더 많은 정보를 처리해야 합니다.

프로젝트 파일이 많거나 큰 파일을 여러 개 읽으면 처리해야 할 정보도 늘어납니다.

복잡한 코드 수정이나 추론이 필요한 작업도 단순한 질문보다 사용량에 더 큰 영향을 줄 수 있습니다.

사용하는 모델도 영향을 줄 수 있습니다.

공식 안내에서는 모델에 따라 사용량과 비용 효율이 달라질 수 있다고 설명합니다.

따라서 “나는 10번밖에 질문하지 않았는데 왜 많이 줄었지?”라고 생각하기보다 질문의 크기와 작업 범위를 함께 보는 것이 좋습니다.

사용량을 아끼려면 어떻게 하면 좋을까.

첫째, 필요한 파일만 Claude에게 보여주는 것이 좋습니다.

전체 프로젝트를 한꺼번에 읽히기보다 현재 작업과 관련된 파일부터 지정하세요.

둘째, 작업 범위를 명확하게 요청합니다.

“프로젝트 전체를 개선해줘”보다

“이 함수의 오류 원인만 찾아줘.”

처럼 좁게 요청하는 편이 효율적입니다.

셋째, 대화가 너무 길어졌다면 /compact를 활용합니다.

넷째, 작업 주제가 바뀌었다면 /clear로 새 세션을 시작하는 것도 방법입니다.

다섯째, 필요 이상으로 무거운 모델을 계속 사용하지 않는 것도 고려할 수 있습니다.

중요한 것은 질문 횟수를 무조건 줄이는 것이 아니라 Claude가 처리해야 할 불필요한 문맥을 줄이는 것입니다.

사용량 제한에 도달하면 어떻게 될까.

구독 플랜에서는 사용량 제한에 도달하면 일정 시간이 지난 뒤 다시 사용할 수 있도록 재설정되는 방식이 적용될 수 있습니다.

표시되는 안내에서 재설정 시점을 확인할 수 있습니다.

API 사용자는 조금 다릅니다.

API는 사용량에 따라 비용이 발생하는 구조이므로 구독 플랜과 같은 방식의 단순 사용 중단이 아니라 API 한도와 과금 상태를 확인해야 합니다.

API에는 분당 요청 수와 입력·출력 토큰 등의 rate limit도 별도로 존재합니다.

따라서 Pro·Max 사용량 제한과 API rate limit을 같은 것으로 이해해서는 안 됩니다.

클로드 코드 토큰 사용량 FAQ.

Q. Claude Code에서 남은 Pro 사용량을 보려면 무엇을 입력하나요?

플랜 사용 한도와 현재 상태를 확인하려면 /usage를 먼저 확인하는 것이 좋습니다.

Q. /status와 /usage는 같은 명령인가요?

아닙니다. /status는 계정·모델·작업 환경 정보를 확인하는 데 가깝고 /usage는 플랜 사용 한도와 현재 사용 상태를 확인하는 기능입니다.

Q. /cost는 언제 사용하나요?

API 키 기반 사용자가 현재 세션에서 소비한 토큰과 비용을 확인할 때 특히 유용합니다.

Q. Pro 사용자도 API 비용이 발생할 수 있나요?

가능합니다. 시스템에 ANTHROPIC_API_KEY가 설정되어 있고 Claude Code가 해당 API 키로 인증되면 구독 사용량이 아니라 API 과금이 발생할 수 있습니다.

Q. /context는 토큰 사용량을 보여주나요?

비용을 보여주는 명령이라기보다 현재 컨텍스트 윈도우에 어떤 정보가 들어가 있고 어디에 공간이 사용되는지 확인하는 기능입니다.

Q. 컨텍스트가 가득 차면 어떻게 하나요?

현재 작업을 이어가려면 /compact, 이전 내용이 필요 없다면 /clear를 사용할 수 있습니다.

무엇을 확인하고 싶은지부터 정하세요.

Claude Code usage status cost context compact 명령 선택 방법

Claude Code 사용량 확인은 명령어 하나로 모든 것을 보는 구조가 아닙니다.

그래서 이렇게 기억하면 가장 쉽습니다.

내 플랜 사용량 → /usage

현재 계정·모델 → /status

API 토큰·비용 → /cost

대화가 차지하는 공간 → /context

긴 대화 정리 → /compact

이 다섯 가지 역할만 구분해두면 Claude Code를 사용하면서 “왜 사용량이 빨리 줄지?”, “API 비용이 왜 발생했지?”, “대화가 왜 길어졌지?” 같은 문제를 훨씬 쉽게 확인할 수 있습니다.

함께 보면 좋은 글.

클로드 코드 사용법｜설치부터 첫 실행·VS Code·명령어·비용까지 초보자 가이드

클로드 코드 설치 방법｜Windows·Mac 설치부터 첫 실행까지

클로드 코드 가격·무료·요금제｜Pro·Max 얼마? API 비용까지 정리

클로드 코드 VS Code 사용법｜확장 프로그램 설치·연결·첫 작업까지

다음 글에서는 Claude Code vs Codex를 설치, 사용방식, 비용, IDE 연동과 초보자 편의성 기준으로 비교해보겠습니다.

※ Claude Code 명령어와 사용량 정책, 모델별 제한은 변경될 수 있습니다. 실제 사용 시 Claude Code 공식 치트시트와 Anthropic 지원 문서에서 최신 내용을 함께 확인하시기 바랍니다.