클로드 코드로 완성하는 에이전틱 코딩 자동화

오사와 후미타카

기술 라이터이자 프로그래머로 정보보안 스페셜리스트와 네트워크 스페셜리스트 자격을 보유하고 있다. 웹 시스템의 설계·개발 업무에 종사하는 한편, 오랜 기간 웹 시스템, 프로그래밍, 데이터베이스, 퍼블릭 클라우드 등 다양한 분야의 기술서를 집필해 왔다. 주요 저서로는 『제대로 활용하는 힘을 기르는 웹과 프로그래밍의 기초 중의 기초 [개정 2판]』(마이나비출판), 『엔지니어를 위한 ChatGPT 활용 입문』(임프레스) 등이 있다.

최용

한국방송통신대학교에서 컴퓨터과학을 전공하고, 응용 소프트웨어 개발자와 은행 전산실 운영자를 거쳐 소프트웨어 컨설턴트로서 엔터프라이즈 IT 시스템 운영 자동화 솔루션 구축 및 기술 지원 업무를 수행했다. 현재는 IT 전문서의 저술·번역·교정 작업을 이어오고 있으며, 인공지능을 일상 업무와 지식 생산에 도입해 얻은 실무적 효율을 다양한 기술 영역으로 확장하는 데 깊은 관심을 두고 있다. 대표적인 저서로 2025년 세종도서 학술부문에 선정된 《OpenAI, 구글 Gemini, 업스테이지 Solar API를 활용한 실전 LLM 앱 개발》(위키북스)이 있으며, 이를 포함해 인공지능, 파이썬, 보안 등 IT 전반에 걸쳐 다수의 전문서를 집필하고 번역했다. 소프트웨어를 넘어 하드웨어와 결합된 지능형 시스템으로 시야를 넓히고자 서울사이버대학교에서 드론·로봇을 전공하고, 동 대학원 AI융합기술학과 석사 과정에 입학하여 학업을 지속하고 있다.

