코딩을 배워야 하나? SDK를 설치해야 하나? 복잡하게 생각할 필요 없습니다. 클로드 데스크탑 앱의 코워크(Cowork) 기능만 있으면, 대화만으로 AI 에이전트 팀을 만들고 실무에 바로 활용할 수 있습니다. 이 글에서는 주식 분석 에이전트 팀을 예시로 전체 과정을 정리합니다.
에이전트란?
에이전트는 결국 잘 짜여진 역할 정의 + 행동 규칙 + 출력 형식을 바탕으로 자동으로 일을 해주는 것입니다. Anthropic 공식 가이드에서는 이것을 하나의 마크다운(MD) 파일로 정의하라고 안내합니다.
📄 MD 파일 = 에이전트의 설계도
🧠 역할, 할 일, 쓸 수 있는 도구, 출력 형식이 모두 담김
👥 여러 MD 파일 = 여러 팀원 → 에이전트 팀 구축
전체 흐름 한눈에 보기
STEP 1
클로드 대화창에서
에이전트 MD 파일 생성
STEP 2
다운로드 후
폴더에 정리
STEP 3
코워크에서
폴더 지정
STEP 4
프롬프트 입력 후
에이전트 팀 실행
STEP 1 — 클로드 대화창에서 에이전트 MD 파일 만들기
클로드 데스크탑 앱(Mac/Windows)을 열고, 대화창에 프롬프트를 입력합니다.
프롬프트 예시
나는 주식 종목을 분석하는 AI 에이전트를 만들고 싶다.
증권사 애널리스트처럼 종목 분석하고 추천픽도 골라주는 에이전트다.
Anthropic 공식 에이전트 가이드에 따라서 만들어라.
YAML 프론트매터 + 마크다운 시스템 프롬프트로 만들어 달라.
description에 proactively use를 포함시켜라.
분석 프레임워크:
- 기업 개요 분석
- 재무 분석
- 산업/모멘텀 분석
- 리스크 분석
- 종합 투자 의견
오케스트레이션 구조:
서브 에이전트 여러 개의 다중 MD 파일로 만들어서
한 명의 팀장이 팀원들을 돌리는 구조로 만들어라.💡 Opus 4.6 모델 + 확장 사고(Extended Thinking)를 켜면 서브 에이전트 MD 파일을 더 잘 만들어 줍니다.
핵심 키워드 설명
| 키워드 | 역할 |
|---|---|
| YAML 프론트매터 | 에이전트의 헤더 — 이름, 역할, 사용 도구, 모델 등 기본 정보를 정해진 양식으로 기재 |
| proactively use | description에 넣으면 에이전트가 적절한 서브 에이전트를 알아서 호출 |
| 오케스트레이션 | 팀장(오케스트레이터)이 팀원(서브 에이전트)들을 순차/병렬로 돌리는 구조 |
생성되는 에이전트 팀 구조
🎯 오케스트레이터 (팀장)
stock-analyst.md — 서브 에이전트를 순차 호출하고 결과 종합
📋 기업 개요
company-overview.md
💰 재무 분석
financial-analysis.md
📈 산업/모멘텀
industry-momentum.md
⚠️ 리스크 분석
risk-analysis.md
🎯 투자 의견
investment-opinion.md
📊 보고서 작성
report-writer.md
STEP 2 — 파일 다운로드 & 폴더 정리
① 클로드 대화창에서 생성된 MD 파일들을 "모두 받기"로 다운로드
② ZIP 파일 해제
③ 원하는 위치에 폴더 생성 (예: stock-agent/)
④ 해제한 MD 파일들을 폴더에 넣기
💡 이 폴더에 MD 파일을 넣는 것 = 팀원들을 자리에 앉혀 놓는 것과 같습니다. 말 그대로 에이전트 팀을 구성한 겁니다.
STEP 3 — 코워크에서 폴더 지정 & 실행
클로드 데스크탑 앱의 코워크(Cowork) 기능을 열고, 방금 만든 에이전트 폴더를 지정합니다.
프롬프트 예시
미이란 전쟁이 발발해서 방산주가 급등하고 있다.
이 상황에서 추천할 한국 주식과 미국 주식을 분석해 달라.
에이전트 가이드에 따라서 진행해라."에이전트 가이드에 따라서 진행해라"라고 명시하면, 폴더에 있는 MD 파일(CLAUDE.md 지침)을 따라 에이전트 팀이 동작합니다.
실행 과정
① 서브 에이전트 여러 개를 병렬 투입하여 시장 리서치 진행
② 각 에이전트가 담당 영역 분석 완료
③ 오케스트레이터가 결과를 종합
④ 최종 종합 보고서를 MD/PDF 파일로 생성
⑤ 에이전트 폴더에 보고서 자동 저장
⚡ 병렬 투입의 장점: 서브 에이전트를 하나씩 순차 실행하는 것보다 훨씬 빠른 업무 처리가 가능합니다.
문제 발생 시 — 티키타카로 수정
결과물에 문제가 있으면 대화로 바로 수정을 요청하면 됩니다.
수정 프롬프트 예시
한글 깨짐 현상이 발생됐다.
MD 파일 업데이트하고 수정해서 PDF 파일까지 다시 만들어라.예약 작업 — 정기 분석 자동화
코워크의 또 다른 강점은 예약 작업(Scheduled Task)입니다. 정기적으로 에이전트 팀을 자동 실행할 수 있습니다.
예약 프롬프트 예시
매주 월요일 장 시작 전(오전 8시)에
방산주 4개 종목 분석을 돌려 줘.
이란 사태와 관련된 미국 주식도 포함해라.⚠️ 주의사항
예약 작업은 클로드 데스크탑 앱이 열려 있고 컴퓨터가 깨어 있는 동안만 실행됩니다. Mac의 경우 맥미니처럼 항상 켜져 있는 환경이면 문제 없습니다.
코워크의 장점
💬 대화 이력 유지
과거 대화 내용을 다시 보고, 맥락을 유지한 채 이어서 작업 가능
⚡ 병렬 에이전트
여러 서브 에이전트를 동시에 투입해 빠른 결과 도출
⏰ 예약 작업
정기적으로 에이전트를 자동 실행하는 스케줄링 기능
📂 파일 출력
분석 결과를 MD/PDF 파일로 자동 생성 및 저장
핵심 요약
| # | 단계 | 내용 |
|---|---|---|
| 1 | 에이전트 설계 | 클로드 대화창에서 "Anthropic 공식 형식으로 만들어 줘" 한 마디 |
| 2 | 파일 준비 | MD 파일 다운로드 → 폴더에 정리 |
| 3 | 코워크 실행 | 폴더 지정 → 프롬프트 입력 → 에이전트 팀이 병렬 분석 |
| 4 | 자동화 | 예약 작업으로 정기 분석 스케줄링 |
핵심 메시지
코딩을 배울 필요도, SDK를 설치할 필요도 없습니다.
클로드 대화창에서 MD 파일을 만들고, 코워크에서 폴더만 지정하면
AI 에이전트 팀이 알아서 일을 시작합니다.