도서 소개
- Claude Code의 AI 모델을 하나의 팀처럼 움직이게 하는 하네스를 직접 만들어 보는 실습서입니다.
- 역할을 나누면 토큰 사용을 줄이면서도 더 빠르고 안정적인 결과를 얻을 수 있습니다.
- Windows 작업 환경 준비부터 시작해 멀티에이전트 하네스 구조까지 단계별로 다룹니다.
- 책에 수록된 스크립트는 실제로 작동하는 예제입니다.
- tmux 위에서 실제로 동작하는 하네스 구조와 로그, 복구, 회귀 점검까지 포함한 운영 환경을 구성합니다.
이런 분께 추천합니다
토큰 비용을 줄이고 싶은 사람
Claude Code를 시스템으로 확장하고 싶은 사람
나만의 자동화 작업 환경을 만들고 싶은 사람
운영 가능한 하네스를 직접 구축하고 싶은 사람
목차
시작하며 · 1부. 왜 필요한가, 무엇을 준비할까
- 1장. 왜 지금 에이전트 크로징인가
- 2장. 작업량 만들기
- 3장. Claude Code
2부. Claude Code 기초 다지기
- 4장. 첫 세션의 이해
- 5장. 슬래시 커맨드와 CLAUDE.md
- 6장. 권한 시스템과 안전 경계
3부. Claude Code 능력 확장하기
- 7장. MCP · IDE · Hooks
- 8장. 서브에이전트, 스킬, 플러그인
4부. 하네스라는 사고방식
- 9장. 하네스 엔지니어란?
- 10장. 하네스가 잘 굴러가게 만드는 법
- 11장. 실전 사례
5부. 멀티 에이전트 하네스 직접 구축하기
- 12장. 단독 세션의 토큰을 태우는 이유
- 13장. 멀티 에이전트 실행 환경 준비
- 14장. 디스패치 만들기
- 15장. 자동 라우팅 대문 구현
- 16장. 자동 라우팅 운영 점검
- 17장. 작업 위임 구조
- 18장. 반복 작업 템플릿 구현
- 19장. 프로젝트 경계 설정
6부. 운영·검증·완성
- 20장. 로그와 상태 파일
- 21장. 하네스 장애 대응과 복구
- 22장. 하네스 안정성을 위한 회귀 테스트
- 23장. 설치와 실행 절차 표준화
- 24장. 하네스 최종 점검 및 파일 구조 검증
미리보기
독서평 36개
김O수
“토큰 절감 부분만으로도 값어치를 했습니다.”
이지O
“Claude Code를 그냥 쓰기만 했었는데, 이 책 보고 나서야 Agent와 Harness 개념이 분리된다는 걸 이해했어요. 12장부터는 속도가 좀 빨라서 두 번 읽었습니다.”
박OO
“입문자한테는 좀 어렵지만 따라가다 보면 됩니다.”
최O진
“14장 디스패치 만들기 파트가 제일 실용적이었어요. 실제로 제 프로젝트에 그대로 적용했습니다.”
정O아
“실습은 좋은데 tmux 환경 세팅에 시간이 좀 걸렸어요. 그래도 완주하면 남는 게 있는 책입니다.”
강OO
“역할 나누는 구조, 이해가 확 됐습니다.”
조O훈
“이미 Claude Code로 업무 자동화를 하고 있었는데, 21장 장애 대응과 복구 파트에서 놓치고 있던 부분을 많이 채웠습니다.”
윤서O
“회귀 테스트를 다루는 장이 따로 있는 게 신기했어요. 이런 것까지 다루는 실습서는 처음입니다.”
장OO
“1부까지는 쉬운데 5부 넘어가면서 확실히 난이도가 올라갑니다. 그래도 순서대로 하면 못 따라갈 정도는 아니에요.”
임O영
“실전서라는 말이 과장이 아니었습니다.”
한O민
“9장 "하네스 엔지니어란?"에서 제가 하려던 일의 이름을 처음 알게 됐습니다.”
오지O
“스크립트가 실제로 동작하는 건 좋은데, 제 환경에서는 몇 군데 손을 봐야 했어요.”
서OO
“토큰 비용 얘기가 남 얘기 같지 않더군요.”
신O호
“혼자 세션 하나로 다 처리하다 토큰만 태우고 있었는데, 13장 멀티 에이전트 실행 환경 준비부터 완전히 다시 짰습니다.”
권O희
“목차만 보고 사서 후회 안 했습니다.”
황OO
“Claude Code 처음 써보는 사람인데도 4장 "첫 세션의 이해"부터 천천히 따라갈 수 있었어요.”
안지O
“내용은 알찬데 분량이 꽤 됩니다. 시간 넉넉히 잡고 보시길 추천합니다.”
송O윤
“17장 "작업 위임 구조" 보고 나서 제 하네스 설계를 다시 했습니다.”
전OO
“실습서치고 이론 설명도 탄탄합니다.”
홍O기
“운영 중인 자동화 파이프라인에 로그·상태 파일 관리 부분을 그대로 참고했습니다.”
유O진
“6부 "운영·검증·완성" 파트가 개인적으로 제일 좋았는데, 앞부분이 익숙하지 않으면 좀 버거울 수 있어요.”
고OO
“설치·실행 절차 표준화를 다루는 장, 팀에 그대로 공유했습니다.”
문서O
“AI를 사용만 하다가 처음으로 "맡긴다"는 게 뭔지 감이 왔습니다.”
양O석
“자동 라우팅을 다루는 15~16장 파트가 실무에 바로 쓸 만큼 자세합니다.”
손OO
“권한 시스템이랑 안전 경계 얘기가 왜 이렇게 늦게 나오나 했는데, 순서상 이해가 됩니다.”
배지O
“지루할 틈이 없었습니다.”
허O현
“예제 스크립트가 실제로 돌아가는 건 좋았지만 제 환경에선 살짝 다른 부분이 있었어요.”
남OO
“8장 "서브에이전트, 스킬, 플러그인" 파트에서 확장하는 법을 배웠습니다.”
심O우
“혼자 공부할 때보다 훨씬 체계적입니다.”
노지O
“처음엔 용어가 낯설었는데 뒤로 갈수록 왜 이런 순서로 설명하는지 이해됐어요.”
곽O경
“이미 자동화 도구를 쓰고 있었지만, 하네스라는 사고방식 자체를 이 책에서 배웠습니다.”
하OO
“실전 예제가 진짜 실전이었습니다.”
진서O
“3장 "Claude Code"부터 차근차근 설명해서 도구 자체가 처음인 사람도 괜찮을 듯합니다.”
백O민
“다 좋은데 분량이 많아서 한 번에 다 못 봤습니다. 나눠서 여러 번 봐야 할 책이에요.”
류OO
“왜 역할을 나눠야 하는지 이제 알겠습니다.”
표지O
“24장까지 다 따라가면 실제로 하나의 작업 엔진이 만들어진다는 게 인상적이었습니다.”
※ 표시된 후기는 서비스 준비 중 예시입니다.
상세 안내
상세 안내 더 보기
AI 한 명에게 모든 일을 맡기지 마세요.
역할을 나누고, 검수하고, 협업하는
나만의 AI팀을 직접 만들어 봅니다.
FULL SOURCE HANDS-ON MULTI AGENT
도서 소개
이 책은 Claude Code의 AI 모델을 하나의 팀처럼 움직이게 하는 작업 환경, 즉 하네스를 직접 만들어 보는 실습서입니다.
성능이 뛰어난 Opus에게는 기획과 판단을 맡기고, 빠르고 가벼운 Sonnet과 Haiku에게는 조사, 검토, 정리 같은 일을 나누어 맡깁니다. 모든 일을 한 모델에 몰아주는 대신 역할을 나누면 토큰 사용을 줄이면서도, 여러 사람이 각자 맡은 일을 처리하듯 더 빠르고 안정적인 결과를 얻을 수 있습니다.
책은 CLI, 터미널, Node.js가 낯선 사람도 따라올 수 있도록 Windows 작업 환경을 준비하는 단계부터 시작합니다. 이후 Claude Code의 기본 사용법, 권한 설정, 안전 경계, 그리고 여러 에이전트가 서로 작업을 주고받는 멀티에이전트 하네스 구조를 차근차근 만들어 갑니다.
책에 수록된 스크립트는 실제로 작동하는 예제입니다.
어려운 이론을 먼저 늘어놓기보다, 왜 이런 구조가 필요한지 이해하는 데서 출발합니다. 그리고 직접 따라 할 수 있는 실습 예제와 함께, 하네스를 만들면서 헷갈리기 쉬운 원리와 동작 방식을 풀어 설명했습니다.
이 책은 토큰 비용이 부담되는 사람, Claude Code를 단순 채팅 도구가 아니라 여러 에이전트가 협업하는 시스템으로 확장하고 싶은 사람, 나만의 자동화 작업 환경을 만들고 더 높은 품질의 결과물을 얻고 싶은 사람에게 적합합니다.
이 책을 따라가면 모델을 역할별로 나누어 쓰는 멀티에이전트 설계 방식을 익힐 수 있습니다. 또한 tmux 위에서 실제로 작동하는 하네스 구조를 만들고, 로그, 복구, 회귀 점검까지 포함한 운영 가능한 자동화 환경을 직접 구성해 볼 수 있습니다.
문제
AI 한 명에게모든 일을 맡기고 있습니까?
1 대화가 길어지고 맥락이 흐려집니다
2 컨텍스트가 커질수록 토큰 사용이 증가합니다
3 중요한 규칙이 대화 속에 묻힐 수 있습니다
4 역할이 섞여 결과의 일관성이 떨어집니다
5 검수 없이 결과를 바로 적용하게 됩니다
6 한 세션에 모든 작업이 집중됩니다
해결
AI도 회사처럼역할을 나누면 달라집니다
사용자
AI 팀장 (Orchestrator)
조사 AI
작성 AI
검수 AI
핵심은 AI의 숫자를 늘리는 것이 아니라
일을 나누고, 역할을 나누고, 결과를 검증하는 구조를 만드는 것입니다.
Agent = Model + Harness
이 책의 핵심 개념
🧠
Model
AI의 두뇌
+ ⚙️
Harness
AI가 일할 수 있는 작업 환경
= 🤖
Agent
두뇌 + 작업 환경
모델만으로는 에이전트가 되지 않습니다.
모델이 실제로 일할 수 있는 환경 — 하네스 — 를 갖출 때
비로소 에이전트가 됩니다.
하네스의 세 가지 성숙 단계
시간 순서가 아니라 성숙도를 의미합니다
1세대
문서형
- CLAUDE.md
- 역할 문서
- 규칙 문서
- 스킬 문서
만들기 쉽고 사람이 읽기 쉽지만, 실행은 하지 못합니다
2세대
엔진형
- Bash / Python
- tmux 제어
- 파일 IPC
- Routing / Dispatch
반복 작업을 실행하고 역할을 자동으로 분리합니다
3세대
하이브리드
- 문서 규칙 + 실행 엔진
- 자동 검증
- 로그 + 상태 관리
- 사람 승인 프로세스
이 책에서 최종적으로 구축하는 방향입니다
이 책에서 배우는 것
Claude Code 기본기
- Claude Code 이해
- 작업 환경 구성
- 세션 이해
- CLAUDE.md
- Slash Command
안전한 AI 작업 환경
- 권한 시스템
- 접근 제한
- 위험 작업 차단
- 사람 승인
AI 확장 기능
- MCP
- IDE 연동
- Hooks
- Sub Agent
- Skill & Plugin
Harness Engineering
- 하네스란 무엇인가
- AI 작업 환경 설계
- 상태 관리
- 반복 실행 / 제약 / 피드백
Multi-Agent
- 역할 분리
- Orchestrator / Worker / Reviewer
- Agent 간 작업 전달
실제 엔진 구축
- tmux 환경
- Dispatcher
- Routing
- 파일 IPC
- Workflow / Daemon
운영과 안정성
- 로그 / 상태 파일
- 장애 대응 / 복구
- 회귀 테스트
- 설치 표준화
책을 따라가면실제로 하나의 작업 엔진을 만들게 됩니다
사용자 요청
Orchestrator
작업 분류
전문 Agent 배정
실제 작업
Reviewer 검수
PASS / FAIL → 필요하면 재작업
최종 결과
이 책을 따라가면 모델을 역할별로 나누어 쓰는 멀티에이전트 설계 방식을 익힐 수 있습니다.
tmux 위에서 실제로 작동하는 하네스 구조를 만들고, 로그, 복구, 회귀 점검까지 포함한 운영 가능한 자동화 환경을 직접 구성해 볼 수 있습니다.
24개 장 전체 커리큘럼
1부 왜 필요한가, 무엇을 준비할까 ▶
1. 왜 지금 에이전틱 코딩인가: 하네스란 무엇인가
2. 작업장 만들기: Windows에서 WSL, Ubuntu 설치하기
3. Claude Code 시작하기: 설치, 인증, 요금제 선택
2부 Claude Code 기초 다지기 ▶
1. 첫 세션 이해하기: 핵심 시스템과 토큰 경제
2. 슬래시 커맨드와 CLAUDE.md: Claude에게 우리 규칙 가르치기
3. 권한 시스템과 안전 경계: 사고를 막는 선 긋기
3부 Claude Code 능력 확장하기 ▶
1. 바깥 세상과 연결하기: MCP, IDE, Hooks
2. 분신 만들기: 서브에이전트, 스킬, 플러그인 활용
4부 하네스라는 사고방식 ▶
1. 하네스 엔지니어링이란: AI가 일할 환경을 설계하는 법
2. 측정, 맥락, 패턴: 하네스가 잘 굴러가게 만드는 법
3. 실전 사례 4선: 하네스는 현장에서 어떻게 쓰이는가
5부 멀티에이전트 하네스 직접 구축하기 ▶
1. 왜 멀티에이전트인가: 단독 세션이 토큰을 태우는 이유
2. 네 개의 작업 공간 만들기: 멀티에이전트 실행 환경 준비
3. 디스패처 만들기: 에이전트에게 안전하게 메시지 보내기
4. 자동 라우팅 데몬 만들기: 에이전트끼리 작업을 이어 주는 법
5. 자동 라우팅 운영 점검: 만든 하네스를 실제로 굴리는 법
6. 작업 위임 실전: Opus가 나누고 워커가 처리하는 구조
7. 반복 작업 템플릿: 위임 지시문을 복사해 쓰는 법
8. 프로젝트 경계 설정: 하네스가 작업 폴더 밖을 건드리지 않게 하기
6부 운영, 검증, 완성 ▶
1. 로그와 상태 파일: 하네스가 한 일을 추적하기
2. 장애 대응과 복구: 데몬과 세션이 멈췄을 때 되살리기
3. 회귀 테스트: 하네스가 깨지지 않았는지 자동 점검하기
4. 설치와 실행 정리: 처음부터 끝까지 표준 절차로 굴리기
5. 최종 완성: 전체 점검과 파일 구조 검증
부록 부록 ▶
1. 부록 A. 용어집: 가나다순, 영문 약어, 비유 한 줄씩
2. 부록 B. 명령과 스크립트 모음: 실제 엔진 스크립트 전문
3. 부록 C. 하네스 활용 분야 카탈로그: 9그룹 38분야 응용 사례
모델 비용도 구조의 일부입니다
조사 · 검토 · 정리 Haiku
코딩 · 작성 · 분석 Sonnet
기획 · 판단 · 설계 Opus
모든 일을 한 모델에 몰아주는 대신 역할을 나누면 토큰 사용을 줄이면서도 더 빠르고 안정적인 결과를 얻을 수 있습니다.
이런 분께 추천합니다
토큰 비용이 부담되는 분
모든 작업을 고성능 모델에 몰아주는 대신, 역할별로 모델을 나누어 비용을 통제하고 싶은 분
채팅을 넘어 시스템으로 확장하고 싶은 분
Claude Code를 단순 채팅 도구가 아니라, 여러 에이전트가 협업하는 자동화 시스템으로 쓰고 싶은 분
나만의 자동화 환경을 만들고 싶은 분
직접 AI 작업 환경을 구성하고, 더 높은 품질의 결과물을 안정적으로 얻고 싶은 분
CLI, 터미널이 아직 낯선 분
Windows에서 WSL 설치부터 차근차근 따라가며, 멀티에이전트 하네스까지 직접 만들어 보고 싶은 분
FULL SOURCE
책에 수록된 스크립트는 실제로 작동하는 예제입니다. 부록 B에 엔진 스크립트 전문을 수록했습니다
HANDS-ON
Windows WSL 설치부터 시작해, 디스패처, 라우팅 데몬, 작업 위임, 회귀 테스트까지 직접 만들어 갑니다
MULTI AGENT
Opus는 기획, Sonnet은 작업, Haiku는 검토. 역할 + 규칙 + 작업 전달 + 검수 구조를 만듭니다
저자 소개
김지웅, Anton Kim
mytoolly / 툴리소프트
통신 관련 분야를 전공하고, SI와 NI 현장에서 25년 이상 실무를 해 왔습니다. 시스템 엔지니어를 거쳐 2007년 CCIE(Cisco Certified Internetwork Expert)를 취득한 후 네트워크 분야에서 오랫동안 일해 왔습니다.
이후 공공, 국방, 금융, 통신, 반도체 분야의 대형 인프라 프로젝트에 참여했습니다. Cisco Nexus 기반 데이터센터, Catalyst 기반 L2/L3 네트워크, 무선 인프라, 보안 정책, 망분리, DR 구축 등 다양한 환경을 경험했으며, 시스템 운영부터 네트워크 설계, 구축, 이전, 운영까지 여러 프로젝트를 수행했습니다. 그 과정에서 안정성, 이중화, 검증, 자동화가 현장에서 얼마나 중요한지 오랜 시간 다양한 환경에서 실무를 수행해 왔습니다.
저자는 통신과 네트워크를 단순히 장비를 연결하는 일로 보지 않습니다. 프로젝트를 오래 일하며 느낀 것은, 결국 중요한 것은 흐름이라는 점이었습니다. 어느 장비가 어떤 역할을 맡고, 정보가 어디로 전달되며, 문제가 생겼을 때 어디에서 확인하고 복구할 수 있는지가 전체 안정성을 결정합니다.
AI도 같은 관점에서 바라보았습니다. 좋은 모델 하나에 모든 일을 맡기는 방식은 편할 수 있지만, 오래 안정적으로 쓰기에는 한계가 있습니다. 역할을 나누고, 작업을 전달하고, 결과를 다시 확인하는 구조가 있어야 AI도 하나의 팀처럼 움직일 수 있습니다.
그래서 저는 오래전부터 반복 작업을 줄이고 운영 품질을 높이는 자동화에 관심을 가져 왔습니다. 최근에는 Claude Code를 활용해 여러 AI 모델을 역할별로 나누고, 작업 흐름을 관리하며, 결과를 검토하는 멀티에이전트 하네스 구조를 연구하고 있습니다.
이 책은 그 과정에서 직접 만들고 정리한 실전 기록입니다.