“클로드 코드에게 코드는 맡기고 있지만 결과가 매번 달라진다면?”

“AI가 필요 이상으로 코드를 수정해 통제하기 어렵다면?”

무엇을 시킬지가 아니라, 어떻게 맡길지를 배우는 실전 워크플로

AI 코딩도구는 이제 낯설지않다. 그런데 정작실제 개발에 투입해보면 결과가 매번달라지고, 필요 이상으로 코드를 건드리고, 테스트 없이완료를 보고하는 경험을한 번쯤 하게된다. 문제는 도구가아니라 맡기는 방식에있다. 이 책은클로드 코드의 설치와작동 원리 같은기초부터, 버티컬 슬라이스라는 검증 가능한 개발단위로 제품을 완성해가는 실전 워크플로까지 하나의흐름으로 안내한다.

 

저자는 SPEC(요구사항)·PLAN(개발 계획)·SLICE(작업 지시서)라는세 문서를 중심에둔다. 세 문서모두 사람이 처음부터 작성하는 것이 아니라클로드 코드와 함께만들어간다는 점이 이책의 실전 감각을만든다. 여기에 CLAUDE.md로 프로젝트 규칙을 관리하고, 스킬·서브에이전트·에이전트 팀즈로역할을 나누고, 훅으로 규칙을강제하고, MCP로 외부시스템까지 연결하는 확장기술을 차례로 쌓아올린다.

 

이 책의 구성

총 5부로 구성된다.

• 1부클로드 코드 기초다지기(1~5장): 설치와 로그인, 대화→계획→실행→검증의기본 루프, 범위 고정프롬프트, CLAUDE.md, 클로드 코드의 작동원리

• 2부에이전틱 코딩으로 실제제품 개발하기(6~9장): 버티컬 슬라이스 방식으로 SPEC·PLAN·SLICE를만들고 구현·검증까지 진행하는 이 책의 중심워크플로

• 3부클로드 코드 능력확장하기 — 스킬, 서브에이전트, 에이전트 팀즈(10~13장): 반복작업을 재사용 가능한스킬로, 전문화된 작업을독립된 서브에이전트로 분리하고 슬라이스 개발에 적용

• 4부자동으로 지키고 자동으로 실행하기 — 훅(14장): CLAUDE.md의 규칙을시스템이 강제하도록 만드는차단 훅과 자동화훅

• 5부실전에서 달라지는 것(15~17장): MCP로외부 시스템 연동, 컨텍스트·세션관리, 권한 시스템과 프롬프트 인젝션 방어

 

이 책의 대상 독자

• 클로드코드를 처음 시작하며 기초 설치부터 실전제품 개발까지 제대로배우고 싶은 입문자

• 바이브코딩으로 프로토타입은 만들어봤지만 실제 개발에서는 결과물이 뒤죽박죽되어 한계를 느낀사용자

• AI에게막연하게 작업을 맡겨복잡한 기능을 개발할때 어려움을 겪었던사용자

• AI 개발도구를 단순 코딩보조로 쓰는 것을넘어 에이전틱 코딩을경험하고 싶은 개발자

• 에이전틱 코딩으로 아이디어를 실제동작하는 서비스로 구현해보고 싶은 비개발자 또는기획자

[목 차]

Part 01 클로드 코드 기초 다지기
Chapter 01 클로드 코드 설치에서 코드 작성까지
　1.1 왜 클로드 코드인가 - 다른 AI 코딩 도구와의 차별점 _25
　1.2 설치와 로그인 _28
　1.3 첫 번째 대화 - 프로젝트 파악하기 _31
　1.4 첫 번째 계획 - Plan 모드 _33
　1.5 실행 결과 확인하기 _36
Chapter 02 원하는 것만 만들게 하는 프롬프트 설계
　2.1 범위 고정 프롬프트 - 무엇을 어디까지 _41
　2.2 범위 고정 프롬프트를 어디에 쓰는가 _43
Chapter 03 프로젝트 생성하기 - 빈 폴더에서 실행 성공까지
　3.1 프롬프트로 프로젝트 만들기 _46
　3.2 시크릿 관리 _51
　3.3 프로젝트 첫 커밋 만들기 _52
Chapter 04 클로드 코드에게 프로젝트 지침 주기 - CLAUDE.md
　4.1 왜 모든 세션은 빈 상태로 시작하는가 - CLAUDE.md가 그 공백을 채우는 방법 _54
　4.2 CLAUDE.md 생성하기 _56
　4.3 CLAUDE.md 작성하기 _58
　4.4 사용하면서 규칙 추가하기 _60
　4.5 CLAUDE.md 규칙의 한계 _61
　4.6 규칙을 어디에 둘 것인가 _62
Chapter 05 프롬프트 뒤에서 일어나는 일 - 클로드 코드 작동 방식 이해하기
　5.1 에이전틱 루프 - 한 사이클이 어떻게 돌아가는가 _64
　5.2 모델 그리고 하네스 _65
　5.3 세션과 컨텍스트 윈도 _68
　5.4 무엇이 언제 로드되는가: 세션 시작 vs 필요할 때 _69
　5.5 권한 시스템 - 클로드 코드가 행동 전에 물어보는 이유 _71

