Claude 앱과 Claude Code 설치

이 장에서 하는 일

이 교육의 핵심은 "Claude에게 말로 부탁하면 Claude가 내 PC에서 직접 일한다"는 경험입니다. 그래서 이 장은 설치 방법을 외우는 시간이 아니라, 설치조차 Claude에게 맡겨 보는 시간입니다. 순서는 아래와 같습니다.

1. 앱 설치
2. Code 탭과 작업 폴더
3. 권한 질문 읽기
4. Claude에게 설치 부탁
5. 새 터미널에서 확인
6. Node.js와 Git for Windows 설치

Claude 데스크톱 앱 내려받기와 설치

공식 다운로드 주소는 claude.com/download 하나입니다. Windows와 Mac 모두 여기서 받아 설치 파일을 실행하면 됩니다.

Code 탭: 앱 안에서 쓰는 Claude Code

앱 위쪽 가운데에는 탭이 세 개 있습니다. 이 교육에서 가장 많이 쓰는 곳은 Code 탭입니다.

작업 폴더 만들기와 선택하기

Claude는 내가 지정한 폴더 안에서만 일합니다. 연습 전용 폴더를 하나 만들어 두면 실수해도 다른 파일에 영향이 없어 안전합니다. 이 장에서는 설치 작업용으로 문서 폴더 아래에 ai-setup이라는 빈 폴더를 씁니다. 사이트를 만들 ai-site 폴더는 3장에서 GitHub 저장소를 내려받을 때 자동으로 생깁니다.

1. 작업 폴더 만들기

   Windows: Win + E를 눌러 파일 탐색기를 열고, 왼쪽에서 "문서"를 누릅니다. 빈 곳에서 우클릭하고 새로 만들기, 폴더 순서로 누른 뒤 이름을 ai-setup로 입력하고 Enter를 누릅니다.

   Mac: Finder에서 "문서" 폴더를 열고 Shift + Command + N을 누른 뒤 이름을 ai-setup로 입력합니다.

   회사 PC의 문서 폴더가 OneDrive 안에 있어도 괜찮습니다

   회사 PC에서는 문서 폴더가 OneDrive와 동기화되어 있을 수 있습니다. 그대로 써도 동작합니다. 다만 나중에 파일이 많이 생기면 동기화가 느려질 수 있으니, 그럴 때는 동기화되지 않는 위치(예: C:\dev\ai-setup)에 폴더를 만들어도 됩니다.

2. Code 탭 열기

   Claude 앱 위쪽 가운데의 Code 탭을 누릅니다. 업그레이드 안내가 나오면 유료 플랜이 필요하다는 뜻입니다. 온라인 로그인을 요구하면 로그인을 끝내고 앱을 한 번 껐다가 다시 켜세요(공식 문서 안내).

3. 환경을 Local로 고르기

   입력창 근처에서 실행 환경을 고르는 곳이 있습니다. Local을 선택하세요. Local은 "내 컴퓨터의 파일을 직접 쓴다"는 뜻입니다. 같은 목록에 보이는 Cloud(인터넷상의 별도 환경에서 실행), SSH(다른 컴퓨터에 연결), WSL(Windows 안의 Linux 환경)은 지금은 쓰지 않습니다.

4. Select folder로 ai-setup 선택하기

   Select folder를 누르면 폴더를 고르는 창이 열립니다. 방금 만든 문서 아래의 ai-setup 폴더를 찾아 선택하고, 창 아래쪽의 확인 버튼(Windows는 보통 "폴더 선택", Mac은 보통 "열기")을 누릅니다. 화면에 폴더 이름 ai-setup가 표시되면 성공입니다.

5. 모델과 권한 모드 확인하기

   입력창의 전송 버튼 옆에 모델을 고르는 목록과 권한 모드를 고르는 선택기가 있습니다. 모델은 기본값 그대로 두세요. 권한 모드는 다음 절에서 설명하는 Manual이 선택되어 있는지 확인합니다.

