Vibe coding

01강. Vibe Coding이란 무엇인가

🎯 학습 목표

  • Vibe Coding(바이브 코딩)의 개념과 기존 코딩 방식과의 차이를 이해한다.
  • AI 페어 프로그래밍이 왜 새로운 패러다임인지 설명할 수 있다.
  • Windows 11 환경에 Claude Code를 설치하고 첫 대화를 성공적으로 진행한다.
  • Claude Code 세션의 기본 흐름(질문 → 제안 → 실행 → 검증)을 체험한다.

📖 개념 설명

Vibe Coding은 개발자가 한 줄 한 줄 직접 타이핑하는 대신, 자연어로 “무엇을 만들고 싶은지”를 설명하면 AI가 코드를 작성하고 개발자는 방향을 잡고 검증하는 새로운 개발 방식입니다. 핵심은 “내가 코드를 친다”에서 “내가 의도를 전달하고 결과를 판단한다”로 작업의 무게중심이 옮겨간다는 점입니다. 이때 AI는 단순 자동완성 도구가 아니라, 함께 문제를 풀어나가는 페어 프로그래밍 파트너에 가깝습니다.

전통적인 개발에서는 문법, API 시그니처, 보일러플레이트를 모두 사람이 기억하고 입력해야 했습니다. Vibe Coding에서는 이런 반복 작업을 AI가 대신하고, 개발자는 “이 기능이 정말 요구사항을 충족하는가”, “이 구조가 유지보수에 적합한가” 같은 더 높은 수준의 판단에 집중합니다. 즉, 코딩의 생산성이 올라가는 동시에 개발자의 역할이 ‘타이피스트’에서 ‘설계자 겸 리뷰어’로 진화합니다.

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 도구입니다. 단순히 코드 조각을 던져주는 챗봇과 달리, 실제 파일을 읽고 수정하며 명령을 실행하고 결과를 확인하는 ‘에이전트형’ 도구입니다. 따라서 프로젝트 전체 맥락을 이해한 상태에서 작업하므로, 여러 파일에 걸친 변경이나 디버깅에 특히 강력합니다.

이 강좌 시리즈에서 우리는 Windows 11을 기준으로 Claude Code를 설치하고, To-Do 앱부터 풀스택 프로젝트까지 점진적으로 만들어 나갈 것입니다. 첫 강에서는 도구를 설치하고 첫 대화를 나누는 것이 목표입니다.

왜 하필 터미널 기반 도구일까 의문이 들 수 있습니다. 그래픽 편집기 안의 자동완성도 편리하지만, 터미널 기반 에이전트는 프로젝트 전체를 하나의 작업 공간으로 보고 파일 생성, 실행, 테스트, 커밋까지 끊김 없이 수행한다는 강점이 있습니다. 즉 ‘코드 한 줄을 채워주는’ 수준을 넘어, ‘작업 하나를 끝까지 처리하는’ 수준의 협업이 가능합니다. 이 차이가 Vibe Coding의 생산성을 결정합니다.

또한 Vibe Coding은 초보자와 숙련자 모두에게 의미가 있습니다. 초보자는 문법의 벽에 막히지 않고 ‘무엇을 만들고 싶은가’에 집중하며 학습할 수 있고, 숙련자는 반복적이고 지루한 작업을 위임하고 설계와 검토라는 고부가가치 활동에 시간을 쏟을 수 있습니다. 다만 공통적으로 중요한 것은, AI가 만든 결과를 맹신하지 않고 항상 읽고 이해하며 검증하는 태도입니다. 이 시리즈 전체를 관통하는 원칙이 바로 이것입니다.

💻 실습

Windows 11에서 Claude Code를 설치하려면 먼저 Node.js(LTS)가 필요합니다. PowerShell을 관리자 권한으로 열고 다음을 실행합니다.

# Node.js 버전 확인 (없다면 https://nodejs.org 에서 LTS 설치)
node --version
npm --version

# Claude Code 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

설치가 끝나면 작업할 프로젝트 폴더로 이동한 뒤 Claude Code를 실행합니다.

# 작업 폴더 생성 및 이동
mkdir C:devhello-claude
cd C:devhello-claude

# Claude Code 실행 (첫 실행 시 브라우저로 로그인 진행)
claude

실행 후 프롬프트가 뜨면 자연어로 첫 대화를 시도합니다. 예를 들어 다음처럼 입력합니다.

> 이 폴더에 hello.txt 파일을 만들고 "안녕하세요, Claude!"라고 써줘

Claude는 파일 생성 의도를 파악하고, 실제로 파일을 만들겠다는 제안을 한 뒤 승인 절차를 거쳐 작업을 수행합니다. 작업이 끝나면 결과를 직접 확인합니다.

# 생성된 파일 내용 확인
Get-Content hello.txt

⚠️ Windows 환경 주의사항

  • 경로 구분자는 Windows에서 백슬래시()를 쓰지만, 많은 도구가 슬래시(/)도 허용합니다. 혼동을 줄이려면 PowerShell 기준으로 일관되게 작성하세요.
  • npm install -g 실행 시 권한 오류가 나면 PowerShell을 “관리자 권한으로 실행”하세요.
  • 회사 보안 정책으로 PowerShell 스크립트 실행이 막혀 있으면 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned로 완화할 수 있습니다.
  • 한글 출력이 깨지면 터미널 인코딩을 UTF-8로 설정하세요: chcp 65001.

💡 팁

  • 첫 대화는 거창할 필요 없습니다. “이 폴더 구조 설명해줘” 같은 가벼운 질문으로 도구의 반응을 익히세요.
  • Claude는 승인 절차를 거쳐 파일을 수정합니다. 무엇을 바꾸려는지 항상 먼저 읽어보는 습관을 들이세요.
  • 프로젝트마다 폴더를 분리하면 Claude가 맥락을 더 정확하게 파악합니다.
  • 막히면 “지금 무엇을 하려는지 한국어로 설명해줘”라고 요청해 의도를 확인할 수 있습니다.