강의 당일 실습을 바로 시작하려면 아래 5단계를 미리 끝내고 와 주세요. 맥, 윈도우 모두 지원합니다.
Claude Desktop은 브라우저 없이 PC에서 바로 Claude를 사용할 수 있는 공식 앱입니다. Code / Cowork 메뉴는 이 데스크탑 앱 안에 들어 있습니다.
1. https://claude.ai/download 접속
2. "Download for Mac" 버튼 클릭 (애플 실리콘 / 인텔 자동 감지)
3. 다운받은 .dmg 파일 실행
4. Claude 아이콘을 Applications 폴더로 드래그해서 설치
5. Launchpad 또는 Spotlight(⌘ + Space)에서 "Claude" 검색 → 실행
6. Pro 요금제 계정으로 로그인
1. https://claude.ai/download 접속
2. "Download for Windows" 버튼 클릭
3. 다운받은 .exe 설치 파일 실행
4. 설치 마법사가 자동으로 진행됩니다 (별도 옵션 선택 없음)
5. 설치 완료 후 시작 메뉴에서 "Claude" 검색 → 실행
6. Pro 요금제 계정으로 로그인
Git은 Cowork 기능이 내부적으로 사용하는 필수 도구입니다.
터미널을 엽니다 (Spotlight: ⌘ + Space → "터미널" 검색).
아래 명령어를 입력하세요:
git --version이미 설치되어 있다면 git version 2.xx.x 같은 결과가 나옵니다. 설치되지 않았다면 자동으로 "개발자 도구를 설치하시겠습니까?" 팝업이 뜨는데 설치를 누르면 끝입니다.
https://git-scm.com/download/mac 에서 다운로드
git --version 입력 → 버전이 나오면 완료
1. https://git-scm.com/download/win 접속
2. "64-bit Git for Windows Setup" 다운로드
3. 설치 파일 실행 → 옵션은 모두 기본값(Next)으로 진행
4. 설치 완료
git --version 입력 → 버전이 나오면 완료
Claude Code CLI는 Node.js 환경에서 동작합니다. 먼저 Node.js를 설치해야 합니다.
1. https://nodejs.org/ko 접속
2. LTS 버전 (왼쪽 권장 버튼) 다운로드
3. 다운받은 .pkg 파일 실행 → 계속 → 동의 → 설치
4. 설치 완료 후 터미널을 완전히 종료하고 다시 엽니다 (⌘ + Q).
node --version 입력 → v20.x.x 같은 버전이 나오면 완료
1. https://nodejs.org/ko 접속
2. LTS 버전 (왼쪽 권장 버튼) 다운로드
3. 다운받은 .msi 파일 실행 → Next 계속 누르며 설치
4. 설치 완료 후 PowerShell을 완전히 종료하고 다시 엽니다.
node --version 입력 → v20.x.x 같은 버전이 나오면 완료
Node.js가 설치되면 Claude Code CLI는 명령어 한 줄로 설치할 수 있습니다.
npm install -g @anthropic-ai/claude-code설치가 시작되며 1~2분 소요됩니다.
✅ 마지막에 added 1 package in 1s 또는 added 254 packages in 5s 같은 줄이 나오면 설치 성공입니다. (에러처럼 보여도 빨간 글씨가 아니면 정상 출력이에요.)
npm error code EACCES / permission denied
맥에 nodejs.org 공식 설치 파일로 Node를 설치한 경우, 글로벌 npm 폴더(/usr/local/lib/node_modules)에 쓰기 권한이 없어서 자주 발생합니다. 해결 방법은 두 가지입니다.
방법 A (가장 간단) — sudo를 붙여서 한 번만 실행
sudo npm install -g @anthropic-ai/claude-code맥 로그인 비밀번호를 한 번 입력하면 진행됩니다. (입력해도 화면에 글자는 안 보입니다 — 정상)
방법 B (권장 · 매번 sudo 안 쓰는 영구 해결) — 사용자 폴더로 npm 글로벌 경로 변경:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc그런 다음 sudo 없이 다시 설치:
npm install -g @anthropic-ai/claude-code한 번 설정하면 이후 모든 글로벌 npm 설치가 권한 에러 없이 됩니다.
claude --version1.x.x 같은 버전이 나오면 설치 완료입니다. 다음 단계에서 실제로 Claude Code를 실행합니다.
터미널에 아래 한 글자를 입력하고 엔터를 누르세요. 이게 Claude Code를 실행하는 명령입니다.
claude처음 실행하면 "Welcome to Claude Code"와 함께 "Choose the text style..."(테마 선택) 화면이 먼저 뜹니다. 이 화면이 보인다는 것 자체가 설치가 잘 됐다는 신호예요. 아직 브라우저가 안 열리는 게 정상입니다 — 로그인은 테마 선택 다음 단계에서 진행돼요.
테마는 Dark mode 그대로 Enter만 눌러도 됩니다 (나중에 /theme으로 변경 가능). 이어서 로그인 단계가 나오면 Enter → 브라우저가 자동으로 열리며 로그인 페이지로 이동합니다. Pro 요금제 계정으로 로그인하면 터미널에 > 같은 입력창이 뜨면서 Claude Code 인터랙티브 모드가 켜집니다.
※ 브라우저가 자동으로 안 열리면 터미널에 표시된 URL을 복사해 브라우저 주소창에 직접 붙여넣으면 됩니다.
npm install -g @anthropic-ai/claude-code설치가 시작되며 1~2분 소요됩니다.
✅ 마지막에 added 1 package in 1s 또는 added 254 packages in 5s 같은 줄이 나오면 설치 성공입니다. (에러처럼 보여도 빨간 글씨가 아니면 정상 출력이에요.)
EACCES / EPERM / permission denied / access is denied
권한 문제로 글로벌 npm 폴더에 설치하지 못해서 발생합니다. PowerShell을 관리자 권한으로 실행한 뒤 다시 시도하면 해결됩니다.
방법 — 관리자 권한 PowerShell 열기
1. 시작 메뉴(Win) → "PowerShell" 검색
2. 검색 결과에서 마우스 오른쪽 클릭 → "관리자 권한으로 실행"
3. UAC 창에서 "예" 클릭
4. 새로 열린 PowerShell에서 다시:
npm install -g @anthropic-ai/claude-code그래도 실행 정책 에러가 뜬다면 (execution of scripts is disabled) 아래 명령을 한 번 실행:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned"Y" 입력 후 엔터. 그런 다음 다시 npm 설치 명령을 실행합니다.
claude --version1.x.x 같은 버전이 나오면 설치 완료입니다. 다음 단계에서 실제로 Claude Code를 실행합니다.
PowerShell에 아래 한 글자를 입력하고 엔터를 누르세요. 이게 Claude Code를 실행하는 명령입니다.
claude처음 실행하면 "Welcome to Claude Code"와 함께 "Choose the text style..."(테마 선택) 화면이 먼저 뜹니다. 이 화면이 보인다는 것 자체가 설치가 잘 됐다는 신호예요. 아직 브라우저가 안 열리는 게 정상입니다 — 로그인은 테마 선택 다음 단계에서 진행돼요.
테마는 Dark mode 그대로 Enter만 눌러도 됩니다 (나중에 /theme으로 변경 가능). 이어서 로그인 단계가 나오면 Enter → 브라우저가 자동으로 열리며 로그인 페이지로 이동합니다. Pro 요금제 계정으로 로그인하면 PowerShell에 > 같은 입력창이 뜨면서 Claude Code 인터랙티브 모드가 켜집니다.
※ 브라우저가 자동으로 안 열리면 PowerShell에 표시된 URL을 복사해 브라우저 주소창에 직접 붙여넣으면 됩니다.
wsl --install 한 줄)
Claude for Chrome은 크롬 안에서 Claude를 바로 호출하고 웹페이지 자동화에 사용하는 공식 브라우저 확장입니다. 강의 실습 때 씁니다.
1. 크롬에서 claude.com/claude-for-chrome 접속
2. "Add to Chrome" (크롬에 추가) 버튼 클릭
3. 권한 확인 팝업이 뜨면 "확장 프로그램 추가" 클릭
4. 크롬 우측 상단 퍼즐(🧩) 아이콘 → Claude 항목 옆 핀(📌) 클릭해서 툴바에 고정
5. 툴바의 Claude 아이콘 클릭 → 본인 Claude 계정으로 로그인 (이미 claude.com에 로그인되어 있으면 한 번 클릭으로 연결됨)
설치를 다 한 것 같다고요? 터미널 명령어를 직접 외울 필요 없습니다. 클로드한테 한 줄 물어보면 끝이에요.
아래 둘 중 편한 방법 하나만 하면 됩니다.
claude 한 줄 입력 → 엔터.화면에 > 입력창이 보이고 클로드 인사말이 떠 있으면 OK.
위 > 입력창에 아래를 그대로 붙여넣고 엔터:
Git, Node, Claude Code 다 잘 깔렸는지 확인하고
4개 항목(Claude Desktop · Git · Node · Claude Code) 옆에 ✓ 또는 ✗ 로 알려줘.
✗ 있으면 어디 가서 어떻게 깔면 되는지 한 줄로 알려줘.클로드가 직접 자기 컴퓨터를 확인해서 표로 정리해줍니다. 모두 ✓ 나오면 끝.
각 항목을 클릭하면 확인 명령어와 "이게 나오면 정상" 기준이 열립니다. 위에서 아래로 하나씩 체크해보세요.
맥: Spotlight(⌘ + Space)에 "Claude" / 윈도우: 시작 메뉴에 "Claude" 검색 → 앱 실행 → 로그인.
터미널(맥) 또는 PowerShell(윈도우)에 입력:
git --versiongit version 2.xx.x 처럼 버전 숫자가 나옵니다.터미널/PowerShell에 두 줄을 차례로 입력:
node --version
npm --versionv20.x.x, 10.x.x 같은 버전 숫자가 나옵니다.터미널/PowerShell에 입력:
claude --version2.x.x (Claude Code) 같은 버전이 나옵니다.이어서 실제 실행도 확인:
claude> 입력창이 바로 뜹니다. 테마 선택 화면에서는 Enter → 로그인 진행하면 됩니다.크롬 우측 상단 퍼즐(🧩) 아이콘을 눌러 목록에 Claude가 있는지 확인 → Claude 아이콘 클릭.
| 증상 | 해결 방법 |
|---|---|
claude 입력했더니 "명령을 찾을 수 없음" |
터미널을 완전히 닫고 다시 열기. 그래도 안 되면 Node.js 재설치 |
npm 입력 시 권한 오류 |
맥: 명령어 앞에 sudo 붙이기 / 윈도우: PowerShell을 관리자 권한으로 실행 |
| 데스크탑 앱 메뉴가 여전히 비활성화 | 데스크탑 앱을 완전히 종료(트레이 포함)하고 재시작 |
| 윈도우에서 자꾸 에러 발생 | WSL 설치 권장: PowerShell 관리자 권한 → wsl --install |