아무도 알려주지 않은 Claude Code 에이전트 10가지

@zodchiii
영어2개월 전 · 2026년 5월 12일
1.2M
706
64
30
3.8K

TL;DR

Claude Code를 활용하여 PR 리뷰, 버그 수정부터 받은 편지함 정리, 콘텐츠 생성까지 모든 것을 처리하는 10개의 강력한 병렬 에이전트 시스템을 구축하는 방법을 알아보세요.

당신의 Claude Code는 잠재력의 10%만 발휘하고 있습니다.

나머지 90%는 병렬로 실행되는 10개의 에이전트가 담당합니다: PR 리뷰, 테스트 작성, 버그 탐지, 받은 편지함 정리, 콘텐츠 재활용까지.

대부분의 창업자들은 이런 기능이 있는지조차 모릅니다. 아는 사람들은 사람들은 3배 더 빠르게 출시하며 마치 마법사처럼 보입니다.

전체 설정은 아래와 같습니다 👇

본격적으로 들어가기 전에, 저는 Telegram 채널에서 AI와 바이브 코딩에 대한 일일 노트를 공유합니다: https://t.me/zodchixquant 🧠

먼저 마인드셋 전환이 필요합니다

Claude Code 에이전트는 채팅 세션이 아닙니다. 그것은 업무 설명서 + 트리거 + 출력물입니다. "PR 리뷰어"는 대화 상대가 아닙니다. 모든 PR에서 실행되어 특정 프롬프트로 Claude를 구동하고 댓글을 남기는 훅니다.

이 에이전트가 존재하는 세 가지 장소:

슬래시 명령어 (.claude/commands/<name>.md): 터미널에서 /name 으로 주문형 주문형 실행

훅 (.claude/hooks/<event>.sh): PreToolUse, PostToolUse 또는 git 이벤트와 같은 이벤트에서 자동으로 실행

Claude Agent SDK를 통한 호스팅 호스팅 스크립트: 서버에서 24/7 실행, 스케줄 또는 웹훅으로 트리거

각 에이전트가 어떤 유형을 사용하는지 아래에 표시하겠습니다.

<payloadbloc k id="blk_1" type="upload" />

1. PR 리뷰어

유형: 슬래시 명령어 + GitHub 훅

열려 있는 모든 PR의 diff를 읽고, 명백한 버그, 누락된 테스트, 보안 문제, 스타일 위반을 확인합니다. 90초 이내에 댓글을 남깁니다.

설정 방법:

  1. 저장소 루트에 .claude/commands/review.md 생성
  2. 아래 프롬프트를 파일에 붙여넣기
  3. 푸시 전에 Claude Code 내에서 /review 실행
  4. 자동화: 마켓플레이스에서 claude-code-action GitHub Action을 설치하고 review.md를 가리키도록 설정

프롬프트:

당신입 시니어 코드 리뷰어입니다. 스테이징된 diff를 읽으세요. 다음을 지적하세요: 하드코딩된 비밀번호, 누락된 테스트, 타입 오류, 명백한 버그. 간결하게, 최대 5개 댓글.

2. 테스트 생성기

유형: 슬래시 명령어 + pre-commit 훅

테스트가 없는 새 함수를 감시합니다. 함수당 3-5개 케이스 작성: 정상 경로, 엣지 케이스, 하나의 실패 모드.

설정 방법:

  1. 저장소 루트에 .claude/commands/tests.md 생성
  2. 아래 프롬프트를 파일에 붙여넣기
  3. 함수 작성 후 /tests <파일명> 실행
  4. 자동화: 일치하는 테스트가 없는 스테이징된 .ts/.py 파일에서 /tests 를 실행하는 pre-commit 훅 연결

프롬프트:

방금 작성한 함수를 읽으세요. [프레임워크, 예: Vitest, Pytest]로 테스트를 생성하세요. 정상 경로, 2개의 엣지 케이스, 하나의 오류 케이스를 포함하세요. 이 저장소의 기존 테스트 스타일과 일치시키세요.

