본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Windows 바이브코딩 초기 세팅

환경 준비

시작하기 전에Git 설치Node.js 설치VS Code 설치

Claude Code

Claude Code 설치Claude Code 인증

프로젝트 시작

Next.js 프로젝트 생성Next.js AI 세팅Claude Code 첫 실행CLAUDE.md 설정

트러블슈팅
핸드북›Windows 바이브코딩 세팅›시작하기 전에

시작하기 전에

Windows 10/11, claude.ai 계정과 Pro 이상 구독, RAM 4GB 등 바이브코딩에 필요한 준비물을 점검하고, 구독 플랜 선택과 PowerShell 여는 법을 익힙니다.

핵심 요약

  • Claude Code는 Free 플랜에 포함되지 않으며, 개인은 보통 Pro(월 $20) 또는 Max로 시작하고 팀은 Team/Enterprise를 사용합니다.
  • 필수 준비물은 Windows 10/11 64비트, 인터넷 연결, claude.ai 계정, RAM 4GB 이상, Claude Code 사용 권한입니다.
  • ANTHROPIC_API_KEY 환경 변수가 설정돼 있으면 구독 대신 API 키로 과금될 수 있으니 결제 전 확인합니다.
  • 처음 시작이라면 Pro 플랜으로 충분하며, 큰 저장소나 사용량 한도에 자주 도달하면 Max/Team을 검토합니다.
  • 설치 과정에서 PowerShell을 자주 쓰며, 일부 단계는 "관리자 권한으로 실행"이 필요합니다.

바이브코딩을 시작하려면 몇 가지 준비물이 필요합니다. 이 챕터에서 하나씩 확인합니다.

검증 기준

이 챕터의 Claude Code 접근 조건과 가격 정보는 2026-05-14에 Anthropic 공식 Claude Code 문서, Claude Help Center, Claude 가격 페이지를 확인해 반영했습니다. 가격과 플랜 구성은 변경될 수 있으므로 결제 전 공식 가격 페이지를 다시 확인하세요.

준비물 체크리스트

항목설명필수 여부
Windows 10/1164비트 운영체제필수
인터넷 연결프로그램 다운로드 및 Claude Code 사용에 필요필수
Claude Code 사용 권한Pro, Max, Team, Enterprise, Console 중 하나 필요필수
claude.ai 계정Claude Code 인증에 사용필수
메모리Claude Code 공식 요구사항: RAM 4GB 이상필수

Claude 구독 플랜

Claude Code는 Free 플랜에 포함되지 않습니다. 개인 사용자는 보통 Pro 또는 Max로 시작하고, 팀은 Team 또는 Enterprise를 사용합니다. API 기반 과금이 필요한 경우에는 Claude Console 계정으로 사용할 수도 있습니다.

플랜공식 가격 표기Claude Code 사용비고
Free$0포함되지 않음웹/앱 Claude 체험용
Pro월 20또는연간결제시월20 또는 연간 결제 시 월 20또는연간결제시월17 상당포함개인 바이브코딩 시작에 충분
Max월 $100부터포함Pro보다 5x 또는 20x 더 많은 사용량 옵션
Team / Enterprise좌석·계약 조건별포함조직 관리, SSO, 중앙 과금이 필요할 때

어떤 플랜을 선택해야 하나요?

처음 시작하신다면 Pro 플랜이면 충분합니다. 큰 저장소를 오래 다루거나 사용량 제한에 자주 도달하면 Max 또는 Team 플랜을 검토하세요.

API 키 과금 주의

컴퓨터에 ANTHROPIC_API_KEY 환경 변수가 설정돼 있으면 Claude Code가 구독 플랜 대신 API 키를 쓸 수 있습니다. 이때 Claude Console API 요금이 따로 나가므로, Pro/Max 구독으로만 쓰려면 로그인 계정과 환경 변수를 확인하세요.

claude.ai 계정 만들기

claude.ai 접속

웹 브라우저에서 claude.ai에 접속합니다.

회원가입

이메일 또는 Google 계정으로 회원가입합니다.

구독 시작

로그인 후 설정에서 Pro 플랜 이상을 구독합니다. 결제에는 해외 결제가 가능한 신용카드가 필요합니다.

PowerShell 열기

앞으로 설치 과정에서 PowerShell(파워셸)을 자주 씁니다. PowerShell은 Windows에 기본으로 깔려 있는 명령어 입력 프로그램입니다.

  1. 화면 왼쪽 아래 시작 버튼(Windows 로고)을 클릭합니다
  2. 검색창에 PowerShell을 입력합니다
  3. Windows PowerShell을 클릭합니다

관리자 권한으로 실행

일부 설치 과정에서는 관리자 권한이 필요합니다. PowerShell을 검색한 뒤 **"관리자 권한으로 실행"**을 선택하면 됩니다.

PowerShell이 열리면 검은색(또는 파란색) 화면에 커서가 깜빡입니다. 여기에 명령어를 입력하고 Enter를 누르면 실행됩니다.


참고 자료

  1. Claude 요금제
  2. Claude Code와 Pro/Max 플랜 사용하기
  3. Claude Code 설치 요구사항
  4. PowerShell 실행 정책

관련 문서

Claude Code 인증

Claude Code에 로그인하고 구독 상태를 확인합니다

CLAUDE.md 설정

AGENTS.md와 CLAUDE.md로 프로젝트 맥락을 Claude Code에게 알려줍니다

Ch10. IDE 통합

Claude Code 고급 활용 · Claude Code를 VS Code·JetBrains에 통합해 사이드바 채팅·@멘션 컨텍스트·인라인 diff·체크포인트·Remote Control·Desktop 앱을 사용하는 방법

Cmd. /team-onboarding

Claude Code 명령어 마스터 · 최근 30일 Claude Code 사용 이력을 바탕으로 팀원이 바로 붙을 수 있는 온보딩 가이드를 생성하는 명령

Ch2. CLAUDE.md 마스터하기

Claude Code 고급 활용 · 프로젝트 지침서의 계층 구조, 모듈형 규칙, @import 활용법

Windows 바이브코딩 초기 세팅

Windows에서 Claude Code와 Next.js로 바이브코딩을 시작하기 위한 환경 세팅 가이드

Git 설치

코드 변경 이력을 관리하는 Git for Windows를 gitforwindows.org에서 설치하고, git --version으로 확인하며 Claude Code가 활용하는 Git Bash까지 함께 갖춥니다.

On this page

준비물 체크리스트Claude 구독 플랜claude.ai 계정 만들기claude.ai 접속회원가입구독 시작PowerShell 열기참고 자료