일반 .chat.md 파일을 MCP 도구를 지원하는 편집 가능한 AI 채팅 세션으로 바꿔 주는 VS Code 확장 프로그램입니다.
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
PyPI에서 SDK를 설치합니다
pip install claude-agent-sdk - 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 통계는 매일 갱신됩니다.
관련 프로젝트
FastGPT는 LLM 앱을 위한 데이터 처리, RAG 지식 베이스, 시각적 워크플로 오케스트레이션을 제공하는 오픈소스 AI Agent 구축 플랫폼입니다.
LLM 에이전트의 대화와 실행을 Python 및 TypeScript 앱에서 활용할 수 있는 영구적이고 구조화된 메모리로 바꾸는 에이전트 네이티브 메모리 인프라입니다.
AI 에이전트를 위해 만든 오픈소스 Chromium 기반 브라우저로, 로컬에서 실행되며 로그인된 계정을 사용해 여러 탭에서 에이전트를 병렬로 작업하게 합니다.
디지털 휴먼(2.5D, 3D, 모바일, PC, 웹)과 LLM(OpenAI 호환, DeepSeek)을 비즈니스 시스템에 연결하는 에이전트 프레임워크입니다.