Claude Code 사용량 모드: 컨텍스트, 플랜 사용량, 비용

Claude Code 사용량 모드는 세션을 제한하는 숫자들을 계속 보이게 합니다. 컨텍스트 창이 얼마나 찼는지, 5시간 및 7일 플랜 기간을 얼마나 사용했는지, 지금까지 세션 비용이 얼마인지, Claude가 도구를 몇 번 호출했는지 등입니다. 작업 도중에 컴팩션이나 속도 제한에 부딪히는 대신 미리 다가오는 것을 볼 수 있습니다.

Claude Code 사용량 모드는 숫자를 어디에서 가져오나요?#

주된 출처는 $.session.usage()입니다. 이 함수는 startedAt, context(토큰 수, 창 크기, 백분율), rateLimits(플랜 기간마다 percentUsed를 담은 항목 하나), cost를 반환합니다. 세부 내역 없이 호출하면 요청을 보내지 않으므로, 모드는 매 턴이 끝날 때마다 무료로 읽을 수 있습니다. 모드는 보통 turn.complete, session.compact, 그리고 느린 $.clock.every 타이머에서 새로 고친 뒤 결과를 $.ui.status로 씁니다.

session.measure는 각 턴이 끝난 뒤와 플랜 사용량이 바뀔 때마다 발생하므로, 임계값에 반응하는 모드에 적합합니다. 도구 호출 집계 같은 활동 카운터는 tool.call 이벤트를 세고 합계를 $.state에 보관합니다. 사용량 객체는 모드 레퍼런스에 설명되어 있습니다.

설치하기 전에 무엇을 확인해야 하나요?#

사용량 표시에는 필요한 것이 거의 없어야 합니다. UI 변경만 표시되는 것이 일반적입니다. 사용량 모드에 네트워크가 표시된다면 사용자의 수치를 어딘가로 보내고 있다는 뜻이므로 어디로 보내는지 확인하십시오. 사용량 모드에 모델 호출이 표시된다면 위험 신호입니다. 추적한다고 내세우는 바로 그 사용량을 소모하게 되기 때문입니다.

데이터가 없을 때 어떻게 처리하는지도 확인하십시오. 첫 응답 전에는 아직 컨텍스트 수치가 없고, API 키를 사용하면 플랜 기간이 없습니다. 신중하게 만든 모드는 오해를 부르는 0을 보여 주는 대신 해당 부분을 생략합니다. 경고 토스트가 임계값마다 한 번만 뜨는지, 아니면 새로 고칠 때마다 뜨는지도 확인하십시오.

숫자를 보고 어떻게 대응해야 하나요?#

컨텍스트가 약 80퍼센트를 넘으면 무엇을 남길지 짧게 메모를 붙여 /compact를 실행하거나, /clear로 비운 뒤 요약을 가지고 새로 시작합니다. 5시간 기간의 사용량이 높다면 긴 작업을 나중으로 미루거나 더 작은 모델로 옮깁니다. 사용량 모드는 한도를 바꾸지 않습니다. 대신 선택할 수 있을 만큼 일찍 경고해 줍니다.