---
title: Claude Agent SDK — MCP 프로토콜
date: 2026-10-18
time: 12:00
model: admin
category: programs
author_type: human
summary: Claude Code와 동일한 에이전트 런타임으로 커스텀 에이전트를 만드는 Anthropic 공식 SDK.
tags: 프로그램, MCP 프로토콜, claude-agent-sdk
---

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

## 기본 정보

| 프로그램 이름 | Claude Agent SDK (클라우드 에이전트 SDK) |
| --- | --- |
| 한 줄 소개 | Claude 기반 커스텀 에이전트를 만드는 공식 SDK |
| 개발·유지 | Anthropic |
| 공식 홈페이지 | https://www.anthropic.com/ |
| 공식 문서 | https://docs.anthropic.com/en/api/agent-sdk |
| 설치·배포 | pip install claude-agent-sdk |
| 동작 환경 | Python 3.10+ · Node.js 18+ |
| 라이선스 | MIT 라이선스 |
| 안정 버전 | PyPI 0.2.168 (2026-10 확인) — 확인일 2026-10-18 |
| GitHub 저장소 | https://github.com/anthropics/claude-code |
| 분류 | MCP 프로토콜 (태그: MCP, 에이전트, Claude, Anthropic, 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 계정 필요
## 비슷한 프로그램과 비교

| 프로그램 | 특징 | 이런 경우에 적합 |
| --- | --- | --- |
| Claude Code CLI | 터미널 직접 사용 | 대화형 개발 |
| OpenAI Agents | OpenAI 에이전트 SDK | GPT 기반 |

## 공식 자료 및 추가 학습

- [공식 홈페이지](https://www.anthropic.com/) — https://www.anthropic.com/
- [공식 문서 / 지식베이스](https://docs.anthropic.com/en/api/agent-sdk) — https://docs.anthropic.com/en/api/agent-sdk
- [설치·배포](pip install claude-agent-sdk) — pip install claude-agent-sdk
- [릴리스 노트](https://github.com/anthropics/claude-code/releases) — https://github.com/anthropics/claude-code/releases
- [소스 / 개발 자료](https://github.com/anthropics/claude-code) — https://github.com/anthropics/claude-code
버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

## 실제 실행 화면

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

![Claude Agent SDK 사용 예시](https://games.cursorai.co.kr/assets/claude-agent-sdk-demo.png)

실제 운영 중인 서버

---
원문(HTML): https://games.cursorai.co.kr/programs/mcp/protocol/claude-agent-sdk.html