Claude Code Desktop 세션 관리하기
각 세션은 자신의 컨텍스트와 변경 사항을 가진 독립적인 대화입니다. 여러 세션을 병렬로 실행하거나, 사이드 채팅을 분기하거나, 작업을 클라우드로 보내거나, Dispatch가 휴대폰에서 세션을 시작하도록 할 수 있습니다.
세션으로 병렬 작업하기
사이드바에서 + New session 을 클릭하거나 macOS에서 Cmd+N 을 누르거나 Windows에서 Ctrl+N 을 눌러 여러 작업을 병렬로 작업합니다. Ctrl+Tab 및 Ctrl+Shift+Tab 을 눌러 사이드바의 세션을 순환합니다. Git 저장소의 경우 각 세션은 Git worktrees를 사용하여 프로젝트의 자신의 격리된 복사본을 가져오므로 한 세션의 변경 사항이 커밋할 때까지 다른 세션에 영향을 주지 않습니다.
두 세션을 동시에 보려면 macOS에서 Cmd 를 누르거나 Windows에서 Ctrl 을 누르고 사이드바의 세션을 클릭합니다. 세션이 이미 열려 있는 창 옆에 두 번째 창에서 열립니다. 분할이 활성화되어 있는 동안 다른 사이드바 세션을 클릭하면 포커스가 있는 창을 바꿉니다. macOS에서 Cmd+\ 를 누르거나 Windows에서 Ctrl+\ 를 눌러 포커스된 창을 닫고 단일 세션으로 돌아갑니다.
Worktrees는 기본적으로 <project-root>/.claude/worktrees/에 저장됩니다. Settings → Claude Code의 "Worktree location"에서 사용자 정의 디렉토리로 변경할 수 있습니다. 또한 모든 worktree 브랜치 이름 앞에 추가되는 브랜치 접두사를 설정할 수 있으며, 이는 Claude가 만든 브랜치를 정리하는 데 유용합니다. 완료되면 사이드바의 세션 위에 마우스를 올리고 아카이브 아이콘을 클릭하여 worktree를 제거합니다. PR이 병합되거나 닫힌 후 세션이 자동으로 아카이브되도록 하려면 Settings → Claude Code에서 Auto-archive after PR merge or close 를 켭니다. 자동 아카이브는 실행을 완료한 로컬 세션에만 적용됩니다.
gitignored 파일 (예: .env)을 새 worktrees에 포함하려면 프로젝트 루트에 .worktreeinclude 파일을 만듭니다.
세션 격리에는 Git이 필요합니다. 대부분의 Mac에는 기본적으로 Git이 포함되어 있습니다. Terminal에서 git --version을 실행하여 확인합니다. Windows에서는 Code 탭이 작동하려면 Git이 필요합니다: Windows용 Git 다운로드, 설치 및 앱 재시작. Git 오류가 발생하면 Cowork 탭에서 Claude에게 설정을 문제 해결하도록 요청하세요.
사이드바 상단의 컨트롤을 사용하여 상태, 프로젝트 또는 환경별로 세션을 필터링하고 프로젝트별로 세션을 그룹화합니다. 세션 이름을 바꾸려면 활성 세션 상단의 도구 모음에서 세션 제목을 클릭합니다. 컨텍스트 사용량을 확인하려면 사용량 확인을 참조하세요. 컨텍스트가 가득 차면 Claude는 자동으로 대화를 요약하고 계속 작업합니다. /compact를 입력하여 요약을 더 일찍 트리거하고 컨텍스트 공간을 확보할 수도 있습니다. 컨텍스트 윈도우에서 압축이 작동하는 방식에 대한 자세한 내용을 참조하세요.
데스크톱 앱은 Code 세션이 작업을 완료하고 현재 해당 세션을 보고 있지 않을 때 OS 알림을 보냅니다.
세션을 벗어나지 않고 옆 질문 하기
사이드 채팅을 사용하면 세션의 컨텍스트를 사용하지만 메인 대화에 아무것도 추가하지 않고 Claude에게 질문할 수 있습니다. 코드 조각을 이해하거나, 가정을 확인하거나, 세션을 벗어나지 않고 아이디어를 탐색하려고 할 때 사용합니다.
macOS에서 Cmd+; 를 누르거나 Windows에서 Ctrl+; 를 누르거나 프롬프트 상자에 /btw를 입력하여 사이드 채팅을 엽니다. 사이드 채팅은 그 지점까지 메인 스레드의 모든 것을 읽을 수 있습니다. 완료되면 사이드 채팅을 닫고 중단한 곳에서 메인 세션을 계속합니다. 사이드 채팅은 로컬 및 SSH 세션에서 사용 가능합니다.
백그라운드 작업 보기
작업 패널은 현재 세션 내에서 실행 중인 백그라운드 작업을 표시합니다: 서브에이전트, 백그라운드 셸 명령, 워크플로우. Views 메뉴에서 열거나 레이아웃으로 드래그합니다.
모든 항목을 클릭하여 서브에이전트 패널에서 출력을 보거나 중지합니다. 다른 세션이 수행하는 작업을 보려면 사이드바를 사용합니다.
원격으로 장기 실행 작업 실행하기
대규모 리팩토링, 테스트 스위트, 마이그레이션 또는 기타 장기 실행 작업의 경우 세션을 시작할 때 Local 대신 Remote 를 선택합니다. 원격 세션은 Anthropic의 클라우드 인프라에서 실행되며 앱을 닫거나 컴퓨터를 종료해도 계속됩니다. 언제든지 돌아와서 진행 상황을 보거나 Claude를 다른 방향으로 조종할 수 있습니다. claude.ai/code에서 또는 Claude iOS 앱에서 원격 세션을 모니터링할 수도 있습니다.
원격 세션은 또한 여러 저장소를 지원합니다. 클라우드 환경을 선택한 후 저장소 pill 옆의 + 버튼을 클릭하여 세션에 추가 저장소를 추가합니다. 각 저장소는 자신의 브랜치 선택기를 가집니다. 이는 공유 라이브러리와 그 소비자를 업데이트하는 것과 같이 여러 코드베이스에 걸친 작업에 유용합니다.
원격 세션이 작동하는 방식에 대한 자세한 내용은 웹의 Claude Code를 참조하세요.
다른 표면에서 계속하기
세션 도구 모음의 오른쪽 아래에 있는 VS Code 아이콘에서 액세스할 수 있는 Continue in 메뉴를 사용하면 세션을 다른 표면으로 이동할 수 있습니다:
- Claude Code on the Web: 로컬 세션을 원격으로 계속 실행하도록 보냅니다. Desktop은 브랜치를 푸시하고, 대화 요약을 생성하고, 전체 컨텍스트를 사용하여 새 원격 세션을 만듭니다. 그 후 로컬 세션을 아카이브하거나 유지하도록 선택할 수 있습니다. 이는 깨끗한 작업 트리가 필요하며 SSH 세션에는 사용할 수 없습니다.
- Your IDE: 현재 작업 디렉토리에서 지원되는 IDE에서 프로젝트를 엽니다.
Dispatch에서 세션
Dispatch는 Cowork 탭에 있는 Claude와의 지속적인 대화입니다. Dispatch에 작업을 메시지하면 처리 방법을 결정합니다.
작업은 두 가지 방법으로 Code 세션이 될 수 있습니다: 직접 요청하는 경우 (예: "Claude Code 세션을 열고 로그인 버그를 수정하세요") 또는 Dispatch가 작업이 개발 작업이라고 결정하고 자동으로 하나를 생성하는 경우입니다. 일반적으로 Code로 라우팅되는 작업에는 버그 수정, 종속성 업데이트, 테스트 실행 또는 pull request 열기가 포함됩니다. 연구, 문서 편집, 스프레드시트 작업은 Cowork에 남아 있습니다.
어느 쪽이든 Code 세션은 Dispatch 배지가 있는 Code 탭의 사이드바에 나타납니다. 완료되거나 승인이 필요할 때 휴대폰에서 푸시 알림을 받습니다.
컴퓨터 사용이 활성화되어 있으면 Dispatch 생성 Code 세션도 사용할 수 있습니다. 이러한 세션의 앱 승인은 30분 후 만료되고 다시 프롬프트하며, 일반 Code 세션처럼 전체 세션 동안 지속되지 않습니다.
설정, 페어링, Dispatch 설정은 Dispatch 도움말 문서를 참조하세요. Dispatch는 Pro 또는 Max 계획이 필요하며 Team 또는 Enterprise 계획에서는 사용할 수 없습니다.
Dispatch는 터미널에서 멀리 떨어져 있을 때 Claude와 작업하는 여러 방법 중 하나입니다. 플랫폼 및 통합을 참조하여 Remote Control, Channels, Slack, 예약된 작업과 비교하세요.