클로드 코드 마스터 (기획·개발·운영이 한 번에 끝나는 AI 에이전틱 코딩 워크플로)

클로드 코드 마스터 (기획·개발·운영이 한 번에 끝나는 AI 에이전틱 코딩 워크플로)

$36.00
Ask a Question
Vendor: 한빛미디어 - 이남희
Type: 인공지능
SKU: 9791175790513
Categories: ALL BOOKS 컴퓨터/인터넷 컴퓨터/인터넷_컴퓨터공학
Tags: 컴퓨터/IT_컴퓨터공학 클로드코드마스터기획개발운영이한번에끝나는AI에이전틱코딩워크플로
Description
클로드 코드 하나로
기획·개발·운영을 한 번에 끝낸다
AI 에이전틱 코딩의 실전 워크플로를 처음부터 끝까지 담은 최초의 클로드 코드 전문서. AI 코딩 도구는 이제 스스로 작업을 정의하고, 설계하고, 테스트까지 반복하는 '에이전트'로 진화했다. 이 책은 그 변화의 중심에 있는 클로드 코드를 실무에서 제대로 활용하는 법을 알려준다. 설치와 환경 설정부터 풀스택 TODO 앱 구현, AWS Bedrock과 연동한 AI 챗봇 개발까지, 실제 프로젝트를 함께 만들어가며 AI와 협업하는 개발자의 역할과 방법론을 체득할 수 있다.
단순한 툴 사용법을 넘어 “AI 시대에 개발자로서 어떻게 일할 것인가”라는 본질적인 질문에 답한다. 작업을 어떻게 분해하고, AI 출력을 어떻게 검증하며, 개발자로서 주도권을 어떻게 유지할 것인지 그 방법론을 실습을 통해 자연스럽게 익힐 수 있도록 설계되었다. 클로드 코드뿐 아니라 어떤 AI 코딩 도구를 사용하더라도 그대로 적용할 수 있는 원칙을 모두 담았다.
저자

이남희

20년차개발자이다.카카오에서셀장,파트장,리더를거쳐AI에이전트가나온이후로는실무에복귀해서현재는평범한서버개발자로근무하고있다.제약회사전산실에서첫직장생활을시작하여WAS기술벤더에서근무한뒤,꽤오랜시간SI업계에몸담았다.커머스,통신,전자등큰프로젝트에서서비스도메인개발을맡으며공통프레임워크개발담당및애플리케이션아키텍트로일했다.2012년에는스터디그룹을꾸려만든오픈소스프로덕트로공개SW개발자대회에입상하였고이후쿠팡에서4년가량주문/배송시스템의MSA분리개발,여행예약서비스개발업무등을수행한후LF를거쳐카카오로이직하였다.2024년에는한빛미디어를통해『개발자기술면접노트』라는책을출간했으며,현재는사이드프로젝트로노트앱(QNote)과홈서버자동구축솔루션인Brewnet등다양한아이디어를AI도구를통해구현하는데재미를느끼고있다.

목차

[1부|시작하기전에]

CHAPTER1AI시대의개발자패러다임
1.1개발자의역할변화
1.2AI코딩어시스턴트란무엇인가
__AI코딩도구의진화
__AI코딩어시스턴트의정의
__LLM기반의작동원리
__AI에이전트도구의등장
1.3클로드코드소개
1.4더많은실험이가능해진시대

