macOS: 유니버설 dmg (Intel/Apple Silicon)
Claude Desktop
A3 치트시트 인쇄 core 76개목차 (33)
- 다운로드 & 시작
- 세 가지 탭
- 세션 시작 설정 (4가지)
- 권한 모드
- 프롬프트 박스
- 슬래시 명령어
- 앱 미리보기 (Browser pane)
- 외부 사이트 브라우징
- Diff 리뷰 & 코드 리뷰
- PR 모니터링
- 워크스페이스 배치
- 터미널 & 파일 편집기
- 뷰 모드
- 키보드 단축키 전체
- 사용량 확인
- Computer Use
- 세션 관리
- 사이드 채팅
- 백그라운드 작업 & 세션 간 작업
- 클라우드 세션 & 이어가기
- Dispatch (Cowork 탭)
- 커넥터 연결
- 스킬 & 플러그인
- 프리뷰 서버 설정 (.claude/launch.json)
- 환경 종류
- 엔터프라이즈 관리
- 네트워크 & 데이터 처리
- CLI → 데스크톱 대응표
- 기능 비교: CLI vs 데스크톱
- CLI와 공유되는 설정
- 데스크톱 vs CLI, 언제 무엇을
- 트러블슈팅
- 참고 링크
다운로드 & 시작
데스크톱 앱은 CLI 와 설정 공유, 조작 체계는 별개. 같은 기능도 이름이 다를 수 있음.
Windows: x64 설치 / ARM64는 별도 설치파일
Linux(베타): apt 또는 .deb
Code
설치 후 로그인 → 탭 클릭
설치 후 앱을 실행하고 Anthropic 계정으로 로그인한다. 세 탭 중 Code 탭을 클릭해서 소프트웨어 개발 기능을 사용한다. CLI와 세션과 설정을 공유한다.
Windows는 Git for Windows 필요 (설치 후 앱 재시작)
공식 문서 ↗ 확인 2026-08-13 (7일 전)
세 가지 탭
탭마다 다루는 대상이 별개. 현재 탭 위치가 사용 가능 기능을 결정.
Chat
일반 대화
일반적인 텍스트 대화를 위한 탭. 코드 작성 없이 아이디어를 브레인스토밍하거나 설명을 요청할 때 사용한다.
Cowork
Dispatch·장기 에이전틱 작업
장기 실행 작업과 에이전트 협업을 위한 탭. 백그라운드 작업을 관리하고 여러 에이전트가 같은 작업에 협력할 수 있다.
Code
소프트웨어 개발 (이 치트시트 범위)
소프트웨어 개발을 위한 전용 탭. 파일 읽기·쓰기, 명령 실행, Git 작업 등 개발에 필요한 모든 기능이 여기에 있다. 이 치트시트는 주로 이 탭을 기준으로 작성되었다.
공식 문서 ↗ 확인 2026-08-13 (7일 전)
세션 시작 설정 (4가지)
세션 시작 위치가 접근 가능한 파일 범위 결정.
Environment
Local/Cloud/SSH/WSL(Win) 선택
Project folder
작업할 폴더·저장소 선택
Model
전송 버튼 옆 드롭다운(세션 중 변경 가능)
Permission mode
모드 선택기(세션 중 변경 가능)
공식 문서 ↗ 확인 2026-08-13 (7일 전)
권한 모드
CLI 와 같은 개념, UI 라벨 표기만 차이. API 식별자 대조 필요 시 CLI 시트 참고.
Manual (default)
편집·명령 전 항상 확인
Accept edits
파일편집+기본 명령 자동승인
Plan
탐색만, 편집 전 계획 제시
Auto
백그라운드 안전검사로 대부분 자동
Bypass permissions
프롬프트 없음, 격리 환경 전용
Bypass: Pro/Max는 설정→Claude Code 토글, Team/Enterprise는 조직 정책. dontAsk 모드는 CLI 전용
공식 문서 ↗ 확인 2026-08-13 (7일 전)
프롬프트 박스
입력창에서 바로 쓸 수 있는 참조·첨부 문법.
Enter 전송, 진행 중 정정 메시지 입력 시 중단 없이 다음 단계에 반영
정지 버튼: 즉시 중단
@파일명: 컨텍스트 추가 (로컬·SSH만, 클라우드·WSL 불가)
첨부: 이미지·PDF 드래그앤드롭
+
버튼: 파일첨부/스킬/커넥터/플러그인
공식 문서 ↗ 확인 2026-08-13 (7일 전)
슬래시 명령어
데스크톱에서 쓸 수 있는 슬래시 명령. 터미널 전용 대화형 명령은 여기서 동작 불가.
/
/ 입력 또는 +→Slash commands 로 탐색 (내장 명령어 + 커스텀·프로젝트·플러그인 스킬)
/clear, /compact, /context
새 대화 시작/요약/컨텍스트 확인
/rewind, /diff
체크포인트 롤백 / diff 뷰어
/model, /effort, /plan
모델·추론강도 변경 / 계획 모드
/rename, /branch, /export
이름변경/대화분기/내보내기
/code-review, /security-review
diff 검토 / 보안 취약점 검사
/background, /tasks, /fork
백그라운드 분리/작업목록/복사
/loop, /goal, /recap, /insights
반복실행/목표설정/요약/분석
/btw
사이드 채팅 열기
/desktop
(터미널에서) 세션을 데스크톱으로 이동
/ide, /mcp, /doctor, /usage
IDE·MCP 관리/진단/사용량
/permissions 등 터미널 전용 대화형 명령어는 "isn't available in this environment" 응답. /config 는 인자 무시하고 설정 화면만 열림
공식 문서 ↗ 확인 2026-08-13 (7일 전)
앱 미리보기 (Browser pane)
앱 안에서 로컬 서버를 띄워 결과 바로 확인. 코드 수정과 화면 확인의 왕복 단축.
수정 후 자동으로 dev 서버 실행·검증(스크린샷/DOM검사/클릭/폼입력)
서버 드롭다운에서 시작/중지
Persist sessions
: 재시작해도 쿠키·로컬스토리지 유지
HTML/PDF/이미지/영상 경로 클릭 시 Browser pane에서 열림
공식 문서 ↗ 확인 2026-08-13 (7일 전)
외부 사이트 브라우징
외부 사이트를 여는 경로. 문서에서 본 내용을 그대로 지시로 받아들이지 않도록 주의.
Cmd/Ctrl+Shift+B 로 Browser pane 열기
첫 접근 시 승인 카드(Allow once/Always allow/Deny), 서브도메인별 개별 승인
로그인 상태 공유 필요하면 Claude in Chrome 확장 사용 (Browser pane은 별도 프로필)
조직 차원 allow/blocklist 및 외부 탐색 자체 차단 가능
공식 문서 ↗ 확인 2026-08-13 (7일 전)
Diff 리뷰 & 코드 리뷰
변경을 시각적으로 훑고 그 자리에서 코멘트 작성.
변경 후 +12 -1 형태 diff stats 클릭 → diff 뷰어
줄 클릭해 댓글, Cmd/Ctrl+Enter 로 한번에 제출
Review code
버튼: 컴파일오류·명백한 버그·보안취약점 위주(스타일은 안 봄)
공식 문서 ↗ 확인 2026-08-13 (7일 전)
PR 모니터링
PR 상태를 앱 안에서 추적.
PR 생성 후 세션에 CI 상태 바 표시 (GitHub CLI gh 필요)
Auto-fix
: 실패한 체크 자동 수정 시도
Auto-merge
: 모든 체크 통과 시 squash 병합(GitHub에서 auto-merge 먼저 활성화 필요)
완료 시 데스크톱 알림
공식 문서 ↗ 확인 2026-08-13 (7일 전)
워크스페이스 배치
여러 세션·패널을 동시에 두는 배치.
패널: chat·diff·browser·terminal·file·plan·tasks·subagent (+macOS는 iOS 시뮬레이터)
헤더 드래그로 위치 변경, 가장자리 드래그로 크기 조절
Views
메뉴에서 패널 추가
Cmd/Ctrl+\ 포커스된 패널 닫기
공식 문서 ↗ 확인 2026-08-13 (7일 전)
터미널 & 파일 편집기
앱 안의 터미널과 편집기. 별도 창을 오갈 필요 감소.
통합 터미널 Ctrl+`: 세션과 동일한 작업 디렉토리·환경 공유 (로컬 세션 전용)
파일 클릭 → 파일 패널에서 바로 편집·저장
파일 우클릭: 컨텍스트로 첨부/다른 앱에서 열기/탐색기 표시/경로 복사
공식 문서 ↗ 확인 2026-08-13 (7일 전)
뷰 모드
무엇을 크게 볼지 고르는 축.
Normal
도구 호출 요약 + 전체 텍스트 응답
Verbose
모든 도구 호출·중간 단계 표시
Summary
최종 응답과 변경사항만
Ctrl+O 로 순환 전환
공식 문서 ↗ 확인 2026-08-13 (7일 전)
키보드 단축키 전체
데스크톱 전용 단축키. 터미널 CLI 와 같은 키라도 동작이 다를 수 있음.
Cmd/Ctrl + /
단축키 목록 표시
Cmd/Ctrl + N
새 세션
Cmd/Ctrl + W
세션 닫기
Ctrl+Tab / Shift+Tab
다음/이전 세션
Esc
응답 중단
Cmd/Ctrl + Shift + D
diff 패널 토글
Cmd/Ctrl + Shift + B
Browser 패널 토글
Cmd/Ctrl + Shift + S
Browser 요소 선택
Ctrl + `
터미널 패널 토글
Cmd/Ctrl + \
포커스 패널 닫기
Cmd/Ctrl + ;
사이드 챗 열기
Ctrl + O
뷰 모드 순환
Cmd/Ctrl + Shift + M
권한 모드 메뉴
Cmd/Ctrl + Shift + I
모델 메뉴
Cmd/Ctrl + Shift + E
effort 메뉴
1–9
열린 메뉴에서 항목 선택
Code 탭 전용 — 터미널 CLI의 Shift+Tab 등과는 다름
공식 문서 ↗ 확인 2026-08-13 (7일 전)
사용량 확인
사용량과 한도를 앱 안에서 확인.
모델 선택기 옆 사용량 링 클릭 → 컨텍스트 사용량(세션별) + 플랜 사용량(전체 서피스 공유)
공식 문서 ↗ 확인 2026-08-13 (7일 전)
Computer Use
실제 데스크톱 조작. 샌드박스 안의 Bash 와는 신뢰 경계가 별개.
화면·앱 직접 조작 (CLI 없는 GUI 자동화용)
macOS·Windows Pro/Max 리서치 프리뷰, Team/Enterprise 불가
기본 꺼짐: 설정→General→Computer use 토글, macOS는 손쉬운 사용+화면 기록 권한 추가 필요
View only(브라우저 등) / Click only(터미널·IDE) / Full control(그 외) 3단계
세션당 1회 승인 (Dispatch 세션은 30분마다 재승인)
실제 데스크톱을 조작 — 샌드박스 Bash와는 다른 신뢰 경계
공식 문서 ↗ 확인 2026-08-13 (7일 전)
세션 관리
세션 목록·이름·재개. 이름을 붙여두면 며칠 뒤 찾기가 훨씬 수월.
Cmd/Ctrl+N 새 세션, 여러 세션 병렬 실행
Git worktree
Git 저장소는 세션마다 자동 로 격리(.claude/worktrees/)
Cmd/Ctrl 누르고 사이드바 클릭 → 2개 세션 분할 보기
완료 후 보관 아이콘, PR 병합 시 자동 보관(Auto-archive) 설정 가능
공식 문서 ↗ 확인 2026-08-13 (7일 전)
사이드 채팅
본 작업 흐름을 끊지 않고 옆에서 질문.
Cmd/Ctrl+; 또는 /btw 로 열기 — 메인 세션 컨텍스트는 읽지만 기록엔 안 남음, 앱 종료 시 사라짐 (로컬·SSH·WSL만)
공식 문서 ↗ 확인 2026-08-13 (7일 전)
백그라운드 작업 & 세션 간 작업
오래 걸리는 작업을 떼어내고 다른 일 병행.
Tasks 패널: 서브에이전트·백그라운드 셸·동적 워크플로우 진행상황
"다른 세션이 뭐 했어?" 같은 자연어로 다른 Code 세션 확인·메시지·이름변경·보관 요청
최근 20개 세션까지, 클라우드 세션은 제외
공식 문서 ↗ 확인 2026-08-13 (7일 전)
클라우드 세션 & 이어가기
실행을 웹으로 올려 기기를 닫아도 계속 진행.
Environment에서 Cloud 선택 → 앱 종료해도 계속 실행, claude.ai/code·모바일 앱에서 확인
여러 저장소 동시 추가 가능
Continue in
메뉴: 웹 세션으로 전송 또는 IDE로 열기
공식 문서 ↗ 확인 2026-08-13 (7일 전)
Dispatch (Cowork 탭)
여러 작업을 한 번에 흩뿌려 돌리는 탭.
휴대폰에서 작업 지시 → 개발 작업이면 자동으로 Code 세션 생성 (Dispatch 배지 표시)
완료·승인 필요 시 폰으로 푸시 알림
Pro/Max 전용, Team/Enterprise 불가
공식 문서 ↗ 확인 2026-08-13 (7일 전)
커넥터 연결
외부 서비스를 UI 에서 바로 연결. MCP 직접 설정 전에 여기부터 확인.
+
버튼 → Connectors: Google Calendar/Slack/GitHub/Linear/Notion 등 (로컬·SSH만, 클라우드·WSL 불가)
설정→Connectors 에서 관리·연결 해제
공식 문서 ↗ 확인 2026-08-13 (7일 전)
스킬 & 플러그인
앱에서 스킬·플러그인 관리. CLI 와 같은 파일 체계 사용.
+
/ 입력 또는 →Slash commands 로 내장 명령어·커스텀 스킬·플러그인 스킬 탐색
+
→Plugins: 설치된 플러그인 확인, "Add plugin"으로 마켓플레이스 설치
플러그인은 클라우드·WSL 세션에서는 사용 불가
공식 문서 ↗ 확인 2026-08-13 (7일 전)
프리뷰 서버 설정 (.claude/launch.json)
미리보기로 띄울 서버를 프로젝트에 정의.
name / runtimeExecutable
식별자 / 실행 명령
runtimeArgs / args
명령 인자
서버 포트
cwd / env
작업 디렉토리 / 환경변수
autoPort
포트 충돌 시 자동 재할당 여부
program / url
node 스크립트 직접 실행 / 접속 주소
autoVerify: 기본 켜짐(수정마다 자동 검증), false로 끌 수 있음
공식 문서 ↗ 확인 2026-08-13 (7일 전)
환경 종류
로컬·클라우드·자체 호스팅 중 실행 위치가 접근 가능 자원 결정.
Local
내 컴퓨터에서 직접 실행
Cloud
Anthropic 관리 인프라, 앱 꺼도 계속 실행
SSH
원격 머신 연결 (Linux·macOS만)
WSL (Windows)
WSL2 배포판 안에서 실행
공식 문서 ↗ 확인 2026-08-20 (0일 전)
엔터프라이즈 관리
조직 정책이 개인 설정보다 우선.
관리 콘솔: Code 데스크톱 사용 여부, 웹 세션, Remote Control, Bypass 모드 비활성화 등 제어
Managed settings: disableAutoMode, sshHostAllowlist, managedMcpServers 등
macOS는 MDM(Jamf/Kandji), Windows는 그룹 정책/레지스트리로 배포·정책 관리
공식 문서 ↗ 확인 2026-08-13 (7일 전)
네트워크 & 데이터 처리
데이터가 어디까지 나가는지에 대한 규칙.
주요 허용 도메인: anthropic.com, claude.ai, claude.com, claude.app, *.claudeusercontent.com (HTTPS 443)
로컬 세션은 로컬 처리, 클라우드 세션은 Anthropic 관리 인프라에서 코드·대화 컨텍스트 처리
공식 문서 ↗ 확인 2026-08-13 (7일 전)
CLI → 데스크톱 대응표
CLI 명령이 데스크톱에서 무엇에 해당하는지 대조표.
--model sonnet
모델 드롭다운
--resume, --continue
사이드바에서 세션 클릭
--permission-mode
모드 선택기
--dangerously-skip-permissions
Bypass permissions 모드
--add-dir
클라우드 세션의 + 버튼(저장소 추가)
--allowedTools/--disallowedTools
세션별 대응 없음(설정파일 규칙은 적용)
--verbose
Verbose 뷰 모드
--print, --output-format
미지원 (대화형 전용)
MAX_THINKING_TOKENS
로컬 환경변수 에디터
공식 문서 ↗ 확인 2026-08-13 (7일 전)
기능 비교: CLI vs 데스크톱
같은 일을 어디서 하는 게 나은지 판단하는 표.
CLI는 dontAsk 포함 전체 / 데스크톱은 4종+Bypass
CLI는 Bedrock 등 / 데스크톱은 기본 Anthropic API
CLI는 설정파일 / 데스크톱은 Connectors UI 또는 설정파일
CLI는 /plugin / 데스크톱은 플러그인 관리자 UI
CLI 불가 / 데스크톱은 이미지·PDF 지원
CLI는 --worktree / 데스크톱은 자동 worktree
CLI는 cron/CI / 데스크톱은 Scheduled tasks
Computer Use
CLI는 macOS /mcp 활성화 / 데스크톱은 앱 내장
CLI는 Computer Use로 구동 / 데스크톱은 전용 패널
Dispatch
CLI 없음 / 데스크톱은 사이드바 지원
CLI는 --print·Agent SDK / 데스크톱 미지원
공식 문서 ↗ 확인 2026-08-13 (7일 전)
데스크톱 vs CLI, 언제 무엇을
터미널이 나은 상황과 앱이 나은 상황의 구분.
병렬 세션 관리, 패널 배치, 변경사항 시각적 검토 → 데스크톱
스크립팅, 자동화, 터미널 워크플로우 선호 → CLI
공식 문서 ↗ 확인 2026-08-13 (7일 전)
트러블슈팅
증상별 확인 순서.
403/인증 오류 → 로그아웃 후 재로그인, 유료 구독 확인
화면 멈춤/빈 화면 → 재시작, 업데이트 확인, 방화벽 CDN 허용 확인
"Failed to load session" → 폴더 존재 확인, Git LFS 설치 확인
Windows "Git is required" → Git for Windows 설치 후 재시작
MCP 서버 Windows 오류 → 설정 확인, 앱 재시작, 작업관리자에서 프로세스 확인
공식 문서 ↗ 확인 2026-08-13 (7일 전)
참고 링크
판정 근거가 되는 1차 출처.
공식 문서: code.claude.com/docs/en/desktop
Cowork: claude.com/product/cowork
Cowork: claude.com/product/cowork
iOS 시뮬레이터: /docs/en/desktop-ios-simulator
WSL 연동: /docs/en/desktop-wsl
다운로드: claude.com/download
공식 문서 ↗ 확인 2026-08-13 (7일 전)