• ▣ 01장: Claude Code의 매력
• 1.1 _ 채팅형 AI에서 에이전트형 AI로
• __자기 PC에서 구동하는 에이전트형 AI
• __많은 파일을 다룰 수 있다
• __커맨드라인에서 실행한다
• 1.2 _ 개발과 설계에 활용하는 Claude Code
• 1.3 _ Claude Code 요금제
• __계약 종류
• __정액제 플랜의 종류
• 1.4 _ 이 책의 구성과 학습법
• __이 책에서 만드는 것
• __이 책이 지향하는 것
•  
• ▣ 02장: Claude Code를 체험해 보자
• 2.1 _ Claude Code 실행 환경을 만들려면
• __자기 PC에 직접 설치하기
• __컨테이너 기술로 격리하기
• __Visual Studio Code에서 DevContainer 사용하기
• 2.2 _ Visual Studio Code에서 쓸 수
• __Claude Code 환경 만들기
• __사전 준비
• __DevContainer에서 Claude Code를 쓸 수 있게 하기
• __Claude Code 설치하기
• 2.3 _ Claude Code 기동과 초기 설정
• __Claude Code 기동
• 2.4 _ 간단한 프로그램을 만들게 해 보자
• __낙하형 퍼즐 게임 만들기
• __조작 허가하기
• __완성된 프로그램 확인하기
• __개선하기
• 2.5 _ Claude Code 종료하기
• 2.6 _ 정리와 과제
•  
• ▣ 03장: Claude Code 기본 조작 (1)
• 3.1 _ 이전 작업에 이어서 시작하기
• __Claude Code를 다시 한번 기동하기
• __기록이 깨끗한 상태에서 시작하기
• __이전 작업에 이어서 재개하기
• 3.2 _ Claude Code의 ‘기억’ 이해하기
• __정보를 기록하는 컨텍스트
• __컨텍스트의 상한
• __컨텍스트 압축
• __컨텍스트 지우기
• 3.3 _ 기대대로 동작하게 하는 방법
• __지시하는 방법을 궁리한다
• __긴 프롬프트를 입력할 때의 요령
• __작업 모드를 구분해 쓴다
• __작업에 맞는 모델을 고른다
• __복잡한 문제에서는 깊이 생각하게 한다
• __잘 안 되면 되돌아가서 다시 한다
• 3.4 _ 편리한 키 조작
• 3.5 _ 정리
•  
• ▣ 04장: Claude Code 기본 조작 (2)
• 4.1 _ 프로젝트 규칙 정의하기
• __CLAUDE.md
• __/init으로 자동 생성하기
• __CLAUDE.md를 작성할 때의 요령
• __CLAUDE.md의 저장 위치
• 4.2 _ 도구와 조작의 허가
• __에이전틱 루프
• __주요 도구
• __도구와 허가
• __허가 확인 선택지와 ‘Yes, and don’t ask again’
• __/permissions로 허가 설정 관리하기
• 4.3 _ 안전하게 작업하기 위한 방법
• __체크포인트를 사용해 되돌리기
• __코드를 변경하기 전에 백업한다
• __Git으로 변경을 관리하기
• 4.4 _ Claude Code 업데이트
• 4.5 _ 정리
•  
• ▣ 05장: 실무 애플리케이션 개발의 실제
• 5.1 _ 사양을 정해 업무 애플리케이션 만들기
• __사양을 정해 원하는 결과가 나오기 쉽게 하기
• __화면 레이아웃과 동작을 정하기
• __기술 스택 정하기
• __단계적으로 만들기
• 5.2 _ 새 프로젝트 준비
• 5.3 _ CLAUDE.md에 기본 설계 작성하기
• __CLAUDE.md의 예
• __Claude Code와 상의하며 CLAUDE.md를 다듬기
• __기본 사용자 인터페이스 만들기
• __입력 화면 만들기
• __브라우저에서 확인하기
• 5.4 _ PDF 생성 기능 구현하기
• __PDF 생성 기능 만들기
• __동작을 확인하기
• 5.5 _ 기능 추가·개선하기
• __용지 프리셋 추가
• __인터넷으로 검색해 더 많은 용지 정보를 자동으로 모으기
• __개선 힌트
• 5.6 _ 정리
•  
• ▣ 06장: 데이터베이스와 관리자 페이지를 포함하는 복잡한 애플리케이션 개발
• 6.1 _ ‘문의 폼’으로 배우는 복잡한 애플리케이션 만드는 법
• __문의 폼 구축에 필요한 요소
• __Laravel 프레임워크를 사용한 개발
• __이 장의 시스템 구성
• 6.2 _ 새 프로젝트 준비
• __DevContainer 설정 구성하기
• __PHP와 Laravel 프레임워크 설치하기
• __Laravel 프로젝트 만들기
• __Laravel의 초기 페이지 확인하기
• 6.3 _ CLAUDE.md에 기본 설계 작성하기
• 6.4 _ 계획을 세워 코드 만들기
• __Plan 모드로 설계한 뒤에 만들기
• __계획을 세운다
• __계획의 실행
• __동작 확인
• 6.5 _ 만들어진 코드의 확인과 조정
• __코드의 육안 확인
• __처리 내용 확인하기
• 6.6 _ 코드로부터 명세서 만들기
• 6.7 _ 코드를 개선하기
• __인증 기능 붙이기
• __관리자 페이지에 필터링 기능 붙이기
• __기능을 더 추가해 나가기
• 6.8 _ 마무리
•  
• ▣ 07장: Claude Code로 테스트 작성하기
• 7.1 _ 테스트 데이터를 대량으로 생성하기
• __Claude Code에 테스트 데이터를 생성시키기
• __테스트 데이터로 동작 확인하기
• 7.2 _ 테스트 케이스 만들기
• __테스트 케이스를 만들게 하기
• __테스트 케이스에 근거해 테스트하기
• 7.3 _ 테스트 자동화하기
• __테스트를 자동화하는 의의
• __테스트를 자동화하는 방법
• __Laravel의 테스트 기능
• __기능 테스트를 Claude Code에 작성 의뢰하기
• __테스트를 실행하기
• 7.4 _ 테스트 주도 개발(TDD)
• __TDD의 사이클
• __TDD를 도입하는 메리트
• __Claude Code와 TDD의 궁합
• __TDD의 예
• 7.5 _ 코드 생성 후 테스트 실행을 필수로 만들기
• __CLAUDE.md에 테스트 실행 지시 작성하기
• __훅으로 테스트를 자동 실행하기
• 7.6 _ 정리
•  
• ▣ 08장: Claude Code에 눈과 손발을 달아 주는 ‘MCP 서버’
• 8.1 _ Claude Code에 기능을 추가하는 ‘MCP 서버’
• __로컬형과 리모트형
• __MCP 서버의 구조
• __MCP 서버를 쓰는 경우와 쓰지 않는 경우의 차이
• 8.2 _ MCP 서버를 설치한다
• __MCP 서버를 구하는 곳
• __MCP 서버의 설치와 실행
• 8.3 _ Playwright MCP를 설치한다
• __Playwright MCP란
• __Playwright MCP로 근거 자료를 남기는 브라우저 테스트를 실시한다
• __블랙박스 테스트와 화이트박스 테스트
• __Playwright MCP 설치
• __MCP 서버의 접속을 확인한다
• 8.4 _ Playwright MCP로 브라우저를 조작한다
• __간단한 조작을 시험한다
• __한국어 폰트를 설치한다
• __문의 폼을 브라우저로 조작한다
• 8.5 _ 브라우저 테스트로 보고서를 만든다
• __테스트 케이스를 준비한다
• __테스트 실행과 보고서 생성
• 8.6 _ 정리
•  
• ▣ 09장: 스킬과 커스텀 서브에이전트로 업무 효율화하기
• 9.1 _ 스킬과 커스텀 서브에이전트
• __입력을 간소화하고 시간을 줄이는 구조
• __스킬이나 커스텀 서브에이전트를 팀에서 공유하기
• 9.2 _ 스킬 만들기
• __스킬로 등록하기
• __서포트 파일의 저장 위치
• __스킬에 인수 전달하기
• __스킬 확인하기
• 9.3 _ 실용적인 스킬 예시
• __릴리스 준비 스킬
• __코드 품질 체크 스킬
• __문서 생성 스킬
• 9.4 _ 스킬 작성 요령
• 9.5 _ 커스텀 서브에이전트
• __서브에이전트
• __내장 서브에이전트
• __커스텀 서브에이전트
• __코드 리뷰용 커스텀 서브에이전트 만들기
• __커스텀 서브에이전트 확인하기
• __커스텀 서브에이전트 실행하기
• __포그라운드와 백그라운드
• __서브에이전트의 제약
• __커스텀 서브에이전트의 활용처
• 9.6 _ 에이전트 팀으로 병렬 작업하기
• __에이전트 팀의 구조
• __에이전트 팀을 활성화하기
• __에이전트 팀의 주의점
• 9.7 _ 정리
•  
• ▣ 10장: 잠자는 동안 코드가 완성! 궁극의 자동 코딩 환경을 목표로
• 10.1 _ AI 일임 개발을 가로막는 ‘권한 확인’
• __settings.json으로 권한을 사전 허가한다
• __바이패스 모드로 전부 허가한다
• __도구 사용을 AI가 판정하는 auto 모드
• __맡긴다면 ‘auto 모드’나 ‘바이패스 모드’
• 10.2 _ AI 일임 개발의 흐름
• 10.3 _ AI 일임 개발을 체험해 보자
• __ToDo 관리 애플리케이션을 만든다
• __개발 환경 준비
• __명세서 작성
• __테스트 케이스 작성
• __완전한 AI 일임 개발을 실행한다
• 10.4 _ 코드 리뷰로 보안과 품질을 담보한다
• __취약점을 체크한다
• __보안 리뷰용 커스텀 서브에이전트
• 10.5 _ 사람 눈에 의한 최종 확인
• 10.6 _ 정리
•  
• ▣ 부록
• A _ Docker Desktop 설치
• __Docker Desktop 다운로드
• __Windows에 설치하기
• __macOS에 설치하기
• __Docker Desktop 종료와 재기동
• B _ Visual Studio Code 설치
• __Visual Studio Code 다운로드
• __Windows에 설치하기
• __macOS에 설치하기
• __한국어화하기
• __Dev Containers 설치하기
• C _ Claude Code 명령 레퍼런스
• __슬래시 명령 목록
• __CLI 기동 옵션 목록
• __키보드 단축키 목록

• GitHub 저장소: https://github.com/wikibook/agentic-coding
• ZIP 형식으로 다운로드: https://github.com/wikibook/agentic-coding/archive/refs/heads/main.zip