3강: 개발 환경 세팅
한 번만 세팅하면 끝. 이 30분이 수백 시간을 좌우해요
오늘의 목표
1강에서 바이브 코딩이 뭔지 알았고, 2강에서 기본 용어를 익혔어요. 이제 진짜로 뭔가 만들 준비를 할 차례예요.
요리에 비유하면, 1강에서 "요리란 이런 거다"를 배웠고 2강에서 "칼, 도마, 프라이팬이 뭔지"를 알았어요. 오늘은 주방에 장비를 갖다놓는 시간이에요. 칼을 사고, 도마를 놓고, 가스레인지를 연결하는 거죠. 한 번만 해두면 다시 안 해도 돼요.
오늘 세팅할 장비는 딱 4가지예요:
- GitHub — 코드를 저장하는 클라우드 금고
- 에디터 — 코드를 보는 돋보기
- Claude Code — AI 조수가 일하는 작업대
- 터미널 기초 — 컴퓨터와 대화하는 카카오톡
1단계: GitHub 가입 — 코드의 클라우드 금고
GitHub이 뭐예요?
GitHub(깃허브) 는 코드를 인터넷에 저장해두는 서비스예요. 네이버 클라우드나 구글 드라이브에 문서를 저장하듯이, 개발자들은 GitHub에 코드를 저장해요. 무료예요.
"지금은 코드를 짤 줄도 모르는데 왜 가입해요?" 라고 생각하실 수 있어요. 이유가 있어요:
- Claude Code가 만들어주는 코드를 저장할 곳이 필요해요
- 나중에 Vercel(코드를 웹사이트로 공개해주는 서비스)과 연결하면 코드를 올리기만 해도 웹사이트가 자동으로 만들어져요
- 5강에서 배울 Git(버전 관리)의 클라우드 백업이기도 해요
가입 방법
- github.com 에 접속하세요
- Sign up 버튼을 누르세요
- 이메일, 비밀번호, 사용자명을 입력하세요
사용자명 팁: 짧고 기억하기 쉽게 정하세요. 이 이름이 github.com/사용자명 형태로 여러분의 주소가 돼요. 나중에 바꿀 수 있지만, 처음부터 잘 정하는 게 좋아요.
- 좋은 예:
kimcoding,dahon,jimin-dev - 피할 것:
xXxDarkCoder99xXx,asdfqwer1234
2단계: 에디터 선택 — 코드를 보는 돋보기
에디터가 뭐예요?
에디터(Editor) 는 코드 파일을 열어보는 프로그램이에요. 메모장도 에디터의 일종이지만, 코드 전용 에디터는 글자에 색깔을 입혀서 어떤 부분이 뭔지 한눈에 보이게 해줘요. 마치 형광펜으로 밑줄 쳐놓은 교과서 같은 거예요.
바이브 코딩에서 에디터는 "코드를 직접 짜는 도구"가 아니에요. AI가 만들어준 코드를 확인하는 돋보기 역할이에요.
3가지 선택지
| 에디터 | 한 줄 설명 | 추천 대상 |
|---|---|---|
| VS Code | 마이크로소프트가 만든 무료 에디터. 전 세계에서 가장 많이 씀 | 첫 에디터로 가장 무난 |
| Cursor | VS Code를 복사해서 AI 기능을 넣은 에디터. 유료(월 $20) | AI 자동완성을 에디터 안에서 쓰고 싶은 분 |
| ZED | Rust(프로그래밍 언어)로 만들어서 매우 빠른 에디터. 무료 | 속도를 중시하는 분 |
저는 뭘 쓰면 되나요?
VS Code를 추천해요. 이유는 간단해요:
- 무료예요
- 전 세계에서 가장 많이 쓰니까, 문제가 생겨도 해결법을 찾기 쉬워요
- Claude Code와 가장 잘 호환돼요
- 확장 기능(Extension, 앱스토어에서 앱 깔듯이 기능을 추가하는 것)이 수만 개라서 나중에 뭐든 붙일 수 있어요
설치: code.visualstudio.com 에서 다운로드 후 설치하세요. Windows든 Mac이든 "Download" 버튼 누르면 알아서 맞는 버전을 받아줘요.
사실 Claude Code만으로도 바이브 코딩은 가능해요. 에디터 없이 시작해도 괜찮아요. 다만 AI가 만든 파일을 직접 눈으로 확인하고 싶을 때 에디터가 있으면 편해요. 지금 당장 설치 안 해도 되고, 필요할 때 설치하셔도 돼요.
3단계: Claude Code 설치 — AI 조수의 작업대
Claude Code가 뭐예요?
1강에서 AI를 "유능한 신입사원"에 비유했죠? Claude Code(클로드 코드) 는 그 신입사원이 앉아서 일하는 작업대예요. 여러분이 말로 지시하면, 이 작업대 위에서 코드를 만들고, 파일을 정리하고, 에러를 고쳐요.
정확히 말하면 Claude Code는 터미널(명령어 입력 창) 안에서 돌아가는 AI 도구예요. 웹 브라우저에서 쓰는 claude.ai와 달리, 여러분 컴퓨터의 파일을 직접 읽고 쓸 수 있어요. 그래서 진짜 프로젝트를 만들 수 있는 거예요.
설치 조건
Claude Code를 쓰려면 아래 조건이 필요해요:
- 운영체제: Windows 10 이상 / macOS 13 이상 / Ubuntu 20.04 이상
- 메모리(RAM): 4GB 이상 (대부분의 컴퓨터가 해당돼요)
- 인터넷 연결: AI가 클라우드(인터넷 서버)에서 동작하기 때문에 필수예요
- Claude 유료 구독: claude.ai 에서 Pro 이상 요금제 구독 필요
Claude Code를 쓰려면 Claude Pro 이상의 유료 구독이 필요해요. 무료 계정으로는 사용할 수 없어요. claude.ai 에서 가입한 뒤 구독을 시작하면 돼요.
요금제 비교
| Pro | Max (100) | Max (200) | |
|---|---|---|---|
| 월 요금 | $20 | $100 | $200 |
| Claude Code | 사용 가능 | 사용 가능 | 사용 가능 |
| 사용량 | 기본 제공량 | Pro의 5배 | Pro의 10배 |
| 모델 | Sonnet 중심 | Opus + Sonnet | Opus + Sonnet |
| 추천 대상 | 개인 프로젝트, 입문자 | 하루 종일 코딩하는 분 | 팀·업무용 헤비 유저 |
처음 시작하시는 분은 Pro($20/월)로 충분해요. 바이브 코딩에 익숙해지고 사용량이 늘어나면 그때 Max로 올리면 돼요.
Windows에서 설치하기
Windows는 설치 방법이 3가지예요. 1번부터 차례로 시도하시고, 안 되면 다음 방법으로 넘어가세요. Claude Code의 Windows 설치 스크립트는 간혹 "설치 완료" 메시지만 뜨고 실제로는 실패하는 경우가 있어서, 이럴 땐 바로 2번으로 넘어가시면 돼요.
어떤 방법으로 설치하든 Git for Windows가 먼저 설치되어 있어야 해요. git-scm.com/downloads/win 에서 다운로드해서 먼저 설치하세요. 설치할 때 옵션은 전부 기본값 그대로 "Next"만 누르면 돼요.
PowerShell 여는 방법: 키보드에서 Windows 키를 누르고 "PowerShell"을 검색해서 실행하세요. 관리자 권한은 필요 없어요. 일반 실행으로 여세요.
방법 1: PowerShell 공식 스크립트 (1순위 시도)
# Claude Code 설치 (Windows 공식 방법)
irm https://claude.ai/install.ps1 | iex
설치 후 아래 명령어로 반드시 확인하세요:
claude --version
버전 번호가 안 나오거나 claude is not recognized... 에러가 나오면 설치가 실패한 거예요 (메시지만 "✅ 설치 완료"로 찍히는 버그가 있어요). 바로 방법 2로 넘어가세요.
방법 2: WinGet으로 설치 (Windows 11 사용자는 이 방법 추천)
Windows 11 사용자는 처음부터 이 방법을 쓰시는 걸 추천해요. WinGet 방식이 공식 스크립트보다 안정적이고, 0KB 빈 파일 생성·PATH 누락 같은 문제가 훨씬 적어요.
# WinGet으로 Claude Code 설치 (Windows 11 권장)
winget install Anthropic.ClaudeCode
WinGet(윈겟)은 Windows에 기본으로 들어있는 앱 설치 도구예요. 마이크로소프트 스토어에서 앱 받듯이 명령어 한 줄로 공식 배포본을 받아와요. Windows 10에도 있지만 Windows 11에 훨씬 잘 세팅돼 있어요.
설치 후 확인:
claude --version
방법 3: npm으로 설치 (최후 수단)
위 두 방법 다 안 되면, Node.js 위에서 돌리는 방식으로 우회할 수 있어요. 공식적으로는 deprecated(권장하지 않음) 이지만, 설치 문제로 막힌 분들에게는 확실한 우회로예요.
-
Node.js LTS 설치: nodejs.org/ko/download 에서 LTS 버전(장기 지원 버전, 안정적인 버전) 을 받아 설치하세요. Windows Installer(.msi) 다운로드 후 기본값으로 "Next"만 누르면 끝이에요.
-
설치 후 PowerShell을 완전히 닫았다가 다시 열고 아래 명령어를 실행하세요:
# Node.js 설치 확인 (버전 번호가 나와야 해요)
node --version
# npm으로 Claude Code 설치
npm install -g @anthropic-ai/claude-code
sudo npm install -g 또는 관리자 권한 PowerShell로 설치하지 마세요. 권한 문제가 생겨요. 일반 PowerShell로 그냥 실행하면 돼요.
설치 후 확인:
claude --version
Mac에서 설치하기
터미널(Terminal, Mac에 기본으로 들어있는 명령어 창)을 열고 아래 명령어를 붙여넣으세요.
# Claude Code 설치 (Mac/Linux 공식 방법)
curl -fsSL https://claude.ai/install.sh | bash
또는 Homebrew(홈브루, Mac용 프로그램 설치 도구)가 있다면:
# Homebrew로 설치하기
brew install --cask claude-code
터미널 여는 방법: Command + Space를 누르고 "Terminal"을 검색해서 실행하세요.
설치 확인
설치가 잘 됐는지 확인해 볼게요. 터미널(또는 PowerShell)에서 아래를 입력하세요:
# 설치된 Claude Code 버전 확인
claude --version
버전 번호가 나오면 성공이에요.
4단계: 터미널 기초 — 컴퓨터와의 카카오톡
터미널이 뭐예요?
터미널(Terminal) 은 컴퓨터와 글자로 대화하는 창이에요.
보통 컴퓨터를 쓸 때는 마우스로 폴더를 클릭하고, 아이콘을 더블클릭하잖아요. 터미널은 같은 일을 글자를 타이핑해서 하는 거예요. 마우스 대신 키보드로 컴퓨터에게 말을 거는 카카오톡이라고 생각하시면 돼요.
"왜 굳이 불편하게 글자로 해요?" 좋은 질문이에요. Claude Code가 바로 이 터미널 안에서 일하기 때문이에요. Claude Code에게 "폴더 만들어줘"라고 말하면, 터미널 안에서 바로 실행해줘요.
딱 5개만 알면 돼요
수백 개의 터미널 명령어가 있지만, 바이브 코딩에 필요한 건 딱 5개예요. 나머지는 Claude Code가 알아서 해줘요.
| 명령어 | 뜻 | 비유 |
|---|---|---|
pwd | 지금 내가 어디에 있는지 보기 | "현재 위치 확인" — 네비게이션의 현재 위치 표시 |
ls | 이 폴더에 뭐가 있는지 보기 | "주변 둘러보기" — 방 안에 뭐가 있나 훑어보기 |
cd 폴더명 | 다른 폴더로 이동하기 | "방 이동하기" — 거실에서 내 방으로 걸어가기 |
mkdir 이름 | 새 폴더 만들기 | "새 방 만들기" — 빈 방을 하나 추가하기 |
rm 파일명 | 파일 삭제하기 | "쓰레기통에 버리기" — 필요 없는 물건 치우기 |
이 5개로 해보는 연습:
# 지금 내가 어디에 있는지 확인
pwd
# 이 폴더에 뭐가 있는지 보기
ls
# "my-project" 라는 새 폴더 만들기
mkdir my-project
# 방금 만든 폴더로 이동하기
cd my-project
# 다시 현재 위치 확인 (my-project 안에 있을 거예요)
pwd
cd .. (cd 뒤에 점 두 개) 을 입력하면 한 단계 위 폴더로 돌아가요. 내 방에서 거실로 나가는 거예요. 자주 쓰니까 기억해두세요.
5단계: Claude Code 첫 실행 — 첫 대화
자, 장비가 모두 준비됐어요. 이제 Claude Code를 처음 켜볼 거예요.
프로젝트 폴더 만들고 시작하기
터미널(Windows는 PowerShell)을 열고 아래를 따라해 보세요:
# 바이브 코딩 연습용 폴더 만들기
mkdir vibe-practice
# 그 폴더로 이동하기
cd vibe-practice
# Claude Code 시작하기
claude
처음 실행하면 로그인 화면이 나와요. Claude 계정(Pro 이상 구독 중인 계정)으로 로그인하세요. 브라우저 창이 뜨면 승인 버튼을 누르면 돼요.
로그인이 끝나면 대화창이 열려요. 이제부터 여기에 하고 싶은 말을 적으면 돼요.
첫 대화 해보기
Claude Code 대화창에 아래를 그대로 입력해 보세요:
안녕, 나는 바이브 코더야. 이 폴더에 hello.txt 파일을 만들어줘. 내용은 "나의 첫 번째 바이브 코딩 파일입니다!" 로 해줘.
Claude Code가 파일을 만들어줄 거예요. 정말 만들어졌는지 확인해 볼까요?
클로드 코드 대화창에서
!를 맨 앞에 붙이면 터미널 명령어를 바로 실행할 수 있어요.
# 파일이 만들어졌는지 확인 (Claude Code 대화창 안에서 실행)
! ls
# 파일 내용 확인
! cat hello.txt
"나의 첫 번째 바이브 코딩 파일입니다!" 가 보이나요? 축하해요. 여러분이 코드를 한 줄도 직접 타이핑하지 않고, AI에게 말로 시켜서 파일을 만든 거예요. 이게 바이브 코딩이에요.
폴더도 만들어 보기
이번에는 좀 더 시켜볼게요. Claude Code 대화창에 이렇게 입력하세요:
이 폴더 안에 "notes" 라는 하위 폴더를 만들고, 그 안에 "study-log.md" 파일을 만들어줘.
내용은 "# 바이브 코딩 스터디 기록" 이라고 적어줘.
그리고 확인:
# 폴더 구조 확인
! ls notes/
파일이 잘 만들어져 있을 거예요. 이렇게 말로 지시하면 AI가 폴더를 만들고, 파일을 만들고, 내용을 넣어줘요.
이번 강에서 기억할 것
핵심만 정리해 볼게요.
-
GitHub는 코드의 클라우드 금고예요. github.com 에서 무료로 가입하세요. 사용자명은 짧고 기억하기 쉽게.
-
에디터는 VS Code를 추천해요. 무료이고, 가장 많이 쓰이고, Claude Code와 잘 호환돼요. 당장 없어도 바이브 코딩은 가능해요.
-
Claude Code 설치는 한 줄이면 끝이에요. Windows는 PowerShell에서
irm https://claude.ai/install.ps1 | iex(안 되면winget install Anthropic.ClaudeCode, 그래도 안 되면 Node.js LTS + npm), Mac은 터미널에서curl -fsSL https://claude.ai/install.sh | bash. Windows 11 사용자는 처음부터 WinGet 방식을 추천해요. -
터미널 명령어는 5개만 기억하세요.
pwd(어디 있어?),ls(뭐가 있어?),cd(이동),mkdir(폴더 만들기),rm(삭제). 나머지는 Claude Code가 해줘요. -
Claude Code 대화창에서
!를 붙이면 터미널 명령어를 바로 실행할 수 있어요.! ls처럼요.
다음 강에서는 VS Code를 내 손에 맞게 세팅하는 방법을 배울 거예요. AI가 만든 코드를 확인하고 관리하는 관제탑을 제대로 꾸며볼 거예요. 오늘 만든 vibe-practice 폴더를 그대로 사용할 거니까 삭제하지 마세요.
이런 분께 추천해요
이번 강은 "환경 세팅"이니까, 바이브 코딩을 시작하기 직전인 분들에게 꼭 필요한 내용이에요.
- 1~2강을 읽고 "이제 직접 해보고 싶다!"는 분 -- 개념은 이해했는데, 뭘 설치해야 하는지 막막했다면 이 강이 길을 열어줘요.
- 컴퓨터에 개발 도구를 설치해 본 적 없는 완전 초보 -- 터미널이 뭔지, 어디서 명령어를 입력하는지부터 차근차근 알려줘요.
- Claude Code를 써보고 싶은데 시작점을 모르는 분 -- 가입, 설치, 첫 실행까지 이 한 편으로 끝나요.
참고 링크
- GitHub 가입: github.com
- VS Code 다운로드: code.visualstudio.com
- ZED 에디터: zed.dev
- Cursor 에디터: cursor.com
- Claude Code 공식 문서: code.claude.com/docs
- Git for Windows 다운로드: git-scm.com/downloads/win
- Node.js LTS 다운로드 (npm 설치 최후 수단용): nodejs.org/ko/download
- Claude 구독 및 가입: claude.ai
▸개정 이력2건
- v22026-04-15Windows 설치 섹션 3단계 플랜 구조로 재구성 (PowerShell → WinGet → npm 최후수단). Windows 11 WinGet 권장 명시, 공식 스크립트 실패 시 대응법 추가, 관리자 권한 안내 제거(공식 문서 기준 불필요), Node.js LTS 다운로드 링크 추가
- v12026-04-12초판
이 글이 도움이 되었나요?