Claude Code /context, /usage, /model: 화면 항목별 읽는 방법

가상의 세션을 하나 놓고 시작하겠습니다. /context는 19%를 가리키는데 /usage의 주간 한도 막대는 62%까지 찼습니다. 둘 중 하나가 틀린 것처럼 보이지만 둘 다 맞는 숫자입니다.

흔히 Claude Code의 「사용량」을 숫자 하나로 생각합니다. 실제로는 재는 대상이 다릅니다. /context는 대화 하나가 컨텍스트 창을 얼마나 채웠는지를, /usage는 비용과 요금제 한도를 얼마나 썼는지를 보여 줍니다. /model은 이 두 숫자가 얼마나 빨리 오를지를 정합니다.

명령	답하는 질문	기준
/context	이 대화의 공간이 얼마나 남았나?	대화 하나
/usage	비용과 한도를 얼마나 썼나?	세션과 요금제
/model	어떤 모델과 effort로 일하나?	세션과 기본 설정

/context가 나누는 컨텍스트 창의 구성

/context는 사용량을 색깔 격자와 항목별 토큰으로 보여 줍니다. 아래는 1M 창을 쓰는 세션을 가정한 표입니다.

항목	예시	들어가는 내용	줄이는 방법
System prompt	3k	Claude Code의 기본 지침	직접 줄이지 않음
System tools	30k	Read, Edit, Bash 같은 내장 도구 정의	직접 줄이지 않음
MCP tools	1k	지금 불러온 MCP 도구 정의	안 쓰는 서버를 /mcp에서 끄기
MCP server instructions	2k	MCP 서버가 제공한 사용 지침	안 쓰는 서버 끄기
Memory files	6k	CLAUDE.md, 자동 메모리	세부 절차를 스킬로 옮기기
Skills	4k	스킬의 이름과 설명	안 쓰는 스킬 정리
Messages	140k	대화, 읽은 파일, 도구 결과	/compact, /clear, 서브에이전트
Free space	781k	아직 비어 있는 공간	해당 없음
Autocompact buffer	33k	자동 압축 전에 남겨 두는 공간	/autocompact로 시점 조정

설명을 위해 만든 가상의 수치입니다. 실제 값은 모델, 연결한 도구, 대화 길이에 따라 달라집니다.

위 표에서 사용량은 186k, 비율로는 19%입니다. 사용량, 여유 공간, 버퍼를 더하면 창 크기인 100만이 됩니다. 33k라는 버퍼는 임의로 넣은 값이 아닙니다. 문서는 기본 1M 창을 쓰는 모델이 약 967K에서 압축한다고 설명합니다. 다만 이 시점은 모델과 설정에 따라 다릅니다.

목록에 보여도 사용량에 더하지 않는 deferred 도구

deferred 도구는 이름만 알고 있다가 쓸 때 정의를 불러오는 도구입니다. MCP 도구 정의는 기본적으로 deferred입니다. 그래서 /context에 큰 숫자가 보여도 사용량 합계에 바로 더하면 안 됩니다. 저는 MCP 서버를 연결할 때 이 값보다 실제로 올라간 MCP tools와 지침 크기를 먼저 보는 편이 맞다고 봅니다.

/context all은 전체 화면 모드에서 접힌 항목별 내역을 펼칩니다.

압축 뒤에 남는 내용과 사라지는 내용

Messages가 커지면 /compact가 대화를 요약합니다. /compact focus on the auth bug fix처럼 무엇을 남길지 지시할 수도 있습니다. 요약이 모든 내용을 그대로 보존하는 것은 아니며, 항목마다 처리가 다릅니다.

항목	압축 후
시스템 프롬프트, 출력 스타일	그대로 적용
프로젝트 루트 CLAUDE.md, 경로 제한 없는 규칙	디스크에서 다시 주입
자동 메모리	디스크에서 다시 주입
플랜 모드에서 쓴 계획	디스크에서 다시 주입
paths: 규칙, 하위 폴더 CLAUDE.md	필요할 때 다시 로드
읽거나 고친 파일	최근 수정 순으로 최대 5개를 다시 읽음
호출한 스킬 본문	스킬당 5,000토큰, 합계 25,000토큰까지 다시 주입
백그라운드 명령과 에이전트	계속 실행
훅이 앞서 추가한 맥락	다른 대화와 함께 요약