CHAPTER2클로드코드설치와환경구성
2.1클로드코드개발환경설정하기
__맥에서클로드코드설치하기
__윈도우에서클로드코드설치하기
__클로드코드실행해보기
__VSCode설치하기
2.2첫번째대화:Hello,World
__클로드코드인터페이스와편집모드의이해
2.3클로드모델계열이해하기
__Opus,Sonnet,Haiku비교
__용도별모델선택가이드
__ExtendedThinking모드
__클로드코드에서Thinking모드변화및사용법
2.4기본명령어(슬래시커맨드)와사용법익히기
__꼭알아야할필수명령어
__자주쓰는단축키
__프롬프트내특수문법
__대화모드vs단일명령모드
__커스텀슬래시명령어만들기
__실전명령어조합예시
2.5CLAUDE.md로프로젝트설정하기
__CLAUDE.md파일의역할
__효과적인CLAUDE.md작성법
__코딩컨벤션과프로젝트규칙전달하기
__AGENTS.md:모든에이전트를위한표준문서
2.6AgentSkill이해하기
__AgentSkill이란무엇인가
__Skill이수행할수있는작업유형
__사용가능한Skill확인하기
__클로드코드Skill저장소소개
__Skill의활성화와비활성화
2.7Hook으로워크플로자동화하기
__Hook이란무엇인가
__작업완료시소리알림설정하기
__Hook활용아이디어
__PreCompactHook으로작업흐름이어가기
__Hook사용시주의사항

CHAPTER3AI와함께하는개발방법론
3.1왜설계가중요한가
3.2작은단위로쪼개기의힘
__한번에하나의작업만요청하기
__작업분해의기준과단위
3.3명확한지시의기술
__컨텍스트제한의원칙
__완료조건을명시하는방법
3.4매단계리뷰하기:주의깊은수정의원칙
__리뷰해야할것들
__단계별리뷰습관만들기
__리뷰워크플로와되돌리기
3.5AI에게없는것-개발자의판단력(Taste)
3.6증강코딩과TDD-AI시대의개발방식
__증강코딩:AI시대의새로운개발방식
__AI출력의비결정적특성과TDD
__AI가TDD사이클을무시할때대응법
__AI가만드는회귀방지하기
__테스트가진짜안전망이되려면
3.7클로드코드에서MCP설정하기
__MCP서버연결과설정
__개발에필수적인MCP서버
__Skill,Hook,MCP확장기능사용의원칙


[2부|기초편_풀스택TODO앱개발]

CHAPTER4프로젝트소개와요건정의
4.1TODO앱으로배우는풀스택개발
__프런트엔드:React+TypeScript
__백엔드:Node.js+Express/Next.jsAPIRoutes
__데이터베이스선택
4.2요구사항정의하기
__기능요구사항정의
__비기능요구사항정의
__사용자스토리정의
4.3클로드코드와함께요건문서작성하기
__프로젝트구조및실제개발계획수립하기
__PRD,TRD,REQUIREMENTS.md작성
4.4명세서설계와TDD방식으로개발시작하기
__데이터설계
__API설계
__컴포넌트및UseCase설계
__테스트케이스정의
__TDD방식의개발흐름
__PostgreSQL설치
__TDD로개발시작하기
4.5SDD와SpecKit
__SDD란무엇인가
__왜AI와SDD가잘맞는가
__TDD와SDD의결합
__SpecKit으로SDD워크플로자동화하기
__수동워크플로vsSpecKit:언제무엇을쓸것인가
__실무활용팁

CHAPTER5백엔드구현-명세를코드로만들기
5.1개발환경준비
__Next.js프로젝트생성및의존성설치
__Jest테스트환경구성
__DrizzleORM과PostgreSQL연결
5.2SDD워크플로로API구현하기
__SpecKit초기화와Constitution설정
__필수안전장치(가드레일)추가
__/speckit명령어를이용한계획수립과구현프로세스
5.3테스트로명세검증하기
5.4API검증과마무리
__명세(API_SPEC.md)대비구현검증
__수동테스트로최종확인
__변경사항기록Skill연동하기

CHAPTER6프런트엔드개발-컴포넌트단위로구축하기
6.1개발환경과구현전략
6.2컴포넌트테스트환경구성
6.3UI컴포넌트설계와구현
__기본컴포넌트TDD로구현하기
__레이아웃구현하기
__티켓폼과모달구현하기
6.4API연동과상태관리
6.5컨테이너조립과페이지통합
6.6디자인시스템을이용한UI와스타일개선
__디자인시스템일관성유지
__디자인시스템을CLAUDE.md에반영하기
__프런트개발플러그인을활용한UI개선
6.7프런트엔드테스트실행과검증

