Cmd. /context
현재 컨텍스트 사용량을 색상 그리드로 시각화하고 항목별 분해와 최적화 제안을 보여주는 명령
핵심 요약
/context는 컨텍스트 사용량을 색상 그리드로 시각화해 단순 토큰 수치가 아니라 어디에 쓰이는지를 한눈에 보여줍니다.- 컨텍스트 과다 도구 최적화 제안, 메모리 비대화 경고, 용량 임박 경고를 함께 안내합니다(v2.1.74).
- 전체화면 모드에서는 항목별 분해가 접혀 있으며,
/context all로 스킬·MCP 도구·메모리별 토큰 분해를 펼칩니다. - v2.1.139부터 스킬별 토큰 추정치가 모델 토크나이저를 반영하고, v2.1.69에서 동일 MCP 서버 도구가 같은 토큰으로 표시되던 버그가 수정됐습니다.
명령어 원본 선언
/context [all]공식 설명 요약
/context는 현재 컨텍스트 사용량을 색상 그리드(colored grid) 로 시각화하는 명령입니다.
공식 문서 설명을 그대로 옮기면 다음과 같습니다.
Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings. In fullscreen mode the per-item breakdown is collapsed to keep the grid visible. Pass
allto expand it.
단순한 토큰 수치가 아니라 컨텍스트 윈도를 어디에 쓰고 있는지를 한눈에 보여주고, 다음 세 가지를 함께 안내합니다.
- 컨텍스트 과다 도구(context-heavy tools) 최적화 제안
- 메모리 비대화(memory bloat) 경고
- 용량 임박(capacity warnings) 경고
전체화면 모드(fullscreen mode)에서는 그리드를 화면에 유지하려고 항목별 분해(per-item breakdown)를 접어 두는데, all 인자를 넘기면 이 분해가 펼쳐집니다.
긴 대화에서 응답 품질이 흔들릴 때, 어디서 토큰이 소모되는지 진단하는 핵심 명령입니다.
최소 지원 버전
v1.0.86이상
사용법
/context # 컨텍스트 사용량을 색상 그리드로 시각화
/context all # 전체화면 모드에서 접혀 있는 항목별 분해까지 모두 펼침좋은 사용 예
- 긴 세션 중 응답 품질 저하 원인 확인
/compact실행 전후 비교- 스킬/에이전트 로딩 상태 점검
/context all로 항목별(스킬·MCP 도구·메모리 등) 토큰 분해 상세 확인- 액셔너블 제안으로 컨텍스트 최적화 (v2.1.74)
v2.1.74: 액셔너블 최적화 제안
/context를 실행하면 단순히 수치만 나열하지 않고 구체적인 최적화 팁을 함께 제시합니다:
- 컨텍스트 과다 도구 식별 — 토큰을 많이 소비하는 MCP 도구/스킬을 콕 집어 알려줌
- 메모리 비대화 감지 — 누적된 대화 메모리가 과도하게 커진 경우 경고
- 용량 경고 + 대응 팁 — 컨텍스트 한도 임박 시
/compact, 불필요한 도구 해제 등 구체적 조치 안내
all 인자 동작
전체화면 모드에서는 색상 그리드를 화면에 유지하려고 항목별 분해를 접어 둡니다.
/context all을 실행하면 이 분해(스킬·MCP 도구·메모리 등 항목별 토큰)를 모두 펼쳐서 봅니다.
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/context | 컨텍스트 내부 상태 분석 | 토큰/구성 확인 목적 |
/compact | 컨텍스트 축약 실행 | 컨텍스트 정리 목적 |
/clear | 컨텍스트 비우고 새 대화 | 완전 초기화 목적 |
활용 사례
- 장시간 세션 운영 표준 루틴
- 컨텍스트 비용 절감 정책 수립
/context all로 어떤 스킬·MCP 도구가 토큰을 잡아먹는지 식별 후 정리
주의사항
- 값이 정상이어도 응답 품질은 모델/프롬프트 영향 포함
- 큰 세션은 주기적
/compact와 병행 권장 - 전체화면 모드에서는 기본적으로 항목별 분해가 접혀 있으므로, 상세 분해가 필요하면
/context all을 사용 - v2.1.69 이전에는 동일 MCP 서버의 모든 도구가 같은 토큰 수로 표시되는 버그가 있었으며, v2.1.69에서 수정됨
버전 히스토리 (Changelog)
| 버전 | 변경 내용 |
|---|---|
| v2.1.141 | 플러그인에서 제공된 스킬에 대해 /context가 제공 플러그인 이름을 표시 |
| v2.1.139 | /context all의 스킬별 토큰 추정치가 모델의 토크나이저를 반영하고 반올림된 값을 표시 |
| v2.1.129 | /context가 렌더링된 ASCII 시각화 그리드를 대화에 덤프해 호출당 약 1.6k 토큰을 낭비하던 버그 수정 |
| v2.1.120 | [VSCode] /context가 평문 세션 비용 대신 네이티브 토큰 사용량 다이얼로그를 표시 |
| v2.1.74 | 단순 수치 나열을 넘어 액셔너블 최적화 제안(과다 도구·메모리 비대화·용량 경고) 추가 |
| v2.1.69 | 동일 MCP 서버의 모든 도구가 같은 토큰 수로 표시되던 버그 수정 |
출처
- Commands (공식): https://code.claude.com/docs/en/commands
- Fullscreen mode: https://code.claude.com/docs/en/fullscreen
- Changelog: https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/CHANGELOG.md