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

3가지 상품을 16체의 AI로 운영하고 있다

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

각 팀에는 리드 획득(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를 중심으로 회사 인프라를 구축했다"는 기록입니다. 동일한 구성을 재현하고자 하는 엔지니어를 위한 책입니다.