Claude Managed Agents: что это и как запустить через API

Ниже — короткая инструкция на русском, что такое Claude Managed Agents, как запустить первого облачного агента через API Anthropic и как понять, нужен ли вам этот режим вообще. По документации Anthropic на 10 апреля 2026 года сервис доступен в beta и включён по умолчанию для всех API-аккаунтов.

Короткий ответ: что такое Managed Agents

Claude Managed Agents — это облачный агентный runtime от Anthropic. Вы не строите свою песочницу, не пишете цикл агента и не поднимаете контейнеры вручную. Вместо этого создаёте agent, environment и session через API, отправляете задачу — и Claude работает в управляемой среде с bash, файлами, вебом и MCP.

Если раньше вы делали что-то похожее через сторонние обёртки поверх подписки Claude, официальный путь со стороны Anthropic теперь другой: через Claude API и Managed Agents.

Что нужно до старта

• Аккаунт в Anthropic Console и API-ключ.
• Переменная окружения ANTHROPIC_API_KEY.
• Понимание, что все запросы требуют beta-заголовок managed-agents-2026-04-01. В SDK он ставится автоматически, в curl нужно указать вручную.

export ANTHROPIC_API_KEY="ваш-api-ключ"

Как запустить Claude Managed Agents: быстрый путь через curl

Шаг 1. Создайте агента

Agent — это конфигурация: модель, system prompt, инструменты, skills и MCP-серверы. Делаете один раз, потом переиспользуете по agent.id.

curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "Coding Assistant",
    "model": "claude-sonnet-4-6",
    "system": "You are a helpful coding assistant. Write clean, well-documented code.",
    "tools": [
      {"type": "agent_toolset_20260401"}
    ]
  }'

Сохраните agent.id. Тип инструмента agent_toolset_20260401 включает встроенный набор инструментов: bash, файловые операции, веб-поиск и другое.

Шаг 2. Создайте environment

Environment — это шаблон контейнера, в котором агент будет жить во время сессии. В quickstart Anthropic использует облачную среду с unrestricted networking.

curl -sS --fail-with-body https://api.anthropic.com/v1/environments \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "quickstart-env",
    "config": {
      "type": "cloud",
      "networking": {"type": "unrestricted"}
    }
  }'

Сохраните environment.id. Он понадобится для каждой новой сессии.

Шаг 3. Запустите session

Session — это уже конкретный запуск агента в вашей среде под одну задачу.

curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "agent": "AGENT_ID",
    "environment_id": "ENVIRONMENT_ID",
    "title": "Quickstart session"
  }'

Сохраните session.id.

Шаг 4. Отправьте задачу

curl -sS --fail-with-body \
  "https://api.anthropic.com/v1/sessions/SESSION_ID/events" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "events": [
      {
        "type": "user.message",
        "content": [
          {
            "type": "text",
            "text": "Проанализируй репозиторий, найди 3 явных бага и предложи исправления по приоритету"
          }
        ]
      }
    ]
  }'

Шаг 5. Подключитесь к stream

Anthropic рекомендует открывать SSE-стрим и читать события по мере выполнения. Так вы увидите, когда агент пишет текст, когда использует инструменты и когда закончил работу.

curl -sS -N --fail-with-body \
  "https://api.anthropic.com/v1/sessions/SESSION_ID/stream" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "Accept: text/event-stream"

Сколько это стоит

По официальной pricing page Managed Agents тарифицируются по двум измерениям: токены модели и runtime сессии. Runtime считается только пока статус сессии running. Время в idle, rescheduling и terminated не тарифицируется.

Если агент у вас работает круглосуточно, только runtime даст около $57.60 в месяц без учёта токенов. В документации Anthropic есть и конкретный пример: часовая сессия на Opus 4.6 с 50K входных и 15K выходных токенов стоит примерно $0.705.

Когда использовать Managed Agents, а когда нет

Использовать стоит, если:

• задача долгая и требует нескольких tool calls;
• вы не хотите строить свой agent loop, sandbox и runtime;
• нужна автономная работа в облаке, пока вы занимаетесь другим;
• важна stateful session с файлами и историей внутри одного прогона.

Лучше не использовать, если:

• задача решается одним вызовом Messages API;
• вам нужен полный контроль над циклом агента и своей инфраструктурой;
• данные нельзя отправлять в сторонний облачный runtime;
• у вас ещё нет базы по агентам и вы пока не понимаете, как формулировать задачи и проверять результат.

Частые ошибки при первом запуске

Забыли beta header

Это самая частая причина, почему Managed Agents “не работает”. Для всех запросов нужен anthropic-beta: managed-agents-2026-04-01. В SDK он ставится автоматически, в curl — нет.

Не сохранили ID сущностей

После каждого шага сохраняйте agent.id, environment.id и session.id. Если потеряли один из них, следующий шаг уже не собрать.

Дали unrestricted networking без необходимости

В quickstart у Anthropic используется unrestricted, потому что это самый прямой путь для demo. Но в реальном проде лучше выдавать сети ровно столько, сколько нужно задаче.

Ожидаете поведение как у Messages API

В pricing docs Anthropic отдельно отмечает, что batch discount, fast mode premium, long context premium и некоторые другие модификаторы Messages API на Managed Agents не распространяются. Это отдельный runtime с собственной моделью тарификации.

Если хотите лучше управлять самим Claude до перехода в облачные agent runtimes, посмотрите ещё наши материалы: рабочие приёмы работы с Claude, команды Claude Code и гайд по skills для AI-агентов.