에이전트 코딩 with 클로드 코드

클로드 코드 기본부터 에이전틱 코딩까지
만들면서 배우는 AI 네이티브 개발의 모든 것!
클로드 코드를 처음 경험하는 초보자부터 실무에서 한 단계 더 실력을 높이고 싶은 개발자까지 모두를 위한 과정을 담았습니다. 클로드 코드의 기본적인 개념은 물론, 프로젝트를 위한 설치, 상태 관리, 모델 설정, 컨텍스트 수집 등을 단계별로 차근차근 학습할 수 있습니다. 또한 이러한 개념들을 관통하는 '코인 트레이딩 시뮬레이터'를 처음부터 끝까지 구현해봅니다. 완성된 앱은 실시간 시세와 지표를 보여주고, 거래 버튼과 자동 규칙 등록 기능, 대시보드 통계를 제공합니다. 실제 프로젝트에서 바로 적용할 수 있는 MCP 활용, 스킬 개발, 서브에이전트 구성, 의사결정 문서 작성 등 AI 네이티브 개발 프로세스가 체계적으로 담겨 있어 개발 생산성을 극대화하고 AI 와 협업하는 개발 방식을 습득할 수 있습니다.

★이 책의 구성★
00장. 무엇을 왜 만드는가: 코드를 한 줄도 쓰기 전에 방향을 잡습니다. 좋은 학습 프로젝트의 조건을 따져보고, 워밍업으로 클로드 코드와 대화하며 기능을 뽑은 뒤, ASCII 아트 화면을 먼저 그려 봅니다.
01장. 클로드 코드 시작하기: 설치와 로그인 및 첫 프로젝트를 생성합니다. 기존 코드 도구와 무엇이 다른지, 컨텍스트를 모으고 행동하고 결과를 확인하는 루프가 어떻게 도는지 직접 경험할 수 있습니다.
02장. 데이터 모델과 상태 관리: 거래 시스템의 뼈대인 데이터 구조를 설계합니다. 동시에 프로젝트 규칙을 클로드 코드에게 기억시키는 법을 익힙니다. 이 장 이후에는 같은 설명을 매번 반복할 필요가 없어집니다.
03장. 시세 데이터와 차트 구현하기: 업비트 공개 REST API를 붙이고, 실시간 캔들 차트를 그립니다. 이동평균선과 RSI, MACD를 얹으면 화면이 처음으로 앱처럼 보이기 시작합니다.
04장. 스킬과 거래 로직 알아보기: 반복 작업을 스킬로 묶고, 그 자리에서 거래 로직에 적용합니다. 잔고 확인과 수수료 계산 같은 검증 규칙을 세우고 수동 매수/매도 화면을 완성합니다.
05장. MCP로 외부 도구 연결하기: Model Context Protocol로 클로드 코드에 외부 도구를 붙입니다. 공식 커뮤니티 서버를 설치해 쓰고, 마지막에는 직접 MCP 서버를 만들어 연결합니다.
06장. 서브에이전트 사용하기: 내장 에이전트 활용부터 커뮤니티 에이전트 설치, 나만의 에이전트 제작 등 여러 개를 동시에 돌리고 지켜보는 방법까지 다룹니다.
07장. 자연어 거래 규칙: 앱 안에서 사용자가 한국어로 쓴 거래 규칙을 해석해 실행 가능한 조건으로 바꿉니다. 개발 도구인 클로드 코드와, 서비스 안에서 도는 LLM API의 역할 차이도 알아봅니다.
08장. UI 통합 프로젝트: 훅으로 포맷팅과 파일 보호를 자동화한 뒤, 지금까지 만든 조각들을 대시보드 하나로 합칩니다. 거래 내역과 보유 현황, 통계 패널이 붙으면서 앱이 완성됩니다.
09장. 테스트와 디버깅 다루기: 일부러 버그를 심어 놓고 클로드 코드와 함께 잡습니다. 테스트 실행과 코드 리뷰를 스킬로 만들어, 만드는 세션과 검증하는 세션을 나누는 습관을 들입니다.
10장. 프로젝트 너머 바라보기: 프로젝트를 벗어나 실무로 나갑니다. 헤드리스 모드로 반복 작업을 스크립트화하고, 에이전트팀으로 병렬 협업을 굴려 본 뒤, 다음 프로젝트를 시작할 때 쓸 체크 리스트를 정리합니다.
11장. 프로토타입에서 서비스로: 클로드 코드를 설계 파트너 삼아 아키텍처와 인증, 배포와 요구사항을 놓고 마지막 워크숍을 진행합니다.
끝으로 부록에는 CLI 명령어와 설정 파일 레퍼런스, 그리고 자주 만나는 오류의 해결법을 담아 실습이 막힐 때면 언제든 펼쳐 볼 수 있도록 구성하였습니다. 부록은 온라인에서 제공합니다.


★이 책의 대상 독자★
__프로그래밍의 기본은 알고 있지만 제대로 된 AI 도구 활용은 아직인 대학생
__클로드 코드는 설치했지만 무엇부터 시켜야 할지 감이 안 잡히는 기획자
__코드를 짜는 시간보다 무엇을 만들지 정하는 시간이 길어진 개발자
__팀에 도입할 개발 기준을 찾는 리더

