Cmd. /context
현재 컨텍스트 사용량을 색상 그리드로 시각화하고 항목별 분해와 최적화 제안을 보여주는 명령
핵심 요약
- context 사용량·과다 항목 시각화
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
context 사용량·과다 항목 시각화
/context [all]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/context all/context # 컨텍스트 사용량을 색상 그리드로 시각화
/context all # 전체화면 모드에서 접혀 있는 항목별 분해까지 모두 펼침선택 시점
- 긴 세션 중 응답 품질 저하 원인 확인
/compact실행 전후 비교- 스킬/에이전트 로딩 상태 점검
/context all로 항목별(스킬·MCP 도구·메모리 등) 토큰 분해 상세 확인- 액셔너블 제안으로 컨텍스트 최적화 (v2.1.74)
v2.1.74: 액셔너블 최적화 제안
/context를 실행하면 단순히 수치만 나열하지 않고 구체적인 최적화 팁을 함께 제시합니다:
- 컨텍스트 과다 도구 식별 — 토큰을 많이 소비하는 MCP 도구/스킬을 콕 집어 알려줌
- 메모리 비대화 감지 — 누적된 대화 메모리가 과도하게 커진 경우 경고
- 용량 경고 + 대응 팁 — 컨텍스트 한도 임박 시
/compact, 불필요한 도구 해제 등 구체적 조치 안내
all 인자 동작
전체화면 모드에서는 색상 그리드를 화면에 유지하려고 항목별 분해를 접어 둡니다.
/context all을 실행하면 이 분해(스킬·MCP 도구·메모리 등 항목별 토큰)를 모두 펼쳐서 봅니다.
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/context | 컨텍스트 내부 상태 분석 | 토큰/구성 확인 목적 |
/compact | 컨텍스트 축약 실행 | 컨텍스트 정리 목적 |
/clear | 컨텍스트 비우고 새 대화 | 완전 초기화 목적 |
실행 결과와 유지 범위
현재 컨텍스트 사용량을 표시합니다. 컨텍스트를 줄이려면 별도로 compact를 실행합니다.
/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 인자를 넘기면 이 분해가 펼쳐집니다.
긴 대화에서 응답 품질이 흔들릴 때, 어디서 토큰이 소모되는지 진단하는 핵심 명령입니다.
주의사항
- 값이 정상이어도 응답 품질은 모델/프롬프트 영향 포함
- 큰 세션은 주기적
/compact와 병행 권장 - 전체화면 모드에서는 기본적으로 항목별 분해가 접혀 있으므로, 상세 분해가 필요하면
/context all을 사용
버전 히스토리 (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 서버의 모든 도구가 같은 토큰 수로 표시되던 버그 수정 |
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록