ММООЗЗГГ.ru

Разбор

OpenAI Agents SDK и Claude Agent SDK: наборы для сборки агентов

7 мин22 источника

OpenAI Agents SDK и Claude Agent SDK это наборы кода для разработчиков, на которых собирают агентов с инструментами и передачей задач. OpenAI выпустила свой набор 11 марта 2025 года, Anthropic переименовала Claude Code SDK в Claude Agent SDK 29 сентября 2025 года. Ниже разница между ними и путь для компании в России: открытые модели на своем сервере.

На странице · 5 разделов

Нужен разработчик

OpenAI Agents SDK

SDK (software development kit) это набор готового кода и инструментов для программиста. OpenAI выпустила Agents SDK 11 марта 2025 года вместе с Responses API, у которого встроен поиск по файлам и в интернете.

В основе три понятия. Агент это модель с инструкцией и инструментами. Передача задачи (handoff) позволяет одному агенту отдать работу другому или вызвать его как инструмент. Ограничители (guardrails) проверяют, что приходит агенту и что он отвечает.

Вокруг них сессии (память разговора), трассировка (запись каждого шага агента для разбора ошибок), подключение серверов MCP и подтверждение действий человеком.

Код открыт по лицензии MIT: его можно использовать и менять в коммерческих проектах. Установка одной командой pip install openai-agents, ключ модели передается в переменной OPENAI_API_KEY.

Набор работает не только с моделями OpenAI. Документация описывает подключение любого поставщика с API, совместимым с OpenAI, через свой адрес и ключ, а также адаптеры LiteLLM и Any-LLM, пока в бета-версии.

Трассировка по умолчанию отправляет записи в OpenAI. Без ключа OpenAI документация советует отключить ее функцией set_tracing_disabled() или подключить свой обработчик записей.

Claude Agent SDK

Claude Agent SDK вырос из Claude Code, агента Anthropic для программистов. 29 сентября 2025 года Anthropic переименовала Claude Code SDK в Claude Agent SDK: цикл «собрать контекст, сделать действие, проверить результат, повторить» и подключение внешних сервисов через MCP. MCP это открытый стандарт подключения ИИ к данным и сервисам.

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

Сверху хуки (свой код в ключевых точках работы агента), субагенты (вспомогательные агенты для отдельных подзадач), права (какие инструменты работают сами, а какие ждут одобрения) и сессии, которые можно продолжить позже.

Требования: Python 3.10 или Node.js 18 и новее. Установка: pip install claude-agent-sdk или npm install @anthropic-ai/claude-agent-sdk. Доступ к модели по ключу ANTHROPIC_API_KEY или через облака Amazon Bedrock, Google Cloud и Microsoft Foundry.

Условия другие, чем у OpenAI: использование набора регулируют коммерческие условия Anthropic, в том числе когда вы строите на нем продукт для своих клиентов. Вход через учетную запись claude.ai сторонним продуктам без разрешения Anthropic запрещен, только ключ API.

Чем отличаются

Набор OpenAI это легкий каркас: инструменты пишете вы, и вы решаете, где агент работает. Главная идея в передаче задач между агентами и проверках на входе и выходе.

Claude Agent SDK это готовый агент Claude Code в виде библиотеки. Он с первого запуска работает с файлами и командами, поэтому подходит для задач, где агенту нужен компьютер: разобрать документы в папке, подготовить отчет, поправить код.

Модели. Набор OpenAI по документации подключает других поставщиков и локальные модели с совместимым API. Claude Agent SDK в документации работает с моделями Claude через API Anthropic или через облака-посредники.

Лицензия. Код набора OpenAI открыт по MIT. Claude Agent SDK используют на коммерческих условиях Anthropic.

Общее у обоих: цикл агента, инструменты, подключение по MCP и запись шагов. Третий путь для разработчика, открытые библиотеки LangChain и LangGraph, не привязан к одному поставщику моделей.

Что проверить до выбора набора

