이 장에서는 바이브 코딩을 위한 환경을 설정합니다. 앞선 책에서는 실습에 있어 가장 큰 허들이었던 장인데, 이 책에서는 앱 하나를 설치하고 로그인하는 것이 사실상 전부입니다. Windows에서는 Code 탭을 처음 켤 때 git 설치와 재부팅이 한 번 필요합니다.

1. 설치 순서

1.1 시스템 요구사항

Claude Desktop은 다음 운영체제(OS)에서 동작합니다.

• Windows: Windows 10 이상 (x64 또는 ARM64)
• macOS: macOS 11(Big Sur) 이상 (인텔·애플 실리콘 모두 지원)

이보다 오래된 OS에서는 설치 파일이 실행되지 않거나, 설치 후에도 정상 동작하지 않을 수 있습니다. 최소 사양은 앱 버전이 올라가면서 바뀔 수 있으니, 헷갈릴 때는 공식 다운로드 페이지(claude.ai/download)에서 한 번 더 확인하세요.

1.2 설치 파일 내려받기

웹 브라우저에서 claude.ai/download에 접속합니다. 접속하면 페이지가 지금 쓰는 운영체제를 자동으로 인식해, Windows에서는 'Download for Windows', macOS에서는 'Download for macOS' 버튼이 표시됩니다. 보이는 버튼을 눌러 설치 파일을 내려받으세요.

1.3 Windows에서 설치

1. 내려받은 설치 파일(.exe)을 실행합니다. UAC(사용자 계정 컨트롤) 창이 뜨면 허용해 주세요.
2. 설치 마법사의 안내에 따라 설치를 완료합니다.
3. 시작 메뉴에서 Claude를 검색하여 실행합니다.

1.4 macOS에서 설치

1. 내려받은 .dmg 파일을 엽니다. (인텔·애플 실리콘 공용 설치 파일입니다.)
2. 창이 열리면 Claude 아이콘을 Applications 폴더로 드래그합니다.
3. Applications 폴더 또는 Spotlight(⌘ + Space)에서 Claude를 검색하여 실행합니다. 인터넷에서 받은 앱이라 첫 실행 때 "여시겠습니까?"라고 묻는 확인 창이 뜨면 열기를 누르면 됩니다.

1.5 로그인과 기본 설정

Claude를 실행하면 로그인 화면이 나타납니다. claude.ai에서 쓰던 계정으로 로그인하면 됩니다. 계정이 없다면 이 화면에서 만들 수 있습니다. 로그인 후 왼쪽 아래 프로필 아이콘을 누르면 설정으로 들어갈 수 있습니다.

당장 손볼 것은 많지 않습니다. 언어가 한국어로 되어 있는지, 다크 모드를 쓸지 정도만 보시면 됩니다. 나머지 설정은 필요해지는 장에서 다룹니다.

2. Code 탭 켜기

Code 탭은 첫 사용 전에 한 번의 준비가 필요합니다. 처음 두 단계는 Windows와 macOS가 같고, 마지막 준비만 운영체제에 따라 갈립니다.

1. 플랜 확인: Code 탭은 유료 플랜(Pro 이상)에서만 쓸 수 있습니다. 화면에 Code 탭 자체가 보이지 않는다면 먼저 본인 플랜부터 확인해주세요.

2. 활성화 진행: 유료 계정이어도 결제하자마자 바로 켜지는 것은 아닙니다. 왼쪽 위의 Code 탭을 누르면 실행 환경을 설정하겠다는 안내 버튼이 나타나고, 클릭하면 준비가 진행됩니다. 버튼에 마우스를 올려보면 준비가 몇 %나 되었는지 볼 수 있습니다.

3. git 설치와 재부팅(Windows): 준비가 완료되면 컴퓨터가 자동으로 재부팅되고, 다시 켜면 탭이 열립니다. 재부팅은 첫 활성화 때 한 번이면 됩니다. 여기에 더해 git이라는 프로그램도 설치되어 있어야 합니다. https://git-scm.com/ 에 접속해 Install for Windows를 클릭하고 Click here to download로 설치 파일을 내려받아 설치를 진행해주세요. 옵션을 묻는 화면이 여러 번 나오는데 기본 설정 그대로 두고 다음 버튼만 눌러서 설치하시면 됩니다.

   

   

   설치를 마쳤으면 제대로 깔렸는지 확인해봅니다. 이 책에서 검은 화면을 여는 유일한 순간입니다. 시작 메뉴에서 명령 프롬프트를 검색해 열고 git --version을 입력한 뒤 Enter를 누르세요. 아래처럼 버전 번호가 나오면 준비가 끝난 것입니다. 숫자가 꼭 저와 같을 필요는 없습니다. 창은 닫으셔도 됩니다.

   

