[공식문서읽기] Claude Code 세션 관리 완벽 가이드: 세션 활용하기, 컨텍스트

Claude Code를 효과적으로 사용하려면 세션 관리 방법을 이해해야 합니다. 이번 글에서는 Claude가 무엇에 접근할 수 있는지, 세션을 어떻게 관리하는지 자세히 알아보겠습니다.

 

 

세션의 특성

 

중요: Claude Code는 세션 간에 지속적인 메모리가 없습니다.

• 각 새 세션은 처음부터 시작
• 시간이 지나도 선호도를 "학습"하지 않음
• 지난주 작업을 기억하지 않음

세션 간에 무언가를 기억하게 하려면 CLAUDE.md에 저장하세요.

브랜치 간 작업하기

각 Claude Code 대화는 현재 디렉토리에 연결된 세션입니다.

브랜치 전환 시 동작

• Claude는 새 브랜치의 파일을 봄
• 대화 기록은 동일하게 유지
• 전환 후에도 이전에 논의한 내용을 기억

병렬 세션 실행

git worktrees를 사용하면 개별 브랜치에 대한 별도 디렉토리를 생성하여 병렬로 Claude 세션을 실행할 수 있습니다.

세션 재개와 포크

세션 재개 (Resume)

claude --continue
# 또는
claude --resume

• 동일한 세션 ID 사용
• 중단한 지점부터 계속
• 새 메시지는 기존 대화에 추가
• 전체 대화 기록 복원
• 주의: 세션 범위 권한은 복원되지 않음 (다시 승인 필요)

세션 포크 (Fork)

claude --continue --fork-session

원본 세션에 영향을 주지 않고 다른 접근 방식을 시도하고 싶을 때 사용합니다:

• 새 세션 ID 생성
• 대화 기록은 보존
• 원본 세션은 변경되지 않음

여러 터미널에서 동일한 세션

여러 터미널에서 동일한 세션을 재개하면:

• 두 터미널 모두 동일한 세션 파일에 씀
• 두 터미널의 메시지가 인터리브됨
• 아무것도 손상되지 않지만 대화가 뒤섞임

권장: 동일한 시작점에서 병렬 작업을 하려면 --fork-session을 사용하세요.

세션 id 얻기

참고로 세션 id는 /status 명령을 통해 얻을 수 있습니다.

 

컨텍스트 윈도우 이해하기

Claude의 컨텍스트 윈도우에는 다음이 포함됩니다:

• 대화 기록
• 파일 콘텐츠
• 명령 출력
• CLAUDE.md 내용
• 로드된 skills
• 시스템 지침

컨텍스트가 채워질 때

Claude Code는 한계에 접근하면 자동으로 관리합니다:

1. 먼저 이전 도구 출력을 지움
2. 필요하면 대화를 요약
3. 사용자 요청과 주요 코드 스니펫은 보존
4. 대화 초반의 상세한 지침은 손실될 수 있음

팁: 지속적인 규칙은 대화 기록보다 CLAUDE.md에 저장하세요.

컨텍스트 관리 명령어

/context 명령

공간을 무엇이 사용하는지 확인합니다. MCP 서버가 상당한 컨텍스트를 소비할 수 있으니 /mcp로 서버별 비용을 확인하세요.

/compact 명령

포커스를 지정하여 압축할 수 있습니다:

/compact focus on the API changes

Skills와 Subagents로 컨텍스트 관리

Skills

• Claude Code
• 세션 관리
• 컨텍스트 윈도우
• git worktree
• 개발 도구
• 필요에 따라 로드됨
• 세션 시작 시 설명만 보임
• 전체 콘텐츠는 사용될 때만 로드

Subagents

• 주 대화와 완전히 분리된 컨텍스트
• 작업이 컨텍스트를 부풀리지 않음
• 완료되면 요약만 반환

이 격리 덕분에 긴 세션에서 subagents가 특히 유용합니다.

마무리

Claude Code의 세션 관리를 이해하면 더 효율적으로 작업할 수 있습니다. 세션 재개와 포크를 적절히 활용하고, 컨텍스트 윈도우를 잘 관리하면 복잡한 프로젝트도 원활하게 진행할 수 있습니다.

다음 글에서는 Claude Code를 안전하고 효과적으로 사용하는 방법에 대해 알아보겠습니다.

---

출처: https://code.claude.com/docs/ko/how-claude-code-works

 

태그: Claude Code, 세션 관리, 컨텍스트 윈도우, 개발 도구

카테고리: 개발 도구