클로드 코드 제대로 시작하기

주홍철,황진성

저자:주홍철
10년차개발자이자AI핀테크스타트업어비스(AVISS)대표로,인공지능모델·데이터레이크파이프라인·퀀트알고리즘·웹·모바일전영역을직접구축해왔다.전네이버개발자이자IT분야1위베스트셀러『면접을위한CS전공지식노트』의저자이며,인프런에서'CS지식의정석','C++코딩테스트'강의를하고있다.2025년미국라스베가스에서열리는CES에한국대표스타트업으로선정되어어비스픽서비스를선보였다.
유튜브:youtube.com/@kundol

저자:황진성
재미있는건다해보는소프트웨어엔지니어다.AI스타트업튜닙에서AI챗봇을만들며커리어를시작해,컬리에서그로스제품의서버를개발했고,지금은카카오뱅크에서서버개발자로일하고있다.새로운AI도구가나오면일단업무에붙여보고어디까지맡길수있는지실험하길좋아한다.해커톤참여를즐기며,최근에는2026SnowflakeAI&Data해커톤에서우승했다.
링크드인:linkedin.com/in/jinseong-hwang/

1부.순한맛

1장.바이브코딩,개발의새로운물결
1.1개발의진입장벽이사라지고있다
__1.1.1아이디어는있는데만들수가없다
__1.1.22026년,무언가달라졌다
__1.1.3무엇이바뀌었는가
__1.1.4개발의무게중심이이동하고있다
__1.1.5그래서이책은무엇을다루는가
1.2바이브코딩의탄생
__1.2.1바이브코딩이란무엇인가
__1.2.2바이브코딩의핵심원칙
__1.2.3바이브코딩vs에이전틱엔지니어링
1.3AI코딩도구의세가지유형
__1.3.1자율성이라는기준
__1.3.2유형1:앱빌더-프롬프트에서완성품까지
__1.3.3유형2:IDE어시스턴트-옆자리의페어프로그래머
__1.3.4유형3:터미널에이전트-일을위임받는주니어개발자
__1.3.5같은작업,다른접근:IDE어시스턴트vs터미널에이전트
__1.3.6어떤상황에어떤유형을선택할까
__1.3.7이책이다루는영역
1.4왜클로드코드인가

2장.클로드코드,새로운개발파트너
2.1AI와에이전틱코딩
__2.1.1개발의80%는코드작성이아니다
__2.1.2에이전틱코딩:나머지80%에대한답
2.2클로드코드란무엇인가
__2.2.1핵심메커니즘:에이전틱루프
__2.2.2무엇이이것을가능하게하는가
__2.2.3클로드코드의핵심기능
__2.2.4클로드코드의사용흐름살펴보기
__2.2.5한계:솔직하게알아야할것들
2.3클로드코드설치
__2.3.1터미널앱선택
__2.3.2클로드코드설치전사전요건확인
__2.3.3macOS/리눅스에서클로드코드설치하기
__2.3.4윈도우에서클로드코드설치하기
__2.3.5회원가입및첫인증
__2.3.6설치확인및첫실행
2.4클로드코드기본사용법
__2.4.1클로드코드실행하고살펴보기
__2.4.2세션이란
__2.4.3컨텍스트란
__2.4.4슬래시명령어
__2.4.5컨텍스트에파일추가하기
__2.4.6다양한실행모드
__2.4.7프로젝트규칙과CLAUDE.md
__2.4.8Skills소개
__2.4.9추론(Thinking)레벨소개
__2.4.10그외다양한팁
2.5실습:첫프로젝트만들기
__2.5.1입력프롬프트작성하기
__2.5.2클로드코드의작업방식살펴보기
__2.5.3브라우저에서자기소개페이지실행하기
__2.5.4대화형개발:한번더수정해보기
__2.5.5파일위치확인하고종료하기

3장.딸깍!클로드코드로링크나무(LinkinBio)서비스만들기
3.1만들제품정의하기
__3.1.1링크나무서비스한줄로정의하기
__3.1.2화면흐름그려보기
__3.1.3프로젝트진행규칙설명하기:CLAUDE.md
__3.1.4실습준비:프로젝트폴더구성하기
3.2프로젝트첫삽뜨기
__3.2.1클로드코드실행하기
__3.2.2CLAUDE.md파일은자동으로컨텍스트가된다
__3.2.3Next.js프로젝트만들기
__3.2.4디렉터리구조살펴보기
__3.2.5로컬에서실행하기
__3.2.6와이어프레임대로첫화면만들기
__3.2.7깃과깃허브이해하기
__3.2.8첫커밋과깃허브푸시
3.3Vercel로배포하기
__3.3.1배포란무엇인가
__3.3.2Vercel이란무엇인가
__3.3.3깃허브저장소연동하기
__3.3.4Vercel계정연결과첫배포
3.4내정보와링크채우기
__3.4.1프로필을내정보로채우기
__3.4.2내SNS/블로그링크로바꾸기
__3.4.3디자인을한단계끌어올리기
__3.4.4완성된제품사용해보기
3.5MongoDBAtlas로데이터저장하기
__3.5.1왜클릭수확인기능에데이터베이스가필요한가
__3.5.2왜MongoDBAtlas인가
__3.5.3MongoDBAtlas가입및클러스터만들기
__3.5.4보안설정과ConnectionString발급
__3.5.5클로드코드로클릭수확인기능완성하기
__3.5.6참고:막혔을때는에러메시지를그대로붙여넣자

4장.오마이클로드코드(OMC):멀티에이전트오케스트레이션
4.1오마이클로드코드란무엇인가
__4.1.1OMC를쓰면어떤점에서좋은가
__4.1.2OMC의특징
__4.1.3OMC설치하기
4.2OMC의주요개념
__4.2.1OMC의아키텍처
__4.2.2OMC의에이전트구조
__4.2.3OMC의상태관리
__4.2.4OMC의실행모드정리