권한(허용) 질문 읽는 법

Claude Code는 내 PC에서 파일을 만들고 명령을 실행합니다. 그래서 "어디까지 알아서 해도 되는지"를 정하는 장치가 있습니다. 이것이 권한 모드입니다.

예전 앱 버전에서는 이 모드들이 Ask permissions, Auto accept edits, Plan mode라는 이름으로 표시되었습니다. 이름은 달라도 같은 개념입니다.

질문이 뜨면 이렇게 읽으세요

1. 무엇을 하겠다는 질문인지 읽습니다

   "파일 만들기", "파일 고치기", "명령 실행" 중 무엇인지 먼저 봅니다. 파일을 고치는 질문이면 바뀌는 줄이 비교 화면에 나옵니다. 지워지는 줄과 새로 생기는 줄이 구분되어 보입니다.

2. 어디에 하겠다는 것인지 확인합니다

   파일 경로에 내가 고른 ai-setup 폴더가 들어 있으면 정상입니다. 문서, 바탕화면, 시스템 폴더 등 작업 폴더 밖의 경로가 보이면 멈추고 이유를 물어보세요.

3. 내가 부탁한 일과 맞는지 판단합니다

   맞으면 허용(Accept)을 누릅니다. 이상하거나 모르겠으면 거절(Reject)을 누르세요. 거절해도 아무것도 망가지지 않습니다. Claude가 "어떻게 진행할까요?"라고 다시 물어봅니다(공식 문서). 화면에 "항상 허용" 같은 선택지가 함께 보여도, 처음에는 한 번씩만 허용하며 익히는 것을 권합니다.

핵심 장면: Claude에게 "터미널에서도 쓸 수 있게 설치해줘"

이제 이 장의 중심입니다. 앱 안의 Claude에게 터미널용 Claude Code 설치를 부탁합니다. Claude가 내 PC에서 명령을 실행하고, 필요한 환경 설정까지 해 줍니다. 나는 읽고 허용만 누르면 됩니다.

1. 준비 상태를 확인합니다

   Code 탭에서 폴더가 ai-setup로 선택되어 있고, 권한 모드가 Manual인지 봅니다.

2. 아래 부탁을 복사해 입력창에 붙여넣고 Enter를 누릅니다

   Claude Code를 터미널(PowerShell 또는 Mac 터미널)에서도 쓸 수 있게 설치해줘.
   설치가 끝나면 어느 폴더에서든 claude 라고만 입력하면 실행되도록 PATH(전역변수)에도 잡아줘.
   
   이렇게 진행해줘.
   1. 먼저 내 컴퓨터가 Windows인지 Mac인지, 이미 claude 명령이 설치되어 있는지 확인해줘.
   2. 없으면 Anthropic 공식 문서의 네이티브 설치 방법으로 설치해줘. 다른 사이트의 설치 방법은 쓰지 마.
   3. 설치가 끝나면 claude 실행 파일이 있는 폴더가 PATH에 들어갔는지 확인하고, 빠져 있으면 내 계정 범위에서만 추가해줘. 관리자 권한이 필요한 작업이나 다른 설정 변경은 하지 마.
   4. 지금 열려 있는 이 화면에는 새 PATH가 바로 반영되지 않을 수 있으니, 실행 파일의 전체 경로로도 claude --version 을 실행해서 확인해줘.
   5. 각 단계를 하기 전에 무엇을 할지 한 줄로 알려주고, 마지막에는 어디에 무엇을 설치했고 PATH를 어떻게 바꿨는지 초보자도 이해할 수 있게 쉬운 한국어로 정리해줘.

   Claude가 먼저 내 PC 종류를 확인하고, 공식 설치 명령을 실행하고, PATH와 버전을 확인한 뒤 결과를 요약합니다.