CHAPTER7빌드와배포
7.1개발/스테이징/운영서버관리전략
7.2Vercel을이용한배포
__배포전준비사항
__Vercel계정생성과프로젝트연결
__첫배포실행
7.3Railway를이용한백엔드배포
7.4도메인연결하기


[3부|실전편_AI챗봇앱개발]

CHAPTER8프로젝트기획과설계
8.1AI챗봇프로젝트개요
__무엇을만들것인가
__이프로젝트를선택한이유
8.2AWSBedrock과모델선택
__AWSBedrock이란
__ConverseAPI를선택한이유
__비용추정과최적화전략
8.3프로젝트범위결정
8.4시스템아키텍처설계
8.5API설계
__엔드포인트목록
__요청/응답형식개요
__SSE이벤트타입정의
8.6프런트엔드UI설계
__화면레이아웃
__주요컴포넌트정의
8.7CLAUDE.md작성
__프로젝트컨텍스트정리
__코딩컨벤션정의
__제외사항명시
8.8TDD+클로드코드워크플로
__역할분담및실제워크플로
__프롬프트패턴
__명세의두가지형태

CHAPTER9AWSBedrock연동
9.1AWS계정과IAM설정
__AWS계정생성
__IAM사용자생성
__Bedrock액세스권한설정
9.2프로젝트초기화
__Node.js프로젝트생성과AWSSDK설치
__테스트환경구성
__CLAUDE.md작성
9.3Bedrock클라이언트구현
__테스트작성:클라이언트생성
__테스트작성:기본메시지전송
__클로드코드에구현요청
__검증과리팩터링
9.4스트리밍응답처리
__테스트작성:스트리밍이벤트
__클로드코드에구현요청
__이벤트타입별핸들링
__토큰사용량추적
9.5에러핸들링
__테스트작성:에러시나리오
__클로드코드에구현요청
__에러타입별처리

CHAPTER10채팅API구현
10.1Express서버설정
__프로젝트구조
__미들웨어설정
__라우터구성
10.2세션관리
__테스트작성:세션CRUD
__구현:SessionManager
10.3대화히스토리관리
__테스트작성:메시지저장/조회
__구현:MessageHistory
__컨텍스트크기관리
10.4시스템프롬프트설계
__프롬프트구조
__페르소나정의
10.5채팅API엔드포인트
__테스트작성:POST/api/chat
__구현:SSE스트리밍응답
__테스트작성:세션API
__구현:세션CRUD엔드포인트
__테스트작성:세션메시지API
__테스트작성:미들웨어
__SSE스트리밍동작확인
10.6통합테스트
__E2E테스트작성
__에러시나리오테스트
__리팩터링:테스트가만드는안전망

CHAPTER11ToolUse구현
11.1ToolUse개념
11.2도구정의와스키마
__도구스키마구조
__JSON스키마작성법
__도구설명작성가이드
11.3시간조회도구구현
11.4계산기도구구현
11.5날씨API연동
__외부API선택
__도구설계
__테스트작성(Mock활용)
__구현
__에러처리
__통합테스트:실제API호출검증
11.6다중도구처리
__병렬도구호출이해
__테스트작성:다중도구
__구현:도구오케스트레이터
__BedrockService에ToolUse통합
__ToolUse통합테스트
11.7ToolUse설계고려사항
__입력검증
__타임아웃처리
__실패시폴백전략
__유틸리티테스트실행

CHAPTER12챗봇프런트엔드개발
12.1React프로젝트설정
__기술스택:Vite+React+TypeScript
__TailwindCSS설정
__프로젝트구조
12.2채팅UI컴포넌트
__컴포넌트설계
__테스트작성:MessageList
__구현:MessageList
__테스트작성:MessageInput
__구현:MessageInput
12.3스트리밍응답표시
__SSE클라이언트설계
__테스트작성:SSE서비스
__구현:SSE클라이언트
__테스트작성:useChatHook
__구현:useChatHook
12.4ToolUse결과표시
__테스트작성:ToolResult컴포넌트
__구현:ToolResult컴포넌트
12.5마크다운렌더링
__MarkdownRenderer컴포넌트구현
__MessageList에MarkdownRenderer연결
__MessageList에ToolResult연결
__리팩터링:MessageItem추출
__보안고려사항(XSS방지)
__구현:sanitize유틸리티
12.6에러처리와로딩상태