5,000토큰이 넘는 파일은 내용 없이 경로만 돌아옵니다. 그래서 압축 전에 읽은 큰 파일의 내용을 Claude가 계속 기억한다고 가정하면 안 됩니다.

/compact에는 비용도 듭니다. 문서는 큰 대화를 압축하는 일 자체가 큰 요청이라고 설명합니다. 앞의 맥락이 필요 없는 새 작업이라면 비용이 들지 않는 /clear가 맞습니다. 대화를 이어 가야 할 때만 /compact를 고르면 됩니다.

/usage의 항목별 의미

/usage는 세션 비용, 요금제 한도, 활동 통계를 한 화면에 보여 줍니다. /cost와 /stats는 별칭이고, /stats는 Stats 탭으로 바로 열립니다. Claude가 응답하는 중에도 바로 실행됩니다.

항목	의미	읽을 때 주의할 점
Total cost	세션 비용 추정치	구독 요금제의 청구액이 아님
Total duration (API)	API 처리에 걸린 시간	실제 경과 시간과 다름
Total duration (wall)	세션이 흐른 전체 시간	자리를 비운 시간도 포함될 수 있음
Total code changes	추가, 삭제한 코드 줄 수	세션 합계
Usage by model	모델별 입력, 출력, 캐시 읽기와 쓰기	모델을 바꾸면 줄별로 나뉨
Prompt cache (main)	요청 수, 캐시 적중 비율, 미스, 웜/콜드	메인 대화만 집계
요금제 사용량 막대	요금제 한도 대비 사용량	요금제에 따라 표시가 다름
활동 통계	사용 활동 요약	Stats 탭에서 확인
Attribution	스킬, 서브에이전트, 플러그인, MCP 서버별 비중	이 기기의 기록으로 계산한 근사치
Recommendations	사용량을 줄이기 위한 제안	표시된 비율은 절감량이 아님
Loops	사용량이 큰 /loop와 예약 작업	v2.1.242 이상
사용 크레딧	이번 달 크레딧 사용액과 한도	크레딧이 켜져 있을 때 표시

Prompt cache 줄은 비용이 늘어난 이유를 찾을 때 유용합니다. 캐시 미스는 이미 캐시에 있던 내용을 다시 처리한 요청입니다. 쉬었다가 돌아오면 캐시 수명이 끝나 전체 맥락을 다시 처리할 수 있습니다. warm이면 캐시가 살아 있고, cold면 수명이 끝난 상태입니다.

Recommendations의 비율은 잘못 읽기 쉽습니다. 25%는 그 제안이 최근 사용량의 25%에 해당한다는 뜻이고, 25%를 아낄 수 있다는 뜻은 아닙니다. 요청 하나가 여러 줄에 함께 집계되므로 합계가 100%를 넘기도 합니다.

화면 안에서 쓰는 키는 다음과 같습니다. d와 w는 기간을 24시간과 7일 사이에서 바꿉니다. r은 한도 조회가 실패했을 때 다시 시도합니다. 하단에 f to fix가 보이면 f로 적용 가능한 제안을 실행합니다(v2.1.305 이상). 집계는 이 기기의 기록으로 계산되므로 다른 기기나 claude.ai 사용량은 빠져 있습니다.

경고 문구로 구분하는 한도와 컨텍스트

컨텍스트 경고와 사용량 한도는 해결 방법이 다릅니다. 컨텍스트 경고는 요금제 한도가 아니라 대화가 자동 압축 시점에 가까워졌다는 뜻입니다. 문서의 구분은 이렇습니다.

