OpenAI Agents SDK
SDK (software development kit) это набор готового кода и инструментов для программиста. OpenAI выпустила Agents SDK 11 марта 2025 года вместе с Responses API, у которого встроен поиск по файлам и в интернете.
В основе три понятия. Агент это модель с инструкцией и инструментами. Передача задачи (handoff) позволяет одному агенту отдать работу другому или вызвать его как инструмент. Ограничителиограничители. Ограничители (guardrails) это проверки и правила вокруг языковой модели, которые не пускают в нее опасные запросы и не выпускают из нее недопустимые ответы и действия. (guardrails) проверяют, что приходит агенту и что он отвечает.
Вокруг них сессии (память разговора), трассировка (запись каждого шага агента для разбора ошибок), подключение серверов MCPMCP. MCP (Model Context Protocol) это открытый стандарт, через который ИИ-приложения подключаются к инструментам и данным: файлам, CRM, базам, сервисам. и подтверждение действий человеком.
Код открыт по лицензии 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 запрещен, только ключ APIAPI-ключ. 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 включена по умолчанию: она записывает ответы модели, вызовы инструментоввызов функций. Вызов функций (function calling) это способ, которым языковая модель просит программу выполнить действие: модель выбирает функцию и заполняет ее параметры, а код приложения выполняет запрос и возвращает результат. и передачу задач между агентами и отправляет записи в 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-ФЗ до трансграничной передачи оператор подает уведомление в Роскомнадзор, а сбор и хранение данных граждан России ведутся в базах на территории России. Как мы это решаем, описано на странице о безопасности данных.
Практичный путь: открытые моделимодель с открытыми весами. Модель с открытыми весами (open-weights model) это нейросеть, файлы параметров которой можно скачать и запустить на своем оборудовании. на своем компьютере или сервере через 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 не поддерживает.
Как устроены агенты на локальной модели и какой сервер для них нужен, мы разобрали отдельно.