/context의 역할
/context는 현재 세션의 컨텍스트 창에 있는 모든 항목의 분석 내용을 출력합니다. Anthropic의 명령 개요에서는 그 목적을 명확하게 설명합니다: "대화가 길어지면 /context는 창을 채우고 있는 항목을 보여주고, /compact는 이를 요약하여 공간을 확보합니다."
출력 결과는 세 부분으로 구성됩니다:
- 색상 그리드: 카테고리별로 창이 얼마나 찼는지 보여줍니다.
- 상세 분석: 각 카테고리와 그 내용을 나열합니다.
- 제안 및 경고: 명령 참조 가이드에 따르면 "컨텍스트 집약적인 도구, memory 비대화에 대한 최적화 제안 및 용량 경고를 표시"합니다.
이 명령은 Claude Code를 실행하는 어디에서나 작동합니다. 터미널에서는 슬래시 명령어로 사용하며, Claude Desktop 앱의 경우 Anthropic은 "프롬프트 박스에 /context를 입력하여 채팅창에 이 세션의 컨텍스트 창 카테고리별 분석 내용을 출력할 수 있다"고 설명합니다.
/context all
전체 화면 모드에서 /context는 그리드가 계속 보이도록 항목별 상세 분석을 축소합니다. all을 추가하면 이를 확장합니다. Anthropic의 기능 개요에서는 MCP 서버에 대해서도 언급합니다: "로드된 각 MCP 도구가 사용하는 토큰 수를 확인하려면 /context all을 실행하세요."
분석 내용 읽는 법
Anthropic의 구성 문제 해결 가이드에는 다음과 같은 카테고리가 나열되어 있습니다: "system prompt, system tools, MCP tools, 로드된 소스가 포함된 custom subagents, memory files, skills, 그리고 conversation messages." 각 항목은 서로 다른 정보를 제공합니다.
System prompt 및 system tools
이것들은 Claude Code 자체의 지침과 내장 도구들입니다. 모든 세션에 존재하며, 사용자가 아무것도 입력하기 전부터 세션이 사용하는 기본 공간을 차지합니다.
MCP tools
이 행은 연결된 MCP 서버의 도구들을 보여줍니다. MCP 도구 정의는 기본적으로 지연 로드(deferred)됩니다. Anthropic의 설명에 따르면 "Claude가 특정 도구를 사용하기 전까지는 도구 이름과 서버 지침만 컨텍스트를 소비"합니다. (deferred) 또는 (loaded on-demand)라고 표시된 도구들을 볼 수 있는데, 이는 작업에 필요할 때 전체 정의가 로드됨을 의미합니다.
이 카테고리가 크다면 /context all을 통해 어떤 서버의 도구가 공간을 차지하는지 확인할 수 있습니다. Anthropic은 창이 붐빌 때 사용하지 않는 서버를 비활성화하여 컨텍스트에서 도구 정의를 제거할 것을 권장합니다.
Custom subagents
정의한 subagents와 각 subagents가 로드된 소스가 여기에 표시됩니다. 두 정의의 이름이 같거나 프로젝트 수준과 사용자 수준의 에이전트가 겹칠 때 이 소스 정보가 중요합니다.
Memory files
규칙이 지켜지지 않을 때 확인해야 할 카테고리입니다. 이 세션에 로드된 CLAUDE.md 파일과 auto memory 목록이 표시됩니다. Anthropic의 컨텍스트 창 가이드에 따르면 /context는 "로드된 CLAUDE.md 및 auto memory 파일을 포함하여 최적화 제안과 함께 카테고리별 실시간 분석"을 제공합니다.
이를 통해 한 가지 질문에 답할 수 있습니다: 예상한 파일이 실제로 로드되었는가? 프로젝트 루트의 CLAUDE.md, 사용자 수준의 CLAUDE.md 또는 CLAUDE.local.md가 목록에 없다면, 파일 내용에 관계없이 Claude는 현재 세션에서 해당 파일을 읽지 않고 있는 것입니다.
Skills
skills 섹션은 컨텍스트 내의 skill 설명을 보여줍니다. 이는 skills 명령보다 범위가 넓습니다. Anthropic은 이 섹션에 "/skills 목록에는 없는 번들형(bundled) skills도 포함된다"고 명시합니다. skill 본문은 호출될 때 로드되지만, 설명은 처음부터 컨텍스트에 상주합니다.
Messages
사용자의 프롬프트, Claude의 응답, Claude가 읽은 파일 내용, 명령 출력 등 대화 내용입니다. 긴 세션에서는 작업이 진행됨에 따라 계속 커지는 카테고리입니다. 세션 중에 로드되는 경로 범위 규칙(path-scoped rules)과 하위 디렉토리 CLAUDE.md 파일도 메시지 기록의 일부로 여기에 추가됩니다.
/context를 사용하여 memory 파일 확인하기
규칙이 지켜지지 않을 때, Anthropic의 문제 해결 가이드는 다음 순서를 제시합니다: 파일이 로드되었는지 확인한 다음, 어떻게 작성되었는지 검토하세요.
파일이 목록에 없는 경우
파일의 위치를 확인하세요. 모든 CLAUDE.md가 세션 시작 시 로드되는 것은 아닙니다. Anthropic의 memory 문서에 따르면 "작업 디렉토리 상위 계층에 있는 CLAUDE.md 및 CLAUDE.local.md 파일은 실행 시 로드되지만, 하위 디렉토리의 파일은 필요할 때 로드(on demand)"됩니다.
따라서 하위 디렉토리 파일이 목록에 없다고 해서 반드시 문제가 있는 것은 아닙니다. 문제 해결 가이드에서도 "하위 디렉토리 CLAUDE.md 파일은 세션 시작 시가 아니라 필요할 때 로드되므로 분석 내용에 나타나지 않는다"고 직접적으로 언급합니다. Claude Code는 Claude가 해당 하위 디렉토리의 다른 파일을 읽거나 쓰거나 수정할 때 이를 로드합니다. 하위 디렉토리 CLAUDE.md 제한 가이드에서 이러한 파일이 로드될 때의 제한 사항을 확인할 수 있습니다.
규칙(Rules)도 같은 방식으로 작동합니다. paths 프런트매터가 없는 규칙은 실행 시 로드됩니다. 경로 범위 규칙은 Claude가 일치하는 파일로 작업할 때 로드되므로, 그 전까지는 목록에 표시되지 않습니다. Claude Code 규칙 가이드에서 paths가 규칙 로드 시점을 어떻게 결정하는지 설명합니다.
AGENTS.md를 사용하는 경우 여기에서도 확인하세요. Claude Code는 특정 구성에서만 이를 읽습니다. Claude Code의 AGENTS.md 지원 가이드에서 어떤 파일이 이를 비활성화하는지 다룹니다.
파일이 목록에 있지만 무시되는 경우
이 경우 로딩은 문제가 아닙니다. Anthropic 가이드는 다음과 같이 설명합니다: "/context를 통해 파일이 로드된 것이 확인되었음에도 Claude가 특정 지침을 따르지 않는다면, 문제는 로드 여부가 아니라 지침이 작성된 방식일 가능성이 높습니다."
일반적인 원인으로는 지침이 "여러 가지로 해석될 만큼 모호함", 두 파일의 지침이 충돌함, 또는 파일이 "너무 길어서 개별 규칙에 대한 주의력이 떨어짐" 등이 있습니다. memory 문서의 크기 권장 사항은 "CLAUDE.md 파일당 200행 미만"입니다. 두 레이어가 충돌하는 경우, 충돌하는 CLAUDE.md 레이어 조정 가이드를 통해 충돌을 찾아 해결하는 방법을 알아보세요.
Auto memory
Auto memory도 memory files 아래에 표시되며 자체적인 제한이 있습니다. Anthropic은 "MEMORY.md의 처음 200행 또는 처음 25KB 중 먼저 도달하는 기준까지 모든 대화 시작 시 로드된다"고 설명합니다. 그 지점을 넘어서는 내용은 세션 시작 시 로드되지 않습니다. Claude Code auto memory 가이드에서 해당 파일의 위치와 관리 방법을 확인할 수 있습니다.
후속 명령어들
/context는 창에 무엇이 있는지 알려줍니다. 각 카테고리에 대한 세부 사항은 다른 명령어를 통해 확인할 수 있습니다. Anthropic의 문제 해결 가이드는 이들을 다음과 같이 짝지어 설명합니다:
/memory: 사용자 및 프로젝트 범위의 memory 파일 위치를 보여주고, 각 파일을 열 수 있게 하며, auto memory 폴더 및 토글에 대한 접근 권한을 제공합니다./skills: 프로젝트, 사용자 및 플러그인 소스에서 사용 가능한 skills를 나열합니다./mcp: 연결된 MCP 서버와 그 상태를 보여줍니다./doctor: 설정 점검을 실행합니다. Anthropic은 이것이 "너무 큰 memory 파일과 사용되지 않는 확장 프로그램을 찾아낸다"고 언급합니다./status: 관리형 설정을 포함하여 활성 설정 소스를 보여줍니다.
컨텍스트 창이 가득 찼을 때
/context는 창이 얼마나 찼는지 보여주고, 한도를 초과하면 경고를 보냅니다.
한도 초과 경고
Anthropic의 오류 참조 가이드에 따르면, 대화가 모델의 컨텍스트 창을 초과하면 /context 출력 상단에 경고가 표시됩니다. 이 경고는 얼마나 초과했는지와 공간을 확보할 수 있는 명령어를 알려줍니다. 조치를 취하기 전까지는 프롬프트가 너무 길다는 오류와 함께 요청이 실패합니다.
1M 창을 가진 모델의 경우, 경고가 전체 컨텍스트 창이 아닌 압축(compaction) 창을 의미할 수도 있습니다. Anthropic은 "압축 창은 모델의 컨텍스트 창보다 낮게 설정될 수 있으므로, 이를 초과한 요청도 여전히 성공할 수 있다"고 설명합니다.
공간 확보 방법
Anthropic이 제안하는 방법은 변화의 크기 순으로 다음과 같습니다:
/compact: 이전 대화 내용을 요약하여 세션을 유지하면서 공간을 확보합니다./clear: 새로운 대화를 시작합니다. /clear 가이드에서 무엇이 유지되는지 확인하세요.- 사용하지 않는 MCP 서버 비활성화:
/mcp disable을 사용하여 도구 정의를 제거합니다. - 큰 CLAUDE.md 파일 정리: 또는 지침을 관련이 있을 때만 로드되는 경로 범위 규칙으로 이동합니다.
압축 후 복구되는 항목
압축은 메시지 카테고리를 변경하며, 일부 memory 파일은 자동으로 다시 로드됩니다. Anthropic의 컨텍스트 창 가이드에 나열된 내용은 다음과 같습니다: 프로젝트 루트의 CLAUDE.md, 범위가 지정되지 않은 규칙, auto memory는 "디스크에서 다시 주입(Re-injected)"됩니다. 경로 범위 규칙과 중첩된 CLAUDE.md 파일은 필요할 때 다시 로드됩니다. 압축 직후 /context를 확인했을 때 메시지 카테고리는 줄어들었지만 memory 파일은 그대로 남아 있는 이유를 아는 것이 중요합니다.
/context와 유사한 명령어 비교
여러 명령어가 세션을 서로 다른 각도에서 살펴봅니다:
/context: 창에 무엇이 있는지, 각 카테고리가 얼마나 많은 공간을 사용하는지 보여줍니다./memory: memory 파일 자체를 열고 편집합니다./compact: 요약을 통해 창의 내용을 줄입니다./doctor: 너무 큰 memory 파일을 포함하여 설정 문제를 확인합니다./btw: 창에 내용을 추가하지 않고 부수적인 질문을 합니다.
사람들이 흔히 하는 실수
파일이 존재한다는 이유로 CLAUDE.md가 로드되었다고 가정하는 것. 존재와 로드는 다릅니다. /context는 이 세션에 실제로 포함된 내용을 보여줍니다.
누락된 하위 디렉토리 파일을 버그로 취급하는 것. 이들은 Claude가 해당 폴더의 파일로 작업할 때 필요에 따라 로드됩니다.
규칙이 무시될 때 더 많은 규칙을 추가하는 것. /context에서 파일이 로드된 것으로 확인된다면, 문제는 문구, 충돌 또는 길이일 가능성이 높습니다. 규칙을 더 추가하면 길이 문제만 악화됩니다.
압축으로 충분할 때 대화를 초기화하는 것. /clear는 새로 시작하지만, /compact는 세션을 유지하며 공간을 확보합니다.
MCP 행을 무시하는 것. 도구가 많은 몇 개의 서버가 창의 상당 부분을 차지할 수 있습니다. /context all로 확인하세요.
해결책: /context를 설정 확인의 일부로 만들기
1단계: 중요한 세션 시작 시 /context 실행
긴 작업을 시작하기 전에 /context를 실행하고 memory files 카테고리를 읽으세요. 예상한 CLAUDE.md 파일과 규칙이 나열되어 있는지 확인하세요. 하나라도 빠져 있다면 수정하기 전에 파일 위치를 확인하세요.
2단계: 증상이 아닌 원인 해결
파일이 로드되었는데도 Claude가 규칙을 놓친다면, 규칙을 구체적으로 다시 작성하고, 레이어 간의 충돌을 해결하며, 각 CLAUDE.md를 짧게 유지하세요. 코드베이스의 일부에만 해당하는 지침은 경로 범위 규칙으로 옮기세요.
3단계: 작업을 위한 창 공간 유지
긴 세션 동안 속도가 느려지면 /context를 확인하세요. 사용하지 않는 MCP 서버를 비활성화하고, 자연스러운 중단점에서 압축하며, 관련 없는 작업 사이에는 대화를 초기화하세요.
MemoryLake에서 설정하기
/context는 하나의 머신, 하나의 저장소에서 하나의 세션이 로드한 내용을 보여줍니다. 하지만 여러분에게 필요한 정보 중 일부는 이들 중 어디에도 얽매여 있지 않습니다. 여러 저장소에 걸쳐 적용되는 결정, 모든 어시스턴트에게 적용하고 싶은 선호도, 모든 CLAUDE.md에서 반복하고 싶지 않은 사실들이 바로 그것입니다.
MemoryLake는 이러한 정보들을 하나의 목록으로 유지하고, Claude Code뿐만 아니라 ChatGPT, Codex 등 연결된 다른 어시스턴트에서도 사용할 수 있게 해주는 memory 레이어입니다.
항목은 여러분이 직접 자신의 언어로 작성합니다. 여러분의 CLAUDE.md 파일, 규칙, auto memory, Claude Code 세션 또는 어떤 벤더의 저장소에서도 내용을 읽거나 쓰거나 삭제하지 않습니다. /context는 Anthropic이 설명한 방식 그대로 계속 작동합니다.
1단계: API 키 생성
로그인 후 대시보드에서 키를 생성하세요. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.
2단계: 첫 번째 memory 업로드
해결책 2단계에서 CLAUDE.md 파일마다 반복했던 사실들부터 시작하세요. 단일 저장소를 넘어 적용되는 결정, 컨벤션, 제약 사항 등을 입력하세요. 항목당 하나의 포인트를 날짜와 함께 작성합니다.
3단계: AI 및 에이전트 연결
Claude Code와 사용하는 다른 어시스턴트들을 연결하세요. 입력한 사실들은 다음 세션, 다른 저장소, 그리고 다른 도구에서도 즉시 사용할 수 있습니다.
실제로 바뀌는 점
첫 번째 차이점은 추측을 멈추게 된다는 것입니다. 지켜지지 않는 규칙은 분석 내용에서 누락되었거나, 존재하지만 문구가 잘못된 것입니다. /context는 이 중 무엇인지 알려줍니다.
두 번째는 공간이 어디에 쓰이는지 알게 된다는 것입니다. MCP 도구, memory 파일, 메시지 각각에 수치가 표시되므로, 모든 것을 지우는 대신 무거운 부분만 다듬을 수 있습니다.
세 번째는 지침 파일이 짧아진다는 것입니다. 프로젝트 간 공통 사실이 다른 곳에 저장되면, 각 CLAUDE.md는 해당 저장소 자체에만 집중할 수 있습니다.
Claude Code의 /context 모범 사례
긴 작업을 하기 전에 실행하세요. 예상한 memory 파일이 나열되어 있는지 확인하세요.
규칙이 무시될 때 memory 파일을 먼저 확인하세요. 그 다음 문구와 충돌을 확인하세요.
필요 시 로드(On-demand loading)를 기억하세요. 하위 디렉토리 CLAUDE.md와 경로 범위 규칙은 Claude가 일치하는 파일로 작업한 후에 나타납니다.
MCP 세부 정보를 보려면 /context all을 사용하세요. 도구당 토큰 수를 보여줍니다.
경고 라인을 읽으세요. 공간을 확보하는 명령어를 알려줍니다.
/memory 및 /doctor와 함께 사용하세요. 하나는 무엇이 로드되었는지 보여주고, 나머지는 파일을 열거나 너무 큰 파일을 찾아냅니다.
CLAUDE.md를 짧게 유지하세요. Anthropic의 목표치는 파일당 200행 미만입니다.
결론
/context는 Claude Code 세션의 컨텍스트 창에 있는 모든 항목을 system prompt, system tools, MCP tools, custom subagents, memory files, skills, messages 카테고리별로 나누어 보여줍니다. 규칙이 지켜지지 않을 때 가장 먼저 실행해야 할 명령어인데, 이는 파일이 실제로 로드되었는지 여부를 알려주기 때문입니다.
파일이 누락되었다면 하위 디렉토리 파일과 경로 범위 규칙은 필요할 때 로드되므로 파일 위치를 확인하세요. 파일이 존재하는데 무시된다면 문구를 검토하세요. 그리고 창이 가득 찼을 때 /context는 공간이 어디에 사용되었는지와 어떤 명령어로 공간을 확보할 수 있는지 보여줍니다.