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. 품앗이 메일로 로그인

  1. 로그인 화면에서 품앗이 메일 주소(○○○@poomasi.org)를 넣고 「이메일로 계속하기」를 한 번만 누릅니다.
  2. 웹메일(webmail.poomasi.org)에 들어가 Anthropic에서 온 메일을 열고 로그인 버튼을 누릅니다. 메일을 받고 10분 안에 눌러야 합니다.
  3. 로그인되면 왼쪽 아래 계정 이름 옆에 「품앗이생협」이 보이는지 확인합니다. 「무료」라고 보이면 그 부분을 눌러 「품앗이생협」을 고릅니다.

이것만 피하세요

  • 구글 계정으로 로그인하지 마세요. 품앗이 메일 주소로만 들어갑니다.
  • 「다시 보내기」를 여러 번 누르지 마세요. 한 번 누르고 웹메일에서 기다리세요.

3. 「</> Code」로 들어가기

사이드바 맨 위의 탭 중 「</> Code」를 누릅니다. 탭이 아이콘으로만 보이면 마우스를 올려 이름을 확인하세요.

탭여기서 하는 일
채팅·프로젝트 (말풍선)일반 대화. 작업에는 쓰지 않습니다. 내 폴더를 못 보고, 다음에 열면 잊습니다
</> Code작업방 폴더에서 문서·파일을 직접 만들고 고칩니다. 우리 일은 여기서 합니다

Code를 눌렀는데 이런 화면이 나오면

  • 업그레이드 안내: 유료 조직 계정이 아닌 상태입니다. 2번의 「품앗이생협」 선택을 다시 확인하세요.
  • 온라인 로그인 안내: 로그인을 마치고 앱을 다시 켭니다.
  • 403 오류: 9번 「막혔을 때」를 보세요.

Code 안에서 대화 하나를 세션이라고 부릅니다. 세션마다 대화 기록과 폴더, 바뀐 내용이 따로 갑니다.

4. 첫 세션 시작하기

입력창 아래 줄에 고를 것이 네 가지 있습니다. 첫 메시지를 보내기 전에 차례로 고릅니다.

  1. 환경: 줄의 맨 앞 칸입니다. 「Local」 묶음의 맨 위 항목을 고릅니다. Local은 내 컴퓨터에서 돈다는 뜻입니다.
  2. 폴더: 환경 바로 옆 칸입니다. 「Open folder…」를 눌러 작업방 폴더를 고릅니다. 작업방이 아직 없으면 처음 한 번만 「문서」 폴더를 고르고 지시문 ①을 붙입니다. 그 안에 작업방 폴더가 생깁니다.
  3. 권한 모드: AI가 묻지 않고 어디까지 할지 정합니다. 5번을 보세요.
  4. 모델: 줄의 오른쪽 끝 쪽에 있습니다. 나중에 바꿔도 됩니다.

그다음 입력창에 할 일을 쓰고 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는 묻지 않고 바로 하니 그럴 일이 없습니다. 대신 두 가지를 지킵니다.

  1. 작업방 폴더를 골라서 일합니다. 작업방을 처음 만들 때 말고는 바탕화면이나 문서 폴더 전체를 고르지 않습니다.
  2. 원본은 그대로 두고 새 이름으로 저장하게 시킵니다. 「원본은 건드리지 말고 새 파일로 저장해 줘」라고 한 줄 붙이면 됩니다.

공식 문서는 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다음 세션으로
EscAI 응답 멈추기
Ctrl+Shift+M권한 모드 메뉴
Ctrl+;곁가지 질문(본 대화에 섞이지 않게 따로 묻기)
Ctrl+/단축키 전체 보기

7. 토큰과 세션: 한 세션에 한 가지 일

  • 한 세션에서는 한 가지 일만 합니다. 다른 일은 「+ New」로 새 세션을 엽니다. 한 세션에 일을 섞으면 대화가 길어져 사용량이 빨리 닳고 AI도 헷갈립니다.
  • 일이 끝나면 「정리해」라고 씁니다. AI가 한 일과 남은 일을 작업방에 기록합니다.
  • 다음에 이어 할 때는 새 세션을 열고 「이어서」라고 씁니다. 기록을 읽고 남은 일부터 합니다.

사용량 확인

  • 이 세션의 대화가 얼마나 찼는지: 대화창 옆 「Context」 카드에 퍼센트로 나옵니다. 입력창에 /context를 쳐도 됩니다.
  • 요금제 사용량: 입력창 아래 줄의 동그라미(사용량 고리)를 누릅니다. 모든 Claude Code 세션이 함께 쓰는 양입니다.
  • 대화가 꽉 차면 AI가 앞부분을 스스로 요약하고 이어 갑니다. 미리 줄이려면 /compact를 칩니다.

자세한 내용은 AI 토큰 사용량과 절약법을 보세요.

8. 다음 단계

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를 끝냅니다

공식 문서