Наборы для разработчиков агентов от OpenAI и Anthropic

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 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, не привязан к одному поставщику моделей.

России нет в списке стран, где работает 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 не поддерживает.

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