3. Claude가 일하는 모습을 지켜봅니다

   Claude는 먼저 "내 PC가 Windows(또는 Mac)이고, claude 명령이 아직 없다"는 식으로 확인 결과를 알려줍니다. 그다음 설치 명령을 실행하려 하면서 허용 질문을 띄웁니다. 질문 안의 명령에 claude.ai/install이 들어 있는지 확인하고 허용하세요. 명령이 실행되는 동안 화면에 글자가 흘러가는데, 수십 초에서 몇 분 걸릴 수 있습니다.

4. 끝나면 Claude의 요약을 읽습니다

   성공하면 Claude가 설치된 위치, PATH를 바꾼 내용, claude --version 결과(예: 2.1.xxx (Claude Code) 형태)를 정리해 줍니다. 버전 숫자는 설치하는 시점에 따라 다릅니다. 이 요약을 읽어 두면 아래 "Claude가 하는 일" 설명과 비교해 볼 수 있습니다.

Claude가 하는 일

Claude가 실제로 실행하는 명령은 공식 문서에 나온 설치 방법과 같습니다. 눈으로 한 번 읽어 두면 "내 PC에서 무슨 일이 일어났는지" 이해할 수 있습니다. 아래 명령은 Claude가 대신 실행하므로 직접 입력하지 않아도 됩니다.

# 1. 이미 설치되어 있는지 확인 (없으면 오류 문구가 나오는 것이 정상)
Get-Command claude
# 2. 공식 설치 스크립트 실행
irm https://claude.ai/install.ps1 | iex
# 3. PATH에 .local\bin 폴더가 들어 있는지 확인 (아무것도 안 나오면 없는 것)
$env:PATH -split ';' | Select-String '\.local\\bin'
# 4. 전체 경로로 버전 확인 (새 터미널이 아니어도 동작)
& "$env:USERPROFILE\.local\bin\claude.exe" --version

# 1. 이미 설치되어 있는지 확인
which claude
# 2. 공식 설치 스크립트 실행
curl -fsSL https://claude.ai/install.sh | bash
# 3. PATH에 .local/bin 폴더가 들어 있는지 확인 (아무것도 안 나오면 없는 것)
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
# 4. 없으면 zsh 설정 파일에 추가하고 바로 반영
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 5. 버전 확인
claude --version

설치 프로그램이 PATH 등록까지 함께 처리하는 경우가 많지만, 환경에 따라 빠질 수 있습니다. 그래서 위 3번, 4번 확인과 추가 단계가 있는 것입니다. 이 설치 방식은 공식 문서가 권장하는 "네이티브 설치"입니다. 그 밖에 Windows의 winget install Anthropic.ClaudeCode, Mac의 brew install --cask claude-code 방법도 있지만, 이 두 방법은 자동 업데이트가 되지 않으므로 이 교육에서는 쓰지 않습니다.

직접 해보는 확인: 새 터미널에서 claude --version

Claude가 "설치했다"고 말했더라도, 내가 직접 새 터미널에서 확인해 보면 확신이 생깁니다. 이 확인은 앞으로도 도구가 이상할 때마다 쓰는 기본 습관입니다.

Windows

1. 새 PowerShell 열기

   Win + X를 누르고 메뉴에서 Windows PowerShell(또는 "터미널")을 선택합니다. 시작 메뉴에서 "PowerShell"을 검색해도 됩니다. 깜빡이는 커서가 있는 창이 열립니다.

   창의 줄 맨 앞이 PS C:\Users\[내 이름]>처럼 PS로 시작하면 PowerShell이 맞습니다. PS 없이 C:\Users\[내 이름]>로 시작하면 CMD(명령 프롬프트)입니다. 이 경우 창을 닫고 PowerShell로 다시 여세요.

2. 버전 확인 명령 입력

   아래 명령을 복사해 붙여넣고 Enter를 누릅니다. PowerShell 창에서는 Ctrl + V 또는 마우스 오른쪽 클릭으로 붙여넣을 수 있습니다.

   # 버전 확인
   claude --version
   # 설치 상태 점검 (읽기만 하는 진단, 세션을 시작하지 않음)
   claude doctor
   # claude가 어느 파일로 실행되는지 보기 (선택)
   Get-Command claude

