CC
CLAUDE CODE 준비 · 05 CLAUDE CODE

클로드 코드 설치하고
첫 프로그램 만들기

명령어 한 줄로 클로드 코드를 설치하고, 로그인한 뒤, 한국어로 말해서 프로그램을 만들어 봅니다.

소요 시간 약 10분Windows 10 / 11유료 플랜 계정 필요앞의 4개 설치 완료 후v1.0 · 2026-07-26
한눈에 보기

Claude Code 설치 전체 흐름

사전 점검 → 설치 명령 한 줄 → 로그인 → 첫 실행 순서입니다. 설치 마법사 창은 없습니다.

01 🔍 사전 점검 STEP 1 02 ⌨️ 설치 명령 STEP 2–4 03 🔑 로그인 STEP 5–6 04 💬 첫 대화 STEP 7–8 05 🛠 점검·활용 STEP 9–10 필요한 것 Git · Node.js · VS Code 설치 완료 · Claude 유료 플랜 계정(Pro/Max/Team/Enterprise) · 인터넷 연결 | 무료 플랜은 사용 불가
STEP 1CLAUDE CODE · 사전 점검

앞의 3개가 잘 설치됐는지 확인

Windows PowerShell ✕ PS C:\Users\hufs> git --version; node --version; npm --version git version 2.51.0.windows.1 v24.9.0 11.6.2 PS C:\Users\hufs> _ 1 2 빨간 오류가 보이면 git 오류 → 02-git-guide 로 node / npm 오류 → 03-nodejs-guide 로 대부분 터미널을 새로 열면 해결됩니다. 3
이 단계의 목표

설치를 시작하기 전에 준비물이 모두 갖춰졌는지 확인합니다.

  1. PowerShell을 새로 열고 아래 한 줄을 붙여넣은 뒤 Enter.
  2. 세 줄이 모두 버전 숫자로 나오면 준비 완료입니다.
  3. 빨간 오류가 보이면 해당 가이드(02·03번)로 돌아가세요.
한 번에 확인 (세미콜론으로 3개 연결) 
git --version; node --version; npm --version
Node.js가 없어도 됩니다

다음 방법 A(네이티브 설치)는 Node.js 없이도 동작합니다. 다만 다른 도구를 위해 설치해 두는 편이 좋습니다.

STEP 2CLAUDE CODE · 설치 (방법 A · 권장)

네이티브 설치 — 명령 한 줄

Windows PowerShell ✕ PS C:\Users\hufs> irm https://claude.ai/install.ps1 | iex Downloading Claude Code… Installing to C:\Users\hufs\.local\bin ████████████████████████ 100% ✔ Claude Code installed successfully Run 'claude' to get started. PS C:\Users\hufs> _ 2 3 1 붙여넣기 방법 PowerShell에서는 Ctrl+V 대신 마우스 오른쪽 클릭 = 붙여넣기 (Ctrl+V 도 되는 경우가 많습니다) 붙여넣은 뒤 Enter 를 누르세요.
이 단계의 목표

Node.js 없이도 동작하고 자동 업데이트되는 권장 방식으로 설치합니다.

  1. PowerShell 창인지 확인합니다. (PS C:\…> 로 시작)
  2. 아래 명령을 복사해 붙여넣고 Enter. (붙여넣기 = 마우스 오른쪽 클릭)
  3. installed successfully 가 나올 때까지 1~3분 기다립니다.
방법 A · 네이티브 설치 (권장) 
irm https://claude.ai/install.ps1 | iex
'irm' 용어가 인식되지 않습니다

지금 창이 CMD(명령 프롬프트) 입니다. 이 명령은 PowerShell 전용입니다. Windows 키 → powershell 로 다시 여세요.

왜 이 방법이 권장인가요?

npm 권한 문제를 피할 수 있고, 업데이트가 자동으로 이루어집니다.

STEP 3CLAUDE CODE · 설치 (방법 B)

npm 설치 — 방법 A가 막혔을 때

