Claude Code와 VPS로 16명의 에이전트로 구성된 AI 회사를 만든 이야기

요약

Claude Code와 VPS를 활용하여 16명의 AI 에이전트로 구성된 가상의 영업 회사를 운영하는 실전 사례를 소개합니다. MCP 서버와 후크 시스템을 통해 에이전트 간의 연속성을 확보하고 업무를 자동화하는 구체적인 설계 방식을 다룹니다.

의약품 자동판매기, 인쇄 서비스, 고급 사과 선물 세트. 이 세 가지를 타겟이 다른 별도의 영업 팀이 담당하고 있는 작은 영업 회사가 있습니다.

각 팀에는 리드 획득(Lead Acquisition)·제안서 작성·메일 문구 생성·시장 조사가 필요합니다. 3가지 상품 × 4가지 태스크 = 12종류의 반복 업무. 이를 현재, 16체의 AI 에이전트(Agent)가 분담하여 움직이고 있습니다.

백엔드는 Hetzner의 VPS 1대($15/월), PM2로 5개 프로세스를 상주시키고 있으며, Claude Code가 뇌로서 기능하고 있습니다.

$ pm2 list
┌────┬──────────────────────┬────────┬───────────┐
│ id │ name │ uptime │ status │
...

이것은 가공의 도해(Diagram)가 아닙니다. 지금 이 순간 움직이고 있는 프로세스입니다.

각 에이전트는 .claude/agents/ 하위의 Markdown 파일로 정의되어 있습니다.

---
name: yakujihan
description: OTC 의약품 IoT 판매기 영업 에이전트. 약국·호텔·상업 시설용
...

@로 시작하는 행은 파일 참조입니다. 에이전트가 기동할 때마다, 이전의 인수인계 정보(HANDOFF.md)와 과거의 실패 사례(lessons_learned.md)를 자동으로 읽어옵니다. 이를 통해 세션을 넘나드는 연속성이 생겨납니다.

Claude Code의 settings.json에는 후크 기능이 있습니다. 세션의 시작·종료·도구(Tool) 사용 후 등의 타이밍에 임의의 스크립트를 실행할 수 있습니다.

"hooks": {
"SessionEnd": [{
"matcher": "",
...

session_end.js는 세션 종료 시 HANDOFF.md의 차분을 검출하여 자동으로 git push 합니다. 다음 날 아침에 기동했을 때, 어젯밤의 작업이 GitHub에 기록되어 있습니다.

크래시 리커버리(Crash Recovery)도 자동화되어 있습니다. 세션이 정상적으로 종료되지 않았을 경우, 다음 기동 시 직전 30건의 도구 로그와 체크포인트가 자동으로 주입됩니다. "계속해줘"라는 한마디로 이전의 문맥(Context)이 복원되는 구조입니다.

MCP(Model Context Protocol)는 외부 서비스를 Claude의 도구로서 연결하는 메커니즘입니다. 이 시스템에서는 30개 이상의 MCP 서버가 작동하고 있습니다.

주요 용도:

"약국 100곳의 리스트를 만들어줘"라고 yakujihan 에이전트에게 부탁하면, Firecrawl과 OSM(OpenStreetMap) MCP를 조합하여 약국 데이터를 수집하고, Excel 파일로서 output/yakujihan/에 저장합니다.

잘 된 점:

실패한 점:

이 시스템의 설계·구현·운용을 통째로 해설하는 Zenn 유료 도서를 집필 중입니다.

가격: ¥4,980

다루는 내용:

"ChatGPT로 할 수 있다"가 아니라 "Claude Code의 CLI를 중심으로 회사 인프라를 구축했다"는 기록입니다. 동일한 구성을 재현하고자 하는 엔지니어를 위한 책입니다.

AI 자동 생성 콘텐츠