CLAUDE.md
- Claude가 매 세션마다 보는 지속적인 컨텍스트를 추가합니다
컨텍스트 윈도우
- Claude의 컨텍스트 윈도우는 대화 기록, 파일 콘텐츠, 명령 출력, CLAUDE.md, 로드된 skills, 시스템 지침을 보유합니다.
- 작업하면서 컨텍스트가 채워집니다.
- Claude는 자동으로 압축하지만, 대화 초반의 지침이 손실될 수 있습니다.
- 지속적인 규칙을 CLAUDE.md에 넣고, /context를 실행하여 공간을 사용하는 것을 확인하세요.
컨텍스트가 채워질 때
- Claude Code는 한계에 접근할 때 컨텍스트를 자동으로 관리합니다.
- 먼저 이전 도구 출력을 지우고, 필요하면 대화를 요약합니다.
- 사용자의 요청과 주요 코드 스니펫은 보존되고, 대화 초반의 상세한 지침은 손실될 수 있습니다.
- 대화 기록에 의존하기보다는 지속적인 규칙을 CLAUDE.md에 넣으세요.
- 압축 중에 보존되는 것을 제어하려면,
- CLAUDE.md에 “Compact Instructions” 섹션을 추가하거나
- /compact를 포커스와 함께 실행하세요 (예: /compact focus on the API changes).
- /context를 실행하여 공간을 사용하는 것을 확인하세요.
- MCP servers는 모든 요청에 도구 정의를 추가하므로, 몇 개의 서버가 작업을 시작하기 전에 상당한 컨텍스트를 소비할 수 있습니다.
- /mcp를 실행하여 서버별 비용을 확인하세요.
skills
- 재사용 가능한 지식과 호출 가능한 워크플로우를 추가합니다.
- skill은 지식, 워크플로우 또는 지침을 포함하는 마크다운 파일입니다.
- /deploy와 같은 슬래시 명령으로 skill을 호출하거나, Claude가 관련이 있을 때 자동으로 로드할 수 있습니다.
- Skill은 현재 대화에서 실행되거나 subagents를 통해 격리된 컨텍스트에서 실행될 수 있습니다.
- Skills는 필요에 따라 로드됩니다.
- Claude는 세션 시작 시 skill 설명을 보지만, 전체 콘텐츠는 skill이 사용될 때만 로드됩니다.
- 수동으로 호출하는 skills의 경우, disable-model-invocation: true를 설정하여 필요할 때까지 설명을 컨텍스트 밖으로 유지하세요.
subagents
- 격리된 컨텍스트에서 자신의 루프를 실행하고 요약을 반환합니다
MCP
- Claude를 외부 서비스 및 도구에 연결합니다