쪽수
ISBN
브랜드
클로드 코드에게 코드는 맡기고 있지만 결과가 매번 달라진다면?
코드는 AI가 쓰고, 방향은 내가 정한다
대부분의 개발자는 여전히 AI 코딩 도구를 코파일럿처럼 사용한다. 무엇을 고쳐야 하는지 스스로 판단한 뒤 지시하고, AI가 코드를 작성하는 방식이다. 편리하지만 개발을 주도하는 것은 여전히 사람이고, 작업 범위가 조금만 커져도 AI는 원하지 않는 파일까지 건드리거나 테스트 없이 완료를 보고한다. 이 책은 여기서 출발한다. 제품 전체를 AI에게 한 번에 맡기는 것은 아직 어렵지만, 작업을 검증 가능한 작은 단위로 나누고 무엇을 만들지·어디까지 만들지·완료를 어떻게 확인할지를 명확히 지시한다면 지금도 AI에게 실제 개발을 맡길 수 있다는 것이다.
이 책은 애자일의 버티컬 슬라이스 개발 방식을 클로드 코드 워크플로에 적용한다. 클로드 코드가 사용자를 인터뷰해 요구사항(SPEC)을 정리하고, 이를 바탕으로 개발 계획(PLAN)과 작업 지시서(SLICE)를 만든 뒤 구현과 테스트까지 수행하는 과정을 단계별 실습으로 안내한다. 여기에 CLAUDE.md, 스킬, 서브에이전트, 에이전트 팀즈로 클로드 코드의 능력을 확장하고, 훅과 권한 시스템으로 안전하게 통제하는 방법까지 다룬다.
책을 마칠 때쯤이면 클로드 코드의 기능을 익히는 데 그치지 않고, 아이디어를 실제 동작하는 제품으로 완성하는 방법과 그 과정에서 AI에게 얼마나, 어떻게 맡겨야 하는지에 대한 감각까지 갖추게 된다.
출판사 리뷰
“클로드 코드에게 코드는 맡기고 있지만 결과가 매번 달라진다면?”
“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
리뷰
24,000원
10%
21,600원