3. 버그 헌터

유형: 호스팅 스크립트 (Claude Agent SDK)

Sentry, Linear 또는 오류 추적기를 수신합니다. 새로운 버그 보고서마다 스택 트레이스를 읽고 관련 파일을 열어 아침까지 수정 제안을 초안 PR로 제출합니다.

설정 방법:

  1. 5분마다 Sentry API를 폴링하여 해결되지 않은 새 이슈를 확인하는 Claude Agent SDK 스크립트 작성
  2. 각 이슈에 대해 스택 트레이스를 가져오고 GitHub API를 통해 관련 파일을 가져온 후 아래 프롬프트로 Claude 실행
  3. 스크립트를 Teamly 팀에 배포하고 Pixel Department에서 작동하는 모습을 지켜보세요. 총 설정 시간: 약 90분

프롬프트:

당신은 시니어 디버거입니다. 이 Sentry 스택 트레이스와 관련 소스 파일을 읽으세요. 근본 원인을 한 문장으로 파악하세요. 최소한 문장으로 파악하세요. 가능하면 회귀 테스트를 추가하세요.

4. 문서 작성자

유형: 병합 후 훅

main에 병합될 때마다 변경 사항이 README, 독스트링 또는 /docs에 문서화된 내용을 건드렸는지 확인합니다. 후속 PR에서 업데이트합니다.

설정 방법:

  1. 저장소에 .claude/hooks/post-merge.sh 생성
  2. 내부에서 아래 프롬프트로 Claude 호출
  3. 보너스: 프로젝트의 어조와 문서 구조를 설명하는 docs.md 스킬 파일을 추가하여 업데이트가 스타일과 일치하도록 함

프롬프트:

마지막 커밋이 [파일 목록]을 변경했습니다. README.md, 해당 파일의 독스트링 및 /docs를 확인하세요. 이 중 정보가 잘못되었거나 누락된 경우 업데이트된 버전을 생성하세요. git 패치로 출력하세요.

5. 리팩터 추적기

유형: 슬래시 명령어 (매주 실행)

코드베이스에서 TODO, FIXME, 중복 로직 및 500줄 초과 파일을 검색합니다. 우선순위가 매겨진 리팩터 목록과 예상 노력을 출력합니다. 수정하지는 않지만, 6개월 동안 무시해 온 부패를 드러냅니다.

설정 방법:

  1. 저장소 루트에 .claude/commands/rot.md 생성
  2. 아래 프롬프트를 파일에 붙여넣기
  3. 매주 금요일 /rot 실행, 월요일 아침에 분류

프롬프트:

저장소를 스캔하세요. 다음을 찾으세요: 30일 이상 된 TODO, FIXME, 500줄 초과 파일, 80줄 초과 함수, 3회 이상 나타나는 중복 문자열 리터럴. 우선순위별로 정렬된 Markdown 테이블로 출력하세요. 각 항목에 예상 노력 (S/M/L)을 추가하세요.

6. 일일 스탠드업 에이전트

유형: 호스팅 스크립트 (Claude Agent SDK)

어제의 GitHub 커밋, Linear 티켓 및 일정을 읽습니다. 오전 8시에 4줄 요약을 작성합니다. "어제: X 출시, Y 시작. 오늘의 장애물: Z."

설정 방법:

  1. 매일 오전 8시에 실행되어 지난 24시간 동안의 GitHub 커밋, Linear 티켓 변경 사항, 오늘의 Google 일정을 가져오는 스크립트 작성
  2. 모든 내용을 아래 프롬프트와 함께 Claude에 전달
  3. 출력은 이메일 또는 Telegram으로 전송. 저는 OAuth를 통한 Telegram 통합이 있는 Teamly에서 실행하며, 한 번의 클릭으로 연결

프롬프트:

최대 4줄로 요약하세요. 어제 X를 했습니다. 오늘 Y를 작업 중입니다. Z에 막혔습니다. 다음 우선순위: W. 사소한 것은 건너뛰세요.

7. 고객 피드백 합성기