Windows PowerShell ✕ PS C:\Users\hufs> npm install -g @anthropic-ai/claude-code npm warn deprecated some-package@1.0.0: no longer supported npm warn deprecated other-package@2.1.0: use v3 instead added 128 packages in 47s PS C:\Users\hufs> _ 1 2 3 노란 warn 은 정상입니다 npm은 부가 정보를 노란색으로 알립니다. 빨간 npm ERR! 만 실제 오류 이 경우 방법 A(네이티브)로 다시 시도하거나 관리자 권한 PowerShell 로 실행하세요.
이 단계의 목표

네이티브 설치가 막히는 환경에서 npm으로 설치합니다.

  1. 아래 npm 명령을 복사해 붙여넣고 Enter. (Node.js가 설치돼 있어야 합니다)
  2. 노란 warn 메시지는 무시해도 됩니다. 2~4분 기다립니다.
  3. 마지막에 added … packages 가 나오면 성공입니다.
방법 B · npm 전역 설치 
npm install -g @anthropic-ai/claude-code
권한 오류(EACCES/EPERM)가 나면

PowerShell을 관리자 권한으로 실행해 재시도하거나 방법 A(네이티브)를 쓰세요.

둘 다 설치할 필요 없습니다

A 또는 B 하나만 하면 됩니다. 둘 다 하면 버전이 충돌할 수 있습니다.

STEP 4CLAUDE CODE · 설치 확인

터미널 새로 열고 claude --version

Windows PowerShell (새 창) ✕ PS C:\Users\hufs> claude --version 2.0.14 (Claude Code) PS C:\Users\hufs> claude doctor ✔ Installation native (C:\Users\hufs\.local\bin) ✔ Version 2.0.14 (up to date) ✔ Git 2.51.0 ✔ Node.js v24.9.0 ✔ Auth logged in PS C:\Users\hufs> _ 2 3 먼저 터미널을 새로 여세요 설치 전에 열어 둔 창에는 PATH가 반영되지 않습니다. 창을 모두 닫고 Windows 키 → powershell 로 새로 열기. 1 ✔ 가 모두 초록이면 완벽합니다
이 단계의 목표

설치가 정상적으로 끝났는지 확인합니다.

  1. 지금 PowerShell 창을 완전히 닫고 새로 엽니다.
  2. claude --version 을 실행해 2.x.x 가 나오는지 봅니다.
  3. claude doctor 를 실행해 ✔ 표시가 모두 초록인지 확인합니다.
버전 확인 
claude --version
전체 진단 (문제가 있을 때) 
claude doctor
"claude 용어가 인식되지 않습니다"

① 터미널을 새로 열었는지 확인 ② PC 재부팅 ③ 그래도 안 되면 다른 설치 방법(A↔B)으로 재시도.

STEP 5CLAUDE CODE · 첫 실행

작업 폴더에서 claude 실행

Windows PowerShell ✕ PS C:\Users\hufs> cd "$HOME\Desktop\dev\hello-claude" PS ...\hello-claude> claude 1 2 ✻ Welcome to Claude Code cwd: C:\Users\hufs\Desktop\dev\hello-claude Choose the text style that looks best with your terminal: To change this later, run /theme ❯ 1. Dark mode ✔ 2. Light mode 3. Dark mode (colorblind-friendly) 4. Light mode (colorblind-friendly) Enter to confirm · ↑↓ to select 3
이 단계의 목표

클로드 코드를 실제로 켭니다. 실행한 폴더가 곧 작업 대상입니다.

  1. 작업 폴더를 만들고 그 안으로 이동합니다.
  2. claude 라고 입력하고 Enter.
  3. 처음이면 테마 선택 화면이 나옵니다. 화살표로 고르고 Enter.
① 작업 폴더 만들고 이동 
mkdir "$HOME\Desktop\dev\hello-claude" -Force; cd "$HOME\Desktop\dev\hello-claude"
② 클로드 코드 실행 
claude
아무 폴더에서나 켜지 마세요

클로드 코드는 실행한 폴더의 파일을 읽고 고칩니다. 반드시 작업용 폴더를 만들어 그 안에서 실행하세요.

STEP 6CLAUDE CODE · 로그인

브라우저로 로그인하기

