개발 환경 준비하기

🛠️ 최소한의 준비로 최대의 효과를

바이브 코딩의 매력은 복잡한 개발 환경을 완벽하게 갖추지 않아도 시작할 수 있다는 점입니다. 하지만 최소한의 설정은 필요합니다. 잘못 구성된 환경은 AI 도구의 효과를 절반으로 줄입니다. 이 강의에서는 가장 빠르고 안정적인 설정 경로를 알아봅니다.

📦 Step 1 — 에디터 설치

에디터가 없다면 VS Code를 설치하세요. 무료이며, AI 도구 대부분이 VS Code 기반이거나 VS Code 확장을 지원합니다.

Cursor를 사용할 계획이라면 VS Code 대신 Cursor를 직접 설치해도 됩니다 — Cursor는 VS Code를 기반으로 만들어져 있어서 VS Code 확장을 그대로 사용할 수 있습니다.

1. VS Code: code.visualstudio.com → 운영체제에 맞는 설치 파일 다운로드
2. Cursor: cursor.com → Download
3. Windsurf: codeium.com/windsurf → Download

⚠️ 두 에디터를 동시에 설치해도 됩니다. 서로 충돌하지 않습니다.

💻 Step 2 — 터미널 확인

터미널(명령줄)은 바이브 코딩의 핵심 공간입니다. AI가 명령을 실행하는 곳이기도 하고, 결과를 확인하는 곳이기도 합니다.

• macOS·Linux: 기본 Terminal 앱 또는 iTerm2를 사용합니다.
• Windows: Windows Terminal(Microsoft Store에서 무료)을 설치하거나, WSL2(Windows Subsystem for Linux)를 설정하면 Linux 환경을 쓸 수 있어 훨씬 편합니다.

VS Code·Cursor·Windsurf에는 내장 터미널(Ctrl+`)이 있으니, 별도 터미널 앱을 열지 않아도 됩니다.

🔑 Step 3 — AI 도구 계정 만들기

선택한 AI 도구의 계정을 만들고 로그인합니다.

도구	가입 주소	무료 여부
Claude Code	claude.ai → Claude Code 다운로드	Claude 구독 필요 ($20/월)
Cursor	cursor.com → Sign Up	무료 2주 체험, 이후 $20/월
Windsurf	codeium.com → Sign Up	무료 플랜 있음
GitHub Copilot	github.com/features/copilot	학생 무료, 일반 $10/월

💡 Cursor 팁: 처음 14일 무료 Pro 체험 기간 동안 모든 기능을 써볼 수 있습니다. 이 기간을 적극 활용하세요.

📁 Step 4 — 첫 프로젝트 폴더 만들기

AI 코딩 도구는 폴더(프로젝트) 단위로 작동합니다. 파일 하나만 열면 AI가 전체 맥락을 파악하기 어렵습니다. 항상 폴더를 만들고 에디터로 그 폴더를 열어야 합니다.

1. 원하는 위치에 폴더를 만듭니다. 예: ~/projects/my-first-app
2. 에디터에서 File → Open Folder로 해당 폴더를 엽니다.
3. 또는 터미널에서:

mkdir ~/projects/my-first-app
cd ~/projects/my-first-app
cursor .        # Cursor로 현재 폴더 열기
# 또는
code .          # VS Code로 열기

⚙️ Step 5 — 도구를 프로젝트에 연결

Cursor / Windsurf: 폴더를 열면 자동으로 AI가 활성화됩니다. 상단 바의 AI 아이콘 또는 단축키(Cmd+K)를 눌러 채팅을 시작합니다.

Claude Code: 터미널에서 프로젝트 폴더 안으로 이동한 뒤 claude 명령어로 실행합니다. 처음 실행 시 브라우저가 열리고 로그인·인증을 요청합니다.

cd ~/projects/my-first-app
claude

🐞 흔한 설치 오류와 해결법

증상	원인	해결
claude: command not found	Claude Code가 PATH에 없음	공식 설치 안내 따라 재설치, 터미널 재시작
에디터에서 AI 반응 없음	로그인 안 됨 또는 인터넷 연결 오류	계정 로그인 상태 확인, 재로그인
폴더 열기 후 파일이 안 보임	파일이 폴더 밖에 있음	File → Open Folder로 정확한 폴더 선택
Windows에서 경로 오류	역슬래시(\) 경로 문제	WSL2 사용하거나 경로를 따옴표로 감쌈

✅ 환경 준비 완료 체크리스트

• ☐ 에디터(VS Code / Cursor / Windsurf) 설치 완료
• ☐ AI 도구 계정 가입 및 로그인
• ☐ 터미널에서 명령 실행 가능한 상태
• ☐ 테스트용 폴더 만들고 에디터로 열기 완료
• ☐ AI 채팅 창이 열리고 반응 확인

모두 체크했다면 다음 강의에서 드디어 첫 바이브 코딩을 해봅니다. 환경 설정에 막혔다면 AI에게 오류 메시지 전체를 그대로 붙여넣어 도움을 받으세요 — 설정 오류를 해결하는 것도 바이브 코딩 연습입니다.