Repolode
anthropics

anthropics/claude-agent-sdk-python

query(), 대화형 클라이언트, 프로세스 내 커스텀 도구와 훅을 제공하는 Claude Code 에이전트 구축용 Python SDK입니다.

스타
8,304
포크
1,363
열린 이슈
571
마지막 커밋
어제

어떤 프로젝트인가요?

Claude Agent SDK for Python을 사용하면 Python 애플리케이션에서 Claude Code를 프로그래밍 방식으로 실행할 수 있습니다. pip로 설치한 다음 query()를 호출해 프롬프트를 보내고 스트리밍 응답 메시지를 순회하거나, ClaudeSDKClient를 사용해 양방향 멀티턴 대화를 진행할 수 있습니다.

이 패키지에는 Claude Code CLI가 포함되어 있어 기본적으로 별도 설치가 필요하지 않습니다. 다만 시스템 전체에 설치하거나 특정 CLI 경로를 설정할 수도 있습니다. 기본적으로 Claude는 Read, Write, Edit, Bash 같은 Claude Code 도구 전체를 사용할 수 있으며, allowed_tools, disallowed_tools, permission_mode로 승인 방식을 제어할 수 있습니다.

ClaudeSDKClient를 사용하면 프로세스 내 MCP 서버로 실행되는 Python 함수 형태의 커스텀 도구를 정의하고, Bash 명령 실행 전 차단처럼 에이전트 루프의 특정 시점에 실행되는 훅을 등록할 수 있습니다. 결과를 처리할 수 있도록 타입이 지정된 옵션, 메시지 클래스, 오류 클래스도 제공됩니다.

핵심 기능

  • 01비동기 query() 함수로 Claude Code의 응답을 스트리밍합니다.
  • 02ClaudeSDKClient로 멀티턴 대화형 세션을 실행합니다.
  • 03Python 데코레이터를 사용해 프로세스 내 MCP 서버 형태의 커스텀 도구를 정의합니다.
  • 04에이전트 루프의 특정 시점에 실행되는 Python 훅을 등록합니다.
  • 05허용 및 차단 도구 목록과 권한 모드로 도구 권한을 제어합니다.

활용 사례

  • Python 애플리케이션이나 내부 도구에 Claude 코딩 에이전트를 통합합니다.
  • Claude가 호출할 수 있는 도메인별 Python 함수를 도구로 추가합니다.
  • 훅을 사용해 특정 셸 명령을 차단하는 등의 정책을 적용합니다.
  • 프로젝트 디렉터리에서 Claude Code를 실행하는 자동화 워크플로를 구축합니다.

빠른 시작

  1. 1

    PyPI에서 SDK를 설치합니다

    pip install claude-agent-sdk
  2. 2

    README의 빠른 시작 코드를 Python 파일로 저장한 다음 anyio로 실행합니다

사용 전 알아둘 점

  • 사용에는 MIT 라이선스만이 아니라 Anthropic의 Commercial Terms of Service가 적용됩니다.
  • Python 3.10 이상이 필요합니다.
  • Claude에 쿼리하려면 Anthropic 서비스에 대한 액세스 권한과 자격 증명이 필요합니다.

토픽

자주 묻는 질문

claude-agent-sdk-python은(는) 무엇인가요?
query(), 대화형 클라이언트, 프로세스 내 커스텀 도구와 훅을 제공하는 Claude Code 에이전트 구축용 Python SDK입니다. Claude Agent SDK for Python을 사용하면 Python 애플리케이션에서 Claude Code를 프로그래밍 방식으로 실행할 수 있습니다. pip로 설치한 다음 query()를 호출해 프롬프트를 보내고 스트리밍 응답 메시지를 순회하거나, ClaudeSDKClient를 사용해 양방향 멀티턴 대화를 진행할 수 있습니다.
claude-agent-sdk-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
claude-agent-sdk-python은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
claude-agent-sdk-python은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. claude-agent-sdk-python의 마지막 커밋은 2026년 10월 19일입니다.
claude-agent-sdk-python은(는) 어디에 사용할 수 있나요?
Python 애플리케이션이나 내부 도구에 Claude 코딩 에이전트를 통합합니다. Claude가 호출할 수 있는 도메인별 Python 함수를 도구로 추가합니다. 훅을 사용해 특정 셸 명령을 차단하는 등의 정책을 적용합니다. 프로젝트 디렉터리에서 Claude Code를 실행하는 자동화 워크플로를 구축합니다.
claude-agent-sdk-python는 어떻게 설치하나요?
PyPI에서 SDK를 설치합니다: pip install claude-agent-sdk README의 빠른 시작 코드를 Python 파일로 저장한 다음 anyio로 실행합니다
claude-agent-sdk-python은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/anthropics/claude-agent-sdk-python

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트