메시지	뜻	할 수 있는 일
컨텍스트, 자동 압축 경고	대화가 커짐	/compact, /clear
session limit, weekly limit	모든 모델이 함께 쓰는 한도에 도달	재설정 대기, 크레딧 사용
Opus limit, Sonnet limit	특정 모델군의 한도에 도달	/model로 다른 모델군 선택
spend limit	크레딧 지출 한도에 도달	한도 조정 또는 재설정 대기

세션 한도에 걸렸을 때는 /model로 바꿔도 풀리지 않는다는 점을 기억해 두면 좋습니다.

/model의 모델 별칭

/model은 인자가 없으면 선택 창을 열고, 이름을 주면 바로 전환합니다.

별칭	쓰임
default	재정의를 지우고 계정 기본 모델로 복귀
best	쓸 수 있으면 Fable, 아니면 Opus와 같은 모델
fable	가장 어렵고 오래 걸리는 작업
opus	복잡한 추론 작업
sonnet	일상적인 코딩 작업
haiku	단순한 작업
opus[1m], sonnet[1m]	1M 창 사용, 이미 기본 1M인 모델에서는 효과 없음
opusplan	플랜 모드에서는 Opus, 실행 단계에서는 Sonnet

쓸 수 있는 모델은 요금제와 조직 설정에 따라 다릅니다. 관리자가 availableModels를 지정하면 제외된 모델은 선택 창에서 사라지고, /model로 지정해도 거부됩니다.

고르는 키에 따라 달라지는 저장 범위

가장 흔한 오해는 /model이 지금 세션만 바꾼다는 생각입니다. 선택 창의 Enter는 모델을 전환하면서 새 세션의 기본값으로도 저장합니다.

조작	적용 범위
선택 창에서 Enter	전환하고 기본값으로 저장
/model <이름> 입력	Enter와 같음
선택 창에서 s	현재 세션만 전환
좌우 화살표	지원 모델의 effort 조절
claude -p에서 /model	현재 세션만 적용
claude --model <이름>	그 실행에만 적용

Opus로 전환하면 세션 모델을 상속하는 서브에이전트도 함께 바뀝니다. 터미널마다 다른 모델을 쓰고 싶다면 /model보다 --model로 각각 실행하는 방법이 안전합니다. 지금 모델을 확인할 때는 상태 표시줄이나 /status를 보면 됩니다.

/model 안에서 함께 고르는 effort

effort는 모델이 얼마나 깊이 추론할지를 정합니다. 높일수록 토큰도 많이 씁니다.

수준	맞는 작업
low	결과를 매번 검토하는 빠른 작업, 이름 변경 같은 작은 수정
medium	범위가 분명한 일상 작업, Opus 5.5, Sonnet 5.5, Haiku 5.5의 기본값
high	기존 코드의 버그 수정처럼 검증이 중요한 작업
xhigh	토큰을 더 쓰더라도 더 깊은 추론이 필요한 작업
max	보안 취약점 찾기처럼 맡겨 두고 풀게 할 어려운 문제

문서는 max의 효과가 작아질 수 있고 과하게 고민하기 쉽다고 경고합니다. 저라면 비용이 오르는 문제를 볼 때 모델을 바꾸기 전에 effort부터 낮춰 보겠습니다. 다만 어느 쪽이 더 효과적인지는 작업마다 다르고, 저도 일반적인 답을 갖고 있지는 않습니다.

숫자를 봤을 때의 판단 순서

서두의 가상 세션으로 돌아가겠습니다. 컨텍스트가 19%라면 대화 공간은 넉넉하므로 /compact가 급하지 않습니다. 주간 한도가 62%라면 /usage의 Attribution과 Recommendations에서 사용량이 어디로 갔는지 봐야 합니다. 원인이 긴 대화라면 /clear로 작업을 나누고, 작업이 가볍다면 /model로 모델이나 effort를 낮춥니다.

항목 이름과 단축키는 Claude Code 버전과 요금제에 따라 달라집니다. 이 글은 2026년 11월 2일에 읽은 공식 문서를 기준으로 했습니다.