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

환경 준비

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

Claude Code

Claude Code 설치Claude Code 인증

프로젝트 시작

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

트러블슈팅
핸드북›Windows 바이브코딩 세팅

Windows 바이브코딩 초기 세팅

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

최근 수정된 챕터

  • CLAUDE.md 설정2026.06.20

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

  • Next.js 프로젝트 생성2026.06.20

    create-next-app 최신 기본값으로 첫 Next.js 프로젝트를 만들고 실행합니다

  • Claude Code 첫 실행2026.06.20

    프로젝트 폴더에서 claude 명령으로 Claude Code를 시작하고, AGENTS.md와 로컬 문서를 기준으로 첫 분석·수정을 요청하며 권한 승인과 종료 방법까지 익힙니다.

  • Git 설치2026.06.20

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

  • Claude Code 설치2026.06.20

    PowerShell 한 줄 네이티브 설치(irm install.ps1)로 Claude Code를 설치하고, ExecutionPolicy·PATH 문제를 해결하며 claude doctor로 환경을 점검합니다.

**바이브코딩(Vibe Coding)**이란 자연어로 AI에게 코딩을 지시하는 새로운 개발 방식입니다. 코드를 한 줄도 모르셔도 괜찮습니다. Claude Code에게 "이런 기능을 만들어줘"라고 말하면, AI가 코드를 작성하고 파일을 수정합니다.

이 가이드는 Windows에서 Claude Code와 Next.js 최신 버전으로 바이브코딩을 시작할 때 필요한 환경 세팅만 다룹니다. 2026-05-14 기준 npm registry의 next@latest는 Next.js 16.2.6이며, 새 프로젝트에는 AI 코딩 에이전트가 최신 문서를 읽도록 돕는 AGENTS.md와 CLAUDE.md가 기본 포함됩니다.

이 가이드의 대상

  • Windows 10 또는 Windows 11 사용자
  • 코딩 경험이 없는 완전 초보자
  • Claude Code와 Next.js 16.2의 AI 지원 기능으로 바이브코딩을 시작하려는 분

전체 세팅 흐름

아래 순서대로 따라오시면 됩니다.

환경 준비

Ch1. 시작하기 전에

필요한 계정과 준비물을 확인합니다

Ch2. Git 설치

코드 버전 관리 도구인 Git을 설치합니다

Ch3. Node.js 설치

JavaScript 실행 환경인 Node.js를 설치합니다

Ch4. VS Code 설치

코드 에디터를 설치하고 기본 설정합니다

Claude Code

Ch5. Claude Code 설치

PowerShell에서 Claude Code를 설치합니다

Ch6. Claude Code 인증

로그인과 구독 확인을 완료합니다

프로젝트 시작

Ch7. Next.js 프로젝트 생성

create-next-app 최신 기본값으로 첫 프로젝트를 만듭니다

Ch8. Next.js AI 세팅

AGENTS.md, 터미널 로그, MCP, DevTools 세팅을 확인합니다

Ch9. Claude Code 첫 실행

프로젝트에서 Claude Code를 시작합니다

Ch10. CLAUDE.md 설정

프로젝트 맥락을 Claude Code에게 알려줍니다

부록

Ch11. 트러블슈팅

Windows에서 자주 발생하는 문제와 해결법


참고 자료

  1. Claude Code 공식 문서
  2. Next.js 공식 사이트
  3. Next.js 16.2: AI Improvements
  4. Next.js AI Coding Agents

함께 보면 좋은 핸드북

엔터프라이즈 프로젝트 설계

Next.js + Turborepo + Vercel 환경에서 다수 서비스를 설계·운영하는 시니어 개발자를 위한 실전 가이드

개발자 언러닝

에이전틱 코딩 시대에 버려야 할 개발 습관과 새로 익혀야 할 실무 마인드셋

Claude Code 고급 활용

Claude Code 사용자를 위한 멀티세션, 자동화, 확장 운영 패턴을 정리한 가이드

시작하기 전에

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

On this page

전체 세팅 흐름환경 준비Claude Code프로젝트 시작부록참고 자료