Claude 데스크탑 앱, 설치하고 첫 작업까지
공식 문서(code.claude.com/docs/en/desktop, 2026년 11월판)를 기준으로, 현장에서 처음 쓰는 분 눈높이에 맞춰 정리했습니다. 화면을 따라오며 하나씩 눌러 보세요.
일은 「
</>Code」에서만 합니다앱에는 채팅과 프로젝트(말풍선 모양)도 있습니다. 거기서는 AI가 내 폴더에 손을 대지 못하고, 다음에 열면 앞의 일을 잊습니다. 지시문을 채팅에 붙여 넣으면 아무것도 만들어지지 않습니다. 입력창 아래 줄에 폴더 이름이 보이면 Code입니다. 안 보이면 Code로 옮겨 가세요. 휴대폰 앱은 작업방을 세팅하는 데 쓰지 않습니다. 컴퓨터 앱에서 합니다.
1. 설치
| 운영체제 | 내려받기 |
|---|---|
| Windows (일반 PC, x64) | 설치 파일 |
| Windows (ARM64) | ARM64 설치 파일 |
| macOS (인텔·애플 칩 공통) | 설치 파일 |
| Linux (베타, Ubuntu·Debian) | apt로 설치. 안내 문서 |
내려받은 파일을 실행하면 설치됩니다. Windows는 시작 메뉴, macOS는 응용 프로그램 폴더에서 Claude를 엽니다.
- 앱 안에 Claude Code가 들어 있어서 Node.js나 터미널용 프로그램을 따로 깔 필요가 없습니다.
- Windows에서 Git은 기본으로는 필요 없습니다. 「Git is required」가 뜨는 경우는 둘입니다. 앱이 옛 버전이면 업데이트하세요(Help → Check for Updates…). 세션마다 격리된 사본(worktree)을 쓰는 기능을 켰을 때만 Git for Windows를 설치합니다.
2. 품앗이 메일로 로그인
- 로그인 화면에서 품앗이 메일 주소(○○○@poomasi.org)를 넣고 「이메일로 계속하기」를 한 번만 누릅니다.
- 웹메일(webmail.poomasi.org)에 들어가 Anthropic에서 온 메일을 열고 로그인 버튼을 누릅니다. 메일을 받고 10분 안에 눌러야 합니다.
- 로그인되면 왼쪽 아래 계정 이름 옆에 「품앗이생협」이 보이는지 확인합니다. 「무료」라고 보이면 그 부분을 눌러 「품앗이생협」을 고릅니다.
이것만 피하세요
- 구글 계정으로 로그인하지 마세요. 품앗이 메일 주소로만 들어갑니다.
- 「다시 보내기」를 여러 번 누르지 마세요. 한 번 누르고 웹메일에서 기다리세요.
3. 「</> Code」로 들어가기
사이드바 맨 위의 탭 중 「</> Code」를 누릅니다. 탭이 아이콘으로만 보이면 마우스를 올려 이름을 확인하세요.
| 탭 | 여기서 하는 일 |
|---|---|
| 채팅·프로젝트 (말풍선) | 일반 대화. 작업에는 쓰지 않습니다. 내 폴더를 못 보고, 다음에 열면 잊습니다 |
</> Code | 작업방 폴더에서 문서·파일을 직접 만들고 고칩니다. 우리 일은 여기서 합니다 |
Code를 눌렀는데 이런 화면이 나오면
- 업그레이드 안내: 유료 조직 계정이 아닌 상태입니다. 2번의 「품앗이생협」 선택을 다시 확인하세요.
- 온라인 로그인 안내: 로그인을 마치고 앱을 다시 켭니다.
- 403 오류: 9번 「막혔을 때」를 보세요.
Code 안에서 대화 하나를 세션이라고 부릅니다. 세션마다 대화 기록과 폴더, 바뀐 내용이 따로 갑니다.
4. 첫 세션 시작하기
입력창 아래 줄에 고를 것이 네 가지 있습니다. 첫 메시지를 보내기 전에 차례로 고릅니다.
- 환경: 줄의 맨 앞 칸입니다. 「Local」 묶음의 맨 위 항목을 고릅니다. Local은 내 컴퓨터에서 돈다는 뜻입니다.
- 폴더: 환경 바로 옆 칸입니다. 「Open folder…」를 눌러 작업방 폴더를 고릅니다. 작업방이 아직 없으면 처음 한 번만 「문서」 폴더를 고르고 지시문 ①을 붙입니다. 그 안에 작업방 폴더가 생깁니다.
- 권한 모드: AI가 묻지 않고 어디까지 할지 정합니다. 5번을 보세요.
- 모델: 줄의 오른쪽 끝 쪽에 있습니다. 나중에 바꿔도 됩니다.
그다음 입력창에 할 일을 쓰고 Enter를 누릅니다.
- 새 세션은 사이드바의 「+ New」나 Ctrl+N(맥은 Cmd+N)으로 엽니다.
- 일하는 도중에 방향을 바꾸고 싶으면 멈추지 않고 고칠 말을 써서 Enter를 누르면 됩니다. 당장 멈추려면 중지 버튼이나 Esc를 누릅니다.
- 파일을 보여 주려면 입력창에
@파일이름을 쓰거나, 입력창 옆 「+」로 붙이거나, 파일을 끌어다 놓습니다.
환경이 입력창 위에 보이면 옛 화면입니다. Help → Check for Updates…(맥은 Claude → Check for Updates…)로 업데이트하세요.
5. 권한 모드는 Bypass permissions 권장
| 모드 | 하는 방식 |
|---|---|
| Manual | 파일을 고치거나 명령을 돌리기 전에 매번 묻습니다. 바뀔 내용을 보여 주고 하나씩 허락받습니다 |
| Accept edits | 파일 수정과 폴더 만들기·옮기기 같은 일은 묻지 않고 하고, 그 밖의 명령은 묻습니다 |
| Plan | 파일을 읽고 살펴본 뒤 계획만 내놓습니다. 원본은 고치지 않습니다 |
| Auto | 따로 묻지 않고 일합니다. 그 대신 검사용 AI가 명령 하나하나를 실행 전에 보고, 위험해 보이면 막습니다 |
| Bypass permissions | 묻지 않고 바로 합니다. 세션 삭제처럼 몇 가지만 예외로 묻습니다 |
우리 현장 권장: Bypass permissions
Auto는 검사용 AI가 일을 막으면 알림이 뜨고, 세 번 잇달아 막히면 다시 하나하나 허락을 묻기 시작합니다. 처음 쓰는 분은 왜 막혔는지 모른 채 그 자리에서 멈추게 됩니다. Bypass는 묻지 않고 바로 하니 그럴 일이 없습니다. 대신 두 가지를 지킵니다.
- 작업방 폴더를 골라서 일합니다. 작업방을 처음 만들 때 말고는 바탕화면이나 문서 폴더 전체를 고르지 않습니다.
- 원본은 그대로 두고 새 이름으로 저장하게 시킵니다. 「원본은 건드리지 말고 새 파일로 저장해 줘」라고 한 줄 붙이면 됩니다.
공식 문서는 Bypass를 격리된 환경(컨테이너·가상머신)에서만 쓰라고 권합니다. 우리는 위 두 가지를 지키는 조건으로 씁니다.
목록에 Bypass permissions가 없으면
- Pro·Max·Ultra 개인 요금제는 Settings → Code(또는 Claude Code)에서 「Allow bypass permissions mode」를 켭니다.
- Team·Enterprise 요금제는 설정에 이 스위치가 없고 조직 정책이 정합니다. 품앗이생협 계정에서 안 보이면 품앗이 담당자에게 알려 주세요.
요령: 크고 복잡한 일은 먼저 Plan으로 계획을 받아 읽어 보고, 괜찮으면 모드를 바꿔 실행시킵니다. 모드는 세션 중에 언제든 바꿀 수 있습니다(Ctrl+Shift+M, 맥은 Cmd+Shift+M).
6. 화면 구성
왼쪽 사이드바
| 항목 | 하는 일 |
|---|---|
| 「+ New」 | 새 세션 |
| 세션 목록 | 지난 세션이 쌓입니다. 눌러서 다시 엽니다. 마우스를 올려 메뉴에서 「Archive」를 고르면 목록에서 치웁니다 |
| Customize | 스킬·커넥터·플러그인을 한곳에서 관리합니다 |
| 맨 아래 계정 | 계정 이름과 소속(품앗이생협) 확인, 설정(Settings) |
세션 이름을 바꾸려면 세션을 열고 위쪽 제목을 누릅니다.
세션 화면
- 대화창 옆 카드(session details): 이 세션이 어디서 도는지, 무엇을 바꿨는지, 무엇을 돌리는 중인지, 대화가 얼마나 찼는지를 보여 줍니다. 세션 제목 줄의 「Hide session rail」로 숨기고 「Show session rail」로 다시 엽니다.
- 바뀐 내용 확인: AI가 파일을 고치면
+12 -1같은 표시가 뜹니다. 누르면 파일별로 무엇이 바뀌었는지(diff) 봅니다. 줄을 눌러 의견을 달면 AI가 읽고 고칩니다. - 창 배치: 세션 제목 줄의 버튼으로 창을 더 엽니다. 「Changes」(바뀐 내용), 「Terminal」(명령창), 「Files」(파일 보기·고치기), 「Browser」(웹 화면) 등입니다. 버튼이 안 보이면 옆의 「⋮」 메뉴에 있습니다. 창은 머리 부분을 끌어 옮기고 가장자리를 끌어 크기를 바꿉니다.
- 파일 열기: 대화에 나온 파일 경로를 누르면 열립니다. 오른쪽 클릭하면 「Show in Explorer」(맥은 Show in Finder)로 그 폴더를 엽니다.
자주 쓰는 단축키
Windows 기준입니다. 맥은 Ctrl 대신 Cmd를 누릅니다. 단, Ctrl+Tab과 Ctrl+`는 맥에서도 Ctrl입니다.
| 키 | 하는 일 |
|---|---|
| Ctrl+N | 새 세션 |
| Ctrl+Tab | 다음 세션으로 |
| Esc | AI 응답 멈추기 |
| Ctrl+Shift+M | 권한 모드 메뉴 |
| Ctrl+; | 곁가지 질문(본 대화에 섞이지 않게 따로 묻기) |
| Ctrl+/ | 단축키 전체 보기 |
7. 토큰과 세션: 한 세션에 한 가지 일
- 한 세션에서는 한 가지 일만 합니다. 다른 일은 「+ New」로 새 세션을 엽니다. 한 세션에 일을 섞으면 대화가 길어져 사용량이 빨리 닳고 AI도 헷갈립니다.
- 일이 끝나면 「정리해」라고 씁니다. AI가 한 일과 남은 일을 작업방에 기록합니다.
- 다음에 이어 할 때는 새 세션을 열고 「이어서」라고 씁니다. 기록을 읽고 남은 일부터 합니다.
사용량 확인
- 이 세션의 대화가 얼마나 찼는지: 대화창 옆 「Context」 카드에 퍼센트로 나옵니다. 입력창에
/context를 쳐도 됩니다. - 요금제 사용량: 입력창 아래 줄의 동그라미(사용량 고리)를 누릅니다. 모든 Claude Code 세션이 함께 쓰는 양입니다.
- 대화가 꽉 차면 AI가 앞부분을 스스로 요약하고 이어 갑니다. 미리 줄이려면
/compact를 칩니다.
자세한 내용은 AI 토큰 사용량과 절약법을 보세요.
8. 다음 단계
- AI 작업방 만들기: 지시문을 「
</>Code」에 붙여 작업방을 세팅합니다 - 한글 문서를 AI로 다루기: 한글(HWP·HWPX) 파일을 읽고 고치는 방법
9. 막혔을 때
| 이럴 때 | 이렇게 |
|---|---|
| 로그인 메일이 안 옴 | 「다시 보내기」를 누르지 말고 웹메일(webmail.poomasi.org)에서 몇 분 기다립니다. 10분이 지나면 처음부터 한 번만 다시 합니다 |
| 왼쪽 아래에 「무료」가 보임 | 그 부분을 눌러 「품앗이생협」을 고릅니다 |
| Code를 누르니 업그레이드 안내 | 품앗이생협 계정이 아닌 상태입니다. 위 칸대로 바꿉니다 |
| 403 오류, 로그인 오류 | 앱 메뉴에서 로그아웃했다가 다시 로그인합니다. 그래도 안 되면 창만 닫지 말고 앱을 완전히 끈 뒤 다시 켜고 로그인합니다 |
| AI가 폴더를 못 찾음, 파일을 못 만듦 | 채팅에 있는 것입니다. 「</> Code」에서 새 세션을 열고 폴더를 고릅니다 |
| 「허용하시겠습니까?」가 자꾸 뜸 | 권한 모드를 Bypass permissions로 바꿉니다(5번) |
| 화면이 하얗게 멈춤 | 앱을 다시 켜고 업데이트를 확인합니다 |
| 「Failed to load session」 | 고른 폴더가 없어졌거나 접근 권한이 없습니다. 다른 폴더를 고르거나 앱을 다시 켭니다 |
| 「Git is required」 | 앱을 업데이트합니다. 그래도 뜨면 Git for Windows를 깔고 다시 시도합니다 |
| 앱이 안 꺼짐 (Windows) | Ctrl+Shift+Esc로 작업 관리자를 열어 Claude를 끝냅니다 |