콘텐츠로 건너뛰기

[서평 작성] 클로드 에이전트 협업의 기술

  • 기준

안녕하세요? 정리하는 개발자 워니즈입니다. 이번 시간에는 클로드 에이전트 협업의 기술을 읽고 서평을 하도록 하겠습니다.

필자는 요즘 개인 블로그 운영을 상당 부분 클로드 에이전트에게 맡겨두고 있는데요. 글 초안을 만들고 발행 전 검사를 돌리고 소셜에 올리는 일까지 하루 네 번 자동으로 돌아가게 해두었습니다. 그런데 막상 굴려보니 도구를 붙이는 것보다 어떤 일을 누구에게 맡길지 정하는 쪽이 훨씬 어렵다는 걸 알게 됐습니다. 이 책이 다루는 게 정확히 그 지점이라 관심이 갔습니다.

책은 클로드 에이전트를 질문 상대가 아니라 업무를 위임받는 팀원으로 다루는 능력을 기르는 데 목표를 두고 있는데요. 챗봇 한 명에게 일일이 지시하던 방식을 끝내고 클로드 코워크와 클로드 코드라는 두 도구로 10명분의 AI 팀을 운영하는 것을 최종 그림으로 제시합니다.

그러면 본격적으로 각 단원별 내용을 정리하고 서평하도록 하겠습니다.
클로드 에이전트 협업의 기술 책 표지

목차

Part 00. AI 팀플레이의 시대가 열리다

  • 0.1 인류는 협력으로 문명을 만들었다
  • 0.2 ‘혼자 일하는 AI’에서 ‘팀으로 일하는 AI’로
  • 0.3 왜 클로드인가: 코워크와 코드, 두 개의 출발점
  • 0.4 이 책의 목표: 나만의 AI 조직도 만들기

Part 01. 클로드 코워크: 나의 첫 번째 에이전트 팀

  • Chapter 01. 시작하기: 5분 안에 세팅하기
  • Chapter 02. 에이전트에 첫 번째 일 맡기기
  • Chapter 03. 에이전트의 능력을 확장하다: 멀티 파일 처리
  • Chapter 04. 커넥터: 에이전트에게 손과 발 달아주기
  • Chapter 05. 스킬: 에이전트에 전문성 부여하기
  • Chapter 06. 플러그인: 에이전트 업무의 묶음을 만들다
  • Chapter 07. 예약 작업으로 100% 자동화 에이전트 만들기

Part 02. 클로드 코드: 에이전트 군단을 지휘하라

  • Chapter 08. 클로드 코드에 입장하기
  • Chapter 09. 명령어 체계: 에이전트에게 지시하는 언어
  • Chapter 10. CLAUDE.md: 에이전트의 업무 매뉴얼
  • Chapter 11. 커스텀 명령어: 나만의 지휘 체계 만들기
  • Chapter 12. MCP 서버: 에이전트의 활동 반경 넓히기
  • Chapter 13. 서브 에이전트: AI가 AI를 부린다
  • Chapter 14. 멀티 에이전트 오케스트레이션: 나만의 AI 조직도 구축하기
  • Chapter 15. 멀티 에이전트 실전 I: PPT 자동화 에이전트 팀 만들기
  • Chapter 16. 멀티 에이전트 실전 II: AI 콘텐츠 마케팅 에이전시 만들기
  • Chapter 17. 에이전트 조직 운영의 기술

클로드 에이전트를 팀으로 굴리는 법, 챕터별 간단 서평

[Part 00 AI 팀플레이의 시대가 열리다]

챗봇과 에이전트와 멀티 에이전트가 어떻게 다른지를 먼저 정리하고 들어가는데요. 용어를 느슨하게 쓰다 보면 “AI에게 맡긴다”는 말이 실제로 무엇을 맡긴다는 것인지 흐려지기 때문에, 이 구분을 앞에 두는 편성은 적절해 보였습니다. 클로드 코워크와 클로드 코드를 두 개의 출발점으로 나눠 소개하는 것도 이 책의 뼈대를 이해하는 데 도움이 됐습니다.

이 장에서 배운 것: 도구를 쓰고 스스로 판단하면 클로드 에이전트 같은 에이전트이고, 그런 에이전트가 여럿 모여 역할을 나누면 멀티 에이전트입니다.


[Part 01 클로드 코워크: 나의 첫 번째 에이전트 팀]

Chapter 01 ~ 03. 세팅과 첫 위임, 그리고 멀티 파일 처리

터미널을 쓰지 않는 독자를 위한 진입 구간입니다. 5분 세팅에서 시작해 첫 업무를 맡겨보고 여러 파일을 한 번에 다루는 데까지 올라가는데요. 난이도를 계단식으로 올려두어서 부담이 적었습니다.

이 장에서 배운 것: 에이전트에게 일을 맡기는 첫 단계는 도구 설정이 아니라 맡길 일의 범위를 문장으로 적어보는 것입니다.

Chapter 04. 커넥터: 에이전트에게 손과 발 달아주기

에이전트가 외부 서비스에 실제로 접근하게 만드는 장입니다. 여기부터 “답변을 받는다”에서 “일이 처리된다”로 성격이 바뀌는데요. 필자도 블로그 자동화를 붙이면서 같은 전환점을 겪었기 때문에 공감이 갔습니다.

이 장에서 배운 것: 커넥터를 붙이는 순간부터는 결과를 되돌릴 수 있는지 먼저 따져야 합니다.

Chapter 05. 스킬: 에이전트에 전문성 부여하기

빌트인, 커스텀, 파트너 세 가지 스킬 유형을 구분하고 SKILL.md를 직접 작성해보는 장입니다. 난이도는 별 두 개, 예상 학습 시간은 40분으로 표시돼 있는데요. 필자는 이 부분이 이 책에서 가장 실용적인 대목이라고 느꼈습니다. 같은 지시를 매번 반복해 설명하는 대신 파일 하나로 굳혀두는 방식이라, 실제로 자주 하는 작업이 있다면 바로 효과가 납니다.

이 장에서 배운 것: 반복해서 설명하고 있는 작업이 있다면 그건 스킬로 만들어야 할 신호입니다.

Chapter 06 ~ 07. 플러그인과 예약 작업

플러그인으로 업무 묶음을 만들고, 예약 작업으로 사람 없이 돌아가게 만드는 구간입니다. 7장은 예약 작업의 한계와 대응 방법까지 학습 목표에 넣어둔 점이 눈에 띄었는데요. 자동 실행은 잘 도는 경우보다 안 도는 경우를 어떻게 알아채느냐에서 운영이 갈립니다. 필자도 하루 네 번 도는 작업이 조용히 실패해서 한참 뒤에 알아챈 적이 있어서, 이 항목이 목차에 있다는 것만으로 신뢰가 갔습니다.

이 장에서 배운 것: 예약 작업은 성공했을 때가 아니라 실패했을 때 어떻게 알 것인가를 같이 설계해야 합니다. 필자의 클로드 에이전트 자동 실행이 실제로 얼마나 자주 미끄러졌는지는 성공률을 세어본 기록에 남겨두었습니다.


[Part 02 클로드 코드: 에이전트 군단을 지휘하라]

Chapter 08 ~ 09. 입장과 명령어 체계

터미널 기반 도구로 넘어가는 구간입니다. 명령어를 “에이전트에게 지시하는 언어”로 표현한 점이 인상적이었는데요. 도구 사용법이 아니라 의사소통 방식으로 접근하는 관점이 이 책 전체를 관통합니다.

이 장에서 배운 것: 명령어를 외우는 것보다 지시가 어디까지 전달되는지 감을 잡는 편이 먼저입니다.

Chapter 10. CLAUDE.md: 에이전트의 업무 매뉴얼

에이전트가 매번 참조하는 규칙 파일을 다루는 장입니다. 필자가 실제로 가장 많이 손대는 파일이기도 한데요. 여기에 무엇을 적고 무엇을 적지 않을지가 결과 품질을 크게 좌우합니다. 규칙을 잔뜩 넣으면 오히려 서로 부딪히는 경우가 생기는데, 그 균형을 잡는 이야기가 담겨 있어 반가웠습니다.

이 장에서 배운 것: CLAUDE.md는 많이 적는 파일이 아니라 충돌 없이 적는 파일입니다.

Chapter 11 ~ 12. 커스텀 명령어와 MCP 서버

반복 작업을 명령어로 굳히고, MCP로 에이전트가 닿을 수 있는 범위를 넓히는 구간입니다. MCP는 최근 관심이 높은 주제라 별도로 찾아보신 분도 많을 텐데요. 규격 자체가 궁금하다면 MCP 공식 문서를 함께 보시면 좋고, 최근 로드맵은 MCP 로드맵을 정리한 글에 따로 적어두었습니다. 이 책은 MCP 자체를 깊게 파기보다 에이전트 조직 안에서 어떤 역할을 하는지의 위치에 놓고 설명합니다.

이 장에서 배운 것: MCP는 새로운 기능이라기보다 에이전트의 활동 반경을 넓히는 배관에 가깝습니다.

Chapter 13. 서브 에이전트: AI가 AI를 부린다

클로드 에이전트가 또 다른 에이전트를 부리는 지휘관과 실행자 구조를 이해하고, 어떤 상황에서 병렬로 나눠야 이득인지 판단하는 장입니다. 난이도 별 네 개, 예상 학습 시간 45분으로 이 책에서 무게가 실린 구간인데요. AGENT.mdmodel, tools, maxTurns 같은 필드를 조정해 비용과 품질을 맞추는 이야기까지 들어 있습니다.

필자도 오늘 작업 중에 서로 독립적인 일 두 개를 서브 에이전트에 나눠 맡겨봤는데, 한쪽 결과에 결함이 있어서 수정 지시를 다시 내려야 했습니다. 그래서 맡기는 것보다 받은 결과를 검증하는 쪽이 진짜 일이라는 이 장의 문제의식이 남 얘기로 읽히지 않았습니다. 자동화를 돌려도 사람에게 남는 몫이 무엇인지는 따로 정리한 글에 적어두었습니다.

이 장에서 배운 것: 병렬로 맡길수록 완료 보고가 아니라 결과물을 직접 확인해야 합니다.

Chapter 14. 멀티 에이전트 오케스트레이션: 나만의 AI 조직도 구축하기

이 책의 정점에 해당하는 장입니다. 팬아웃, 파이프라인, 경쟁 가설, 스웜 네 가지 설계 패턴을 구분하고 업무에 맞는 것을 고르게 하는데요. 필자는 이 네 가지를 이름으로 정리해준 것만으로도 값어치가 있다고 느꼈습니다. 그동안 상황에 따라 감으로 나눠 맡기던 것을 부를 이름이 생기니 선택이 훨씬 명확해집니다.

에이전트끼리 소통하는 방식을 파일 기반, 체이닝, 에이전트 팀으로 나눠 설명하는 부분도 유용했습니다. 자동화가 커질수록 결국 걸리는 지점이 결과를 어디에 남기고 누가 읽느냐인데, 그 선택지를 정리해두었습니다.

이 장에서 배운 것: 독립적인 작업이면 팬아웃, 순서가 있으면 파이프라인, 정답이 불확실하면 경쟁 가설로 나눕니다.

Chapter 15 ~ 16. 멀티 에이전트 실전 두 가지

PPT 자동화 팀과 콘텐츠 마케팅 에이전시를 직접 만들어보는 실습 구간입니다. 개념만 설명하고 끝나는 책이 많은데 여기서는 완성된 조직도 두 개를 끝까지 따라가게 해둔 점이 좋았습니다. 자기 직무에 맞게 변형할 출발점으로 쓰기 좋아 보였습니다.

이 장에서 배운 것: 조직도는 처음부터 크게 그리는 것이 아니라 일 하나를 끝까지 돌려본 뒤 늘리는 것입니다.

Chapter 17. 에이전트 조직 운영의 기술

만든 다음의 이야기를 다루는 장이라 개인적으로 가장 반가웠습니다. 아침 브리핑부터 퇴근 보고까지의 하루 운영 루틴, CLAUDE.md 버전 관리로 하는 온보딩, 결과물 품질 체크 루틴, 그리고 비용 최적화가 차례로 나오는데요.

특히 “Opus는 팀장에게, Sonnet은 실무자에게” 라는 절 제목을 보고 웃었습니다. 필자가 실제로 쓰고 있는 방식과 같아서인데요. 판단이 필요한 자리에는 무거운 모델을, 지시가 명확한 정형 작업에는 가벼운 모델을 붙이는 것이 비용과 품질을 함께 잡는 현실적인 타협점입니다. 트러블슈팅 절을 따로 둔 것도 실제 운영을 해본 사람이 쓴 목차라는 인상을 줬습니다.

이 장에서 배운 것: 에이전트 조직은 만드는 비용보다 운영하고 고치는 비용이 더 듭니다.

서평

누가 읽으면 좋은가

  • AI 챗봇을 1년 이상 써왔지만 결국 내가 다 해야 한다는 한계를 느끼는 직장인
  • AI 자동화 시스템을 직접 설계해보고 싶은 3~10년 차 기획자, 마케터, 운영자
  • 터미널이 낯설지 않고 클로드 코드의 제어권을 더 확보하고 싶은 분

책이 밝히고 있는 대상 독자인데요. 클로드 에이전트를 처음 붙여보는 분부터 이미 굴리고 있는 분까지, 읽어보니 실제로 그 범위에 잘 맞습니다. 개발자만을 위한 책은 아니고, Part 01은 터미널 없이 따라갈 수 있게 구성돼 있어서 비개발 직군도 앞부분만으로 충분히 얻어갈 것이 있습니다.

책의 주요 장점

  1. 장마다 학습 목표와 난이도, 예상 학습 시간이 붙어 있습니다
    • 별점 난이도와 분 단위 시간이 표시돼 있어 어디에 힘을 쓸지 미리 고를 수 있습니다
    • 시간이 없을 때 필요한 장만 골라 읽기 좋은 구조입니다
  2. 설계 패턴에 이름을 붙여줍니다
    • 팬아웃, 파이프라인, 경쟁 가설, 스웜이라는 이름이 생기면 상황마다 무엇을 고를지가 분명해집니다
    • 감으로 나눠 맡기던 일을 언어로 정리하게 해주는 것이 이 책의 큰 기여라고 생각합니다
  3. 만든 다음의 이야기가 있습니다
    • 17장 전체가 운영, 비용, 품질 체크, 트러블슈팅에 할애돼 있습니다
    • 자동화 책이 대개 구축까지만 다루고 끝나는 것과 대비됩니다
  4. 두 도구를 하나의 흐름으로 엮습니다
    • 클로드 코워크에서 시작해 클로드 코드로 넘어가는 순서라 진입 장벽이 완만합니다
    • 도구별 매뉴얼이 아니라 조직을 만들어가는 이야기로 읽힙니다

클로드 에이전트를 여러 개 굴려본 입장에서 읽고 나서 가장 크게 남은 것은 에이전트를 늘리는 일보다 검증하고 운영하는 일이 본체라는 감각이었습니다. 클로드 에이전트를 한 번이라도 붙여본 분이라면 아마 같은 지점에서 고개를 끄덕이실 것 같습니다.


본 포스팅은 “한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다