Windows PowerShell ✻ Select login method ❯ 1. Claude account with subscription Pro · Max · Team · Enterprise 플랜 2. Anthropic Console account API 사용량 과금(개발자용) Enter to confirm · ↑↓ to select Opening browser to sign in… https://claude.ai/oauth/authorize?code=... 안 열리면 위 주소를 복사해 직접 붙여넣으세요. ✔ Login successful 이제 클로드 코드를 사용할 수 있습니다. claude.ai/oauth/authorize ✻ Claude Code 터미널의 Claude Code가 계정 접근 권한을 요청합니다. 계정: hufs.staff@gmail.com 플랜: Claude Pro ✔ Authorize 거부 1 2 3 4
이 단계의 목표

Claude 계정과 연결해 사용 준비를 마칩니다.

  1. Claude account with subscription (구독 계정)을 선택하고 Enter.
  2. 브라우저가 자동으로 열립니다. 안 열리면 화면의 주소를 복사해 직접 붙여넣습니다.
  3. 브라우저에서 Authorize 를 누릅니다.
  4. 터미널로 돌아오면 Login successful 이 뜹니다.
유료 플랜이 필요합니다

Claude Code는 Pro · Max · Team · Enterprise 유료 플랜에서 사용합니다. 무료 플랜으로는 로그인해도 사용할 수 없습니다.

STEP 7CLAUDE CODE · 첫 대화

한국어로 말해서 프로그램 만들기

Windows PowerShell — claude ✻ Claude Code v2.0.14 cwd: C:\Users\hufs\Desktop\dev\hello-claude > 한국어로 인사하는 간단한 웹페이지를 index.html 로 만들어줘. 알겠습니다. index.html 파일을 만들겠습니다. Create index.html + <!DOCTYPE html> + <html lang="ko"> + <h1>안녕하세요 👋</h1> + <button onclick="showDate()">오늘 날짜 보기</button> … 12 more lines Do you want to create index.html? ❯ 1. Yes 2. No, tell Claude what to do differently ③ 승인이 안전장치입니다 내용을 확인하고 Yes를 고르면 그때 실제로 파일이 만들어집니다. 1 2 3
이 단계의 목표

바이브 코딩을 직접 체험합니다. 코드를 몰라도 한국어로 요청하면 됩니다.

  1. > 표시 옆에 한국어로 원하는 것을 적고 Enter.
  2. 클로드가 만들 파일 내용을 미리 보여 줍니다. 내용을 확인합니다.
  3. 1. Yes 를 골라 승인하면 실제로 파일이 만들어집니다.
첫 요청 예시 (그대로 복사해 붙여넣기) 
한국어로 인사하는 간단한 웹페이지를 index.html 로 만들어줘. 버튼을 누르면 오늘 날짜가 표시되게 해줘.
승인(Yes)이 안전장치입니다

클로드 코드는 파일을 만들거나 고치기 전에 항상 물어봅니다. 내용을 보고 Yes를 골라야 실행됩니다.

STEP 8CLAUDE CODE · 결과 확인

만들어진 파일 확인하고 열어 보기

Windows PowerShell > /exit PS ...\hello-claude> dir Mode LastWriteTime Length Name ---- ------------- ------ ---- -a---- 2026-07-26 10:24 842 index.html PS ...\hello-claude> start index.html file:///C:/Users/hufs/.../index.html 안녕하세요 👋 클로드 코드로 만든 첫 웹페이지입니다 오늘 날짜 보기 2026년 7월 26일 다시 켜려면 같은 폴더에서 claude 입력 이전 대화를 이어서 claude --continue 코드를 보려면 code . 1 2 3
이 단계의 목표

클로드 코드가 실제로 파일을 만들었는지 확인하고 결과를 봅니다.

  1. /exit 를 입력해 클로드 코드를 빠져나옵니다. (Ctrl+C 두 번도 가능)
  2. dir 로 index.html 이 생겼는지 확인합니다.
  3. start index.html 로 브라우저에서 열어 봅니다.
① 파일 목록 확인 
dir
② 브라우저로 열어 보기 
start index.html
이것이 바이브 코딩입니다

코드를 한 줄도 쓰지 않고 한국어 요청만으로 동작하는 웹페이지를 만들었습니다. 수정도 claude 를 다시 켜고 말하면 됩니다.

STEP 9CLAUDE CODE · 기본 사용법

꼭 알아야 할 슬래시 명령

