Claude Agent SDK로 내 업무용 AI 비서 만들기 — 초보자 10단계 실전 가이드

Claude Agent SDK 이거 처음 만지고 나서 제가 만들던 업무 자동화 코드가 확 짧아졌어요. 파이썬 잘 모르는 분도 3일이면 '내 업무 비서' 한 명 만들 수 있습니다. 2026년 4월 23일 기준으로 제가 밟은 경로를 10단계로 풀어볼게요.

1단계: Anthropic 콘솔 계정 생성 + API 키 발급

console.anthropic.com에 가입하면 가입 크레딧 5달러가 붙어요. 이걸로 대략 Claude Opus 4.7로 400번 정도 호출 가능합니다. API 키는 'sk-ant-'로 시작하는 문자열인데, 절대 깃헙이나 슬랙에 복사하지 마세요. 제가 실수로 한 번 공개 리포에 올렸다가 10분 만에 차단됐어요.

2단계: 파이썬 3.10+ 설치, 가상환경 만들기

python -m venv venv
source venv/bin/activate  # Windows: venv\\Scripts\\activate
pip install anthropic

여기까지 5분. 프로젝트별로 가상환경 분리하는 습관을 들이면 버전 꼬임 사고가 절반으로 줄어요.

3단계: 첫 호출 — "Hello Claude"

from anthropic import Anthropic
client = Anthropic()
msg = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=100,
    messages=[{"role": "user", "content": "오늘 날씨 어때?"}],
)
print(msg.content[0].text)

환경변수 ANTHROPIC_API_KEY를 설정해두면 Anthropic() 생성자에 키를 안 넘겨도 돼요.

4단계: 프롬프트 캐싱 켜기 (비용 90% 절감)

긴 시스템 프롬프트(2000토큰+)가 있을 때 반드시 켜야 합니다. cache_control 파라미터를 추가하면 1시간 동안 캐시돼서, 두 번째 호출부터는 입력 비용이 10%만 나와요. 월 7만 원 나가던 게 1만 원 이하로 떨어집니다.

5단계: Tool Use — 계산기부터 시작

에이전트의 핵심은 '툴'이에요. 제일 간단한 계산기 툴 하나 붙여보세요.

tools = [{
    "name": "calculator",
    "description": "두 숫자의 사칙연산을 수행",
    "input_schema": {"type": "object", "properties": {
        "op": {"type": "string"}, "a": {"type": "number"}, "b": {"type": "number"}
    }}
}]

Claude가 툴을 '써야겠다'고 판단하면 stop_reason이 "tool_use"로 나오고, 그 결과를 다시 넣어주는 루프를 짜는 게 다예요.

6단계: 실전 예제 ① — 이메일 초안 작성기

제가 매일 받는 광고 제안 메일에 정중히 거절 답장 쓰는 게 지겨워서 만든 에이전트예요. 받은 메일 텍스트 붙여넣으면 30초 안에 제 톤으로 답장 초안이 나옵니다. 첫 2주 동안 총 74통 처리했고, 시간 환산하면 약 3.7시간 절약됐어요.

7단계: 실전 예제 ② — 회의록 요약기

Zoom 녹음 전사본을 던지면 '핵심 결정 3개 / 액션 아이템 담당자별 / 다음 회의 안건'으로 구조화해줍니다. 회의 20분마다 요약 15초. 회사 전체에 돌릴 땐 Slack 봇으로 확장 가능해요.

8단계: 실전 예제 ③ — 보고서 목차 생성기

"2026년 2분기 마케팅 보고서" 같은 주제 던지면 상위 10개 경쟁사 리포트 구조를 참고해 목차 초안 뽑아줍니다. Claude 4.7의 긴 컨텍스트(1M 토큰) 덕에 PDF 30개 동시 참조도 가능해요.

더 깊이 들어가고 싶다면 Claude AI 사용법 완벽 가이드에 콘솔 UI부터 정리돼 있고, 모델 선택 기준은 Claude 4.7 vs Gemini 2.5 Pro vs ChatGPT-5 실사용 비교 쪽이 편하실 거예요.

9단계: Cloudflare Workers에 배포 (월 0원~5달러)

파이썬 에이전트를 로컬에서만 돌리면 컴퓨터를 켜놔야 해서 귀찮아요. Cloudflare Workers로 올리면 24시간 가동되고, 하루 10만 요청까진 무료예요. 저는 텔레그램 봇 형태로 연결해서 폰에서 바로 쓰고 있습니다.

10단계: 로그 관리 + 비용 알림

마지막 단계가 가장 중요해요. 토큰이 폭주하면 하루 3달러씩 새어나갈 수 있거든요. 저는 Anthropic 콘솔의 Usage 알림을 일 5달러로 설정해놨고, 매일 저녁 슬랙으로 사용량이 자동 푸시됩니다. 6주째 쓰는 중인데 아직 알림 한 번도 안 울렸어요.

3일 공부 + 주말 구축으로 얻은 체감 변화

• 주간 이메일 작업 시간: 5.2시간 → 1.4시간 (-73%)
• 회의록 정리 시간: 주 2시간 → 15분 (-87%)
• 월 API 비용: 6,800원

대기업 자동화 솔루션 견적 받으면 월 30만 원부터 시작해요. 개인 개발자가 Claude Agent SDK로 직접 만들면 1/40 비용으로 비슷한 효과가 납니다. 첫 툴 하나만 돌아가면 나머진 복사 붙여넣기로 확장 가능하니, 이번 주말에 1번부터 5번까지만 해보세요.