Обзор Claude Managed Agents

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

Claude Managed Agents предоставляет фреймворк и инфраструктуру для запуска Claude в качестве автономного агента. Вместо того чтобы создавать собственный цикл агента, выполнение инструментов и среду выполнения, вы получаете полностью управляемую среду, в которой Claude может читать файлы, выполнять команды, просматривать веб-страницы и безопасно запускать код. Фреймворк поддерживает встроенное кэширование подсказок, компактизацию и другие оптимизации производительности для высококачественных и эффективных выходных данных агента.

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

Создайте свою первую сессию агента

Справочник API

Полная документация по конечным точкам

Основные концепции

Claude Managed Agents построен на четырёх концепциях:

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

Как это работает

Создайте агента
Определите модель, системный промпт, инструменты, MCP-серверы и навыки. Создайте агента один раз и ссылайтесь на него по идентификатору в разных сессиях.
Создайте среду
Настройте облачный контейнер с предустановленными пакетами (Python, Node.js, Go и др.), правилами доступа к сети и подключёнными файлами.
Запустите сессию
Запустите сессию, которая ссылается на конфигурацию вашего агента и среды.
Отправляйте события и получайте потоковые ответы
Отправляйте сообщения пользователя в виде событий. Claude автономно выполняет инструменты и передаёт результаты в потоковом режиме через события, отправляемые сервером (SSE). История событий сохраняется на стороне сервера и может быть получена в полном объёме.
Управляйте или прерывайте
Отправляйте дополнительные пользовательские события для управления агентом в процессе выполнения или прерывайте его, чтобы изменить направление.

Когда использовать Claude Managed Agents

Claude Managed Agents лучше всего подходит для рабочих нагрузок, которым требуется:

Длительное выполнение — задачи, выполняющиеся минутами или часами с множеством вызовов инструментов
Облачная инфраструктура — защищённые контейнеры с предустановленными пакетами и доступом к сети
Минимальная инфраструктура — нет необходимости создавать собственный цикл агента, песочницу или уровень выполнения инструментов
Сессии с сохранением состояния — постоянные файловые системы и история разговоров в нескольких взаимодействиях

Поддерживаемые инструменты

Claude Managed Agents предоставляет Claude доступ к обширному набору встроенных инструментов:

Bash — выполнение команд оболочки в контейнере
Операции с файлами — чтение, запись, редактирование, поиск по шаблону и grep файлов в контейнере
Веб-поиск и получение данных — поиск в интернете и получение содержимого по URL
MCP-серверы — подключение к внешним поставщикам инструментов

Полный список и параметры конфигурации см. в разделе Инструменты.

Бета-доступ

Claude Managed Agents в настоящее время находится в бета-версии. Все конечные точки Managed Agents требуют бета-заголовка managed-agents-2026-04-01. SDK устанавливает бета-заголовок автоматически. Поведение может быть уточнено между выпусками для улучшения результатов.

Для начала работы вам потребуется:

Ключ API Claude
Указанный выше бета-заголовок во всех запросах
Доступ к Claude Managed Agents (включён по умолчанию для всех учётных записей API)

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

Ограничения скорости

Конечные точки Managed Agents имеют ограничения скорости на уровне организации:

Операция	Лимит
Конечные точки создания (агенты, сессии, среды и т. д.)	60 запросов в минуту
Конечные точки чтения (получение, список, поток и т. д.)	600 запросов в минуту

Также применяются лимиты расходов и ограничения скорости на основе уровня на уровне организации.

Основные концепции

Как это работает

Когда использовать Claude Managed Agents

Поддерживаемые инструменты

Бета-доступ

Ограничения скорости

Рекомендации по брендингу