Part 7. 바이브 코딩 & Claude Code

자연어로 코딩하는 새로운 개발 방식

이 장이 강의의 핵심이다. "코드를 한 줄도 직접 작성하지 않고, AI에게 자연어로 요청해서 프로그램을 만드는 것" — 그게 바이브 코딩이다.

#7-1. 바이브 코딩이란?

한 줄 정의

"코드를 한 줄도 직접 작성하지 않고, AI에게 자연어로 요청해서 프로그램을 만드는 새로운 개발 방식"

#시작은 한 명의 트윗

2025년 2월, OpenAI 공동창립자이자 테슬라 전 AI 디렉터였던 Andrej Karpathy가 처음 제안한 개념이다.

그는 자기 프로젝트를 만들면서 이렇게 표현했다.

Andrej Karpathy, 2025-02

"프로젝트를 만들고 있는데, 코딩이라기보다는 그냥 보고, 말하고, 실행하고, 복붙하고… 그런데 거의 다 잘 동작한다."

그가 이 새로운 방식을 가리켜 처음 쓴 표현이 "Vibe Coding"이었다.

#기존 개발 vs 바이브 코딩

#7-2. 바이브 코딩 개발 도구

#① 모델 선택형 도구

사용자가 원하는 AI 모델(Claude, GPT, Gemini 등)을 직접 선택하는 방식.

#② 전용 모델형 (CLI 기반) 도구

특정 회사가 만든 모델에 최적화된 명령줄 도구.

#7-3. PRD (Product Requirements Document) 작성

PRD란

"AI에게 무엇을 만들어달라고 요청할지, 사람의 말로 정리한 설계 문서"

바이브 코딩에서 가장 중요한 것은 "무엇을 만들지 명확히 정의하는 것"이다. AI는 모호한 요청에는 모호한 결과로 답한다.

#5W1H로 PRD 작성하기

#7-4. AI와의 협업 루프

#협업 루프

flowchart LR
    R[1. 요청<br/>명확한 프롬프트] --> G[2. 생성<br/>AI 코드 생성]
    G --> C[3. 확인<br/>의도 검토]
    C --> M[4. 수정<br/>부분 수정 요청]
    M --> T[5. 점검<br/>테스트·검증]
    T -->|반복| R
    style R fill:#e3f2fd
    style G fill:#fff3e0
    style C fill:#f3e5f5
    style M fill:#fce4ec
    style T fill:#e8f5e9

1. 요청: 명확한 프롬프트로 작업 지시

2. 생성: AI가 코드 생성

3. 확인: 결과물이 의도와 맞는지 검토

4. 수정: 필요한 부분 수정 요청

5. 점검: 동작 테스트 및 품질 확인

#7-5. Claude Code 시작하기

Claude Code란

Anthropic이 만든 "터미널 기반 AI 코딩 도구"

#사전 준비

#설치 방법 — 두 가지 선택지

Claude Code는 네이티브 설치와 npm 설치 두 방식을 모두 지원한다.

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

npm install -g @anthropic-ai/claude-code

설치 후 공통 작업:

# 설치 확인
claude --version

# 프로젝트 디렉토리로 이동 후 시작
cd my-project
claude

#두 방식의 차이점

#7-6. Claude Code 주요 명령어

#7-7. CLAUDE.md — AI의 기억장치

CLAUDE.md란

"Claude Code가 매번 자동으로 읽는 프로젝트 설명서"

매 세션마다 "우리 프로젝트는 React 쓰고, 컨벤션은 이렇고…"라고 설명하기는 번거롭다. CLAUDE.md에 한 번 적어두면 Claude Code가 자동으로 읽고 기억한다.

#CLAUDE.md 예시

# 프로젝트: 할 일 관리 앱

## 기술 스택
- Frontend: React 18 + TypeScript + Tailwind CSS
- Backend: Spring Boot 3.2 + Java 17
- Database: PostgreSQL 15

## 코딩 컨벤션
- 컴포넌트는 PascalCase, 함수는 camelCase
- API 엔드포인트는 RESTful 규칙 준수