유형: 호스팅 스크립트 (매주)

Intercom, X 멘션 및 제품 리뷰에서 데이터를 가져옵니다. 피드백을 주제별로 클러스터링합니다 ("결제가 느림", "다크 모드 원함", "가격 책정이 불명확함"). 빈도순으로 출력합니다.

설정 방법:

  1. 매주 일요일 오후 6시에 실행되어 지난 7일 동안의 Intercom 대화, 귀하의 핸들에 대한 X 멘션 및 리뷰 플랫폼 데이터를 가져오는 스크립트
  2. 모든 내용을 아래 프롬프트와 함께 Claude에 전달하고, Notion 페이지 또는 이메일로 출력
  3. 가장 어려운 부분은 API 인증이며, 이것이 제가 Notion과 나머지 서비스가 OAuth를 통해 연결되는 Teamly에서 호스팅하는 이유입니다

프롬프트:

이것들을 5-10개 주제로 클러스터링하세요. 각 주제에 대해 한 줄 요약, 개수 및 출처의 인용문을 제공하세요. 빈도순으로 정렬하세요.

8. 콜드 아웃리치 개인화 도구

유형: 호스팅 스크립트 (Claude Agent SDK)

CRM의 모든 새 리드에 대해 에이전트가 회사 사이트, LinkedIn, 최근 게시물, 관련 시 GitHub를 조회합니다. 그들에 관한 실제 정보 하나를 언급하는 개인화된 콜드 이메일을 작성합니다.

설정 방법:

  1. CRM (Attio, HubSpot, Notion CRM)의 웹훅으로 트리거되는 스크립트. 새 리드 발생 시: 회사 홈페이지 스크래핑, LinkedIn 찾기, 마지막 3개 X 게시물 읽기
  2. 모든 내용을 아래 프롬프트와 함께 Claude에 전달하고, 출력은 Gmail 초안 폴더로 전송
  3. 제 스크립트는 CRM 웹훅과 Gmail OAuth가 미리 구성된 Teamly에서 실행됩니다

프롬프트:

4줄 콜드 이메일을 작성하세요. 이 사람에 관한 구체적인 실제 사실 하나를 언급하세요 (회사, 최근 게시물 또는 출시 제품). 일반적인 오프너 사용 금지. "님의...를 보았습니다" 사용 금지. [귀하의 이름]으로 서명하세요.

9. 콘텐츠 재활용 도구

유형: 슬래시 명령어

하나의 긴 형식 게시물 (기사, 스레드, 문서)을 작성합니다. 에이전트가 이를 3개의 X 트윗, 1개의 LinkedIn 게시물, 1개의 Telegram 노트, 1개의 뉴스레터 요약으로 분할합니다. 모두 귀하의 어조로 작성됩니다.

설정 방법:

  1. 저장소 또는 콘텐츠 폴더에 .claude/commands/repurpose.md 생성
  2. 아래 프롬프트를 파일에 붙여넣기
  3. 소스 파일에서 /repurpose blog-post.md 실행. "어조" 라인이 비결입니다: 귀하의 실제 글쓰기 예시 3개를 제공하고 이를 고정하세요

프롬프트:

입력 파일을 읽으세요. 5개 섹션 출력: (1) 각 280자 미만의 3개 X 트윗, (2) 100-150 단어의 1개 LinkedIn 게시물, (3) 캐주얼한 어조의 1개 Telegram 노트, (4) 1개 뉴스레터 소개 문단, (5) 5개 대체 헤드라인. [3개 예시 링크]의 제 어조와 일치시키세요.

10. 받은 편지함 분류 에이전트

유형: 호스팅 스크립트 (30분마다)

30분마다 받은 편지함을 읽습니다. 이메일을 4개 버킷으로 분류: 오늘 답장 필요, 이번 주, 참고용, 보관. 처음 두 버킷에 대해 초안 답장을 작성하여 편집 후 보내기만 하면 됩니다.

