Repolode
Предложить
anthropics

anthropics/claude-agent-sdk-python

Python SDK для создания агентов на базе Claude Code: query(), интерактивный клиент, собственные инструменты и хуки в процессе.

Открыть на GitHub
Звёзды
8,304
Форки
1,363
Открытые issues
571
Последний коммит
17 часов назад

Что это?

Claude Agent SDK for Python позволяет Python-приложениям программно управлять Claude Code. Установите пакет через pip и вызовите query(), чтобы отправить запрос и получать потоковые сообщения ответа, или используйте ClaudeSDKClient для двусторонних диалогов с несколькими ходами.

Пакет включает Claude Code CLI, поэтому обычно устанавливать его отдельно не нужно. При этом можно настроить системную установку CLI или указать путь к конкретному файлу. По умолчанию Claude доступны все инструменты Claude Code, например Read, Write, Edit и Bash; параметры allowed_tools, disallowed_tools и permission_mode определяют, для каких действий нужно подтверждение.

С помощью ClaudeSDKClient можно объявлять собственные инструменты в виде функций Python, работающих как MCP-серверы в процессе, и регистрировать хуки, которые срабатывают на разных этапах цикла агента, например блокируют команду Bash до её выполнения. Для обработки результатов предусмотрены типизированные параметры, классы сообщений и классы ошибок.

Ключевые возможности

  • 01Получайте потоковые ответы Claude Code с помощью асинхронной функции query().
  • 02Запускайте интерактивные сессии с несколькими ходами через ClaudeSDKClient.
  • 03Создавайте собственные инструменты в виде MCP-серверов в процессе с помощью декоратора Python.
  • 04Регистрируйте хуки Python, срабатывающие на разных этапах цикла агента.
  • 05Управляйте разрешениями на использование инструментов с помощью списков разрешённых и запрещённых инструментов и режимов разрешений.

Сценарии использования

  • Встраивание агента для написания кода на базе Claude в Python-приложение или внутренний инструмент.
  • Добавление предметно-ориентированных функций Python в качестве инструментов, которые может вызывать Claude.
  • Применение политик, например блокировка определённых команд оболочки с помощью хуков.
  • Создание автоматизированных сценариев, в которых Claude Code работает с каталогом проекта.

Быстрый старт

  1. 1

    Установите SDK из PyPI

    pip install claude-agent-sdk
  2. 2

    Сохраните код быстрого старта из README в файл Python и запустите его с помощью anyio

Что важно знать

  • Использование регулируется Commercial Terms of Service Anthropic, а не только лицензией MIT.
  • Требуется Python версии 3.10 или выше.
  • Для запросов к Claude необходимы доступ к сервису Anthropic и учетные данные.

Темы

#ai#agent#llm#claude#python-sdk#mcp#anthropic

Частые вопросы

Что такое claude-agent-sdk-python?
Python SDK для создания агентов на базе Claude Code: query(), интерактивный клиент, собственные инструменты и хуки в процессе. 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 — 19 окт. 2026 г..
Для чего можно использовать claude-agent-sdk-python?
Встраивание агента для написания кода на базе Claude в Python-приложение или внутренний инструмент. Добавление предметно-ориентированных функций Python в качестве инструментов, которые может вызывать Claude. Применение политик, например блокировка определённых команд оболочки с помощью хуков. Создание автоматизированных сценариев, в которых Claude Code работает с каталогом проекта.
Как установить claude-agent-sdk-python?
Установите SDK из PyPI: pip install claude-agent-sdk Сохраните код быстрого старта из README в файл Python и запустите его с помощью anyio
Где скачать claude-agent-sdk-python?
Исходный код и инструкции по установке — на GitHub: https://github.com/anthropics/claude-agent-sdk-python

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты