Claude Agent SDK — MCP 프로토콜

MCP·Skill / MCP 프로토콜 / claude-agent-sdk.html

Claude 기반 커스텀 에이전트를 만드는 공식 SDK

기본 정보

이 프로그램은 무엇인가?

Claude Agent SDK는 Claude Code 터미널 에이전트와 동일한 런타임을 프로그래밍 방식으로 사용하는 공식 SDK입니다. 도구 호출·파일 작업·MCP 연결을 포함한 에이전트 루프를 제공합니다.

Python과 TypeScript 두 버전이 있으며, 기존 Claude Code 스킬·MCP 설정을 그대로 재사용할 수 있습니다.

어떤 문제를 해결하는가?

• ('커스텀 에이전트에서', 'Claude 기반 특수 목적 에이전트를 만들어야 할 때', '공식 에이전트 런타임 사용')
• ('자동화에서', '터미널 에이전트를 코드로 제어해야 할 때', 'SDK로 에이전트 루프 호출')

주요 기능

에이전트 루프

Claude Code와 동일한 에이전트 루프 제공

• 활용 상황: 검증된 에이전트 동작
• 얻는 결과: 도구 호출·리트리
• 제한 사항: 토큰 비용 관리

MCP·스킬 통합

기존 MCP·스킬 설정 재사용

• 활용 상황: 에이전트 기능 확장
• 얻는 결과: 설정 공유
• 제한 사항: 권한 설정 주의

설치 및 실행

pip

pip로 설치합니다.

pip install claude-agent-sdk

npm

npm으로 설치합니다.

npm install @anthropic-ai/claude-agent-sdk

실제 사용 예제

에이전트 호출

SDK로 에이전트를 실행합니다.

from claude_agent_sdk import query

장점과 한계

장점

• Anthropic 공식 SDK
• Claude Code 런타임 재사용
• MIT 라이선스

사용 전에 고려할 점

• Claude API 비용 발생
• Anthropic 계정 필요

비슷한 프로그램과 비교

공식 자료 및 추가 학습

• 공식 홈페이지 — https://www.anthropic.com/
• 공식 문서 / 지식베이스 — https://docs.anthropic.com/en/api/agent-sdk
• 설치·배포 — pip install claude-agent-sdk
• 릴리스 노트 — https://github.com/anthropics/claude-code/releases
• 소스 / 개발 자료 — https://github.com/anthropics/claude-code

버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

실제 실행 화면

합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

실제 운영 중인 서버

이 문서는 화면 표시용 가상 디렉터리의 항목입니다. 실제 서버 파일시스템과 연결되지 않으며, 파일 실행이나 시스템 명령을 수행하지 않습니다.