클로드 코드로 시작하는 실전 에이전틱 코딩

클로드 코드로 시작하는 실전 에이전틱 코딩

$33.00
저자

GoosKim

저자:GoosKim
소리바다·파일바다의대용량파일시스템개발을시작으로위메프를거쳐,태국과한국에서거위날다(FlyGooseThailand)라는스타트업을창업했다.하지만7년만에거위는끝내날개를펼치지못하고COVID-19와함께추락했다.그7년간의개발공백을에이전틱AI로메우고,현재는'모두의AI'공장장으로서Copyleft마인드를바탕으로돈안되는오픈소스를즐겨만들고,나만의노하우를온라인에나누는반세기개발자아저씨다.
주말엔가끔DJ부스에선다.

목차

__추천인의글
__저자와의인터뷰
__이책의구성

PART1클로드코드마스터

CHAPTER01클로드코드시작하기
1-1클로드코드와에이전틱코딩
__앤트로픽과에이전틱AI의부상
__에이전틱코딩이란
__에이전틱루프:클로드코드의동작원리
__터미널에서시작하는AI코딩
__컨텍스트윈도우와20만토큰컨텍스트의의미
__컨텍스트윈도우관리전략
__다섯가지접근영역과핵심기능
__엔터프라이즈환경에서의클로드코드
1-2클로드코드설치
__운영체제별설치방법
__인증설정
__버전관리와업데이트전략
1-3클로드코드CLI기초
__대화형모드와비대화형모드
__다양한실행플래그
__시스템상태진단과문제해결
__체크포인트와되감기시스템
1-4프로젝트로특징이해하기
__프로젝트컨텍스트의이해
__간단한프로그램작성
__파일읽기와쓰기패턴
__깃통합
__효과적인작업관리
__마무리

CHAPTER02워크플로와설정
2-1기본작업방식
__탐색-계획-구현-커밋워크플로
__탐색과분석
__점진적개발전략
__깃통합워크플로
__비대화형모드에서의세션재개
__파이프와클로드
2-2설정관리
__settings.json설정과우선순위
__기본설정옵션
__프로젝트별설정전략
__환경변수관리
__팀표준설정구축
__민감한파일보호
__도구별설정
__클로드코드의다섯가지확장도구비교
2-3IAM권한관리
__IAM개념
__파일및명령권한설정
__도구별권한체계
__안전한실행환경구축
__권한문제해결
__보안유의사항
__권한설정실무예시
__데이터사용정책
__데이터보존기간
__원격분석과비활성화옵션
2-4모델구성과API최적화
__모델별칭시스템이해하기
__모델설정방법의우선순위
__환경변수를통한모델별칭커스터마이징
__프롬프트캐싱이해와최적화
__모델선택전략

CHAPTER03에이전트스킬
3-1클로드스킬의개념과구조
__컨텍스트윈도우는공용자산이다
__스킬의유형
__SKILL.md파일구조
__세단계점진적작동방식
__스킬컨텍스트비용
__도구접근권한제한
3-2스킬사용과개발
__스킬목록과스킬조합
__커스텀스킬개발
__스킬에서환각방지지침작성
__코드실행통합
__테스트와검증방법
3-3스킬고급사용과최적화
__동적스킬로딩패턴
__스킬성능최적화
__스킬버전관리
__팀스킬개발
__디버깅기법
__재사용가능한스킬패턴
__스킬문서화유의사항
__스킬의격리실행:context:fork메커니즘

CHAPTER04서브에이전트
4-1서브에이전트의개념과아키텍처
__에이전트위임패턴:오케스트레이터-워커
__단일책임원칙과서브에이전트
__컨텍스트엔지니어링원칙
__에이전트체인과병렬실행
__언제서브에이전트를사용하는가
4-2서브에이전트사용하기
__사용가능한서브에이전트목록
__에이전트호출문법
__에이전트결과통합
__작업재개기능활용
__에러처리및복구
__서브에이전트성능측정
4-3커스텀서브에이전트개발과스킬주입
__서브에이전트정의파일구조
__YAML프론트매터완전가이드
__프롬프트작성가이드
__에이전트테스트와최적화
__스킬주입예제
4-4에이전트팀
__에이전트팀의핵심개념
__팀생성과생애주기관리
__컨텍스트와권한
__메시지전달시스템
__태스크조정시스템
__파일소유권전략
__서브에이전트와에이전트팀
4-5CLI기반동적에이전트활용
__--agent플래그:기존에이전트직접실행
__에이전트해석과정
__CLI에이전트와에이전트팀의관계

