Agent SDK

Agent SDK 개요

Claude Code를 라이브러리로 사용하여 프로덕션 AI 에이전트 구축

Claude Code SDK가 Claude Agent SDK로 이름이 변경되었습니다. 이전 SDK에서 마이그레이션하는 경우 마이그레이션 가이드를 참조하세요.

파일 읽기, 명령 실행, 웹 검색, 코드 편집 등을 자율적으로 수행하는 AI 에이전트를 구축하세요. Agent SDK는 Claude Code를 구동하는 동일한 도구, 에이전트 루프, 컨텍스트 관리를 Python과 TypeScript에서 프로그래밍 가능하게 제공합니다.

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())

Agent SDK에는 파일 읽기, 명령 실행, 코드 편집을 위한 내장 도구가 포함되어 있어 도구 실행을 직접 구현하지 않아도 에이전트가 즉시 작업을 시작할 수 있습니다. 빠른 시작 가이드를 살펴보거나 SDK로 구축된 실제 에이전트를 탐색해 보세요:

빠른 시작

몇 분 만에 버그 수정 에이전트 구축

예제 에이전트

이메일 어시스턴트, 리서치 에이전트 등

시작하기

SDK 설치
API 키 설정
Console에서 API 키를 받은 다음 환경 변수로 설정하세요:
export ANTHROPIC_API_KEY=your-api-key
SDK는 타사 API 제공업체를 통한 인증도 지원합니다:
- Amazon Bedrock: CLAUDE_CODE_USE_BEDROCK=1 환경 변수를 설정하고 AWS 자격 증명을 구성하세요
- Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1 환경 변수를 설정하고 Google Cloud 자격 증명을 구성하세요
- Microsoft Azure: CLAUDE_CODE_USE_FOUNDRY=1 환경 변수를 설정하고 Azure 자격 증명을 구성하세요
자세한 내용은 Bedrock, Vertex AI, 또는 Azure AI Foundry 설정 가이드를 참조하세요.
사전 승인되지 않은 한, Anthropic은 Claude Agent SDK로 구축된 에이전트를 포함하여 타사 개발자가 자사 제품에 claude.ai 로그인 또는 요금 제한을 제공하는 것을 허용하지 않습니다. 대신 이 문서에 설명된 API 키 인증 방법을 사용하세요.

첫 번째 에이전트 실행

이 예제는 내장 도구를 사용하여 현재 디렉토리의 파일을 나열하는 에이전트를 생성합니다.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

구축할 준비가 되셨나요? 빠른 시작을 따라 몇 분 만에 버그를 찾아 수정하는 에이전트를 만들어 보세요.

기능

Claude Code를 강력하게 만드는 모든 것이 SDK에서 사용 가능합니다:

Claude Code 기능

SDK는 Claude Code의 파일 시스템 기반 구성도 지원합니다. 이러한 기능을 사용하려면 옵션에서 setting_sources=["project"] (Python) 또는 settingSources: ['project'] (TypeScript)를 설정하세요.

기능	설명	위치
스킬	Markdown으로 정의된 전문화된 기능	`.claude/skills/SKILL.md`
슬래시 명령	일반적인 작업을 위한 커스텀 명령	`.claude/commands/*.md`
메모리	프로젝트 컨텍스트 및 지침	`CLAUDE.md` 또는 `.claude/CLAUDE.md`
플러그인	커스텀 명령, 에이전트, MCP 서버로 확장	`plugins` 옵션을 통한 프로그래밍 방식

Agent SDK와 다른 Claude 도구 비교

Claude 플랫폼은 Claude로 구축하는 여러 가지 방법을 제공합니다. Agent SDK가 어떻게 적합한지 살펴보세요:

변경 로그

SDK 업데이트, 버그 수정, 새로운 기능에 대한 전체 변경 로그를 확인하세요:

TypeScript SDK: CHANGELOG.md 보기
Python SDK: CHANGELOG.md 보기

버그 보고

Agent SDK에서 버그나 문제를 발견한 경우:

TypeScript SDK: GitHub에서 이슈 보고
Python SDK: GitHub에서 이슈 보고

브랜딩 가이드라인