Набор для разработки выбирают последним. Сначала отвечают на пять вопросов о процессе, данных и людях, и часто ответы решают выбор сами.

Нужен ли агент вообще. Anthropic в разборе от 19 декабря 2024 года советует начинать с самого простого решения и усложнять, только когда простое не справляется. Если шаги процесса известны заранее, хватит обычного сценария, где порядок задан кодом, без цикла агента.

Где работает модель. Если модель должна стоять на вашем сервере, выбор почти сделан: набор OpenAI по документации подключает локальные модели через Ollama, а для Claude Agent SDK такого пути в документации нет.

Какие данные пойдут в запросы. Трассировка набора OpenAI включена по умолчанию: она записывает ответы модели, вызовы инструментов и передачу задач между агентами и отправляет записи в OpenAI. Для проекта с данными клиентов ее отключают в коде или переменной OPENAI_AGENTS_DISABLE_TRACING.

Какие действия агент делает сам. OpenAI в руководстве по сборке агентов от апреля 2025 года советует передавать задачу человеку перед рискованными действиями: отменой заказа, крупным возвратом, платежом. В наборе OpenAI для этого есть параметр needs_approval: агент останавливается, пока человек не одобрит вызов или не отклонит его. В Claude Agent SDK ту же роль играют права на инструменты.

Кто будет поддерживать код. Набор для разработки это библиотека без экранов и кнопок: каждую правку после запуска делает программист. Если своего разработчика нет, разумнее начать с визуальной платформы n8n, которую ставят на свой сервер.

Отдельно считают расход. Anthropic в разборе от 13 июня 2025 года пишет, что агент тратит примерно в 4 раза больше токенов, чем чат, а система из нескольких агентов примерно в 15 раз больше. Передача задач между агентами удобна, но каждый лишний агент умножает счет за модель или нагрузку на ваш сервер.

Пример из документации OpenAI: в поддержке первый агент принимает обращение и передает его агентам по статусу заказа, по возвратам и по частым вопросам. Для интернет-магазина это та же схема, что у живой линии поддержки, только каждого «сотрудника» описывают в коде.

Доступность в России и открытые модели

России нет в списке стран, где работает API OpenAI. Документация OpenAI предупреждает, что доступ из стран вне списка может закончиться блокировкой учетной записи.

У Anthropic так же: в политике поддерживаемых регионов от 12 мая 2026 года России нет, а все, чего нет в списке, не поддерживается.

Есть и вопрос данных. В базовой настройке оба набора отправляют запросы на серверы поставщика модели за рубежом. Если в запросах персональные данные клиентов, по 152-ФЗ до трансграничной передачи оператор подает уведомление в Роскомнадзор, а сбор и хранение данных граждан России ведутся в базах на территории России. Как мы это решаем, описано на странице о безопасности данных.

Практичный путь: открытые модели на своем компьютере или сервере через Ollama. Ollama отдает модели через API, совместимый с OpenAI, по адресу http://localhost:11434/v1/. Ключ API клиент требует, но Ollama его не проверяет. Модель сначала скачивают командой ollama pull.

Для набора OpenAI это штатный путь из документации: свой клиент с адресом Ollama через set_default_openai_client или модель OpenAIChatCompletionsModel, трассировка в OpenAI отключена. Код по MIT, модель и данные остаются у вас.

Ollama отвечает и в формате API Anthropic: ее документация описывает подключение Claude Code к локальным моделям через переменную ANTHROPIC_BASE_URL. Для Claude Agent SDK такой инструкции мы не нашли ни у Anthropic, ни у Ollama, а часть функций, например кэширование запросов, Ollama не поддерживает.

Как устроены агенты на локальной модели и какой сервер для них нужен, мы разобрали отдельно.

Вопросы и ответы

Можно ли использовать OpenAI Agents SDK без моделей OpenAI?

