에이전트 여럿을 굴리는 운영법
8개 개념, 총 학습 약 130분
코딩 에이전트 운영 심화: 멀티 에이전트와 검수 체계
코딩 에이전트 운영 심화는 여러 코딩 에이전트를 함께 돌리며 결과를 믿고 합칠 수 있게 만드는 작업 설계와 검수, 비용, 기록 방법을 8가지 개념으로 정리한 코스입니다. 에이전트 하나로 일하는 데는 익숙해졌지만, 여러 개를 동시에 돌리자 충돌과 검수와 한도가 한꺼번에 문제가 된 분들을 위해 만들었습니다.
에이전트 수를 늘리면 만드는 속도는 빨라지지만 나누고 확인하고 합치는 일은 사람에게 몰립니다. 이 코스는 그 병목을 설계로 푸는 방법을 다룹니다. 에이전트의 원리는 AI 에이전트 중급 코스에서, 도구별 설치와 사용법은 코딩 에이전트 입문 코스에서 다뤘으므로 여기서는 정의를 반복하지 않고 구조와 절차, 비용, 실패 사례를 중심으로 설명합니다.
📚 다루는 개념 8가지
- 나누기: 멀티 에이전트 작업 설계, 깃 워크트리와 병렬 세션, 작업 명세 쓰기
- 거르기: 검수 체계, 실패 유형과 대응
- 운영하기: 비용과 토큰 예산, 관측과 기록, 에이전트를 쓰지 않을 때
나누기 묶음의 세 편은 순서대로 읽는 편이 이해가 빠릅니다. 거르기와 운영하기 묶음은 실제로 문제가 생긴 대목부터 골라 읽어도 됩니다. 명령과 설정은 클로드 코드를 기준으로 적었고, 코덱스와 오르카처럼 다른 도구의 방식은 비교가 필요한 곳에 함께 적었습니다.
❓ 자주 묻는 질문
에이전트를 하나만 쓰는데도 이 코스가 필요한가요?
작업 명세와 검수 체계, 실패 유형, 에이전트를 쓰지 않을 때 편은 에이전트 하나로 일할 때도 그대로 씁니다. 워크트리와 멀티 에이전트 설계 편은 에이전트를 둘 이상 동시에 돌리기 시작할 때 읽으면 됩니다.
개발자가 아니어도 따라갈 수 있나요?
깃의 브랜치와 커밋, 터미널 명령에 익숙하다면 무리 없이 따라갑니다. 이 코스의 대부분은 코드를 쓰는 법보다 일을 나누고 확인 기준을 적는 법이라서, 에이전트에게 일을 맡기는 역할이라면 개발 경험과 관계없이 쓸모가 있습니다. 깃이 낯설다면 바이브코딩 기초 코스의 깃 편을 먼저 보는 편이 낫습니다.
여기 적힌 요금과 한도는 계속 맞나요?
요금과 한도, 도구의 설정은 2026년 9월 28일 공식 문서 기준이고 이후 바뀔 수 있습니다. 코스의 중심은 바뀌기 쉬운 수치가 아니라 나누는 기준과 확인 순서라서, 수치가 바뀌어도 판단 방법은 그대로 씁니다.
🔗 함께 보는 코스
- AI 에이전트 중급: 원리와 설계: 에이전트 루프와 하네스, 보상 해킹, 프롬프트 캐시처럼 이 코스가 바탕으로 삼는 원리를 다룹니다
- 코딩 에이전트 입문: 코덱스 CLI와 제미나이 CLI, 오르카 같은 도구의 사용법과 권한 설정을 다룹니다
- 클로드 코드 중급: 실무 설정과 운영: 클로드 코드 한 도구의 설정과 운영을 더 깊게 다룹니다
3줄 요약
이번 방문에서 한 편은 바로 볼 수 있습니다.
멀티 에이전트 작업 설계: 메인과 작업자 나누기, 한 작업의 크기
멀티 에이전트 작업 설계는 하나의 목표를 여러 코딩 에이전트에게 맡기기 전에 누가 무엇을 소유하고 어떤 순서로 돌며 결과를 어떻게 합칠지를 정하는 일입니다. 나누는 기준은 파일 소유권과 의존 관계, 한 번의 검수로 판정할 수 있는 작업 크기입니다.
깃 워크트리(Git Worktree)와 병렬 세션: 여러 에이전트를 충돌 없이 돌리는 법
깃 워크트리는 한 저장소에 연결된 작업 폴더를 여러 개 두어 폴더마다 다른 브랜치를 동시에 꺼내 쓰게 하는 기능입니다. 코딩 에이전트 여러 개를 같은 저장소에서 동시에 돌릴 때 에이전트마다 워크트리를 하나씩 주면 서로의 파일을 덮어쓰지 않습니다.
작업 명세 쓰기: 대상, 변경, 제약, 소유권, 완료 증거
작업 명세는 코딩 에이전트에게 일을 맡길 때 무엇을 어디서 바꾸고, 무엇을 지키며, 어느 파일까지 만질 수 있고, 무엇을 보여 주면 끝난 것으로 볼지를 적은 지시서입니다. 대상, 변경, 제약, 소유권, 완료 증거 다섯 항목으로 쓰면 결과를 한 번에 판정할 수 있습니다.
코딩 에이전트 검수 체계: 자체 검수, 기계 검사, 별도 검수자 나누기
코딩 에이전트 검수 체계는 에이전트가 만든 변경을 작성자 자체 확인, 기계 검사, 별도 검수자, 사람의 최종 확인 순서로 거르도록 역할을 나눠 둔 구조입니다. 앞 단계일수록 싸고 일정한 검사를, 뒤 단계일수록 판단이 필요한 검토를 맡깁니다.
코딩 에이전트 비용과 토큰 예산: 모델 선택, 캐시, 컨텍스트, 세션 수
코딩 에이전트의 토큰 예산은 정해진 사용량이나 비용 안에서 작업을 끝내도록 모델 선택과 캐시 유지, 컨텍스트 정리, 동시에 돌리는 세션 수를 미리 정해 두는 운영 방식입니다. 같은 작업도 이 네 가지에 따라 쓰는 양이 몇 배씩 달라집니다.
코딩 에이전트 실패 유형과 대응: 보상 해킹, 범위 이탈, 멈춤, 중복 수정
코딩 에이전트 실패 유형은 에이전트를 운영할 때 반복해서 나타나는 잘못된 결과를 증상과 원인별로 나눈 것입니다. 보상 해킹, 범위 이탈, 멈춤과 헛돎, 중복 수정, 이른 완료 선언이 대표적이고 유형마다 즉시 대응과 재발 방지 장치가 다릅니다.
코딩 에이전트 관측과 기록: 무엇을 남기고 어떻게 되짚는지
코딩 에이전트 관측은 에이전트가 무엇을 읽고 실행하고 바꿨는지, 얼마를 썼는지를 기록으로 남겨 나중에 되짚을 수 있게 하는 운영 방식입니다. 도구가 자동으로 남기는 대화 기록과 체크포인트, 사람이 따로 남기는 작업 기록과 비용 기록을 함께 씁니다.
코딩 에이전트를 쓰지 않을 때: 사람이 더 빠른 일, 되돌리기 어려운 일
코딩 에이전트를 쓰지 않을 때를 정하는 일은 설명하는 시간이 직접 하는 시간보다 긴 일, 되돌리기 어려운 일, 결과를 확인할 수단이 없는 일을 가려 사람이 직접 하거나 사람의 승인을 거치게 하는 판단입니다. 에이전트는 응답 시간과 비용을 더 쓰는 대신 판단을 맡는 구조라서 모든 일에 맞지 않습니다.