개발자 심화
Claude를 앱에서 쓰는 단계를 넘어, 코드와 API로 직접 다루고 싶은 분을 위한 섹션이에요. 업무 봇 만들기, 에이전트 직접 만들기, MCP 서버 연결, CI 자동화, 결과 품질 관리까지 실행 가능한 코드를 중심으로 10편으로 정리해요.
누구를 위한 섹션인가요?
섹션 제목: “누구를 위한 섹션인가요?”- 개발자이거나, 코드를 읽고 터미널을 쓰는 데 거부감이 없는 파워 유저
- Claude Code와 API를 이미 한 번 써 본 분
기초 설명은 반복하지 않아요. 이 섹션은 Claude Code 핵심 기능(C14), 모델 분담(C15), API 시작하기(C16)를 읽은 독자를 기준으로 쓰여요. 모르는 용어가 나오면 해당 편으로 돌아가세요.
준비물
섹션 제목: “준비물”- Claude API 키 (환경변수로만 관리해요. 코드에 직접 쓰지 않아요)
- Python 3.10 이상
- Node.js (TypeScript·JavaScript 예제와 MCP 서버, Claude Code에 필요해요)
- 터미널과 Git
추천 학습 순서
섹션 제목: “추천 학습 순서”- API 기본기: 도구 사용(01) → 비용 최적화(02)
- 에이전트: Agent SDK(03) → Managed Agents(04)
- 확장과 배포: MCP 서버(05) → 스킬·플러그인(06)
- 자동화와 품질: 헤드리스·CI(07) → 평가(08)
- 응용: 사내 문서 Q&A(09) → 컴퓨터·브라우저 도구(10)
이 섹션의 튜토리얼
섹션 제목: “이 섹션의 튜토리얼”- 고급
도구 사용(Tool use)으로 업무 봇 만들기
도구 정의, tool_use와 tool_result 루프를 직접 구현하고 SDK tool runner로 줄여 보며, 사내 재고·일정 조회 봇을 오류 처리와 반복 상한까지 갖춰 만드는 고급 튜토리얼
개발자 심화· 60분
- 고급
프롬프트 캐싱·배치·effort로 API 비용 줄이기
캐시 읽기 단가, Message Batches 50% 할인, effort 조절, 모델 분담, 토큰 세기와 사용량 로그를 Python 예제와 가격 비교 계산으로 정리한 API 비용 최적화 참고서
개발자 심화· 60분
- 고급
Claude Agent SDK로 나만의 에이전트 만들기
Claude Code와 같은 에이전트 루프를 Python·TypeScript 코드로 불러 쓰는 Agent SDK로, 읽기 전용 에이전트부터 사용자 정의 도구, 권한 잠금, 서브에이전트, 세션 이어가기까지 만들어 보는 실습
개발자 심화· 60분
- 고급
Managed Agents로 서버에서 에이전트 돌리기
에이전트 루프와 샌드박스를 Anthropic이 대신 운영해 주는 Claude Managed Agents(베타)의 구조를 이해하고, 에이전트·환경·세션을 만들어 스트리밍으로 결과를 받고, 동적 워크플로와 비용 상한까지 설정해 보는 실습
개발자 심화· 60분
- 고급
MCP 서버 직접 만들어 Claude에 연결하기
공식 Python SDK로 도구 2개짜리 MCP 서버를 만들고, Claude Code(claude mcp add)와 Claude 앱의 커스텀 커넥터에 연결하는 방법. 권한 최소화와 프롬프트 인젝션 주의까지 정리했어요.
개발자 심화· 60분
- 고급
스킬·플러그인 패키지로 만들어 팀에 배포하기
SKILL.md 설계 원칙부터 플러그인 구조, 마켓플레이스, claude plugin eval 품질 확인, 저장소·조직 설정으로 팀 배포, Anthropic 디렉터리 제출 포털까지 정리한 참고서
개발자 심화· 75분
- 고급
Claude Code 헤드리스 모드와 GitHub Actions 자동화
claude -p로 스크립트와 CI에서 Claude Code를 돌리고, 공식 GitHub Action으로 PR 리뷰와 이슈 분류를 자동화하는 방법. 권한, 비밀 값, 비용 상한까지 정리했어요.
개발자 심화· 60분
- 고급
평가(evals)로 LLM 결과 품질 관리하기
테스트 세트를 만들고, 정답 기반 채점과 LLM 채점으로 점수를 내고, 프롬프트나 모델을 바꿀 때마다 회귀를 비교하는 작은 Python 평가 스크립트를 만들어요.
개발자 심화· 60분
- 고급
사내 문서 Q&A 만들기: Files API와 인용(citations)
사내 PDF·텍스트 문서를 Files API로 올리고, 인용 기능으로 출처가 붙는 답변을 받는 Q&A 도구를 Python으로 만들어요. 긴 컨텍스트와 RAG 선택 기준, 비용, 개인정보·보존 주의까지 정리했어요
개발자 심화· 60분
- 고급
컴퓨터·브라우저 도구 API로 화면 작업 자동화
컴퓨터 툴셋(computer_toolset_20260801)과 브라우저 툴셋(browser_toolset_20260801)의 구조를 이해하고, 격리된 환경에서만 돌리는 최소 에이전트 루프를 Python으로 만들어요. 안전 수칙과 비용 상한까지 정리했어요
개발자 심화· 60분