Agent 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로 구축한 실제 에이전트를 탐색하세요:

기능

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

Claude Code 기능

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

시작하기

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

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 파일에 표시된 대로 다른 라이선스에 의해 적용되는 경우는 제외합니다.

다음 단계