바이브코딩
초기 세팅 완벽 가이드
Claude Code 기반 환경 세팅을 도와드립니다!
따라하면 누구나 바로 시작할 수 있습니다!
준비 체크리스트
터미널 열기
터미널은 컴퓨터한테 문자 보내는 거라고 생각하시면 됩니다! 카톡처럼 글자를 쳐서 보내면 컴퓨터가 읽고 실행해주는 거예요. 무서워 보이지만 그냥 명령어를 복사 붙여넣기 하면 됩니다!
Windows: PowerShell 열기
- 키보드에서 ⊞ Win 키를 누르세요 (키보드 왼쪽 하단)
- PowerShell 이라고 타이핑하세요
- "Windows PowerShell" 이 나오면 클릭!
검은색 또는 파란색 창이 뜨면 성공입니다! 이게 터미널이에요!
Git 설치
Git은 코드의 타임머신이라고 생각하시면 됩니다! 작업한 걸 저장해두고, 실수하면 되돌리고, 다른 사람과 함께 작업할 수 있게 해주는 도구예요. 먼저 이미 설치되어 있는지 확인해보세요!
설치 확인
터미널에 아래 명령어를 복사해서 붙여넣고 Enter를 누르세요:
git --version
git version 2.xx.x 같은 숫자가 나오면 이미 설치되어 있습니다! Step 3로 넘어가세요!
아래처럼 나오면 아직 설치가 안 된 거예요!
'git'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.
git : 'git' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
위 메시지는 실행하는 게 아니에요! 이런 게 뜨면 "아 아직 설치 안 됐구나" 하고 아래 설치 방법을 따라하시면 됩니다! 혹시 위와 다른 에러 메시지가 나오면, 그 메시지를 전체 복사해서 클로드한테 그대로 붙여넣고 "이게 뭐야?" 라고 물어보세요! 친절하게 알려줍니다!
Windows: Git 설치
- git-scm.com/download/win 접속
- "Click here to download" 클릭
- 다운로드된 파일 실행
- 설치 화면에서 전부 Next → Next → Install (기본값 그대로!)
- 설치 완료 후 PowerShell을 닫았다가 다시 열기
- 다시 확인:
git --version
중요! 설치 후 반드시 PowerShell을 닫았다가 다시 여세요! 안 그러면 git을 못 찾습니다!
Node.js 설치
Node.js는 컴퓨터에서 프로그램을 돌리기 위한 엔진 같은 거예요! 자동차에 엔진이 있어야 달리듯이, Claude Code를 실행하려면 Node.js가 필요합니다!
설치 확인
node --version
v20.xx.x 이상이 나오면 OK! Step 4로 넘어가세요!
아래처럼 나오면 아직 설치가 안 된 거예요!
'node'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.
node : 'node' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
위 메시지는 실행하는 게 아니에요! 이런 게 뜨면 아래 설치 방법을 따라하세요! 다른 에러가 나오면 메시지를 복사해서 클로드한테 물어보면 됩니다!
설치 방법
- nodejs.org 접속
- LTS (왼쪽 초록 버튼) 클릭해서 다운로드
- 설치 파일 실행 → 전부 Next → Install
- 설치 후 터미널 닫았다가 다시 열기!
- 확인:
node --version
npm도 같이 설치됩니다! npm --version 도 확인해보세요!
GitHub 가입
GitHub은 코드를 저장하는 구글 드라이브라고 생각하시면 됩니다! 내 코드를 인터넷에 안전하게 보관하고, 다른 사람과 공유할 수 있어요. 이미 계정이 있으면 Step 5로!
가입하기
- github.com 접속
- "Sign up" 클릭
- 이메일, 비밀번호, 유저네임 입력
- 이메일 인증 완료
Git에 GitHub 계정 연결하기
터미널에서 아래 두 줄을 각각 입력하세요 (본인 정보로 바꿔서!):
git config --global user.name "여기에본인영어이름"
git config --global user.email "여기에본인이메일@gmail.com"
예를 들어 이름이 김루피이고 이메일이 loopy@gmail.com 이면:
git config --global user.name "Loopy"
git config --global user.email "loopy@gmail.com"
위의 Loopy, loopy@gmail.com 은 예시입니다! 반드시 본인 이름과 이메일로 바꿔서 입력하세요! 이름은 영어로 입력해주세요! (한글로 하면 나중에 에러가 날 수 있습니다!)
GitHub 로그인 연결 확인
아래 명령어를 입력해서 GitHub에 로그인이 잘 되는지 미리 확인해보세요!
git ls-remote https://github.com
입력하면 브라우저가 자동으로 열리면서 GitHub 로그인 화면이 뜰 수 있습니다! 당황하지 마시고 GitHub 계정으로 로그인해주세요!
브라우저에서 "Authorize" 또는 "허용" 버튼을 누르면 됩니다! 이건 한 번만 하면 다음부터는 자동으로 연결됩니다!
Claude Code 설치
Claude Code는 터미널에서 작동하는 AI 과외 선생님입니다! "이런 사이트 만들어줘"라고 말하면 알아서 코드를 짜주는 바이브코딩의 핵심 도구예요!
Windows: 설치 (PowerShell)
PowerShell을 열고 아래 명령어를 복사 붙여넣기 하세요:
irm https://claude.ai/install.ps1 | iex
혹시 위 명령어가 안 되면, ⊞ Win 키를 누르고 cmd 라고 검색해서 "명령 프롬프트"를 열고 아래를 입력하세요:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
설치가 끝나면 터미널을 닫았다가 다시 열고 확인:
claude --version
Windows에서는 Git for Windows가 먼저 설치되어 있어야 합니다! (Step 2에서 했으면 OK!)
에러가 나면?
설치 중 아래 같은 에러가 나올 수 있어요! 당황하지 마세요!
npm ERR! code EACCES npm ERR! permission denied
npm : 'npm' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
WARN deprecated / WARN optional 어쩌구...
WARN은 경고일 뿐이라 무시해도 됩니다! ERR이 나오면 아래 방법으로 해결하세요!
- 에러 메시지를 전체 복사
- claude.ai 에 접속해서 클로드한테 그대로 붙여넣기
- "이 에러 어떻게 해결해?" 라고 물어보세요!
최종 확인
터미널에서 아래 명령어를 하나씩 입력해서 전부 버전이 나오면 준비 완료!
git --version
node --version
npm --version
claude --version
성공하면 이렇게 보여요!
숫자는 다를 수 있어요! 숫자가 나오기만 하면 성공입니다!
여기까지 되셨으면 바이브코딩 준비 완료입니다!
바이브코더 루피가 여러분의 여정을 응원합니다!!