Да. Документация набора описывает подключение любого поставщика с API, совместимым с OpenAI, через свой адрес и ключ, в том числе Ollama на вашем компьютере по адресу http://localhost:11434/v1/. Трассировку в OpenAI в этом случае отключают функцией set_tracing_disabled() или переменной окружения. Код набора открыт по лицензии MIT.

Claude Agent SDK можно использовать бесплатно в своем продукте?

Репозиторий набора на GitHub помечен лицензией MIT, но использование регулируют коммерческие условия Anthropic, в том числе когда вы строите на нем продукт для своих клиентов. Сам набор обращается к моделям Claude через API Anthropic или облака-посредники. России в политике поддерживаемых регионов Anthropic от 12 мая 2026 года нет.

Чем наборы OpenAI и Anthropic отличаются от LangChain?

LangChain это открытая библиотека, которую выпускает не поставщик моделей. Модель в ней задается одной строкой, а поддерживаются OpenAI, Anthropic, Google и открытые модели через Ollama. Смена поставщика в такой схеме означает смену строки и пакета, а не переписывание агента.

Когда нужна команда агентов, а когда хватит одного?

Документация LangChain отмечает, что один агент с правильными инструментами и инструкцией часто дает похожий результат. Команда полезна, когда у одного агента слишком много инструментов, нужен жесткий порядок шагов или параллельная работа. Каждый дополнительный агент увеличивает расход: по оценке Anthropic, система из нескольких агентов тратит примерно в 15 раз больше токенов, чем чат.

Источники и проверка

Проверено редакцией 16 октября 2026.

  1. OpenAI, 11 марта 2025 (openai.com)
  2. Claude Blog, 29 сентября 2025 (claude.com)
  3. Brace Law Firm, 9 июля 2023 (brace-lf.com)
  4. OpenAI Agents SDK Docs, 2026 (openai.github.io)
  5. GitHub, openai/openai-agents-python, LICENSE, 2025 (github.com)
  6. OpenAI Agents SDK Docs, Models, 2026 (openai.github.io)
  7. Claude Code Docs, Agent SDK overview, 2026 (code.claude.com)
  8. Claude Code Docs, Agent SDK quickstart, 2026 (code.claude.com)
  9. Anthropic, Supported Regions Policy, 12 мая 2026 (anthropic.com)
  10. OpenAI, Supported countries and territories, 2026 (developers.openai.com)
  11. Ollama Docs, OpenAI compatibility, 2026 (docs.ollama.com)
  12. Ollama Docs, Anthropic compatibility, 2026 (docs.ollama.com)
  13. Документация OpenAI Agents SDK: Quickstart, проверено 16 октября 2026 (openai.github.io)
  14. Anthropic, 19 декабря 2024 (anthropic.com)
  15. OpenAI, A practical guide to building agents, апрель 2025 (cdn.openai.com)
  16. OpenAI Agents SDK Docs, Tracing, 2026 (openai.github.io)
  17. OpenAI Agents SDK Docs, Human-in-the-loop, 2026 (openai.github.io)
  18. OpenAI Agents SDK Docs, Handoffs, 2026 (openai.github.io)
  19. Anthropic, 13 июня 2025 (anthropic.com)
  20. GitHub, anthropics/claude-agent-sdk-python, 2026 (github.com)
  21. LangChain Docs, Overview, 2026 (docs.langchain.com)
  22. LangChain Docs, Multi-agent, 2026 (docs.langchain.com)

Нашли ошибку? Напишите нам

Публикации

Как создать чат-бот в Максе: инструкция для компании

Чтобы создать чат-бот в Максе, компании нужно пройти четыре шага на платформе MAX для партнеров: проверить профиль организации через Госуслуги, заполнить карточку бота, дождаться модерации до 48 часов по рабочим дням и собрать сценарий в конструкторе или своим кодом. Ниже каждый шаг по документации MAX, проверенной 16 октября 2026 года, а также как связать бота с сайтом, CRM и командой и на чем бо

ИнструкцияИТСредний11 мин
Написать в Telegram