Claude Agent SDK를 통합하는 파트너의 경우 Claude 브랜딩 사용은 선택 사항입니다. 제품에서 Claude를 참조할 때:

허용:

"Claude Agent" (드롭다운 메뉴에 권장)
"Claude" (이미 "Agents"로 레이블이 지정된 메뉴 내에서)
"{YourAgentName} Powered by Claude" (기존 에이전트 이름이 있는 경우)

허용되지 않음:

"Claude Code" 또는 "Claude Code Agent"
Claude Code 브랜드 ASCII 아트 또는 Claude Code를 모방하는 시각적 요소

귀하의 제품은 자체 브랜딩을 유지해야 하며 Claude Code 또는 Anthropic 제품으로 보이지 않아야 합니다. 브랜딩 준수에 대한 질문은 영업팀에 문의하세요.

라이선스 및 약관

Claude Agent SDK의 사용은 Anthropic의 상업적 서비스 약관에 의해 규율되며, 이는 귀하가 자체 고객 및 최종 사용자에게 제공하는 제품 및 서비스를 구동하는 데 사용하는 경우를 포함합니다. 단, 특정 구성 요소 또는 종속성이 해당 구성 요소의 LICENSE 파일에 명시된 대로 다른 라이선스에 의해 적용되는 경우는 예외입니다.

다음 단계

빠른 시작

몇 분 만에 버그를 찾아 수정하는 에이전트 구축

예제 에이전트

이메일 어시스턴트, 리서치 에이전트 등

TypeScript SDK

전체 TypeScript API 레퍼런스 및 예제

Python SDK

전체 Python API 레퍼런스 및 예제

Was this page helpful?

Agent SDK

Agent SDK 개요

Claude Code를 라이브러리로 사용하여 프로덕션 AI 에이전트 구축

Claude Code SDK가 Claude Agent SDK로 이름이 변경되었습니다. 이전 SDK에서 마이그레이션하는 경우 마이그레이션 가이드를 참조하세요.

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())

빠른 시작

몇 분 만에 버그 수정 에이전트 구축

예제 에이전트

이메일 어시스턴트, 리서치 에이전트 등

시작하기

SDK 설치
API 키 설정
Console에서 API 키를 받은 다음 환경 변수로 설정하세요:
export ANTHROPIC_API_KEY=your-api-key
SDK는 타사 API 제공업체를 통한 인증도 지원합니다:
- Amazon Bedrock: CLAUDE_CODE_USE_BEDROCK=1 환경 변수를 설정하고 AWS 자격 증명을 구성하세요
- Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1 환경 변수를 설정하고 Google Cloud 자격 증명을 구성하세요
- Microsoft Azure: CLAUDE_CODE_USE_FOUNDRY=1 환경 변수를 설정하고 Azure 자격 증명을 구성하세요
자세한 내용은 Bedrock, Vertex AI, 또는 Azure AI Foundry 설정 가이드를 참조하세요.
사전 승인되지 않은 한, Anthropic은 Claude Agent SDK로 구축된 에이전트를 포함하여 타사 개발자가 자사 제품에 claude.ai 로그인 또는 요금 제한을 제공하는 것을 허용하지 않습니다. 대신 이 문서에 설명된 API 키 인증 방법을 사용하세요.

첫 번째 에이전트 실행

이 예제는 내장 도구를 사용하여 현재 디렉토리의 파일을 나열하는 에이전트를 생성합니다.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

구축할 준비가 되셨나요? 빠른 시작을 따라 몇 분 만에 버그를 찾아 수정하는 에이전트를 만들어 보세요.

기능

Claude Code를 강력하게 만드는 모든 것이 SDK에서 사용 가능합니다:

Claude Code 기능

기능	설명	위치
스킬	Markdown으로 정의된 전문화된 기능	`.claude/skills/SKILL.md`
슬래시 명령	일반적인 작업을 위한 커스텀 명령	`.claude/commands/*.md`
메모리	프로젝트 컨텍스트 및 지침	`CLAUDE.md` 또는 `.claude/CLAUDE.md`
플러그인	커스텀 명령, 에이전트, MCP 서버로 확장	`plugins` 옵션을 통한 프로그래밍 방식