Claude Code 설치

이 페이지의 목표 — 이번엔 VS Code 안의 Claude AI를 가이드 삼아 Claude Code(CLI)를 설치합니다. 모르는 게 있을 때 AI에게 물어보면서 진행하는 흐름을 직접 경험해보세요.

Claude Code는 공식 문서가 잘 정리돼 있어서 AI가 정확하게 안내해줄 가능성이 높아요.

시작 전 준비물

  • VS Code 설치 완료 + Claude Code 확장으로 로그인 완료 (아직이면 VS Code 설치 페이지부터)
  • Claude 구독 계정 또는 Anthropic Console 계정 — Claude Code 사용 인증에 필요
  • (선택) Git for Windows — 권장사항. 없어도 동작하지만 있으면 더 편함

Claude 계정이 없다면? claude.com/pricing에서 가입하세요. Pro 구독 또는 Anthropic Console(API)로 인증할 수 있어요.

STEP 1. VS Code에서 터미널 열기

Claude Code는 터미널에서 동작하는 CLI 도구예요. 먼저 VS Code 안에 있는 터미널 패널을 엽니다.

  1. VS Code가 실행된 상태에서 Ctrl + ` (백틱) 단축키 누르기
  2. 화면 하단에 터미널 패널이 열림
  3. 현재 셸 종류 확인 — PowerShell(PS C:\) 또는 Git Bash 등

터미널 패널이 안 보이면 메뉴에서 Terminal → New Terminal (또는 터미널 → 새 터미널)로 열 수도 있어요.

STEP 2. Claude Code 설치

이제 AI에게 물어보면서 설치를 진행해봅시다.

먼저 VS Code의 Claude AI에게 물어보세요

좌측 사이드바의 Claude 아이콘을 클릭해서 채팅 패널을 열고, 아래 프롬프트를 그대로 복사해서 붙여넣어 보세요.

복사용 프롬프트

Claude Code(클로드 코드)를 설치하고 싶어. 나는 Windows를 쓰고 있어.

공식 설치 문서를 먼저 참고해주세요:
https://code.claude.com/docs/en/overview

Native Installer 방식으로 설치하는 방법을 단계별로 알려주세요.
각 단계마다 어떤 명령어를 어디(PowerShell/CMD/Git Bash)에 입력해야 하는지,
설치가 잘 됐는지 어떻게 확인하는지도 함께 알려주세요.

AI가 단계별로 안내해줄 거예요. 그 설명을 따라 VS Code 터미널에 명령어를 입력해보세요.

왜 이렇게 물어봤을까요? (메타학습 설명)

이번엔 공식 문서 링크를 함께 줬어요. Claude Code 공식 문서(code.claude.com)는 잘 정리돼 있고 크롤링이 잘 되는 정적 페이지라서, AI가 이 링크를 참고해서 더 정확하게 답할 수 있어요.

자료 없이 묻기 — 옛날 정보로 답할 수 있음

Claude Code 설치하는 법 알려줘

공식 문서와 함께 묻기 — 최신 정보로 답

Claude Code 설치하는 법 알려줘.
공식 문서: code.claude.com/docs/en/overview

이 패턴은 도구의 공식 문서가 잘 정리된 경우 강력해요. 자료가 많은 도구는 공식 문서 링크와 함께 묻고, 자료가 적은 신생 도구는 "본질이 같은 더 잘 알려진 것"으로 일반화해서 묻는 식으로 — 상황에 맞게 골라 쓰면 됩니다.

모범답안 (잘 안 되면 참고)

AI 답변이 아래 모범답안과 너무 다르거나 잘 안 된다면? 이 모범답안을 그대로 따라하시면 됩니다.

VS Code 터미널이 PowerShell인지 확인하고 (프롬프트가 PS C:\로 시작하면 PowerShell), 아래 명령어를 복사해서 붙여넣고 엔터:

PowerShell 설치 명령어

irm https://claude.ai/install.ps1 | iex

설치가 끝나면 다음 명령어로 확인:

설치 확인

claude --version

버전 번호가 나오면 설치 성공! 안 나오면 VS Code를 한 번 종료했다가 다시 열어보세요 (PATH 갱신).

"'irm'은(는) 내부 또는 외부 명령이 아닙니다" 에러가 뜬다면? 지금 터미널이 PowerShell이 아니라 CMD일 가능성이 높아요. 프롬프트가 PS C:\로 시작하는지 다시 확인하고, 아니면 새 PowerShell 터미널을 열어서 다시 시도해보세요.

다른 터미널/OS는 어떻게 하나요?
  • Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • Mac / Linux / WSL: curl -fsSL https://claude.ai/install.sh | bash
  • WinGet 사용자: winget install Anthropic.ClaudeCode
  • Homebrew(Mac): brew install --cask claude-code

STEP 3. 첫 실행 & 로그인

설치가 끝났으면 이제 실제로 실행해봅시다.

먼저 AI에게 물어보세요

복사용 프롬프트

방금 Claude Code 설치를 끝냈어요.
이제 어떻게 시작해야 하나요? 첫 실행과 로그인 방법을 알려주세요.

저는 Claude 유료 구독 계정이 있어요.

공식 문서 참고:
https://code.claude.com/docs/en/overview

모범답안 (잘 안 되면 참고)

VS Code에서 작업할 폴더를 이미 열어둔 상태라면 STEP 1에서 연 터미널이 이미 그 폴더에 들어가 있어요. cd 없이 바로 4번부터 진행하면 됩니다.

  1. (폴더가 열려있지 않다면) VS Code 메뉴 파일 → 폴더 열기로 작업 폴더 먼저 열기
  2. (또는 새 폴더부터 만들고 싶다면 터미널에서) mkdir C:\dev\my-project; cd C:\dev\my-project — 경로는 예시, 본인이 원하는 위치·이름으로 바꿔서 쓰기 (영문 경로 권장)
  3. 터미널 프롬프트가 작업할 폴더 경로로 시작하는지 확인
  4. 터미널에 claude 입력 후 엔터
  5. 처음 실행이면 로그인 안내가 뜸 → Chrome이 자동으로 열림
  6. Claude 계정으로 로그인 → 권한 동의 → 터미널로 돌아옴
  7. "Welcome to Claude Code" 메시지가 나오면 성공!

STEP 4. CLI와 확장 함께 쓰기

VS Code 설치 페이지에서 이미 Claude Code 확장(채팅 패널)을 깔았고, 이번 페이지에서 터미널 CLI까지 설치했어요. 둘은 같은 Claude 계정으로 자동 인증되어 함께 작동합니다.

  • 확장(채팅 패널) — 가볍게 질문, 코드 설명, 빠른 수정에 편함
  • 터미널 CLI — 스킬 실행(/pdca plan 같은 명령어), 자동화, 긴 작업에 강함

상황에 따라 골라 쓰면 됩니다. 튜토리얼 진행 중엔 두 가지를 모두 쓰게 돼요.

다음 단계

Claude Code 설치까지 끝났어요. 이제 두 단계 남았습니다.

  1. Node.js 설치 — bkit의 자동화 기능이 동작하는 데 필요
  2. bkit 설치 — Claude Code 위에 얹는 개발 방법론 플러그인

이 둘까지 마치면 환경 세팅이 완전히 끝나고, 본격적으로 "나만의 라이프 위키" 만들기에 들어갑니다.