CHAPTER05출력인터페이스
5-1출력스타일커스터마이징
__출력스타일의핵심개념
__내장출력스타일살펴보기
__출력스타일변경방법
__커스텀출력스타일생성하기
__관련기능과의비교
__팀표준출력스타일구축
__스타일검증과다국어출력
__출력스타일에서환각방지지침
5-2상태표시줄
__상태표시줄설정방법
__상태표시줄스크립트작동원리
__Bash로작성한여러가지상태표시줄스크립트
__파이썬과Node.js로작성한상태표시줄스크립트
__헬퍼함수를활용한모듈화와ANSI코드
__성능최적화전략
__문제해결
5-3대화형모드활용
__고급제어기능
__단축키빠른참조

CHAPTER06메모리와대화세션관리
6-1메모리시스템이해하기
__네가지계층적메모리
__자동메모리
__CLAUDE.md가져오기와조건부로딩
__메모리시스템을자유자재로
__메모리최적화와장기작업관리
__모듈형룰시스템
__사용자수준룰과고급기능
6-2체크포인팅과복구시스템
__/rewind화면과되감기사용법
__체크포인팅의제한사항과대응전략
__체크포인팅과깃
__다중체크포인트와스마트복구
__실험주도개발을위한체크포인팅워크플로
6-3세션관리전략
__컨텍스트윈도우최적화와세션복구
__다중세션관리
__세션데이터보관
__협업에서의세션관리
__장기프로젝트에서의세션전략

CHAPTER07자동화
7-1비대화형모드와스크립트자동화
__주요플래그
__프로그래밍활용
__비대화형모드사용시고려사항
7-2훅시스템
__훅이벤트
__종료코드와결정제어체계
__훅구성파일과우선순위
__매처패턴이해하기
__프롬프트기반훅과에이전트기반훅
__비동기훅
__프론트매터훅과에이전트범위훅
__실용적인훅예제
__훅실행의특성과디버깅
__체크포인팅보완을위한훅활용
__HTTP훅
7-3MCP통합으로외부세계와의연결확장
__MCP전송방식
__주요MCP서버활용사례
__MCP서버설정과구현방법
__훅과MCP의연동전략
__유의사항
7-4플러그인시스템이해하기
__플러그인구조
__컴포넌트유형
__플러그인과프로젝트설정의관계
__플러그인설치범위
__LSP서버지원
__앤트로픽공식마켓플레이스
__플러그인설치,활성화,비활성화,제거
__팀플러그인워크플로와자동설치
__실전플러그인,코드품질도구
__로컬테스트환경설정과개발워크플로
__플러그인캐싱
__플러그인배포와마켓플레이스게시

PART2MoAI-ADK와실전에이전틱코딩

CHAPTER08클로드코드와MoAI-ADK
8-1하네스엔지니어링과MoAI-ADK
__에이전트하네스,MoAI-ADK
__하네스엔지니어링
__MoAI-ADK가해결하는문제
__MoAI-ADK실행엔진
8-2설치와초기설정
__설치방법
__프로젝트초기화와설정
__환경진단
__업데이트
8-3아키텍처
__4계층구조
__MoAI의지침,CLAUDE.md
__Rules시스템
__settings.json:네단계스코프시스템
__.mcp.json:MCP서버구성
__응답스타일시스템
8-4개발방법론,TDD와DDD
__SPEC과EARS형식
__DDD
__이진방법론
8-5TRUST-5품질프레임워크
__다섯가지원칙
__LSP품질게이트
__LoopEngine:자율품질루프
__TRUST-5와LSP매핑
__품질리포트생성
8-6에이전트생태계
__Manager에이전트그룹
__Expert에이전트그룹
__Builder에이전트그룹
__에이전트선택의사결정트리
__에이전트정의파일구조