4. git 확인(macOS): macOS에서는 대부분 재부팅 없이 준비가 끝나는 대로 Code 탭이 열립니다. git도 대부분의 Mac에 이미 설치되어 있지만, 일부 기기에는 없는 경우가 있으니 한 번만 확인해주세요. Spotlight(⌘ + Space)에서 터미널을 검색해 열고, git --version을 입력한 뒤 Enter를 누릅니다. 버전 번호가 나오면 이미 설치된 것이니 그대로 쓰면 됩니다. 설치되어 있지 않다면 이어서 xcode-select --install을 입력하고 Enter를 누르세요. 실행하면 명령어 라인 개발자 도구를 설치하겠냐는 확인 창이 뜨는데, 설치를 누르고 완료될 때까지 기다리면 git까지 함께 설치됩니다.

준비가 끝나면 사이드바 위쪽의 Code 탭을 누를 수 있게 됩니다. Code 탭으로 넘어가면 사이드바 항목도 새로 생성, 아티팩트, 사용자 지정처럼 Code 작업에 맞게 바뀝니다.

3. 설치와 실행이 막힐 때

윈도우나 맥에서 다양한 문제를 만나실 수 있습니다. 앞선 책에 비하면 훨씬 적지만, 없지는 않습니다. 이러한 문제를 만나는 상황을 익숙하게 받아들이셨으면 좋겠어요.

여기 나와있지 않은 문제는 위니버시티 디스코드에 제보 부탁드립니다. 추가된 사례는 이 책에 업데이트 해놓겠습니다.

• 위니버시티 디스코드: https://discord.gg/MASRTmyu8a

3.1 OS가 너무 오래된 경우

시스템 요구사항(Windows 10 이상 / macOS 11 이상)보다 오래된 OS라면 설치 파일이 실행되지 않을 수 있습니다. 가능하면 OS를 업데이트하거나 지원되는 기기에서 진행하기를 권장합니다. 또한 Claude Desktop 앱은 64비트(x64·ARM64) 전용입니다. 드물게 남아 있는 32비트 Windows에는 설치되지 않습니다.

3.2 Code 탭이 끝내 켜지지 않는 경우

위 2절의 과정을 마쳤는데도 탭이 열리지 않는다면 순서대로 확인해 보세요.

1. 플랜이 Pro 이상인지 확인합니다. 결제 직후라면 앱을 완전히 껐다 켜 보세요. 오른쪽 위 X는 창만 닫을 뿐 프로그램은 뒤에서 계속 돌고 있으니, 메뉴의 파일 > 종료를 눌러야 합니다.
2. Windows라면 git이 제대로 설치되었는지 git --version으로 다시 확인합니다.
3. 재부팅을 마쳤는지 확인합니다.
4. 그래도 해결되지 않으면 채팅 탭에서 Claude에게 물어보세요. 'Claude Desktop Code 탭이 켜지지 않는데 내 컴퓨터는 Windows 11이야. 확인할 것을 순서대로 알려줘.'처럼 상황을 적으면 됩니다.

3.3 Cowork 탭이 켜지지 않는 경우

이 책의 실습은 Code 탭 위주라 Cowork가 안 켜져도 진행에 지장은 없습니다. 다만 Windows에서 Cowork를 쓰려면 '가상 머신 플랫폼' 기능이 켜져 있어야 합니다. 제어판 > 프로그램 > Windows 기능 켜기/끄기에서 아래 항목을 체크하고 재부팅하면 대부분 해결됩니다.

• Hyper-V
• Windows 하이퍼바이저 플랫폼
• 가상 머신 플랫폼
• Linux용 Windows 하위 시스템
• 컨테이너

그래도 안 되면 BIOS에서 가상화(인텔은 VT-x, AMD는 SVM/AMD-V)를 켜야 하는 경우입니다. 'Claude Desktop 가상화 BIOS 설정'으로 검색하면 기종별 방법을 찾을 수 있습니다. 회사 PC라면 IT 담당자에게 요청하세요.

3.4 기타 문제

현재 정리된 것 외에도 OS에 따라, 사용자 환경에 따라 다양한 문제가 발생할 수 있습니다. 대부분의 문제는 Claude가 해결할 수 있으니 화면에 나온 문구를 그대로 복사해서 채팅 탭에 질문하기를 권해 드립니다.