Windows PowerShell — claude > / /clear 대화 기록 지우고 새로 시작 /help 사용법·명령 목록 보기 /init 프로젝트 규칙 파일(CLAUDE.md) 생성 /model 사용할 모델 바꾸기 /status 로그인 계정·버전·사용량 확인 /exit 클로드 코드 종료 /theme 화면 색상 테마 변경 ↑↓ 로 선택 · Enter 로 실행 · Esc 로 닫기 초보자가 쓰는 5개 /clear 주제가 바뀌면 반드시 /help 막히면 여기부터 /init 새 프로젝트 시작할 때 /status 로그인·사용량 확인 /exit 끝낼 때 (Ctrl+C 두 번도 가능) 1 2 3
이 단계의 목표

클로드 코드 안에서 쓰는 기본 명령을 익힙니다.

  1. 클로드 코드 실행 중에 / 를 입력합니다.
  2. 명령 목록이 나오면 ↑↓ 로 고르고 Enter.
  3. 초보자는 오른쪽의 5개만 알면 충분합니다.
대화 새로 시작 (맥락 초기화) 
/clear
종료 
/exit
/clear 를 자주 쓰세요

주제가 바뀌면 /clear 로 정리하세요. 이전 대화가 섞여 엉뚱한 답이 나오는 것을 막습니다. 새 프로젝트를 시작할 때는 /init.

STEP 10CLAUDE CODE · VS Code 연동

VS Code 안에서 클로드 코드 쓰기

파일 편집 선택 보기 이동 실행 터미널 도움말 🗂 🔍 ⑂ 탐색기 ▾ HELLO-CLAUDE 📄 index.html 📄 style.css 📄 CLAUDE.md index.html <!DOCTYPE html> <html lang="ko"> <body> <h1>안녕하세요 👋</h1> <button onclick="showDate()">오늘 날짜</button> </body> </html> 문제 출력 디버그 콘솔 터미널 터미널 ✻ Claude Code v2.0.14 > 글자를 더 크게 하고 배경색을 연한 하늘색으로 바꿔줘 style.css 를 수정하겠습니다. ✔ Updated style.css (+4 -1) > _ ⑂ main* ⊗ 0 ⚠ 0 1 2 3 4
이 단계의 목표

