설치와 시작하기
설치와 시작하기
Claude Agent SDK를 쓰는 첫 단계는 패키지를 설치하고 API 키를 세팅하는 일이에요. npm으로 타입스크립트 패키지를 받아 쓰는 흐름이 가장 흔해요.
출처: https://github.com/anthropics/claude-agent-sdk-typescript
설치는 다음 한 줄이면 끝나요.
npm install @anthropic-ai/claude-agent-sdk
패키지를 설치한 뒤에는 Anthropic API 키를 환경 변수로 설정하고, 에이전트 코드를 작성하면 돼요. SDK는 파이썬에서 pip install로, 타입스크립트에서 npm으로 받아 쓸 수 있어요. 어느 쪽이든 에이전트 루프를 내 애플리케이션에 그대로 심는다는 점은 같아요.
참고로 이전에 Claude Code SDK로 개발했다면, 지금은 Claude Agent SDK로 이름이 바뀌었어요. 마이그레이션 가이드가 공식 문서에 있으니 깨지는 변경 사항을 확인하고 옮기면 돼요.
에이전트를 처음부터 만드는 입문 예제(코드에서 버그를 찾아 고치는 에이전트)는 공식 퀵스타트에 준비되어 있어요. SDK 설치, API 키 설정부터 첫 에이전트 구동까지 한 번에 확인할 수 있죠.
직접 도구 루프를 짤 필요 없이, Claude Code와 같은 수준의 작업(파일 편집·명령 실행)을 코드로 제어하고 싶다면 이 SDK가 딱 맞아요.