Cmd. /desktop
현재 터미널 세션을 Claude Code Desktop 앱으로 넘겨서 이어 진행하는 플랫폼 명령
핵심 요약
- 현재 session을 Claude Code Desktop으로 이동 (
/app) - 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
현재 session을 Claude Code Desktop으로 이동 (/app)
/desktop사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | /app |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/desktop/app명령은 메시지 맨 앞에서만 인식되며, 별도 인자는 받지 않습니다.
선택 시점
- 터미널에서 작업을 시작한 뒤 시각적인 검토가 필요할 때 desktop 앱으로 세션을 넘겨 이어 보기
- 이미지·긴 결과·diff 리뷰처럼 GUI가 더 편한 작업을 desktop 환경에서 마무리
- 병렬 세션, 드래그 앤 드롭 페인 레이아웃 등 desktop 전용 기능을 활용하려고 세션을 이관
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/desktop (/app) | 현재 CLI 세션을 desktop 앱으로 넘기고 CLI 종료 | 같은 세션을 desktop UI에서 계속 |
/remote-control (/rc) | 이 로컬 세션을 claude.ai에서 원격 제어 가능하게 공개 | 다른 기기에서 로컬 세션 제어 |
/teleport (/tp) | 웹(Claude Code on the web) 세션을 터미널로 가져오기 | 원격/웹 세션을 로컬 터미널로 회수 |
실행 결과와 유지 범위
현재 대화를 Claude Code Desktop에서 이어갈 수 있게 합니다.
/desktop은 현재 진행 중인 CLI 세션을 Claude Code Desktop 앱으로 옮겨서 이어 진행하는 명령입니다.
공식 Commands 문서의 설명은 다음과 같습니다.
Continue the current session in the Claude Code Desktop app. Requires macOS or Windows and a Claude subscription. Alias:
/app
macOS나 Windows에서 Claude 구독으로 로그인했을 때만 쓸 수 있고, /app 별칭으로도 똑같이 실행됩니다.
동작 방식은 Desktop 문서에 더 자세히 나옵니다. 터미널에서 /desktop을 실행하면 Claude가 현재 세션을 저장한 뒤 desktop 앱에서 그 세션을 열고 CLI는 종료됩니다. 두 환경을 나란히 띄우는 게 아니라 세션을 한쪽으로 "넘겨주는(hand off)" 동작입니다.
주의사항
- macOS와 Windows 전용입니다. Linux에서는 desktop 앱이 제공되지 않으므로 CLI를 그대로 사용해야 합니다.
- Claude 구독으로 로그인한 경우에만 명령이 노출됩니다. API 키 인증이나 Bedrock·Vertex·Foundry 환경에서는 사용할 수 없습니다.
- 실행하면 CLI가 종료되고 세션이 desktop 앱으로 넘어갑니다. 터미널 세션을 유지한 채 양쪽을 동시에 쓰는 명령이 아닙니다.
- Windows에서 Code 탭을 처음 열 때는 Git for Windows 설치가 필요할 수 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록