---
title: "Claude Agent SDK: 기능, 버전, Quickstart · DotsAgent"
description: "Anthropic의 Claude Agent SDK: 라이선스, 최신 버전, MCP 지원, 내구성 있는 실행, 사람의 승인, 추적 및 평가 기능을 확인하고 복사해 쓸 수 있는 Quickstart를 살펴보세요."
url: https://dotsagent.io/ko/frameworks/claude-agent-sdk
---

프레임워크 · Anthropic

# Claude Agent SDK 한눈에 보기

Anthropic의 SDK는 Claude Code를 통해 하네스를 제공하며, 파일 및 셸 도구, 권한, 훅, 서브에이전트, 스킬을 자체 Python 또는 TypeScript 프로그램에서 사용할 수 있습니다. 이 목록의 다른 항목과 달리 Claude 모델만 실행하며, 사용에는 Anthropic의 상업용 약관이 적용됩니다.

**추천 용도:**  사용자가 제어하는 도구 권한 아래에서 Claude가 파일 시스템의 실제 작업을 수행해야 하는 앱.

## 주요 정보

- **관리자**: Anthropic
- **언어**: Python, TypeScript
- **라이선스**: Anthropic Commercial Terms
- **최신 버전**: `Python 0.2.163 / TypeScript 0.3.286` · 2026년 9월 30일
- **저장소**: [anthropics/claude-agent-sdk-python](https://github.com/anthropics/claude-agent-sdk-python) · 별 8,200개
- **호스팅 옵션**: [Claude Managed Agents](https://code.claude.com/docs/en/agent-sdk/overview)Anthropic이 하네스를 호스팅하며, 세션은 Anthropic이 관리하는 샌드박스 또는 자체 호스팅 샌드박스에서 실행됩니다.

## Quickstart

패키지를 설치하고 인증 정보를 설정한 다음, 공식 문서에서 가장 간단한 에이전트를 실행하세요. 모델 ID는 문서에서 사용하는 값이며 계정에서 활성화되지 않았을 수 있습니다.

### Python

`설치`

```
pip install claude-agent-sdk
```

ANTHROPIC_API_KEY 필요

`Python`

```
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())
```

[Quickstart 출처](https://code.claude.com/docs/en/agent-sdk/overview)

### TypeScript

`설치`

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

ANTHROPIC_API_KEY 필요

`TypeScript`

```
import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Find and fix the bug in auth.ts",
  options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
  console.log(message); // Claude reads the file, finds the bug, edits it
}
```

[Quickstart 출처](https://code.claude.com/docs/en/agent-sdk/overview)

## 기능

| 모든 모델 | — | Anthropic, Bedrock, Google Cloud 또는 Foundry를 통해 Claude만 지원 |
| --- | --- | --- |
| MCP 클라이언트 | — | mcpServers 옵션을 제공하며, 플러그인에 MCP 서버를 포함할 수 있습니다. |
| MCP 서버 | — | — |
| 멀티 에이전트 | — | 서브에이전트가 특정 하위 작업을 처리합니다. |
| 내구성 있는 실행 | — | 세션을 재개하거나 분기할 수 있지만, 내구성 엔진은 없습니다. |
| 사람의 승인 | — | 권한 모드에 따라 승인이 필요한 도구가 결정됩니다. |
| 트레이싱 | — | OpenTelemetry 내보내기를 지원하며, 트레이스는 베타입니다. |
| Evals | — | — |

## 최근 변경 사항

- Claude Code SDK에서 이름이 변경되었으며, 마이그레이션 가이드를 제공합니다.
- 두 SDK 모두 이제 기본 Claude Code 바이너리를 포함합니다.
- 15 June 2026부터 구독 요금제에서 SDK를 사용하면 별도의 월간 Agent SDK 크레딧이 차감됩니다.
- Anthropic의 승인 없이 타사 앱에서 claude.ai 로그인을 제공할 수 없습니다.

## 같은 언어로 만든 대안

- [OpenAI Agents SDK](https://dotsagent.io/ko/frameworks/openai-agents-python)

- [OpenAI Agents SDK (JS)](https://dotsagent.io/ko/frameworks/openai-agents-js)

- [Google ADK](https://dotsagent.io/ko/frameworks/google-adk)

- [Microsoft Agent Framework](https://dotsagent.io/ko/frameworks/microsoft-agent-framework)

- [LangGraph](https://dotsagent.io/ko/frameworks/langgraph)

- [CrewAI](https://dotsagent.io/ko/frameworks/crewai)

## 출처

1. [code.claude.com](https://code.claude.com/docs/en/agent-sdk/overview)/docs/en/agent-sdk/overview
2. [code.claude.com](https://code.claude.com/docs/en/agent-sdk/quickstart)/docs/en/agent-sdk/quickstart
3. [code.claude.com](https://code.claude.com/docs/en/agent-sdk/observability)/docs/en/agent-sdk/observability
4. [code.claude.com](https://code.claude.com/docs/en/bedrock-vertex)/docs/en/bedrock-vertex
5. [pypi.org](https://pypi.org/pypi/claude-agent-sdk/json)/pypi/claude-agent-sdk/json
6. [registry.npmjs.org](https://registry.npmjs.org/@anthropic-ai%2fclaude-agent-sdk)/@anthropic-ai%2fclaude-agent-sdk
7. [api.github.com](https://api.github.com/repos/anthropics/claude-agent-sdk-python)/repos/anthropics/claude-agent-sdk-python
8. [api.github.com](https://api.github.com/repos/anthropics/claude-agent-sdk-typescript)/repos/anthropics/claude-agent-sdk-typescript

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일