설정 방법:

  1. Gmail OAuth가 있는 스크립트, 30분마다 실행되어 읽지 않은 이메일 가져오기
  2. 각 이메일을 아래 프롬프트와 함께 Claude에 전달하고, 각 버킷에 Gmail 레이블 적용, 초안을 초안 폴더에 저장
  3. Gmail 토큰을 새로고침해야 하며 호스팅 스크립트가 이를 자동으로 처리하기 때문에 Teamly에서 실행

프롬프트:

이 이메일을 [오늘 / 이번 주 / 참고용 / 보관]으로 분류하세요. 오늘 또는 이번 주인 경우, 제 어조로 3줄 초안 답장을 작성하세요. 발신자의 격식 수준과 일치시키세요. AI처럼 들리지 않게 하세요.

이 모든 것이 실제로 어디에 있나요?

5개는 로컬에서 잘 실행됩니다.

PR 리뷰어, 테스트 생성기, 문서 작성자, 리팩터 추적기, 콘텐츠 재활용 도구. 트리거되면 작업을 수행하고 종료합니다. 인프라가 필요하지 않습니다.

나머지 5개는 24/7 실행되어야 합니다.

버그 헌터, 일일 스탠드업, 콜드 아웃리치, 고객 피드백, 받은 편지함 분류. 사용자가 잠든 사이에 깨어나 작동해야 합니다. 이것이 대부분의 설정이 실패하는 지점입니다:

→ macOS 업데이트 중 오전 4시에 크론이 중단됨

→ VPS가 토요일에 다운됨

→ 저녁 식사 중에 Sentry 알림이 쌓임

처음에는 VPS를 시도했습니다 (DevOps 주말 프로젝트).

그런 다음 몇 가지 일반 호스트를 시도했습니다.

그리 Teamly에 정착했습니다.

<payloadblock id="blk_2" type="upload" />

AI 에이전트를 위해 특별히 구축된 관리형 클라우드 호스팅입니다.

Claude Agent SDK 스크립트를 넣으면 전용 인프라에서 24/7 실행됩니다.

@Teamly에서는 각 에이전트가 가상 사무실 (Pixel Department)에서 픽셀 아트 캐릭터로 나타나므로, 새벽 2시에 JSON 로그를 뒤질 필요 없이 작업을 지켜볼 수 있습니다.

가격:

$29/월 — 5개 에이전트, $20 Teamly Dollars

$89/월 — 15개 에이전트, $80 Teamly Dollars (위의 10개를 모두 실행한다면 최적)

$179/월 — 30개 에이전트, $170 Teamly Dollars

Sonnet과 Opus 사용량은 하나의 지갑 (Teamly Dollars)으로 통합되므로, 별도 청구되는 3개의 API 키를 관리할 필요가 없습니다.

"혼자서 어떻게 그렇게 빨리 출시하나요?"라는 질문에 대한 지루한 답변: 에이전트를 사용자가 사용하는 동일한 머신에서 호스팅하지 않는 것입니다.

<payloadblock id="blk_3" type="upload" />

솔직한 조언

주말에 10개를 모두 출시하려고 하지 마세요.

이번 주에 가장 고통스러운 2개를 선택하세요. PR 리 리뷰어와 받은 편지함 분류는 거의 모든 사람에게 가장 쉬운 승리입니다.

그런 다음 주당 하나씩 추가하세요.

3개월 차가 되면 혼자서 10개 에이전트 운영하게 될 것이며, 누군가가 어떻게 그렇게 빨리 출시하는지 물을 때 정확히 무엇을 가리켜야 할지 알게 될 것입니다.

AI 에이전트, 바이브 코딩 및 개발 워크플로우에 대한 일일 노트: https://t.me/zodchixquant 🧠

<payloadblock id="blk_4" type="upload" />

Save to YouMind

Use YouMind to read viral articles deeply

Save the source, ask focused questions, summarize the argument, and turn a viral article into reusable notes in one AI workspace.

Explore YouMind

분석할 패턴 더 보기

최근 바이럴 아티클

더 많은 바이럴 아티클 보기