20기 2주차 핵심강의 claude code 로 바이브코딩 시작하기(개발자F) 요약 정리

항목

내용

스터디/세션명

Claude Code 핵심강의

일시

발표자/강사

곽은철(개발자/AI·ML 엔지니어, 1인 개발자)

참여자 수준

초보(비개발자 포함)

핵심 목표

① 바이브코딩 사고방식 이해 ② Git 최소 개념 습득 ③ Claude Code 기본 사용 흐름 익히기

결과물(산출물)

(예) 미니 게임 프로토타입, 기획문서/작업계획 MD, CLAUDE.md, 커밋/푸시 기록

항목

내용

문제의식

“비개발자가 Claude Code 강의/실습을 따라갈 수 있는가?”

접근 방식

전통 개발 vs 바이브코딩 비교 → Git 핵심 개념 최소화 → Claude Code 모드/명령 → 실전 사이클 적용

핵심 전제

코드는 AI가 만들 수 있으나, 기획·계획·확인·저장(복구) 습관이 성패를 좌우

수업 톤/원칙

“질문 많이 하기”, “공식문서 기반”, “플랜 읽기”, “작게 쪼개기”, “자주 저장”

구분

핵심 개념

강의에서의 설명(비유)

스터디 적용 포인트

개발 방식

전통 개발

건축(설계→쌓기→수정비용 큼)

설계 중요, 변경 비용 큼

개발 방식

바이브코딩

스케치북(러프→수정→폐기 용이)

빠른 반복/폐기가 강점

리스크

기술부채

통합/일관성/보안 취약 가능

“돌아갈 지점”과 “확인 루프” 필수

버전관리

Git

문서의 ‘최종/최최종’ 문제 해결

초보는 4개만: clone/add/commit/push

협업/클라우드

GitHub

USB/드라이브 같은 “코드용 클라우드”

집·회사 동기화, 협업 기반

도구 습관

대화관리

대화 길면 성능↓ (/clear, /compact)

작업을 작게 쪼개 5턴 내외 권장

프로젝트 규칙

CLAUDE.md

“프로젝트 지침서/행동강령”

반복 설명 감소, 일관성 강화

항목

설명

초보 권장 범위

git clone

프로젝트 통째로 내려받기

✅ 필수

git add

저장할 변경 파일 선택

✅ 필수

git commit

버전 저장 + 메모 남기기

✅ 필수

git push

GitHub로 업로드(백업/공유)

✅ 필수

git pull

최신 버전 받기

△ 필요시

branch/PR/merge

실험/리뷰/병합

⛔ 초반엔 생략(혼자 실습이면)

모드

역할

언제 쓰나

주의점

Plan Mode

계획 제시/질문/정리

작업 시작, 큰 작업 쪼개기

플랜 반드시 읽기

Accept/Edit Mode

파일 생성·수정 실행

플랜 확정 후 실행

중간 승인/권한 흐름 확인

(고급) Skip Permission/Headless

빠르게 자동 실행

숙련 후

파일 삭제 등 위험, 초보 비권장

명령어

기능

사용 타이밍

/init

프로젝트 초기화 + CLAUDE.md 생성

“기획/규칙/환경” 고정하고 싶을 때

/clear

대화 기록 초기화

작업 단위 종료 후(맥락 오염 방지)

/compact

대화 요약(컨텍스트 압축)

대화가 길어질 때 중간중간

/resume

이전 세션 이어서

필요 시

단계

행동

목적

완료 기준(체크)

1

Git 레포 준비(또는 클론)

“되돌릴 기반” 확보

레포 연결 완료

2

기획문서 작성(PRD/요구사항)

만들 것 정의

기획 1p 이상

3

작업계획 MD로 쪼개기

큰 일→작은 일

단계별 MD 3개 이상

4

Plan Mode로 1단계 플랜 작성

실행 전 설계

플랜 수정/확정

5

Accept/Edit로 실행

실제 구현

결과물 생성/수정

6

확인(가능하면 Claude in Chrome)

QA 자동화

핵심 기능 동작 확인

7

commit/push

안전 저장(보스 전 저장)

커밋 메시지 남김

8

/clear 또는 /compact

컨텍스트 정리

다음 작업 준비

상황

강의에서 제안한 대응

스터디 적용 규칙

같은 오류 반복

플랜 다시 세워 “작게 쪼개서” 접근

오류 1개=플랜 1개

3회 이상 막힘

이전 커밋으로 롤백 후 재시도

“3번이면 돌아가기” 룰

결과물 품질 불만

플랜 단계에서 요구사항 구체화

“플랜 읽고 수정 요청” 필수

대화가 길어짐

/clear 또는 /compact

작업 단위(5턴 내외) 유지

항목

내용

데모 과제

웹 기반 미니 게임(HTML/CSS/JS) 제작

진행 흐름

새 폴더 → VSCode 터미널 → claude 실행 → Plan→Edit→실행

산출물

index.html 등 파일 생성, 브라우저 실행 가능한 게임

개선 예시

점수 시스템, 난이도, 게임오버 화면, 모바일 대응 등

항목

내용

Claude in Chrome

버튼 클릭/페이지 이동/테스트 자동 수행

Hook(알림)

작업 종료 시 음성/알림(맥 say 등)

MCP 연계 예시

Google Calendar 일정→Notion 정리 자동화

핵심 메시지

Claude Code는 “코딩만”이 아니라 “업무 흐름 자동화”까지 확장 가능

구분

잘 된 점

아쉬운 점/리스크

개선 제안

이해 설계

비유(문서 최종버전)로 진입장벽 낮춤

용어량이 많아 초반 과부하 가능

초보는 “4개만” 반복 실습

실전성

기획→플랜→실행→확인→저장 사이클 제시

플랜을 안 읽으면 실패 확률↑

플랜 체크리스트 강제 적용

안정성

commit/push 중심으로 복구 가능

권한 자동모드(고급) 위험

초반 금지 규칙 명시

학습 습관

/clear,/compact로 컨텍스트 관리

초보가 타이밍 놓칠 수 있음

“작업 단위 끝나면 clear” 룰

우선순위

할 일

목표 시간

1

GitHub 레포 1개 만들기

2분

2

clone → add → commit → push 한 번 해보기

5분

3

“기획 10줄” 작성(무엇을 만들지)

3분

4

기획을 3단계 작업계획 MD로 쪼개기

5분

5

1단계 Plan→Edit→실행 후 commit/push

10분