## 주의사항
- 절대 main 브랜치에 직접 push 금지
- 커밋 메시지는 한국어로 작성

#두 가지 레벨

#7-8. 나만의 명령어 만들기 — 스킬(Skills)

자주 쓰는 작업을 슬래시 명령어로 만들 수 있다. 같은 지시를 매번 복붙하고 있다면, 그건 스킬로 만들 때가 된 것이다.

#어디에 두나

폴더 이름이 곧 명령어가 된다. .claude/skills/commit/ → /commit

#예시: /commit 스킬 만들기

.claude/skills/commit/SKILL.md:

---
name: commit
description: 변경사항을 분석해 적절한 커밋 메시지로 자동 커밋합니다
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *) Bash(git diff *)
---

다음 작업을 수행해주세요:

1. git status로 변경된 파일 확인
2. git diff로 변경 내용 분석
3. Conventional Commits 규칙에 따라 분류
4. 한국어로 명확한 커밋 메시지 작성
5. git add . 후 git commit 실행

이제 Claude Code에서 /commit만 입력하면 위 작업이 자동 수행된다.

#알아둘 프론트매터 필드

#7-9. 서브에이전트 (Sub-agents)

서브에이전트란

"특정 작업에 특화된, 빈 컨텍스트로 시작하는 전문가 AI 인스턴스"

메인 대화를 어지럽히지 않고 별도의 깨끗한 컨텍스트에서 조사·리뷰 같은 일을 시킬 수 있다. 결과만 돌려받는다.

/agents 명령으로 대화형으로 만들 수도 있고, 파일로 직접 적을 수도 있다.

#서브에이전트 파일 예시

.claude/agents/code-reviewer.md:

---
name: code-reviewer
description: 코드 리뷰 전문가. PR 분석, 버그 발견, 개선 제안
tools: Read, Grep, Glob, Bash
model: sonnet
---

당신은 시니어 개발자입니다. 다음 기준으로 코드를 리뷰하세요:

1. 보안: SQL 인젝션, XSS 등 취약점이 없는가?
2. 성능: 불필요한 반복, N+1 쿼리, 자원 누수가 없는가?
3. 가독성: 변수명, 함수명이 명확한가?
4. 테스트: 엣지 케이스가 커버되는가?

#알아둘 프론트매터 필드

#7-10. Claude Code + MCP 연동

Part 6에서 본 MCP를 Claude Code에서 활용하면 진정한 시너지가 난다.

#주요 MCP 설치 명령어

# Notion MCP — 노션 페이지/DB 조작
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Sequential Thinking — 단계별 사고 도구
claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

# Context7 — 최신 라이브러리 문서 조회
claude mcp add context7 -- npx -y @upstash/context7-mcp

# Playwright — 브라우저 자동화
claude mcp add playwright -- npx -y @playwright/mcp

# GitHub — 저장소 관리 (GitHub 공식 원격 MCP · Personal Access Token 필요)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ -H "Authorization: Bearer <GitHub PAT>"

#활용 예시

#Claude Code 생태계 전체 그림

Claude Code를 중심으로 CLAUDE.md(기억), 커스텀 명령어(자동화), 서브에이전트(전문가), MCP(외부 도구)가 함께 동작한다

#정리

• 바이브 코딩 = 자연어로 코딩, Andrej Karpathy가 2025년 2월에 명명

• 핵심은 PRD(설계 문서)와 작은 협업 루프

• Claude Code는 터미널 기반 AI 코딩 도구 (설치는 네이티브 권장)

• CLAUDE.md로 프로젝트 컨텍스트 자동 주입 — 항상 읽는 사실

• 스킬(Skills)로 반복 절차를 명령어화 — 쓸 때만 로드되는 절차

• 서브에이전트로 전문 작업을 빈 컨텍스트에 위임, MCP로 외부 도구 연결

다음 장에서는 실제로 TO-DO 앱과 레시피 추천 앱을 만들면서 이 모든 걸 종합한다.