Part 02 에이전틱 코딩으로 실제 제품 개발하기
Chapter 06 버티컬 슬라이스 - 전체를 작은 단위로 나누어 만들어가기
　6.1 버티컬 슬라이스란 무엇인가 _75
　6.2 슬라이스는 바로 정의되지 않는다 _77
　6.3 버티컬 슬라이스로 작업하는 흐름 _79
　6.4 슬라이스의 반복이 제품 개발이다 _81
Chapter 07 무엇을 만들지 정하고 작업 계획 세우기 - SPEC.md와 PLAN.md
　7.1 실습 프로젝트 준비하기 _84
　7.2 클로드 코드로 SPEC.md 작성하기 - 무엇을 만들 것인가 _86
　7.3 클로드 코드로 PLAN.md 작성하기 - 어떻게 만들 것인가 _93
Chapter 08 슬라이스를 실행 가능한 지시서로 만들기 - SLICE.md
　8.1 PLAN.md만으로는 왜 부족한가 - SLICE.md가 필요한 이유 _99
　8.2 SLICE.md에서 일반적으로 다루는 내용 _100
　8.3 클로드 코드로 SLICE.md 초안 만들기 _102
　8.4 SLICE.md에 디자인 참조 채우기 _106
　8.5 완료 기준 보강하기 _111
　8.6 SLICE.md 최종 점검 _114
Chapter 09 슬라이스 구현과 검증
　9.1 슬라이스 검증 환경 준비하기 _116
　9.2 SLICE.md를 전달하고 구현 시작하기 _116
　9.3 결과 확인하고 수정 지시하기 _119

Part 03 클로드 코드 능력 확장하기 - 스킬, 서브에이전트, 에이전트 팀즈
Chapter 10 새로운 워크플로 추가하기 - 스킬
　10.1 스킬이란 무엇이고 왜 필요한가 _125
　10.2 이미 만들어진 스킬 가져다 쓰기 _125
　10.3 스킬 직접 만들기 - SKILL.md 작성부터 다듬기까지 _131
　10.4 스킬 본문에 정보 끼워 넣기 _135
　10.5 호출 제어 - 자동 호출 막기 _137
Chapter 11 별도 공간에서 일하는 전문가 만들기 - 서브에이전트
　11.1 서브에이전트란 무엇이고 왜 필요한가 _140
　11.2 클로드 코드 내장 서브에이전트 알아보기 _142
　11.3 커스텀 서브에이전트 만들기 _143
　11.4 서브에이전트 설정 자세히 보기 _147
　11.5 서브에이전트에 스킬 주입하기 _152
　11.6 언제 서브에이전트를 쓰고, 언제 쓰지 않을 것인가 _153
Chapter 12 제품 개발에 스킬과 서브에이전트 활용하기
　12.1 버티컬 슬라이스 개발 돌아보기 _156
　12.2 SPEC 작성에 스킬 적용하기 _157
　12.3 SLICE 구현에 서브에이전트 적용하기 _165
Chapter 13 협업하며 일하는 팀 만들기 - 에이전트 팀즈
　13.1 에이전트 팀즈란 - 서브에이전트를 넘어 팀으로 일하기 _176
　13.2 에이전트 팀즈 설정하고 실행하기 _179
　13.3 에이전트 팀즈를 쓸 때 알아야 하는 것 _186

Part 04 자동으로 지키고 자동으로 실행하기 - 훅
Chapter 14 자동으로 실행되는 명령 걸기 - 훅
　14.1 클로드 코드가 건드린 파일을 전부 확인할 수 없다 _189
　14.2 훅이란 무엇인가 _190
　14.3 훅의 동작 원리 - 이벤트, 매처, 핸들러 _192
　14.4 첫 번째 훅 만들기 - settings.json에 훅을 등록하고 /hooks로 확인하기 _196
　14.5 차단 훅 - 위험한 파일 수정과 명령어 실행을 막는 방법 _199
　14.6 자동화 훅 - 특정 시점의 작업을 자동으로 실행하기 _204
　14.7 훅이 실행되지 않을 때 - 원인 찾기와 해결 _206

Part 05 실전에서 달라지는 것 - 더 많이 맡기되 고삐를 쥐는 법
Chapter 15 클로드 코드를 세상과 연결하기 - MCP
　15.1 MCP란 무엇이고 왜 필요한가 _211
　15.2 어떤 MCP 서버가 있나 - 개발에 유용한 서버들 _212
　15.3 MCP 서버 연결하기 - 슬랙 _215
Chapter 16 클로드 코드를 날카롭게 유지하기 - 컨텍스트와 세션 관리
　16.1 컨텍스트 사용 현황 확인하기 - /context _220
　16.2 컨텍스트 관리 - 비우기, 압축하기, 되돌리기 _222
　16.3 세션 관리 - 이어가기와 분기하기 _226
Chapter 17 클로드 코드에게 안전하게 맡기기 - 권한, 경계, 그리고 보안
　17.1 권한 시스템 이해 _230
　17.2 클로드 코드의 접근 범위 제한하기 _233
　17.3 프롬프트 인젝션 이해와 방어 _236
　17.4 클로드 코드에게 맡기지 말아야 할 것 _240

[본 문]

P. 5
제품을 검증 가능한 작은 단위로 나누고 각 단위에서 무엇을 만들고 어떻게 완료를 확인할지 명확히 한 뒤 AI에게 맡기는 것, 이것이 제가 찾은 에이전틱 코딩의 방법이자 이 책의 핵심입니다.

P. 25
바이브 코딩이 건축가에게 '여기 벽 하나 세워줘' '창문 좀 넓혀줘'라고 하나씩 지시하는 것이라면, 에이전틱 코딩은 '이런 건물을 짓고 싶다'고 말하면 건축가가 설계도를 작성하고, 건축주의 승인을 받고, 시공까지 진행하는 것입니다.

P. 25
좋은 건축주가 자신이 원하는 건물의 용도와 구조를 알아야 하듯, 에이전틱 코딩을 잘 하려면 자신이 만드는 제품의 목적과 기능을 잘 이해하고 있어야 합니다.

P. 26
도구를 가지고 있다는 것만으로는 충분하지 않습니다. 에이전트를 에이전트답게 만드는 것은 도구를 반복해서 사용하며 목표에 도달할 때까지 스스로 판단하는 루프입니다.