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

바이브 코딩부터 하네스 엔지니어링까지!
한 권으로 완성하는 클로드 코드

① 바이브 코딩이 처음이라면 순한맛으로 시작!
바이브 코딩과 에이전틱 코딩 개념부터 클로드 코드 설치 및 환경 설정까지 차근차근 시작합니다. 링크나무(Link in Bio) 서비스, 할 일 앱, AI 비서 등 다양한 예제를 직접 만들어 보며 CLAUDE.md, PRD, 플랜 모드 등 클로드 코드의 기본 기능을 자연스럽게 익힐 수 있도록 구성했습니다.

② 코딩 경험이 있거나 순한맛을 끝냈다면 매운맛으로 레벨업!
프롬프트와 컨텍스트 설계부터 훅(hook), 스킬(skill), 서브에이전트 활용까지 클로드 코드를 좀 더 깊이 있게 배우고 활용할 수 있는 내용들을 다룹니다. 나아가 스펙 주도 개발(SDD)과 하네스 엔지니어링을 통해 AI가 더 잘 이해하고 일하도록 시스템을 설계하는 방법까지 살펴봅니다.

③ 흥미로운 예제로 배우고, 최신 트렌드까지!
숏폼 자동화, 디스코드를 이용한 AI 비서 등 흥미로운 예제로 클로드 코드의 핵심 기능을 익히고, 스펙 주도 개발, 동적 워크플로, 하네스 엔지니어링 등 최신 개발 흐름도 함께 담았습니다.

④ 저자들의 시행착오와 실전 노하우를 그대로!
기능을 나열하는 데 그치지 않고, 원하는 결과를 얻기 위해 어떻게 활용해야 하는지에 집중했습니다. 실무에서 직접 부딪히며 얻은 경험과 시행착오, 같은 실수를 반복하지 않는 방법까지 솔직하게 담았습니다.

⑤ 14명의 리뷰어와 함께!
마케터, PM, 다양한 분야의 개발자들이 함께 리뷰하고 토론하며 독자분들의 관점에서 다듬었습니다. 현장의 니즈를 반영한 완성도 높은 내용을 만나보세요.

1부. 순한맛

1장. 바이브 코딩, 개발의 새로운 물결
1.1?개발의 진입 장벽이 사라지고 있다?
__1.1.1?아이디어는 있는데 만들 수가 없다?
__1.1.2?2026년, 무언가 달라졌다?
__1.1.3?무엇이 바뀌었는가??
__1.1.4?개발의 무게 중심이 이동하고 있다?
__1.1.5?그래서 이 책은 무엇을 다루는가??
1.2?바이브 코딩의 탄생?
__1.2.1?바이브 코딩이란 무엇인가??
__1.2.2?바이브 코딩의 핵심 원칙?
__1.2.3?바이브 코딩 vs 에이전틱 엔지니어링?
1.3?AI 코딩 도구의 세 가지 유형?
__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.1?AI와 에이전틱 코딩?
__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.3?macOS/리눅스에서 클로드 코드 설치하기
__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.8?Skills 소개?
__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장. 딸깍! 클로드 코드로 링크나무(Link in Bio) 서비스 만들기
3.1?만들 제품 정의하기?
__3.1.1?링크나무 서비스 한 줄로 정의하기?
__3.1.2?화면 흐름 그려 보기?
__3.1.3?프로젝트 진행 규칙 설명하기: CLAUDE.md?
__3.1.4?실습 준비: 프로젝트 폴더 구성하기
3.2?프로젝트 첫 삽 뜨기?
__3.2.1?클로드 코드 실행하기?
__3.2.2?CLAUDE.md 파일은 자동으로 컨텍스트가 된다?
__3.2.3?Next.js 프로젝트 만들기?
__3.2.4?디렉터리 구조 살펴보기?
__3.2.5?로컬에서 실행하기?
__3.2.6?와이어프레임대로 첫 화면 만들기?
__3.2.7?깃과 깃허브 이해하기?
__3.2.8?첫 커밋과 깃허브 푸시?
3.3?Vercel로 배포하기?
__3.3.1 배포란 무엇인가?
__3.3.2?Vercel이란 무엇인가??
__3.3.3?깃허브 저장소 연동하기?
__3.3.4?Vercel 계정 연결과 첫 배포?
3.4?내 정보와 링크 채우기?
__3.4.1?프로필을 내 정보로 채우기?
__3.4.2?내 SNS/블로그 링크로 바꾸기?
__3.4.3?디자인을 한 단계 끌어올리기?
__3.4.4?완성된 제품 사용해 보기?
3.5?MongoDB Atlas로 데이터 저장하기?
__3.5.1?왜 클릭 수 확인 기능에 데이터베이스가 필요한가??
__3.5.2?왜 MongoDB Atlas인가??
__3.5.3?MongoDB Atlas 가입 및 클러스터 만들기?
__3.5.4?보안 설정과 Connection String 발급?
__3.5.5?클로드 코드로 클릭 수 확인 기능 완성하기?
__3.5.6?참고: 막혔을 때는 에러 메시지를 그대로 붙여 넣자

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

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

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

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

11장. 스펙 주도 개발(SDD)
11.1?스펙 주도 개발의 시작?
__11.1.1?같은 프롬프트, 다른 결과?
__11.1.2?병목은 코드가 아니라 의도다?
__11.1.3?스펙은 프롬프트가 아니라 계약이다?
__11.1.4?전통적 워크플로 vs SDD 워크플로?
__11.1.5?여러 SDD 도구?
11.2?스펙의 3요소: Context/Control/Correctness?
__11.2.1?Context: 결정 기반으로 동작하는 작업?
__11.2.2?Control: 무엇을 만들고, 무엇은 하지 않을지?
__11.2.3?Correctness: 완료를 어떻게 증명할 것인가?
11.3?실습: GSD로 오늘 배운 것을 기록하는 TIL 명령어 만들기?
__11.3.1?왜 GSD부터인가??
__11.3.2?GSD 설치하기?
__11.3.3?한 줄 프롬프트로 자율 리서치 시작?
__11.3.4?산출물의 두 층: 결론과 근거?
__11.3.5?C-C-C가 어디에 들어 있는가?
__11.3.6?페이즈를 넘어갈 때 세션을 비운다?
__11.3.7?ROADMAP의 결정이 실제 코드에서 다시 확인된 두 장면?
__11.3.8?til 직접 실행해 보기?
__11.3.9?한 사이클을 돌고 나서?
11.4?SDD의 한계?
__11.4.1?스펙이 코딩보다 오래 걸리는 함정?
__11.4.2?스펙을 썼는데 AI가 일부를 무시할 때?
__11.4.3?스펙으로 잡기 어려운 영역?
__11.4.4?세션이 길어지면 AI가 스펙을 잊는다?
__11.4.5?OpenSpec과 GitHub Spec Kit

12장. 하네스 엔지니어링
12.1?하네스 엔지니어링이란?
12.2?Planner-Generator-Evaluator 구조?
__12.2.1?Planner?
__12.2.2?Generator?
__12.2.3?Evaluator?
12.3?주식 분석 리포트 하네스 분석하기?
__12.3.1?시스템 설계?
__12.3.2?에이전트 구성 살펴보기?
__12.3.3?리뷰 에이전트?
__12.3.4?리뷰-수정 루프?
__12.3.5?Builder?
__12.3.6?훅 기반 가드레일 ?
__12.3.7?파일 시스템?
__12.3.8?최종 상태 정의?
__12.3.9?더 나아가야 할 길?
12.4?대규모 레거시 프로젝트에 클로드 코드 적용하기

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

유튜브: https://www.youtube.com/@kundol