CHAPTER09MoAI-ADK워크플로
__/moaiproject:프로젝트문서생성
__신규프로젝트시작하기
__기존프로젝트에도입하기
9-1plan-run-sync핵심워크플로
__/moaiplan:명세서생성
__/moairun:TDD/DDD구현
__/moaisync:코드,SPEC,프로젝트문서동기화
__/moai:자율자동화모드
__단계전환조건
9-2서브에이전트심층활용
__Agent도구의기본사용법
__에이전트호출패턴
__병렬실행전략
__에이전트간통신과컨텍스트격리
__에이전트재개
__실전오케스트레이션예시
9-3에이전트팀,팀기반병렬개발
__에이전트팀활성화
__실행모드와팀모드의조합
__디스플레이모드와환경요구사항
__팀생성과구성
__팀커뮤니케이션
__plan단계팀워크플로
__run단계팀워크플로
__서브에이전트와에이전트팀비교
9-4스킬생태계와점진적공개
__스킬분류체계
__YAML프론트매터스키마
__점진적공개와토큰
__트리거시스템:자동로딩의방식
__슬래시명령어연동
__스킬과에이전트연동
9-5빌더에이전트와스킬만들기
__builder-agent:커스텀에이전트생성
__builder-skill:커스텀스킬생성
__도구권한설계원칙
__실전:보안검사에이전트만들기
9-6훅시스템과MCP통합
__MoAI-ADK의훅이벤트체계
__MCP통합
__훅과MCP의시너지
9-7깃작업트리:병렬SPEC개발
__MoAI-ADK의작업트리통합
__작업트리하위명령어
__병렬SPEC개발패턴
__작업트리복구와정리
9-8슬래시명령어와CLI유틸리티
__슬래시명령어
__CLI유틸리티명령어
__moaistatusline:상태표시줄설정

CHAPTER10에이전틱코딩실습:스네이크게임만들기

STEP1초기화:프로젝트초기화와문서생성
__01게임개발준비
__02moaiinit으로프로젝트시작
__03moaiproject로프로젝트문서생성
__04생성한프로젝트문서확인
__05클로드코드의프로젝트컨텍스트인식
__06HTML5Canvas와게임루프패턴
__다음단

출판사 서평

나만의하네스를구축하고에이전트오케스트레이션으로완성하는진짜생산성
__이경록테디노트@유튜브,랭체인앰배서더

클로드코드를단순히‘쓰는’수준에머물것인가,아니면나만의하네스를구축하고에이전트를오케스트레이션하여진짜생산성을끌어낼것인가?이책은바로그차이를만들어주는책입니다.
MoAI를직접설계하고오픈소스로공개한Goos님이쓴만큼,담긴내용의깊이와실용성은타의추종을불허합니다.뜬구름잡는이론이아닌당장실전에써먹을수있는내용만을다뤄온저자의철학이이책에도고스란히녹아있습니다.스킬설계부터서브에이전트오케스트레이션,MCP통합,TDD기반의MoAI-ADK까지,단순한기능소개서가아닌고품질의결과물을반복적으로만들어내기위한방법론이담겨있습니다.에이전틱코딩을제대로시작하고싶은분께강력히추천합니다.

국내최고바이브코더의통찰,AI에이전트해부학
__김태영(주)인공지능팩토리CEO,마이크로소프트RD&AIMVP,랭체인앰배서더

저는커뮤니티세미나에서이책의저자를‘국내최고의바이브코더’라고소개한적이있습니다.기본에충실하면서도자신만의소프트웨어개발철학을갖추고,강의와실무현장에서수많은(비)개발자와호흡하며무엇이실제로유효한지,그리고어떻게써야가장효율적인지를누구보다깊이이해하고계신분이기때문입니다.
이책은단순한클로드코드사용서를넘어,AI에이전트의구조와작동원리를해부학처럼정교하게풀어냅니다.해부학이의학부터재활,스포츠,미술,로봇공학에이르기까지폭넓게활용되듯,이책또한에이전트의뼈대와움직임을이해하게함으로써입문자에게는길잡이가,개발자에게는설계의기준을제시하는소중한지침서가될것입니다.

혼란의시대,진짜에이전틱코딩으로안내하는가이드북
__김영우《Doit!쉽게배우는R데이터분석》저자,데이터분석가,유튜브데이터홀릭운영자

SNS에서조금이상한사람을발견했습니다.AI작동원리와한계를끝까지파헤치겠다며온갖기상천외한방법으로토큰을쏟아부으면서,이것은차라리고문이아닐까싶은지경까지AI를실험하는사람이었습니다.그러더니그과정에서알게된온갖노하우와지식을아낌없이사람들과공유하고,결국에는프롬프트몇문장만입력하면소프트웨어가뚝딱완성되는MoAI-ADK를개발해배포하기시작했습니다.심지어제약없이마음대로쓰라며Copyleft라이선스로말이죠.
그가바로이책의저자,Goos님이었습니다.끊임없이쏟아지는모델과도구로혼란스러웠던시기에Goos님을알고‘이제이분만따라가면되겠구나’하고안도하는마음이들었습니다.그런Goos님의노하우를정리한책이세상에나왔다니,반가울수밖에요.
그동안이러저러한코딩도구를찔러보며정처없이떠돌았다면,이제이책을보며클로드코드와MoAI-ADK의세계에안착하세요.‘이게진짜에이전틱코딩이구나’하며감동하고,새로운아이디어가샘솟고,마치슈퍼히어로가된기분이들겁니다.