편집기와 터미널을 한 화면에서 함께 써 작업 효율을 높입니다.

  1. VS Code에서 작업 폴더를 엽니다. (우클릭 → Code로 열기)
  2. Ctrl + ` 로 아래쪽 터미널을 엽니다.
  3. 터미널에 claude 를 입력하고 한국어로 요청합니다.
  4. 왼쪽 파일 목록에서 결과가 바뀌는 것을 실시간으로 확인합니다.
이 조합이 가장 편합니다

왼쪽 = 파일 목록·코드, 아래 = 클로드 코드 대화. 바뀌는 내용을 눈으로 확인하면서 작업할 수 있습니다.

VS Code 확장도 있습니다

확장 검색에서 Claude Code 를 설치하면 사이드 패널에서도 쓸 수 있습니다. 터미널 방식만으로도 충분합니다.

명령어 모음COPY & PASTE · 1/2

Claude Code 명령어 모음 (복사해서 사용) (1/2)

터미널 명령(PowerShell)과 클로드 코드 안에서 쓰는 슬래시 명령을 모았습니다.

① 설치 — 방법 A · 네이티브 (권장)
irm https://claude.ai/install.ps1 | iex
PowerShell 전용입니다. CMD에서는 동작하지 않습니다.
② 설치 — 방법 B · npm
npm install -g @anthropic-ai/claude-code
Node.js가 있어야 합니다. A가 막힐 때만 사용하세요.
③ 버전 확인
claude --version
→ 2.x.x (Claude Code)
설치가 끝났는지 확인하는 명령입니다.
④ 전체 진단 (문제 생기면 가장 먼저)
claude doctor
설치·버전·인증 상태를 한 번에 점검합니다.
⑤ 실행 (작업 폴더 안에서)
claude
실행한 폴더가 곧 작업 대상입니다.
⑥ 이전 대화 이어서 실행
claude --continue
마지막 대화를 그대로 이어 갑니다.
명령어 모음COPY & PASTE · 2/2

Claude Code 명령어 모음 (복사해서 사용) (2/2)

터미널 명령(PowerShell)과 클로드 코드 안에서 쓰는 슬래시 명령을 모았습니다.

⑦ 업데이트
claude update
네이티브 설치는 보통 자동 업데이트됩니다.
⑧ 작업 폴더 만들고 바로 시작 (한 줄)
mkdir "$HOME\Desktop\dev\my-app" -Force; cd "$HOME\Desktop\dev\my-app"; claude
폴더 생성 → 이동 → 실행을 한 번에 합니다.
⑨ 실행 정책 오류가 날 때
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
"스크립트를 실행할 수 없으므로" 오류에 사용. 물어보면 Y.
⑩ 한글이 깨질 때
chcp 65001
터미널 인코딩을 UTF-8로 바꿉니다.
문제 해결TROUBLESHOOTING

Claude Code — 문제가 생겼을 때

무엇을 해도 안 되면 claude doctor 부터 실행하세요.

이런 화면·메시지가 나오면 원인 이렇게 해결하세요
'irm' 용어가 … 인식되지 않습니다 지금 창이 CMD(명령 프롬프트) irm 은 PowerShell 전용 명령입니다. Windows 키 → powershell 입력 → Windows PowerShell 실행 후 다시 시도하세요.
'claude' 용어가 … 인식되지 않습니다 PATH 미반영 ① 터미널 완전히 닫고 새로 열기 ② PC 재부팅 ③ claude doctor ④ 그래도 안 되면 다른 설치 방식(A↔B)으로 재시도.
이 시스템에서 스크립트를 실행할 수 없으므로 PowerShell 실행 정책 제한 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 실행 → Y 입력 → 터미널 새로 열기.
로그인은 되는데 사용이 막힘 무료 플랜 계정 Claude Code는 Pro·Max·Team·Enterprise 유료 플랜이 필요합니다. claude.ai에서 플랜을 확인하세요. 결제 후 /status 로 재확인.
브라우저가 안 열려 로그인 불가 기본 브라우저 설정·보안 정책 터미널에 표시된 https://claude.ai/oauth/… 주소를 드래그해 복사한 뒤 브라우저 주소창에 직접 붙여넣으세요.
npm ERR! EACCES 권한 오류 npm 전역 설치 권한 관리자 PowerShell로 재시도하거나, 방법 A(네이티브 설치)로 바꾸세요. 권한을 강제로 바꾸지 마세요.
한글이 깨져 보임 터미널 인코딩 PowerShell에서 chcp 65001 실행. 또는 Windows Terminal(Microsoft Store 무료)을 설치해 사용하면 한글이 깔끔합니다.
엉뚱한 폴더의 파일을 고침 잘못된 위치에서 실행 /exit 후 cd 로 작업 폴더로 이동한 뒤 다시 claude 실행. 실행 위치가 곧 작업 범위입니다.
마무리CHECKLIST & NEXT

전체 설치 완료 — 이제 시작입니다

5개 프로그램이 모두 준비됐습니다. 아래 명령으로 최종 점검하세요.

✅ 완료 체크리스트

  • GitHub 계정을 만들었다아이디·비밀번호·복구 코드 보관
  • git --version 이 나온다이름·이메일 설정 완료
  • node --version / npm --version 이 나온다LTS 버전
  • code --version 이 나온다VS Code PATH 등록 완료
  • claude --version 이 나온다2.x.x (Claude Code)
  • 로그인하고 첫 파일을 만들어 봤다index.html 생성 성공

➡️ 다음 단계 & 참고

  • 앞으로의 작업 루틴① 작업 폴더 우클릭 → Code로 열기 ② Ctrl + ` 터미널 ③ claude ④ 한국어로 요청
  • 좋은 요청 쓰는 법무엇을(기능) · 어떤 파일로 · 어떻게 동작하게 를 함께 적으면 결과가 훨씬 좋아집니다.
  • 주제가 바뀌면 /clear이전 대화가 섞이면 엉뚱한 결과가 나옵니다.
  • 문제가 생기면 claude doctor설치·인증·버전을 한 번에 진단합니다.
  • 만든 결과를 GitHub에 올리기클로드 코드에게 "이 폴더를 GitHub에 올려줘" 라고 말하면 됩니다.
최종 점검 (한 줄로 전부)git --version; node --version; code --version; claude --version