5장.PRD와플랜모드
5.1PRD
__5.1.1PRD란무엇인가
__5.1.2PRD의구조
__5.1.3할일앱PRD.md만들기
5.2플랜모드란무엇인가
__5.2.1플랜모드실행하기
__5.2.2플랜검증하기
__5.2.3할일앱만들기
__5.2.4할일앱미세조정하기
__5.2.5만들어진할일앱확인하기
__5.2.6Vercel로배포하기
__5.2.7에어비앤비스타일디자인적용하기

6장.딸깍!숏폼자동화파이프라인만들기
6.1프롬프팅과MD세팅하기
__6.1.1.env파일설정하기
__6.1.2폴더생성및문서와이미지저장하기
__6.1.3sample.md준비하기
6.2클로드코드에숏폼생성요청하기
6.3미세조정하기
__6.3.11차수정
__6.3.22차수정
__6.3.33차수정
__6.3.44차수정

7장.딸깍!디스코드로만드는AI비서,자비스
7.1PC앞을떠나면멈추는에이전트
__7.1.1왜디스코드인가,왜CLI인가
7.2시스템설계
__7.2.1전체아키텍처
7.3디스코드봇셋업
__7.3.1애플리케이션과봇토큰
__7.3.2서버초대와환경변수

2부.매운맛

8장.프롬프트엔지니어링
8.1좋은프롬프트의구조
__8.1.1좋은프롬프트체험해보기
8.2프롬프트강화하기
__8.2.1예시기반방법
__8.2.2프롬프트이터레이션
__8.2.3오픈소스활용방법

9장.컨텍스트엔지니어링
9.1컨텍스트엔지니어링이란무엇인가
9.2컨텍스트의구성요소
__9.2.1시스템프롬프트
__9.2.2도구실행결과
__9.2.3외부문서
__9.2.4현재상태:파일과코드그리고외부문서
9.3컨텍스트선택과설계패턴
__9.3.1무엇을넣을것인가
__9.3.2위치전략:어디에놓을것인가
__9.3.3계층형컨텍스트설계
9.4컨텍스트오염
__9.4.1컨텍스트오염이란
__9.4.2오염사례분석
__9.4.3컨텍스트리셋전략

10장.클로드코드심화
10.1CLAUDE.md,클로드코드의장기기억
__10.1.1대화가끝나면사라지는기억
__10.1.2계층형메모리구조
__10.1.3CLAUDE.md를꾸준히다듬는방법
__10.1.4CLAUDE.md잘쓰는법
__10.1.5CLAUDE.md파일에는덜써야한다
__10.1.6모노레포에서상위CLAUDE.md파일을다룰때조심해야할점
__10.1.7규칙이커지면.claude/rules/로모듈화한다
10.2.claude/폴더의settings.json
10.3Tools,클로드코드의손과발
__10.3.1핵심도구
__10.3.2도구호출의흐름
__10.3.3실전시나리오:Read+Grep+Edit로함수호출부분을찾고수정하기
__10.3.4에이전트를만들때필요한도구들
__10.3.5클로드코드의MCP도구확장
10.4Hooks,이벤트기반자동화
__10.4.1결정론적자동화가필요한이유
__10.4.2훅이벤트
__10.4.3훅유형다섯가지
__10.4.4exit코드의의미
__10.4.5Matcher와if필드
__10.4.6훅스크립트환경변수와설정위치
__10.4.7실전예시모음
__10.4.8점진적도입하기
10.5Skills,복잡한작업을레시피로
__10.5.1Skills란무엇인가
__10.5.2SKILL.md파일형식
__10.5.3스킬호출방식
__10.5.4동적컨텍스트와변수
__10.5.5스킬저장위치와우선순위
__10.5.6지원파일과점진적공개
__10.5.7스킬을잘만드는원칙
__10.5.8실습:스킬만들기
10.6CustomAgents,나만의전문가팀
__10.6.1서브에이전트란무엇인가
__10.6.2내장서브에이전트
__10.6.3커스텀에이전트정의하기
__10.6.4자동위임과수동호출
__10.6.5스킬프리로드
__10.6.6실전에이전트설계3종
__10.6.7커스텀에이전트설계원칙
10.7MCP,외부세계와연결하기
__10.7.1MCP란무엇인가
__10.7.2MCP서버추가하기
__10.7.3실습:PlaywrightMCP로웹페이지자동탐색하기
__10.7.4더많은MCP서버활용하기
__10.7.5보안주의사항
10.8동적워크플로오케스트레이션
__10.8.1동적워크플로란무엇인가
__10.8.25단계아키텍처
__10.8.3적대적수렴메커니즘
__10.8.4동적예산
__10.8.5동적패턴카탈로그
__10.8.6ultracode
__10.8.7/deep-research

11장.스펙주도개발(SDD)
11.1스펙주도개발의시작
__11.1.1같은프롬프트,다른결과
__11.1.2병목은코드가아니라의도다
__11.1.3스펙은프롬프트가아니라계약이다
__11.1.4전통적워크플로vsSDD워크플로
__11.1.5여러SDD도구
11.2스펙의3요소:Context/Control/Correctness
__11.2.1Context:결정기반으로동작하는작업
__11.2.2Control:무엇을만들고,무엇은하지않을지
__11.2.3Correctness:완료를어떻게증명할것인가
11.3실습:GSD로오늘배운것을기록하는TIL명령어만들기
__11.3.1왜GSD부터인가
__11.3.2GSD설치하기
__11.3.3한줄프롬프트로자율리서치시작<