입문자와고급사용자누구에게나통하는책
__조대협GoogleCloudPrincipalArchitect

한마디로매우깊이가있는책입니다.양산형입문서와달리,스킬,에이전트등고급기능까지깊이있게다루었고,실전예제를통해서활용방법까지자세하게설명합니다.클로드코드를사용한다면입문자와고급사용자상관없이반드시읽어야하는책입니다.

집요한설계자가제안하는새로운일의문법,분해하고위임하고검증하라
__권승민블루툴스대표,풀스택에이전틱코더

AI로일하는방식을근본부터바꾸고싶다면이책을권합니다.MoAI-ADK를설계하고발전시켜온과정에서다듬어진문제의식과방법론에는집요함만이닿을수있는섬세함이배어있습니다.이책에서는문제를어떻게분해하고,에이전트에어떻게위임하며,결과를어떤기준으로검증할것인가라는사고의구조를다룹니다.
AI를단순한보조도구가아니라파트너로삼고싶다면분명한지침이되어줄책입니다.

결과물의격을바꾸는에이전틱코딩의정석을배우고싶은분들께
__김명호영어강사,바이브코더

문과출신영어강사인제가개발에발을들인건클로드코드와Goos님덕이었습니다.처음에는클로드코드와MoAI의명령어조차구분하지못했으나,이제는개발속도가빨라지고,품질높은결과물을생산할수있게되었습니다.Goos님이강의에서오랫동안강조했던에이전틱코딩은비개발자인제단점을보완하고AI의장점을극대화해주었습니다.좋은모델과많은토큰만으로는한계가있습니다.에이전틱코딩이라는올바른방법론이뒷받침될때비로소결과물수준이달라진다는것을몸소체감했습니다.이책은바로그방법론을체계적으로담고있습니다.
오롯이나누는사람Giver인Goos님의철학이담긴MoAI-ADK와평소나누는정보글덕분에배우고성장할수있었습니다.먼저책을읽어보니강의와글을포함해나누고자하는마음까지도책에잘담겨있었습니다.비개발자이든,개발자이든클로드코드와에이전틱코딩을하며한단계도약하고싶으신모든분께이책을진심으로추천드립니다.

하네스엔지니어링으로여는실전의문
__김해영카카오페이기술전략실리더

에이전틱코딩을실무에어떻게적용해야하는지저마다길을찾고있는이순간,이책은그여정에큰도움을줄수있습니다.제품을빠르고쉽게만드는차원을넘어,일하는방식을설계하고AI가스스로잘일할수있는방법을실무자시각으로풀어냅니다.또한에이전틱코딩을어떻게적용해야할지막막했던분들에게는해결의단초를제공하며,하네스엔지니어링패러다임에서실무수준의방향을제시합니다.
제목에들어간‘실전’은결코과장이아닙니다.동시에이책의깊이가깊다고해서클로드코드를처음접하는사람에게어려운수준의책은아닙니다.기초부터차근차근안내하기때문에누구나에이전틱코딩의세계에자연스럽게입문할수있고,그위에서실전수준의깊이까지도달할수있습니다.

에이전틱코딩이제시하는새로운협업의표준
__박종우디지털드로잉작가,바이브코더

《클로드코드로시작하는실전에이전틱코딩》은인공지능과개발자가협업하는미래의방식을가장앞서제시하는가이드북입니다.IT분야에서다양한경험을쌓은저자가오랜시간다양한AI와클로드코드를직접다루며쌓아온실전노하우와온오프라인커뮤니티를통해수많은유저와소통하며정제한지식이고스란히담겨있습니다.
책은단순히명령어사용법을나열하는데그치지않고,개발환경구축부터복잡한리팩터링,자동화테스트까지이어지는일련의과정을저자의깊이있는통찰력으로풀어내어초보자부터숙련된개발자까지모두가새로운영감을얻을수있습니다.
AI시대를준비하는모든창작자와개발자에게이책은든든한나침반이되어줄것입니다.에이전틱코딩의정수를경험하고싶다면주저없이펼쳐보시길권합니다.