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 · 별 8,200개

호스팅 옵션

Claude Managed Agents

Anthropic이 하네스를 호스팅하며, 세션은 Anthropic이 관리하는 샌드박스 또는 자체 호스팅 샌드박스에서 실행됩니다.

Quickstart

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

Python

pip install claude-agent-sdk

ANTHROPIC_API_KEY 필요

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 출처

TypeScript

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

ANTHROPIC_API_KEY 필요

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 출처

기능

최근 변경 사항

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

같은 언어로 만든 대안