Claude Code 데스크탑 앱 — 설치 후 안내문
공식 문서(code.claude.com/docs/en/desktop) 기준으로 정리한 안내입니다.
교육 중 화면을 따라오며 하나씩 눌러 보세요.
1. 설치
설치 후 앱을 열고 Anthropic 계정으로 로그인한 다음, 위쪽 가운데의 Code 탭을 누릅니다.
- Code 탭은 유료 구독(Pro·Max·Team·Enterprise) 이 필요합니다. 업그레이드 안내가 뜨면 구독이 없는 상태입니다.
- 로그인 오류(403)가 나면: 로그아웃 → 다시 로그인이 1차 처방입니다.
2. 앱의 세 가지 탭
| 탭 | 용도 |
|---|
| Chat (Home) | 일반 대화. 내 파일에 접근하지 않습니다. claude.ai와 같습니다 |
| Cowork | 가상머신 안에서 혼자 일하는 백그라운드 에이전트 |
| Code | 코딩·문서 작업. 내 폴더에 직접 접근합니다. 오늘 주로 쓰는 곳 |
Code 탭에서 대화 하나하나를 세션이라고 부릅니다. 세션마다 대화 이력·폴더·변경 내용이 독립적입니다.
3. 첫 세션 시작하기
- 사이드바의 + New (또는 Ctrl+N)
- 환경 선택 — 처음엔 Local(내 컴퓨터)을 고르세요. Cloud(앤트로픽 서버에서 계속 돌아감), SSH(원격 서버), WSL(Windows)도 있습니다.
- 폴더 선택 — 작업할 프로젝트 폴더를 고릅니다. 처음엔 잘 아는 작은 폴더가 좋습니다.
- 모델 선택 — 입력창 오른쪽 아래 드롭다운. 나중에 바꿔도 됩니다.
- 입력창에 할 일을 쓰고 Enter.
4. 화면 구성 — 왼쪽 사이드바
| 항목 | 기능 |
|---|
| + New | 새 세션 (Ctrl+N) |
| Artifacts | 세션에서 만든 웹 페이지 산출물 목록 |
| Customize | 스킬·커넥터·플러그인 관리 |
| 프로젝트 그룹 | 폴더별로 세션이 묶여 보입니다. 그룹 옆 + 는 그 폴더로 새 세션 |
| 세션 앞 동그라미 | 상태 표시등 — 주황 점 「Needs input」은 Claude가 질문하고 기다리는 중(눌러서 답해야 진행), 채워진 점은 작업 중, 빈 동그라미는 대기/완료 |
| 세션에 마우스 올림 | 보관(archive) 아이콘 — 끝난 세션 정리 |
| 맨 아래 계정 | 설정(Settings) 진입, 로그아웃 |
Ctrl+클릭으로 세션 두 개를 나란히 볼 수 있고, Ctrl+Tab으로 세션을 오갑니다.
5. 입력창(프롬프트 상자) 둘러보기
입력창 위 알약 버튼
| 알약 | 뜻 |
|---|
| 첫 번째 | 환경 — 이 세션이 어디서 도는지 (Local/Cloud/SSH/WSL) |
| 두 번째 | 작업 폴더 |
| 세 번째 (⑂) | git 브랜치. — 표시는 git 저장소가 아니라는 뜻 |
| worktree 체크 | 켜면 세션마다 격리된 사본에서 작업 (원본이 안전) |
입력창 아래 버튼
| 버튼 | 기능 |
|---|
| 권한 모드 (Auto 등) | Claude가 얼마나 승인 없이 움직일지. 아래 표 참조 |
| + | 파일 첨부 · 스킬(Slash commands) · 커넥터 · 플러그인 |
| 🎤 | 음성 입력 |
| 모델 드롭다운 | 모델 선택·변경 |
| effort (High 등) | 추론 강도 — 높을수록 깊게 생각하고 토큰을 더 씁니다 |
| 동그라미 (usage ring) | 클릭하면 현재 대화의 컨텍스트 사용량과 요금제 사용량 표시 |
| ⏎ 전송 | 작업 중엔 ⏹(중지)로 바뀝니다. 중지 없이 방향만 바꾸려면 그냥 이어서 입력하고 Enter |
권한 모드 4종
| 모드 | 동작 |
|---|
| Auto | 안전 분류기가 위험한 것만 걸러 물어봄. 승인 질문 최소 |
| Manual | 파일 수정·명령 실행 전에 매번 물어봄 |
| Accept edits | 파일 수정은 자동 승인, 그 외 명령은 물어봄 |
| Plan | 계획만 제안하고 파일은 안 건드림. 큰 작업 시작 전에 좋습니다 |
요령: 복잡한 일은 Plan으로 계획 먼저 받아 보고, 승인한 뒤 Auto나 Accept edits로 실행하세요.
입력창에서 쓰는 특수 입력
| 입력 | 기능 |
|---|
@파일명 | 파일을 대화에 첨부 (자동완성) |
/ | 스킬·명령 목록 (예: /compact — 대화가 길어졌을 때 압축) |
| 드래그&드롭 | 이미지·PDF 첨부. 버그 스크린샷, 참고 문서에 유용 |
6. 작업 결과 확인하기
- Claude가 파일을 고치면
+12 -1 같은 표시가 뜹니다. 클릭하면 diff 뷰어로 파일별 변경 내용을 봅니다.
- diff의 줄을 클릭하면 댓글을 달 수 있고, Ctrl+Enter로 제출하면 Claude가 읽고 고칩니다.
- diff 뷰 오른쪽 위 Review code — Claude가 스스로 변경분을 검토해 코멘트를 답니다.
- 화면은 판(pane) 단위로 자유 배치됩니다: 채팅, diff, 브라우저(앱 미리보기), 터미널(Ctrl+`), 파일 편집기, 작업 감시(tasks). 판 머리글을 드래그해 옮기고, Ctrl+\ 로 닫습니다. 추가 판은 세션 툴바의 Views 메뉴.
- 대화 표시 모드(Ctrl+O 순환): Normal(요약) / Verbose(모든 단계) / Summary(결과만).
7. 주요 단축키 (전체 목록은 Ctrl+/)
| 키 | 동작 |
|---|
| Ctrl+N | 새 세션 |
| Ctrl+W | 세션 닫기 |
| Ctrl+Tab | 다음 세션 |
| Esc | 응답 중지 |
| Ctrl+Shift+D | diff 판 |
| Ctrl+Shift+B | 브라우저 판 |
| Ctrl+` | 터미널 판 |
| Ctrl+; | 곁가지 질문(side chat) — 본 대화를 흐리지 않고 질문 |
| Ctrl+Shift+M | 권한 모드 메뉴 |
| Ctrl+Shift+I | 모델 메뉴 |
macOS는 Ctrl 대신 Cmd를 씁니다 (세션 전환·터미널·표시 모드는 macOS에서도 Ctrl).
8. 막혔을 때
| 증상 | 처방 |
|---|
| 403 / 로그인 오류 | 로그아웃 → 재로그인. 유료 구독 여부 확인 |
| 화면이 하얗게 멈춤 | 앱 재시작 → 업데이트 확인 (Help → Check for Updates) |
| “Failed to load session” | 선택한 폴더가 없어졌거나 권한 문제. 다른 폴더로 시도 |
| ”Git is required” (Windows) | Git for Windows 설치 후 앱 재시작 |
| npm 등 도구를 못 찾음 | 일반 터미널에서 되는지 확인 → 앱 재시작 |
| 대화가 너무 길어짐 | 자동 요약되며 계속됩니다. /compact로 미리 압축 가능 |
더 읽기 (공식 문서)
다음 단계