Agent SDK 예제 모음 (Examples)
기준일: 2026-10-23
공식 기준: Examples
개요
이 공식 페이지는 바로 실행할 수 있는 Agent SDK 프로젝트와 Claude Cookbook의 단계별 레시피로 안내하는 길잡이입니다. 애플리케이션 예제는 claude-agent-sdk-demos 저장소에, Python 레시피는 Claude Cookbook에 있습니다.
핵심 개념
| 출발점 | 무엇이 들어 있나 | 언제 고르나 |
|---|---|---|
| Agent SDK quickstart | TypeScript 또는 Python으로 첫 에이전트를 만드는 설정 포함 가이드. 샘플 파일의 버그를 찾아 고치는 에이전트 | SDK로 아직 아무것도 만들어 본 적 없을 때 |
| Hello World | 최소 TypeScript 프로젝트 | 저장소 코드를 clone해서 시작하고 싶을 때 |
claude-agent-sdk-demos |
이메일 클라이언트부터 멀티 에이전트 리서치 시스템까지 로컬 개발용 데모 앱 | 만들려는 것과 모양이 비슷한 앱을 찾을 때 |
| Claude for commerce 레퍼런스 구현 | Python SDK로 만든 완성 프로젝트 | 쇼핑 에이전트나 merchant 에이전트를 만들 때 fork |
| Claude Cookbook Agent SDK 시리즈 | Python notebook 레시피 연작 | 단순한 리서치 에이전트에서 멀티 에이전트 시스템까지 차근차근 익힐 때 |
상세
최소 에이전트부터 실행
전체 애플리케이션을 보기 전에 quickstart나 Hello World 중 하나로 SDK가 내 환경에서 도는지 먼저 확인하는 것이 좋습니다. quickstart는 설치·인증 단계까지 포함하고, Hello World는 바로 clone해서 수정해 볼 수 있는 저장소 코드입니다.
데모 애플리케이션 고르기
claude-agent-sdk-demos의 앱은 로컬 개발용 데모입니다. 운영 배포용으로 다듬어진 코드가 아니므로, 구조를 참고하되 배포 전에는 Hosting·Secure deployment 문서로 격리·자격 증명·네트워크 통제를 따로 설계해야 합니다.
완성 프로젝트를 fork
쇼핑·merchant 에이전트처럼 commerce 영역이라면 Python SDK 기반 Claude for commerce 레퍼런스 구현에서 시작합니다.
Python 레시피 순서대로 익히기
Cookbook의 Agent SDK 시리즈는 notebook마다 앞 notebook을 바탕으로 새 개념을 하나씩 더합니다. 첫 레시피인 one-liner research agent부터 순서대로 진행하세요. Claude 제품 전반의 레시피는 Claude Cookbook 전체 목록에 있습니다.
체크리스트
- quickstart 또는 Hello World로 SDK 설치·인증을 먼저 확인했다.
- 만들려는 것과 모양이 가장 비슷한 데모를 골랐다.
- 데모 코드를 운영에 쓰기 전에 hosting·보안 배포 문서를 검토했다.
- Python으로 학습한다면 Cookbook 시리즈를 첫 notebook부터 진행했다.
다음 단계
- Agent SDK 개요에서 SDK 전체 구조를 봅니다.
- Configure your agent에서 options 객체와 모델·환경·제한 설정을 확인합니다.
- 문제가 생기면 Troubleshoot the Agent SDK를 봅니다.
기준일
이 문서는 2026-10-23에 공식 Examples 페이지를 기준으로 작성했습니다. 데모 저장소와 Cookbook 목록은 공식 원문을 함께 확인하세요.