Cmd. /desktop
현재 터미널 세션을 Claude Code Desktop 앱으로 넘겨서 이어 진행하는 플랫폼 명령
핵심 요약
/desktop(별칭/app)은 현재 CLI 세션을 Claude Code Desktop 앱으로 넘기는(hand off) 명령입니다.- 실행하면 세션이 desktop 앱에서 열리고 CLI는 종료됩니다. 양쪽을 동시에 쓰는 명령은 아닙니다.
- macOS·Windows 전용이며 Claude 구독 로그인에서만 노출됩니다. Linux나 API 키·Bedrock·Vertex·Foundry에서는 쓸 수 없습니다.
- diff 리뷰, 이미지, 병렬 세션처럼 GUI가 편한 작업을 desktop으로 마무리할 때 적합합니다.
명령어 원본 선언
/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)" 동작입니다.
최소 지원 버전
- 현재 공식
Commands문서에는 들어 있지만, 공개 Changelog에 최초 도입 버전이 따로 적혀 있지 않습니다. 정확한 버전이 확인되지 않아 임의로 기재하지 않습니다.
사용법
/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) 세션을 터미널로 가져오기 | 원격/웹 세션을 로컬 터미널로 회수 |
활용 사례
- 터미널에서 구현·테스트를 마친 뒤 desktop 앱에서 변경 사항을 시각적으로 리뷰
- 회의나 화면 공유 상황에서 터미널보다 보기 편한 GUI로 전환
- desktop의 통합 터미널·파일 에디터·사이드 챗 등으로 작업 환경을 확장
주의사항
- macOS와 Windows 전용입니다. Linux에서는 desktop 앱이 제공되지 않으므로 CLI를 그대로 사용해야 합니다.
- Claude 구독으로 로그인한 경우에만 명령이 노출됩니다. API 키 인증이나 Bedrock·Vertex·Foundry 환경에서는 사용할 수 없습니다.
- 실행하면 CLI가 종료되고 세션이 desktop 앱으로 넘어갑니다. 터미널 세션을 유지한 채 양쪽을 동시에 쓰는 명령이 아닙니다.
- Windows에서 Code 탭을 처음 열 때는 Git for Windows 설치가 필요할 수 있습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Desktop application: https://code.claude.com/docs/en/desktop