Mac

1. 새 터미널 열기

   Command + Space를 눌러 Spotlight 검색을 열고 Terminal을 입력한 뒤 Enter를 누릅니다. 커서가 깜빡이는 창이 열리면 터미널입니다.

2. 버전 확인 명령 입력

   # 버전 확인
   claude --version
   # 설치 상태 점검
   claude doctor
   # claude가 어느 파일로 실행되는지 보기 (선택)
   which claude

Node.js와 Git for Windows 설치

앞으로 두 가지 도구가 더 필요합니다. 둘 다 없으면 설치해 달라고 Claude에게 부탁하면 됩니다.

Windows: winget으로 확인하고 설치하기

Windows에는 winget이라는 설치 도구가 기본으로 들어 있습니다(Windows 10 1809 이상, 앱 설치 관리자의 일부). 앱 스토어의 "앱 설치 관리자" 구성 요소가 최신이면 바로 쓸 수 있습니다. 아래 부탁을 Code 탭에 입력하세요.

내 Windows PC에 Node.js와 Git for Windows가 설치되어 있는지 확인해줘.
- node --version 과 git --version 으로 확인하고, 결과를 쉬운 말로 알려줘.
- Node.js는 22 이상이어야 하고 LTS 버전이면 좋아. 없거나 22 미만이면 winget 으로 설치해줘. 패키지 이름은 OpenJS.NodeJS.LTS 야.
- Git for Windows 가 없으면 winget 으로 설치해줘. 패키지 이름은 Git.Git 이야.
- 설치하기 전에 무엇을 설치할지 먼저 알려주고, 설치한 뒤에는 새 터미널을 열어야 반영된다는 점도 알려줘.
- 이미 충분한 버전이 있으면 아무것도 설치하지 말고 "이미 준비되어 있습니다"라고만 알려줘.

Claude가 버전을 확인하고, 필요한 것만 winget으로 설치합니다.

Mac: 확인하고 안내받기

내 Mac에 Node.js와 Git이 설치되어 있는지 확인해줘.
- node --version 과 git --version 으로 확인하고, 결과를 쉬운 말로 알려줘.
- Node.js는 22 이상이어야 하고 LTS 버전이면 좋아. 없거나 낮으면 nodejs.org 의 LTS 설치 파일을 내가 직접 내려받아 설치하는 방법을 화면 순서대로 알려줘.
- Git 이 없으면 Mac이 안내하는 명령줄 개발자 도구 설치 방법을 알려줘.
- 이미 충분한 버전이 있으면 아무것도 설치하지 말고 "이미 준비되어 있습니다"라고만 알려줘.
- 내 허락 없이 Homebrew 같은 새 도구를 설치하지는 마.

Mac에서는 Claude가 확인하고 안내하며, 설치 파일은 내가 직접 실행합니다.

# Node.js 버전 (v22 이상의 숫자가 나오면 성공. 예: v24.x.x)
node --version
# Git 버전 (git version 2.x.x 같은 줄이 나오면 성공)
git --version

이 장에서 자주 막히는 곳

터미널에서 claude 라고 입력하면 "인식되지 않습니다" 또는 "command not found" 라고 나와요.
Claude Code 설치 위치와 PATH 설정을 점검하고 고쳐줘.
- 실행 파일이 실제로 있는지, PATH에 그 폴더가 들어 있는지 먼저 확인해줘.
- 고치기 전에 무엇을 바꿀지 알려주고, 내 계정(사용자) 범위에서만 바꿔줘.
- 다 끝나면 내가 새 터미널을 열어 확인하는 방법을 알려줘.

# 내 계정(사용자) PATH 끝에 .local\bin 추가
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# Windows (PowerShell)
winget install Anthropic.ClaudeCode
# Mac (Homebrew가 설치되어 있을 때)
brew install --cask claude-code