출판사 서평

"AI가코드를짜주는시대,개발자는무엇을해야하는가"
20년차개발자의경험을집대성한에이전틱코딩워크플로가이드

클로드코드,커서,코덱스등AI에이전트코딩도구가폭발적으로성장하면서개발현장은빠르게바뀌고있다.그러나'어떻게쓰는지'가아니라'어떻게잘쓰는지'를체계적으로정리한실무서는여전히드물다.이책은1년이상클로드코드를실무에직접적용하며시행착오를겪어온저자들이,그경험을바탕으로AI와함께일하는방법론을처음으로정리한실전서다.
버튼설명서가아닌,협업방법론을배운다.AI도구는업데이트될때마다UI와기능이달라진다.이책은특정버전의기능을하나하나설명하는매뉴얼이아닌'작업을어떻게쪼갤것인가','AI출력을어떻게검증할것인가','개발자로서주도권을어떻게유지할것인가'이세가지질문을중심으로AI와협업하는방법론자체를다룬다.여기서배운원칙은클로드코드가아닌다른도구를쓸때도그대로통한다.
실전프로젝트두개로완성하는풀스택역량을기른다.이론만으론부족하다.기초편(풀스택TODO앱)과실전편(AWSBedrock기반AI챗봇앱)이라는두개의완성형프로젝트를직접따라가며클로드코드의실제워크플로를익힌다.React+TypeScript프런트엔드,Node.js백엔드,PostgreSQL데이터베이스그리고ClaudeAPI의ToolUse와스트리밍응답까지기획,명세작성,구현,테스트,배포의전과정을AI와함께단계별로따라갈수있다.
TDD와SDD로AI출력을믿을수있는코드로만든다.할루시네이션대응,회귀방지,대규모코드베이스다루기등실무에서반드시부딪히는문제들을TDD(테스트주도개발)와SDD(명세주도개발)방법론으로풀어낸다.SpecKit을활용한워크플로자동화까지더해,AI의비결정적출력을안전하고검증된코드로바꾸는실전전략을배울수있다.
CLAUDE.md,Hook,MCP...클로드코드를내것으로만드는고급설정을배운다.클로드코드를잘쓰려면기본기능외에도프로젝트전용설정파일(CLAUDE.md),워크플로자동화를위한Hook,외부서비스와연결하는MCP서버설정을제대로이해해야한다.이책은그설정들을단편적으로소개하는것이아니라,실제프로젝트흐름안에서자연스럽게녹여알려준다.

이책의대상독자
● AI코딩도구를써봤지만결과물의수준을믿지못하는개발자
● 클로드코드를좀더체계적으로실무에적용하고싶은중급개발자
● AI시대에개발자로서의경쟁력을고민하는분
● 풀스택AI앱을처음부터끝까지직접만들어보고싶은분

미리읽은베타리더들의한마디
● AI에이전트에관한기존책들이대부분바이브코딩과에이전트기초만다뤘다면이책은수준높은심화활용기법을상세히파고듭니다._노경태님
● 무엇보다SpecKit기반의SDD예제는복잡한프로젝트를구조화하고통제하는방법에대한명확한단초를제공합니다._윤석진님
● TODO,챗봇앱을처음부터끝까지AI에이전트를활용해개발하는부분은마치시니어개발자가바로옆에서알려주는느낌이들었습니다.‘딸깍’이난무하는시대에이렇게자세하고친절한책은처음입니다._정윤성님
● 모든단계가실제동작하는코드로뒷받침되며,이론과실습이이렇게단단하게맞물린책을만나는건어려운일입니다.AI와함께일하는개발자라면꼭봐야할책입니다._전영식님