Claude Code /context란? AI 대화 공간 확인하는 법
“Claude Code에 홈페이지 수정을 맡겼는데 대화가 길어지자 처음 정한 조건을 자꾸 놓치는 것 같아요. 어디부터 확인해야 할까요?” AI로 코딩하다 보면 이런 일이 생깁니다. 처음에는 버튼 색깔만 바꾸기로 했는데, 긴 대화 뒤에는 앞서 정한 조건을 빠뜨리거나 이미 읽은 파일을 다시 조사하는 것처럼 보일 수 있습니다. 원인은 여러 가지일 수 있습니다. 그중 하나가 현재 AI 대화의 작업 공간에 얼마나 많은 정보가 쌓였는지와 관련됩니다.
이때 Claude Code에서 사용하는 명령어가 /context입니다.
/context는 현재 Claude Code 대화의 컨텍스트 공간이 무엇으로 채워져 있는지 시각적으로 보여 주는 진단 명령어입니다. 공식 문서에 따르면 색상 격자 형태로 현재 사용량을 보여 주며, 공간을 많이 쓰는 도구나 메모리 관련 항목을 살펴보고 최적화 제안도 확인할 수 있습니다.
어렵게 느껴진다면 휴대전화의 저장 공간 분석 화면을 떠올려 보세요.
사진·앱·문서가 각각 얼마나 공간을 차지하는지 확인하듯, /context는 AI가 지금 참고하는 대화·도구 결과·지침 등의 공간 사용을 이해하도록 돕습니다.
단, 이 비유에는 차이가 있습니다. 휴대전화의 영구 저장 공간이 아니라 현재 AI 대화의 작업 공간을 진단합니다. 파일을 지우거나 구독 한도를 초기화하는 기능은 아닙니다.
이 글에서는 /context를 언제 쓰는지, 어떻게 입력하는지, 무엇을 확인해야 하는지, 공간이 부족할 때 어떤 선택을 할 수 있는지 차근차근 살펴보겠습니다.
이 글의 순서
1. /context는 무엇을 확인하는 명령어인가요?
Claude Code는 질문 한 줄만 보고 답하는 것이 아닙니다. 현재 작업에 필요한 여러 정보를 참고할 수 있습니다. 예를 들어 AI에게 “어제 수정하던 홈페이지에서 모바일 메뉴만 고쳐 줘”라고 요청했다면 다음 정보가 관련될 수 있습니다.
- 지금 입력한 요청과 이전 대화
- AI가 읽은 HTML·CSS·JavaScript 파일의 내용
- 터미널 명령 실행 결과와 오류 메시지
- 프로젝트 규칙을 적어 둔
CLAUDE.md - 불러온 스킬이나 일부 메모리·도구 정보
이러한 정보는 작업에 도움이 되지만 한 번에 처리할 수 있는 공간은 무한하지 않습니다.
Claude Code 공식 문서는
/context를 실행하면 현재 컨텍스트 사용량을 색상 격자로 시각화하고, 어떤 항목이 공간을 차지하는지 확인하도록 돕는다고 설명합니다. 즉/context는 “AI가 얼마나 똑똑한가?”를 검사하는 명령이 아니라 “지금 이 작업 공간에 무엇이 들어 있는가?”를 살펴보는 도구입니다. 프로젝트에 저장된 모든 파일이 매번 통째로 컨텍스트에 들어가는 것은 아닙니다. 실제로 어떤 내용을 읽고 어떤 도구가 로드됐는지에 따라 구성은 달라집니다.
2. 사용법
Claude Code에서 /context를 입력하면 현재 컨텍스트 점유 상태를 살펴볼 수 있습니다.
Claude Code를 사용 중인 터미널이나 대화 입력창에서 명령을 메시지의 맨 앞에 입력합니다. 공식 문서에 따르면 색상이 있는 격자로 공간의 구성과 사용량을 시각화하고 최적화 제안을 표시합니다.
세부 항목이 접혀 있다면 /context all을 입력할 수 있습니다. 여기서 all은 표시 내역을 펼치는 옵션이지 모든 파일을 읽으라는 명령이 아닙니다. 일반 Claude 웹 채팅이나 ChatGPT에서 동일하게 작동하는 명령도 아닙니다.
실제 화면의 색상과 항목 이름은 설치 버전 및 실행 환경에 따라 달라질 수 있습니다. 이 글에서는 특정 계정에서 명령을 직접 실행하거나 스크린샷을 촬영하지 않았습니다.
3. 화면에 나온 정보를 어떻게 해석하나요?
/context를 보고 색이나 숫자가 많다고 무조건 문제가 발생한 것은 아닙니다. 무엇이 공간을 차지하는지와 지금 하려는 작업에 필요한지를 함께 판단해야 합니다.
가상의 홈페이지 프로젝트를 생각해 보겠습니다. 오전에는 홈페이지 파일을 여러 번 읽고, 오후에는 긴 빌드 로그를 확인하고, 저녁에는 버튼 하나만 바꾸려고 합니다.
이전 대화: 이미 끝난 작업의 질문과 답변이 현재 수정에 불필요할 수 있습니다.
파일과 코드 내용: 큰 파일을 많이 읽었다면 공간이 커질 수 있습니다.
필요한 파일을 정확히 지정하는 편이 좋습니다. 도구 출력: 터미널 명령, 긴 오류 로그, 파일 검색 결과가 누적될 수 있습니다. 오류 한 줄만 필요할 때 전체 로그를 반복해서 읽지 않는 것이 좋습니다. 프로젝트 지침·메모리·스킬: 유용하지만 지나치게 길거나 관련 없는 자료는 검토할 필요가 있습니다. Claude Code는 일부 도구 정보를 필요할 때 불러오는 최적화도 사용합니다. 도구를 연결했다는 이유만으로 모든 설명이 매번 전체 컨텍스트에 들어가는 것은 아닙니다. 비중이 큰 항목은 조사할 단서이지 실제 비용 증가나 오류 원인을 확정하는 증거는 아닙니다.
4. /context와 /usage는 무엇이 다른가요?
두 명령은 함께 알아두면 좋지만 확인하려는 대상이 다릅니다.
/context는 현재 대화 공간의 구성과 점유 상태를 살펴봅니다.
반면 /usage는 세션 비용, 사용량과 플랜 한도 등 계정·세션 관련 정보를 확인하는 명령입니다. 공식 문서는 활동 통계 등도 표시할 수 있다고 설명합니다.
| 비교 | /context | /usage |
|---|---|---|
| 무엇을 보나요? | 현재 대화 공간을 차지하는 정보 | 세션 비용·플랜 사용량·활동 통계 |
| 언제 유용한가요? | 긴 대화와 큰 파일·도구 출력 점검 | 한도나 비용 상태 확인 |
| 한도를 초기화하나요? | 아니요 | 아니요 |
6. 초보자용 사례: 홈페이지 작업이 길어졌을 때
다음은 교육용 가상 사례입니다. 실제 계정에서 명령을 실행해 측정한 결과가 아닙니다.
첫날에는 홈페이지 디자인을 만들고, 둘째 날에는 메뉴를 수정하고, 셋째 날에는 오류 로그를 여러 번 확인했습니다. 이제 모바일 버튼 하나만 수정하면 됩니다.
먼저 /context로 공간의 구성을 확인합니다. 긴 도구 출력이나 이전 대화가 많아 보인다면 지금 버튼 수정에 필요한지 살펴봅니다. 비중만으로 비용이나 오류의 원인을 확정하지는 않습니다.
이어서 다음과 같은 작업 기록을 별도 문서에 남깁니다.
목표: 모바일 메뉴 버튼 클릭 오류만 수정.유지: 기존 색상·광고 코드·내부 링크.완료: 데스크톱 디자인 확정.미완료: 모바일 동작 테스트.다음 단계: 관련 버튼 코드 확인 → 최소 수정 → 모바일 확인. 위 기록은 교육용 예시입니다. 실제 수정 파일과 테스트 결과는 해당 프로젝트에서 확인해야 합니다. 같은 홈페이지 작업을 계속할 예정이고 대화가 길어졌다면
/compact를 고려합니다. 완전히 다른 프로젝트라면 새 대화가 적절할 수 있습니다.그다음 AI에게 요청합니다. 지금은 모바일 메뉴 버튼만 확인해 줘. 관련 파일과 클릭 이벤트부터 살펴보고 다른 화면은 수정하지 마. 수정 후 어떤 테스트를 실제로 수행했고 무엇은 확인하지 못했는지 구분해 줘. 이 방법의 목적은 필요한 정보를 찾기 쉽게 하고 불필요한 재작업을 줄이는 것입니다. 모든 프로젝트에서 특정 비율만큼 토큰이 절약된다는 보장은 없습니다.
7. /context를 사용할 때 흔한 오해
오해 1.
/context를 실행하면 공간이 비워진다. 아닙니다. 현재 상태를 보는 명령입니다. 오해 2. 공간이 많이 찼다면 AI가 반드시 틀린다. 그렇지 않습니다. 지시 충돌, 불완전한 파일, 코드 오류 등 다른 원인도 확인해야 합니다. 오해 3. 점유율이 곧 결제 금액이다. 아닙니다. 비용과 사용량은 모델·요청·토큰 처리·캐싱·제품 정책 등 다른 요인에도 영향을 받습니다. 오해 4./context all은 프로젝트 전체를 읽는다.아닙니다. 공식 문서에서는 접힌 세부 항목을 펼쳐 보여주는 옵션이라고 설명합니다. 오해 5. 긴
CLAUDE.md는 무조건 삭제해야 한다. 아닙니다. 안전 규칙과 프로젝트 제약이 빠지면 오히려 잘못된 수정이 생길 수 있습니다. 핵심 규칙을 간결하게 유지하고, 자주 쓰지 않는 상세 자료는 필요할 때 읽도록 분리하는 방법을 검토하세요.8. /context를 확인한 뒤 AI에게 이렇게 요청해 보세요
지금 Claude Code 작업이 길어졌습니다.
/context결과에서 공간을 많이 차지하는 항목을 설명해 주세요. 어떤 정보가 이번 작업에 꼭 필요한지와 불필요할 가능성이 있는지를 구분해 주세요. 프로젝트 파일이나 기록을 삭제하지 말고, 정리가 필요하다면/compact또는 새 대화 중 무엇이 적절한지 이유와 함께 제안해 주세요. 중요한 결정과 미완료 작업은 먼저 문서에 남길 내용을 정리해 주세요. AI가 이 문장을 받았다고 해서 명령을 실제로 실행했다고 가정하면 안 됩니다. 실행 결과와 표시된 화면을 직접 확인해야 합니다. 작업 화면이나 로그를 공유할 때는 개인 식별 정보, 인증 정보, 내부 주소 등이 포함되지 않았는지 점검하세요.자주 묻는 질문(FAQ)
Q1. /context는 무료인가요?
/context는 Claude Code에 포함된 진단 명령입니다. 그러나 Claude Code 이용 자격, 구독 요금, API 사용량 및 실제 과금 조건은 계정과 이용 방식에 따라 달라질 수 있습니다. 명령이 존재한다는 사실만으로 모든 사용이 무료라는 뜻은 아닙니다.Q2. /context를 보면 남은 토큰을 정확히 알 수 있나요?
현재 컨텍스트의 점유 상태를 파악하는 데 도움이 됩니다. 그러나 그 값을 구독 플랜의 남은 사용량이나 다음 요청의 정확한 비용으로 해석하면 안 됩니다. 사용량 한도는
/usage에서 별도로 확인하세요.Q3. Claude 웹사이트에서도 /context를 입력하면 되나요?
이 글에서 설명한 명령은 Claude Code 전용입니다. 일반 웹 채팅과 동일하다고 가정하지 마세요.
Q4. /context를 실행하면 프로젝트 코드가 변경되나요?
명령 자체는 컨텍스트 사용량을 살펴보는 진단 기능입니다. 코드를 수정하거나 파일을 삭제하라는 명령이 아닙니다.
Q5. /compact를 하면 원래 대화가 완전히 보존되나요?
아닙니다. 요약 과정에서 세부 정보가 빠질 수 있습니다. 정확한 파일 이름, 결정 사항, 검증 결과는 프로젝트 문서에 별도로 보존하는 편이 좋습니다.
Q6. /context all을 쓰면 더 많은 공간을 사용하게 되나요?
공식 문서에서
all은 접힌 항목별 내역을 펼쳐 보는 옵션으로 설명합니다. 프로젝트 파일을 모두 추가로 읽으라는 의미가 아닙니다. 실제 명령 실행의 내부 처리 비용을 이 글에서 실측한 것은 아닙니다.Q7. 도구나 메모리가 많이 보이면 모두 꺼야 하나요?
그럴 필요는 없습니다. 중요한 프로젝트 규칙과 필수 도구가 있을 수 있습니다. 먼저 어떤 정보가 필요한지 살펴보고, 사용하지 않는 연결이나 지나치게 긴 참고자료가 있는지 검토하세요.
마무리: /context는 AI 작업 공간을 살펴보는 점검창입니다
Claude Code로 긴 작업을 할 때 중요한 것은 무조건 모든 내용을 지우거나 모든 파일을 다시 읽는 것이 아닙니다.
/context로 현재 공간을 확인하고 → 필요한 정보와 불필요한 정보를 구분하고 → 작업에 맞게 범위를 좁히거나/compact·/clear를 선택하면 됩니다. 오늘 한 가지를 기억한다면 이것입니다./context는 사용량을 초기화하는 명령이 아니라, 현재 AI 대화 공간이 무엇으로 채워져 있는지 확인하는 명령입니다. 이 차이를 알면 AI가 긴 대화에서 엉뚱한 답을 할 때 무조건 모델을 바꾸기보다 작업 환경과 제공된 정보를 먼저 점검할 수 있습니다.
함께 읽으면 좋은 글
- AI 컨텍스트란? ChatGPT가 내 말을 이해하고 잊어버리는 이유 — AI 대화 맥락의 일반 개념을 먼저 확인합니다.
- AI 컨텍스트 윈도우란? 긴 대화에서 내용을 놓치는 이유와 해결법 — 대화가 참고할 수 있는 제한된 정보 공간도 함께 알아봅니다.