00장 무엇을 왜 만드는가
__0.1 프로젝트 주제 선정
__0.2 기능 브레인스토밍
__0.3 ASCII 아트 프로토타이핑
__0.4 기술 스택 결정
__0.5 코드를 짜지 않는 자리의 클로드 코드

01장 클로드 코드 시작하기
__1.1 클로드 코드란 무엇인가
__1.2 설치와 첫 실행
__1.3 [빌드] 프로젝트 스캐폴딩
__1.4 에이전틱 루프 이해하기
__1.5 손에 익히는 운영 도구함

02장 데이터 모델과 상태 관리
__2.1 프롬프트 잘 쓰는 법
__2.2 [빌드] 코인/거래 데이터 모델 설계
__2.3 [빌드] 상태 관리 구현
__2.4 CLAUDE.md로 프로젝트 메모리 설정
__2.5 .claude/rules/ 모듈식 규칙 관리
__2.6 컨텍스트를 다스리는 네 가지 장치

03장 시세 데이터와 차트 구현하기
__3.1 시세 API 구조 이해
__3.2 [빌드] 시세 API 서비스 구현
__3.3 [빌드] 실시간 차트 구현
__3.4 [빌드] 기술적 지표 추가
__3.5 비용·진단·시각 입력: API 작업의 운영 패널

04장 스킬과 거래 로직 알아보기
__4.1 스킬 탐색과 설치
__4.2 커밋 스킬 만들기
__4.3 거래 검증 로직
__4.4 거래 실행 엔진
__4.5 수동 거래 UI 만들기
__4.6 스킬 생태계: 단계적 공개부터 마켓플레이스까지

05장 MCP로 외부 도구 연결하기
__5.1 MCP 서버란 무엇인가
__5.2 MCP 서버 찾고 설치하기
__5.3 인기 MCP 서버 활용하기
__5.4 MCP 서버 관리하기
__5.5 나만의 MCP 서버 만들기
__5.6 코인 시뮬레이터에 안 쓴 MCP 카탈로그와 운영 가드레일

06장 서브에이전트 사용하기
__6.1 서브에이전트란 무엇인가
__6.2 [실습] 내장 서브에이전트 활용하기
__6.3 [실습] 커뮤니티 서브에이전트 설치하기
__6.4 [실습] 나만의 서브에이전트 만들기
__6.5 [실습] 서브에이전트 병렬 실행과 모니터링
__6.6 스킬과 서브에이전트 함께 사용하기
__6.7 서브에이전트 실전 패턴: 매퍼·게이트·워크트리

07장 자연어 거래 규칙
__7.1 [빌드] Next.js에서 OpenAI API 연동
__7.2 [빌드] 자연어 규칙 파서
__7.3 [빌드] 규칙 평가와 관리
__7.4 헤드리스 모드: 자연어 규칙 파서를 CI에서 돌리기

08장 UI 통합 프로젝트
__8.1 [실습] 훅으로 개발 자동화하기
__8.2 [빌드] 대시보드 레이아웃
__8.3 [빌드] 거래 내역과 보유 현황
__8.4 [빌드] 통계 패널
__8.5 훅 7종 카탈로그와 가드레일

09장 테스트와 디버깅 다루기
__9.1 Claude와 디버깅
__9.2 단위 테스트 작성
__9.3 코드 리뷰 스킬과 Git 워크플로우
__9.4 진단·관측·복구 도구함

10장 프로젝트 너머 바라보기
__10.1 CLI로 반복 작업 자동화
__10.2 에이전트 팀으로 병렬 협업하기
__10.3 다음 프로젝트 시작하기
__10.4 프로젝트 회고
__10.5 자동화의 마지막 조각: GitHub Actions와 플러그인

11장 프로토타입에서 서비스로
__11.1 아키텍처 의사결정
__11.2 인증과 보안 설계
__11.3 배포 전략 수립
__11.4 요구사항 정제
__11.5 클로드 코드 자체의 운영 안전성: 샌드박싱·인젝션·거버넌스

김성박 1997년 국내 최초의 인터넷 부동산 서비스 개발을 시작으로, 25년 넘게 코드를 짜고 또 가르쳤다. 멀티캠퍼스 전임 강사로 1만 시간이 넘는 강의를 진행했고 삼성전자, SK플래닛, 신한은행, 현대자동차, 이베이코리아 등에서 자바와 스프링, UML 분석·설계, 엔터프라이즈 아키텍처를 가르쳤다.
T3Q 기술이사, ㈜써니베일 대표이사, NHN Dooray 메신저 개발 팀장, eBay Korea Sr. MTS를 거쳐 ㈜펴나니 개발본부장을 지냈으며, 현재 문피아 CTO로 일한다. 2025년에는 현대자동차에서 AI를 활용한 요구사항 정의 과정을 진행하며, 개발자의 일이 타이핑에서 판단으로 옮겨 가는 변화를 현장에서 지켜봤다. 지은 책으로는 《AI 프로토타이핑 실전》, 《프로그래머로 산다는 것》, 《자바 IO/NIO 프로그래밍》, 《쉽게 배우는 웹 로직과 EJB》 등이 있다.