클로드 코드 데스크탑 — 설치와 CLI에서 달라지는 것
클로드 코드 데스크탑은 따로 받는 프로그램이 아닙니다. 클로드 데스크탑 앱을 설치하면 들어 있는 Code 탭이 그것이고, 터미널 CLI와 같은 엔진·같은 설정 파일을 씁니다. CLAUDE.md·MCP 서버·훅·스킬·권한 규칙이 그대로 넘어오고, 한 컴퓨터에서 같은 프로젝트를 CLI와 앱으로 동시에 열어도 됩니다. 대신 --print 같은 스크립팅·자동화는 앱에서 안 됩니다. 이 글은 2026년 7월 29일 기준 공식 문서에서 확인한 설치 요건, CLI 세션을 앱으로 옮기는 법, 그리고 CLI와 데스크탑이 갈리는 지점을 정리합니다.
1. 설치 — 운영체제별 준비물
클로드 앱에는 Chat · Cowork · Code 세 개의 탭이 있고, 개발용은 Code 탭입니다. 설치하고 로그인한 뒤 Code 탭을 누르면 됩니다.
| 운영체제 | 설치 | 주의 |
|---|---|---|
| macOS | dmg 유니버설 빌드 | 인텔·애플 실리콘 공용 |
| Windows | x64 설치 파일 (ARM64는 별도 설치 파일) | Git for Windows가 먼저 필요 · 설치 후 앱 재시작 |
| Linux | apt 또는 .deb (Ubuntu·Debian) | 베타 · 컴퓨터 사용 기능 아직 없음 |
터미널 CLI 쪽 설치가 아직이라면 클로드 코드 설치 글을 먼저 보세요. 둘은 따로 설치되며, 앱을 깔아도 터미널에 claude 명령이 생기지는 않습니다.
2. 쓰던 CLI 세션을 앱으로 그대로 옮기기 — /desktop
터미널에서 작업하다가 화면을 넓게 보고 싶어질 때가 있습니다. 그때 세션을 통째로 옮기는 명령이 있습니다.
# 터미널에서 작업 중에
/desktop
# 세션이 저장되고 데스크탑 앱에서 열린 뒤, CLI는 종료된다조건이 있습니다. macOS와 x64 윈도우에서, 클로드 구독으로 로그인한 상태여야 합니다. API 키 인증이나 Amazon Bedrock · Google Cloud Agent Platform · Microsoft Foundry로 붙어 있으면 이 명령을 쓸 수 없습니다.
3. 설정은 공유되고, 세션 기록만 따로다
여기가 가장 궁금한 부분일 텐데, 공식 문서는 "데스크탑과 CLI가 같은 설정 파일을 읽는다"고 못 박습니다.
- 공유되는 것 — 프로젝트의
CLAUDE.md·CLAUDE.local.md,~/.claude.json과.mcp.json의 MCP 서버, 훅과 스킬,~/.claude/settings.json의 권한 규칙과 허용 도구, 사용 가능한 모델 목록 - 따로 가는 것 — 세션 기록. 사이드바의 앱 세션과 터미널의
--resume목록은 별개입니다.
claude_desktop_config.json의 MCP 서버까지 Code 탭 로컬 세션에 불러오지만, 단독 CLI는 이 파일을 읽지 않습니다. 앱에서만 되고 터미널에서 안 되는 커넥터가 있다면 이것 때문입니다. macOS·WSL에서는 아래 명령으로 옮깁니다.
claude mcp add-from-claude-desktop4. CLI 플래그는 앱에서 어디로 갔나
터미널 습관을 그대로 가져가려는 사람을 위한 대응표입니다. 공식 문서의 표를 옮긴 것이며, 목록에 없는 플래그는 스크립팅·자동화용이라 앱에 대응 항목이 없습니다.
| CLI | 데스크탑에서는 |
|---|---|
--model sonnet |
보내기 버튼 옆 모델 드롭다운 |
--resume · --continue |
사이드바에서 세션 클릭 |
--permission-mode |
보내기 버튼 옆 모드 선택기 |
--dangerously-skip-permissions |
Bypass permissions 모드 (Pro·Max는 설정에서 켜야 보임) |
--verbose |
Transcript 보기 드롭다운의 Verbose 모드 |
--allowedTools · --disallowedTools |
세션별 대응 없음 (설정 파일의 권한 규칙은 그대로 적용) |
--print · --output-format |
사용 불가 — 데스크탑은 대화형 전용 |
5. 데스크탑에만 있는 것, 데스크탑에 없는 것
이 두 목록이 "언제 앱을 쓰고 언제 터미널을 쓰나"의 답입니다. 공식 문서의 권고도 같습니다 — 여러 세션을 한 창에서 관리하거나 패널을 나란히 놓고 변경사항을 눈으로 볼 때는 데스크탑, 스크립팅·자동화가 필요하거나 터미널 흐름이 편할 때는 CLI입니다.
| 항목 | CLI | 데스크탑 |
|---|---|---|
| 세션 격리 | --worktree 플래그 |
자동 워크트리 |
| 여러 세션 | 터미널 창을 여러 개 | 사이드바 탭 |
| 파일 첨부 | 없음 | 이미지 · PDF |
| @멘션 파일 | 텍스트 입력 | 자동완성 (로컬·SSH 세션) |
| iOS 시뮬레이터 | 컴퓨터 사용으로 조작 | 전용 패널이 자동으로 열림 |
| 반복 작업 | cron · CI 파이프라인 | 예약 작업 기능 |
| 스크립팅·자동화 | --print · 에이전트 SDK |
불가 |
데스크탑에서 안 되는 것도 문서에 따로 적혀 있습니다.
- 서드파티 프로바이더 — 기본은 Anthropic API입니다. Bedrock·Foundry를 쓰려면 CLI 쪽입니다(게이트웨이 경유·기업 배포는 예외).
- 인라인 코드 제안 — 자동완성식 제안은 없습니다. 대화와 명시적 변경으로만 동작합니다.
- 에이전트 팀 — 서로 메시지를 주고받는 병렬 세션은 CLI 기능입니다. 한 세션 안에서 여러 에이전트를 굴리는 워크플로우는 데스크탑에서도 됩니다.
- 터미널 대화형 명령 —
/permissions처럼 터미널 패널을 여는 명령은 Code 탭에서isn't available in this environment라고 답합니다. 설정 파일을 직접 고치거나 CLI에서 실행해야 합니다. - 컴퓨터 사용 — macOS·윈도우의 리서치 프리뷰이며 Pro·Max 플랜 전용입니다. Team·Enterprise에서는 안 됩니다.
6. 권한 모드는 이름이 다르다
터미널에서 Shift+Tab으로 돌리던 모드가 앱에서는 보내기 버튼 옆 모드 선택기로 바뀝니다. 설정 키는 CLI와 같아서, settings.json의 permissions.defaultMode가 그대로 먹습니다.
| 모드 | 설정 키 | 동작 |
|---|---|---|
| Manual | default |
파일 수정·명령 실행 전에 매번 묻는다 (처음 쓰는 사람 권장) |
| Accept edits | acceptEdits |
파일 수정과 mkdir·touch·mv 같은 명령은 자동 승인, 나머지 터미널 명령은 물어본다 |
| Plan | plan |
읽고 탐색만 하고 소스는 건드리지 않은 채 계획을 제안한다 |
| Auto | auto |
백그라운드 안전 검사를 걸고 전부 실행 (Opus 4.6 이상 · Sonnet 4.6 이상 · Fable 5 필요) |
| Bypass permissions | bypassPermissions |
묻지 않고 실행. Pro·Max는 설정에서 켜야 목록에 뜬다. 샌드박스·VM에서만 |
CLI에만 있는 dontAsk 모드는 데스크탑에 없습니다. 모드별 차이를 더 보려면 클로드 코드 권한 설정 글을 참고하세요.
7. 자주 쓰는 단축키
전체 목록은 앱에서 Cmd+/(윈도우는 Ctrl+/)로 볼 수 있습니다. 아래는 손이 자주 가는 것만 추린 것입니다.
| 단축키 (mac) | 동작 |
|---|---|
Cmd N / Cmd W | 새 세션 / 세션 닫기 |
Ctrl Tab | 다음 세션으로 이동 |
Esc | 응답 중단 |
Cmd Shift D | diff 패널 열고 닫기 |
Ctrl + 백틱 | 터미널 패널 열고 닫기 |
Cmd Shift M / Cmd Shift I | 권한 모드 메뉴 / 모델 메뉴 |
Cmd ; | 사이드 챗 열기 (본 대화를 흐트러뜨리지 않고 곁가지 질문) |
윈도우에서는 Cmd 자리에 Ctrl을 씁니다. 다만 세션 이동·터미널 토글·보기 모드 전환은 모든 플랫폼에서 Ctrl입니다. 그리고 터미널에서 쓰던 Shift+Tab 모드 순환 같은 대화형 모드 단축키는 Code 탭에 적용되지 않습니다. 터미널 쪽 단축키는 클로드 코드 단축키 글에 정리해 뒀습니다.
자주 묻는 질문 (FAQ)
Q. 앱을 깔면 터미널 claude 명령도 같이 설치되나요?
아닙니다. 데스크탑 앱과 CLI는 별개로 설치합니다. 앱만 깔면 Code 탭은 되지만 터미널에서 claude를 치면 명령을 찾지 못합니다.
Q. CLI와 앱을 동시에 켜도 되나요?
됩니다. 공식 문서가 "같은 머신에서, 같은 프로젝트에서도 동시에 실행할 수 있다"고 명시합니다. 설정과 CLAUDE.md는 공유되고 세션 기록만 각자 갖습니다.
Q. 사용량은 어디서 보나요?
모델 선택기 옆의 사용량 링을 누르면 현재 세션의 컨텍스트 사용량과 기간별 플랜 사용량이 나옵니다. 컨텍스트는 세션마다 따로지만, 플랜 사용량은 모든 클로드 코드 창구가 함께 씁니다.
Q. 리눅스에서도 되나요?
Ubuntu·Debian에서 apt 또는 .deb로 설치할 수 있지만 베타이고, 컴퓨터 사용 기능은 아직 리눅스 앱에 없습니다.
마무리
정리하면 이렇습니다. ① 데스크탑은 클로드 앱의 Code 탭이고 CLI와 같은 엔진입니다. ② CLAUDE.md·MCP·훅·스킬·권한 규칙은 공유되고 세션 기록만 따로입니다. ③ 쓰던 세션은 /desktop으로 옮깁니다. ④ 병렬 세션·diff·미리보기는 앱이, 스크립팅과 자동화는 CLI가 맡습니다.
화면 구성과 기능은 앱 버전마다 바뀌므로, 메뉴 이름이 다르면 앱에서 Cmd+/로 현재 버전의 단축키 목록을 먼저 확인하는 편이 빠릅니다.
📚 참고 출처 (2026년 7월 29일 확인)
· Claude Code Docs — Desktop application
· Claude Code Docs — Feature availability
· Claude Code Docs — Connect Claude Code to tools via MCP
COMMENTS