클로드 코드 에이전틱 코딩

"클로드 코드에게 코드는 맡기고 있지만 결과가 매번 달라진다면?"
"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

이행철 삼성SDS에서 지능형 로봇 SW 플랫폼과 엔터프라이즈 웹 서비스 개발, IT 신사업 기획을 거치며 기술 스택과 도메인을 넓혀왔다. 이후 두 차례의 CTO와 두 차례의 창업을 경험하며 서비스 개발 전반을 두루 다뤘다.
피트니스캔디(LG전자·SM엔터테인먼트 합작 법인)에서는 CTO로 제품 개발을 총괄하고 기술 조직을 이끌었다. 레스토랑 O2O 플랫폼 테이블엔조이에서는 CTO로서 기존 시스템을 쿠버네티스 기반 멀티테넌트 SaaS 플랫폼으로 전면 개편했다. 2016년에는 에이치랩을 창업해 음성 인식 기반 영어회화 학습 모바일 서비스를 출시했으며, 2023년 프라임소프트를 창업한 이후 에이전틱 AI를 중심으로 소프트웨어를 개발하고 있다.
최근에는 베이스 모델을 파인튜닝한 한국어 학습 AI 챗봇과 랭체인·랭그래프 기반 에이전트 서비스를 구축했다. 2025년에는 LG CNS가 운영하는 K-디지털 트레이닝 부트캠프의 리드 강사로 512시간 분량의 쿠버네티스·MSA 과정을 맡아 교육 자료와 예제 코드를 직접 제작하고 교육을 진행했다. 또한 파이썬과 에이전틱 AI 튜토리얼을 집필해 pyai.io에서 제공하고 있다.