/context는 지금 컨텍스트 창이 무엇으로 채워져 있는지 보여 주는 진단 명령입니다. 대화가 느려지거나 지침이 무시될 때 원인을 찾으려고 씁니다.
어떻게 동작하나
컨텍스트 창에는 내 지침, Claude가 읽은 파일, Claude의 응답, 터미널에 보이지 않는 내용이 모두 들어갑니다. 입력하기도 전에 CLAUDE.md, 자동 메모, MCP 도구 이름, 스킬 설명이 먼저 올라갑니다.
/context [all]은 이 사용량을 색 격자로 시각화합니다. 컨텍스트를 많이 쓰는 도구, 메모리 비대화, 용량 경고에 대한 최적화 제안도 함께 보여 줍니다. 대화가 컨텍스트 창을 넘으면 출력에 경고가 나오고, 얼마나 넘었는지와 공간을 비우는 명령이 안내됩니다. 전체 화면(fullscreen) 모드에서는 항목별 내역이 접혀 격자가 먼저 보이고, all을 붙이면 펼쳐집니다.
사용 방법
- /context 를 입력해 격자와 제안을 확인합니다.
- 항목별 내역이 접혀 있으면 /context all 로 펼칩니다.
- Memory files 목록에서 CLAUDE.md, CLAUDE.local.md가 로드됐는지 확인합니다. 목록에 없으면 Claude에게 보이지 않는 파일입니다.
- MCP 도구가 많다면 /mcp에서 쓰지 않는 서버를 끕니다.
- 제안에 따라 CLAUDE.md를 줄이거나, 주제가 바뀌었다면 /clear, 같은 작업을 이어간다면 /compact를 합니다.
/context /context all
무엇을 줄일 수 있나
공식 비용 문서가 제시하는 방향은 다음과 같습니다. 무관한 작업 사이에는 /clear를 쓰고, /compact에는 남길 내용을 지시문으로 붙입니다. CLAUDE.md는 200줄 이내로 유지하고, 특정 작업에만 필요한 절차는 호출될 때만 불러오는 스킬로 옮깁니다. MCP 도구 정의는 기본적으로 지연 로드되어 이름과 서버 지침만 먼저 올라가지만, 쓰지 않는 서버는 꺼 두는 편이 좋습니다.
큰 조사 작업은 서브에이전트에 맡깁니다. 서브에이전트는 자기 컨텍스트에서 파일을 읽고 요약만 돌려주므로 내 컨텍스트가 덜 찹니다.
더 큰 창이 필요하다면 모델에 따라 100만 토큰 컨텍스트를 지원하는 경우가 있습니다. 가능 여부와 선택 방법은 모델 설정 문서에서 확인하세요.
이웃 명령과의 관계
- /compact: 같은 대화를 요약해 공간을 비웁니다. /context가 진단이면 /compact는 처치입니다.
- /clear: 빈 컨텍스트로 새 대화를 시작합니다.
- /autocompact: 자동 압축이 시작되는 시점을 정합니다.
- /memory: /context 목록에 보인 메모리 파일을 열어 편집합니다.
- /usage: 컨텍스트가 아니라 비용과 플랜 사용 한도를 봅니다.
실제 예시
CLAUDE.md에 새 규칙을 추가했는데 Claude가 전혀 반영하지 않는 것 같을 때
/context
출력의 Memory files 목록에서 해당 CLAUDE.md가 있는지 봅니다. 없으면 파일 위치가 잘못된 것이고, 있으면 파일이 너무 길거나 다른 지침과 충돌하는지 점검합니다.
MCP 서버를 여러 개 연결한 뒤 대화가 부쩍 무거워졌을 때
/context 로 확인한 뒤, 쓰지 않는 서버를 /mcp에서 비활성화
컨텍스트를 많이 차지하는 도구가 제안으로 표시되면 그 서버부터 끕니다. 이름과 지침만 올라가는 지연 로드라도 서버가 많으면 쌓입니다.
오래 이어진 대화에서 경고가 뜨고 곧 한도에 닿을 것 같을 때
/context 로 확인 후 /compact 지금까지의 결정 사항과 남은 할 일 위주로
격자로 현재 점유율을 확인한 뒤, 같은 작업을 이어가기 위해 지시문을 붙여 압축합니다. 다시 /context를 하면 사용량이 줄어든 것을 볼 수 있습니다.
흔한 실수와 쓰지 말아야 할 때
- /context를 압축 명령으로 착각하는 것. 보기만 하고 아무것도 비우지 않습니다.
- 출력의 모든 제안을 한꺼번에 적용하는 것. 제안은 후보일 뿐이므로 내 작업에 필요한 것인지 보고 고르세요.
- 컨텍스트 문제와 사용 한도 문제를 구분하지 않는 것. 컨텍스트 경고는 한도 초과가 아닙니다. 한도는 /usage에서 봅니다.
- 최적화 전에 격자를 안 보고 감으로 줄이는 것. 실제로 무엇이 큰지 확인해야 헛수고를 줄입니다.
자주 묻는 질문
/context와 /usage는 뭐가 다른가요?
/context는 컨텍스트 창이 무엇으로 차 있는지 보여 줍니다. /usage는 세션 비용, 플랜 사용 한도, 활동 통계를 보여 줍니다.
컨텍스트 경고가 뜨면 작업이 끊기나요?
아닙니다. Claude Code는 한도에 가까워지면 자동으로 압축합니다. 다만 무엇이 남을지 직접 정하고 싶다면 미리 /compact에 지시문을 붙여 실행하세요.
로드된 CLAUDE.md는 어디서 확인하나요?
/context 출력의 Memory files 목록입니다. /memory에서도 파일 목록을 보고 열 수 있습니다.
2026-10-30 공식 문서와 대조함. 출처: Claude Code 문서: Commands, Claude Code 문서: Explore the context window, Claude Code 문서: Manage costs effectively, Claude Code 문서: How Claude remembers your project. 작성 원칙