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

환경 준비

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

Claude Code

Claude Code 설치Claude Code 인증

프로젝트 시작

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

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

Git 설치

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

핵심 요약

  • gitforwindows.org에서 설치하며, 대부분 옵션은 기본값(Next)으로 두면 됩니다.
  • 설치 시 기본 에디터로 VS Code를 고를 수 있고, PATH 옵션은 "Git from the command line and also from 3rd-party software"를 선택합니다.
  • git --version이 git version 2.x...처럼 나오면 정상이며, 인식되지 않으면 PowerShell을 새로 열거나 재부팅합니다.
  • 함께 설치되는 Git Bash는 Claude Code가 내부 명령 실행에 사용할 수 있으므로 삭제하지 않습니다.
  • 바이브코딩에서 Git은 코드 변경 이력을 기록하고, 문제가 생겼을 때 이전 상태로 되돌리는 안전장치 역할을 합니다.

Git(깃)은 코드의 변경 이력을 관리하는 도구입니다. Windows native 환경에서 Claude Code는 Git for Windows를 권장하고, Git Bash가 있으면 내부 명령 실행에도 쓰입니다.

필수인가요?

Claude Code 공식 문서는 native Windows에서 Git for Windows를 권장합니다. Git Bash가 없으면 Claude Code가 PowerShell을 쓰기도 하지만, 초보자라면 Git 설치를 먼저 끝내는 쪽이 되돌리기와 문제 해결에 안전합니다.

Git for Windows 다운로드

공식 사이트 접속

웹 브라우저에서 gitforwindows.org에 접속합니다.

다운로드

Download 버튼을 클릭하여 설치 파일을 다운로드합니다.

설치 실행

다운로드된 .exe 파일을 실행합니다. 설치 마법사가 나타나면 여러 옵션을 선택하는 화면이 나옵니다.

옵션 선택

대부분의 옵션은 기본값(Next)을 그대로 유지하면 됩니다. 아래 항목만 확인하세요:

  • Default editor: 기본값(Vim) 또는 Use Visual Studio Code as Git's default editor 선택
  • PATH environment: Git from the command line and also from 3rd-party software (기본값) 선택
  • 나머지는 모두 기본값으로 Next를 클릭합니다

설치 완료

Install 버튼을 클릭하고 설치가 완료될 때까지 기다립니다.

설치 확인

PowerShell을 열고 아래 명령어를 입력합니다:

git --version

아래와 비슷한 결과가 나오면 정상적으로 설치된 것입니다:

git version 2.53.0.windows.2

명령어를 찾을 수 없다고 나올 때

'git'은(는) 내부 또는 외부 명령...이 아닙니다라고 나오면, PowerShell을 닫고 새로 열어보세요. 새 PowerShell에서도 안 되면 컴퓨터를 재시작한 뒤 다시 시도하세요.

Git Bash란?

Git for Windows를 설치하면 Git Bash라는 프로그램도 함께 깔립니다. Git Bash는 Linux 스타일의 명령어를 Windows에서 그대로 쓰게 해주는 터미널입니다.

Claude Code가 내부적으로 Git Bash를 쓰기도 하니, 따로 삭제하지 마세요.

Git을 왜 설치하나요?

바이브코딩에서 Git은 두 가지 역할을 합니다:

  1. Claude Code가 코드를 수정한 이력을 기록합니다
  2. 문제가 생겼을 때 이전 상태로 되돌릴 수 있습니다

참고 자료

  1. Git for Windows 공식 사이트
  2. Git 공식 사이트
  3. Git 설치 가이드
  4. Git Windows 설치
  5. Pro Git 한국어판
  6. Git 공식 문서
  7. Claude Code Windows setup

관련 문서

Claude Code 설치

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

트러블슈팅

PowerShell 실행 정책, PATH 인식 실패, claude 명령 누락, 포트 3000 충돌, Next.js MCP 연결 등 Windows 바이브코딩 세팅에서 자주 막히는 문제의 증상과 해결법을 모았습니다.

Cmd. /worktree

Codex 명령어 마스터 · Codex CLI의 새 세션·fork를 격리 git checkout으로 실행하고 worktree 소유 정보·삭제 확인을 구분하는 방법을 설명합니다.

Ch9. Agentic 개발 체계

엔터프라이즈 프로젝트 설계 · Claude Code 중심 CLAUDE.md 설계, 멀티세션, 서브에이전트, Hooks 자동화

Cmd. /batch

Claude Code 명령어 마스터 · 대규모 코드베이스 변경을 독립 단위로 분해해 워크트리에서 병렬 실행하는 bundled skill 명령

시작하기 전에

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

Node.js 설치

nodejs.org에서 Node.js LTS를 설치해 Next.js 실행에 필요한 20.9 이상 조건을 충족하고, node·npm 버전 확인과 함께 npm·npx의 역할까지 이해합니다.

On this page

Git for Windows 다운로드공식 사이트 접속다운로드설치 실행옵션 선택설치 완료설치 확인Git Bash란?참고 자료