Claude Code 서브에이전트란 정확히 무엇인가요?

하나의 Markdown 파일로 정의되는 단일 목적 Claude 인스턴스입니다. 자체 설명, 도구 허용 목록, 시스템 프롬프트를 포함합니다. Claude가 설명을 읽고 작업 위임 시점을 스스로 판단하므로, 사용자가 수동으로 오케스트레이션할 필요가 없습니다.

코드를 직접 작성해야 하나요?

아니요. .md 파일 하나가 전부입니다. 라이브러리 임포트도, 오케스트레이션도 필요 없습니다. .claude/agents/에 넣어두면, 다음에 해당 유형의 작업을 요청할 때 Claude Code가 자동으로 인식합니다.

현재 사용 중인 스택과 호환되나요?

대부분의 서브에이전트는 HTTP API, 파일 I/O, 셸 명령어와 통신하며, 특정 프레임워크에 종속되지 않습니다. 각 카드의 "stack" 항목에 해당 서브에이전트가 사용하는 연동 정보가 나열되어 있습니다.

스킬(Skill)과 서브에이전트의 차이점은 무엇인가요?

Skill은 여러 서브에이전트를 오케스트레이션하는 슬래시 명령어 파이프라인입니다. 서브에이전트는 단일 역할로, Skill 내부의 한 단계이거나 독립적인 단일 목적 에이전트입니다. 같은 Markdown 형식이지만 범위가 다릅니다.

9가지 카테고리의 Codex + Claude Code 자동화

Codex + Claude Code 프로젝트에 바로 적용되는 자동화.

아래 카드 하나하나는 실제 동작하는 자동화입니다. 각자 고유한 프롬프트와 도구, 모델을 갖춘 전문 에이전트죠. Claude Code와 Codex 모두에서 작동합니다. 파일을 프로젝트에 넣어두면, 작업에 맞는 상황일 때 러너가 자동으로 불러옵니다.

내 것 제출하기 →새로운 업데이트 알림 받기

Claude 서브에이전트의 작동 방식

Claude가 자동으로 라우팅하는 특화된 에이전트입니다.

서브에이전트는 .claude/agents/ 폴더에 담긴 작은 Markdown 파일입니다. 각 파일에는 고유한 설명, 도구 허용 목록, 시스템 프롬프트가 들어 있습니다. Claude는 이 설명을 읽고 언제 작업을 위임할지 스스로 결정합니다.

각 서브에이전트는 독립된 컨텍스트 윈도우에서 실행되어 메인 세션의 집중이 흐트러지지 않습니다. 병렬로 실행할 수 있고, 구조화된 단일 답변을 반환하며, 서로의 잡음은 전혀 보지 않습니다.

01
파일 저장
.md 파일을 프로젝트 루트의 .claude/agents/ 폴더에 넣거나, 개인용으로 여러 프로젝트에서 사용하려면 ~/.claude/agents/ 아래에 배치하세요.
02
Claude가 설명을 읽습니다
일치하는 질문을 Claude에게 하면, 설명 필드를 읽고 적절한 서브에이전트를 선택합니다.
03
격리된 환경에서 실행
독자적인 도구와 컨텍스트를 사용합니다. 하나의 병합된 답변만 반환하며, 메인 세션으로 불필요한 chatter를 보내지 않습니다.
04
집중력을 유지하세요
특화된 작업은 방해가 되지 않고 처리됩니다. 메인 세션에서는 상위 수준의 계획에만 집중할 수 있습니다.

⌘K

마케팅

아웃리치, 소셜, 콘텐츠 증폭.

세일즈 및 CRM

파이프라인 관리, 준비, 아웃바운드, 후속 조치.

Hubspot ↔ Airtable 동기화

ERPNext 리드 관리자

ERPNext 후보자 쇼트리스트 자동화

Telegram + Supabase Memory

콘텐츠 & 문서

Notion, WordPress, Drive, PDF, 시트.

DevOps & 코드

PR 리뷰, 릴리스, 감사, 인프라 에이전트.

리서치 & 인텔

웹 크롤링, 시장 스캔, 경쟁사 레이더.

SQL Copilot

Postgres 대화 에이전트

SQLite LangChain 에이전트

라이브러리의 작동 방식

오늘 밤 바로 프로젝트에 투입해 검증된 프로덕션급 서브에이전트.

위의 각 카드는 실제 유료 고객 프로젝트에서 추출한 서브에이전트입니다. 프롬프트, 도구 목록, 운영 절차까지 재사용할 수 있도록 이미 분리해 두었습니다. 오케스트레이션 코드도, 직접 시행착오를 겪을 필요도 없습니다.

설명을 읽고, 다운로드하고, .md 파일을 .claude/agents/에 넣으면 끝입니다. 다음에 해당 설명과 일치하는 작업이 생기면 Claude가 자동으로 라우팅합니다. 대부분 60초 안에 처음부터 끝까지 실행됩니다.

대상 고객

→차기 자동화 대상을 선정하면서도 일회용 배관 코드는 작성하고 싶지 않은 엔지니어링 리드.
→엔지니어 1명과 Claude Code, 그리고 짧은 런웨이만으로 제품을 출시해야 하는 창업자.
→여러 개의 불안정한 Zapier 연동 대신 단일 서브에이전트를 원하는 RevOps 및 CX 팀.

사용 방법: 3단계

01지원하려는 팀과 설명이 일치하는 카드를 선택하세요.
02다운로드를 클릭하면 .md 파일이 한 번의 클릭으로 내 컴퓨터에 저장됩니다.
03프로젝트의 .claude/agents/ 폴더에 배치하세요. 다음번에 해당 작업이 발생하면 Claude가 이를 자동으로 라우팅합니다.

자주 묻는 질문

Claude Code 서브에이전트란 정확히 무엇인가요?: 하나의 Markdown 파일로 정의되는 단일 목적 Claude 인스턴스입니다. 자체 설명, 도구 허용 목록, 시스템 프롬프트를 포함합니다. Claude가 설명을 읽고 작업 위임 시점을 스스로 판단하므로, 사용자가 수동으로 오케스트레이션할 필요가 없습니다.
코드를 직접 작성해야 하나요?: 아니요. .md 파일 하나가 전부입니다. 라이브러리 임포트도, 오케스트레이션도 필요 없습니다. .claude/agents/에 넣어두면, 다음에 해당 유형의 작업을 요청할 때 Claude Code가 자동으로 인식합니다.
현재 사용 중인 스택과 호환되나요?: 대부분의 서브에이전트는 HTTP API, 파일 I/O, 셸 명령어와 통신하며, 특정 프레임워크에 종속되지 않습니다. 각 카드의 "stack" 항목에 해당 서브에이전트가 사용하는 연동 정보가 나열되어 있습니다.
스킬(Skill)과 서브에이전트의 차이점은 무엇인가요?: Skill은 여러 서브에이전트를 오케스트레이션하는 슬래시 명령어 파이프라인입니다. 서브에이전트는 단일 역할로, Skill 내부의 한 단계이거나 독립적인 단일 목적 에이전트입니다. 같은 Markdown 형식이지만 범위가 다릅니다.

Codex + Claude Code 프로젝트에 바로 적용되는 자동화.

Claude가 자동으로 라우팅하는 특화된 에이전트입니다.

파일 저장

Claude가 설명을 읽습니다

격리된 환경에서 실행

집중력을 유지하세요

마케팅