유한대학교 전자책도서관

책소개

클로드 코드에게 코드는 맡기고 있지만 결과가 매번 달라진다면?
코드는 AI가 쓰고, 방향은 내가 정한다

대부분의 개발자는 여전히 AI 코딩 도구를 코파일럿처럼 사용한다. 무엇을 고쳐야 하는지 스스로 판단한 뒤 지시하고, AI가 코드를 작성하는 방식이다. 편리하지만 개발을 주도하는 것은 여전히 사람이고, 작업 범위가 조금만 커져도 AI는 원하지 않는 파일까지 건드리거나 테스트 없이 완료를 보고한다. 이 책은 여기서 출발한다. 제품 전체를 AI에게 한 번에 맡기는 것은 아직 어렵지만, 작업을 검증 가능한 작은 단위로 나누고 무엇을 만들지·어디까지 만들지·완료를 어떻게 확인할지를 명확히 지시한다면 지금도 AI에게 실제 개발을 맡길 수 있다는 것이다.

이 책은 애자일의 버티컬 슬라이스 개발 방식을 클로드 코드 워크플로에 적용한다. 클로드 코드가 사용자를 인터뷰해 요구사항(SPEC)을 정리하고, 이를 바탕으로 개발 계획(PLAN)과 작업 지시서(SLICE)를 만든 뒤 구현과 테스트까지 수행하는 과정을 단계별 실습으로 안내한다. 여기에 CLAUDE.md, 스킬, 서브에이전트, 에이전트 팀즈로 클로드 코드의 능력을 확장하고, 훅과 권한 시스템으로 안전하게 통제하는 방법까지 다룬다.

책을 마칠 때쯤이면 클로드 코드의 기능을 익히는 데 그치지 않고, 아이디어를 실제 동작하는 제품으로 완성하는 방법과 그 과정에서 AI에게 얼마나, 어떻게 맡겨야 하는지에 대한 감각까지 갖추게 된다.

저자소개

삼성SDS에서 지능형 로봇 SW 플랫폼과 엔터프라이즈 웹 서비스 개발, IT 신사업 기획을 거치며 기술 스택과 도메인을 넓혀왔다. 이후 두 차례의 CTO와 두 차례의 창업을 경험하며 서비스 개발 전반을 두루 다뤘다.

피트니스캔디(LG전자·SM엔터테인먼트 합작 법인)에서는 CTO로 제품 개발을 총괄하고 기술 조직을 이끌었다. 레스토랑 O2O 플랫폼 테이블엔조이에서는 CTO로서 기존 시스템을 쿠버네티스 기반 멀티테넌트 SaaS 플랫폼으로 전면 개편했다. 2016년에는 에이치랩을 창업해 음성 인식 기반 영어회화 학습 모바일 서비스를 출시했으며, 2023년 프라임소프트를 창업한 이후 에이전틱 AI를 중심으로 소프트웨어를 개발하고 있다.

최근에는 베이스 모델을 파인튜닝한 한국어 학습 AI 챗봇과 랭체인·랭그래프 기반 에이전트 서비스를 구축했다. 2025년에는 LG CNS가 운영하는 K-디지털 트레이닝 부트캠프의 리드 강사로 512시간 분량의 쿠버네티스·MSA 과정을 맡아 교육 자료와 예제 코드를 직접 제작하고 교육을 진행했다. 또한 파이썬과 에이전틱 AI 튜토리얼을 집필해 pyai.io에서 제공하고 있다.

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

책소개

저자소개

목차