Claude Managed Agents на своих серверах: гайд с вопросами для самопроверки

12 ноября Anthropic открыла частную бету self-hosted Claude Managed Agents. Managed Agents — сервис на платформе Claude для автономных агентов: разработчик описывает агента и отправляет ему задачи через API, а Anthropic ведёт цикл агента, держит песочницы, где тот выполняет команды, и хранит историю сессий. Теперь всё это, кроме самой модели, можно запустить в своём облаке или в своём дата-центре. На следующий день Приянка Фатак из Anthropic перечислила, что входит в поставку:

Priyanka@PriyankaPhatak

Вчера мы выпустили Self-Hosted Claude Managed Agents. Мы строили Claude Managed Agents как самую надёжную и масштабируемую инфраструктуру с харнесом, оптимизированным под Claude. Теперь эту магию можно перенести в собственную инфраструктуру, если наши облачные продукты вам не подходили.

Мы поставляем вам сервер CMA, который работает с вашим провайдером учётных записей (IdP), отдаёт телеметрию через OTel и включает хранилище. А ещё вместе с ним мы выпустили self-hosted консоль, в которой впервые появился продукт для оценки агентов, Evals!

Оригинал

Yesterday we shipped Self-Hosted Claude Managed Agents. We built Claude Managed Agents to be the most robust and scalable infra with a harness optimized for Claude. Now you can bring this magic to your own infrastructure if using our hosted products was not an option for you.

We ship you the CMA server that works with your IDP, includes OTel for telemetry, storage. We also shipped this with a self hosted console that brings you an Evals product for the very first time!

X,

Гайд устроен как занятие со скилом-репетитором socratic-tutor11Скил выложила торговая компания Jane Street. Он не отвечает на вопросы, а задаёт их: делит тему на 4–10 поднавыков, оценивает каждый по шкале от 0 до 5 и повышает уровень только после нескольких независимых проверок., о котором мы писали в статье о том, как учиться с AI-агентом. Тема разбита на поднавыки, перед большинством разделов стоит вопрос, а в конце идут проверка вперемешку по всем разделам, задача на всё сразу и ответы. На вопрос перед разделом стоит ответить до чтения, хотя бы догадкой: потом будет видно, в каком месте догадка разошлась с документацией.

Карта навыков

Оцените себя по каждому поднавыку до чтения и ещё раз после проверки в конце. Шкала из скила: 0 — не знаю, что это; 1 — слышал; 2 — могу следить за объяснением; 3 — могу с подсказкой; 4 — могу сам; 5 — могу объяснить другому и разобрать граничные случаи.

Поднавыки и то, что на уровне 4 вы делаете сами:

  • Устройство Managed Agents. Назвать агента, окружение, сессию и события и сказать, что из них где хранится.
  • Мозг и руки. Сказать для каждого варианта, где работает цикл агента и где выполняются его команды.
  • Три варианта размещения. Выбрать между облаком, своими песочницами и своим сервисом по требованиям задачи.
  • Что уходит наружу. Перечислить, что покидает сеть компании при каждом вызове модели.
  • Состав установки. Назвать сервер, базу, воркеры, консоль и три ключа и сказать, у кого какой.
  • Безопасность. Объяснить, откуда берётся изоляция команд агента и почему одна установка рассчитана на один уровень доверия.
  • Ограничения. Назвать, чего нет на своём сервере по сравнению с облачным сервисом.

Из чего состоит Managed Agents

В апреле 2026 года инженеры Anthropic рассказали, как строили этот сервис. Работа с ним держится на четырёх понятиях:

  • Агент — сохранённое описание: модель, системный промпт, инструменты, скилы, MCP-серверы. У агента есть версии, и сессия закрепляется за одной из них.
  • Окружение — место, где выполняются инструменты агента: команды bash и операции с файлами.
  • Сессия — один запуск агента в окружении вместе с его историей.
  • События — то, чем вы и агент обмениваетесь во время работы: ваши сообщения, вызовы инструментов и их результаты, ответы модели. Их читают потоком или списком.

Цикл агента, харнес22Харнес — программа вокруг модели. Он передаёт ей контекст, разбирает её ответ, выполняет вызовы инструментов и возвращает результаты. Подробнее — в статье о харнесе AI-агента., у Anthropic отделён от песочницы. Инженеры называют это разделением «мозга» и «рук»: харнес вызывает песочницу как любой другой инструмент, а если контейнер упал, поднимает новый. Подробно эта схема разобрана в статье о том, почему харнес выносят из песочницы. Благодаря разделению части сервиса можно отдавать клиенту по отдельности: сначала Anthropic отдала песочницы, теперь и сам сервис.

Первый вариант: свои песочницы

До чтения. Компания перенесла к себе только песочницы, а сервис оставила у Anthropic. Агент выполнил cat config.yaml. Где лежит файл и куда попадёт его содержимое?

В окружении типа self_hosted Anthropic по-прежнему ведёт цикл агента, а команды выполняет программа компании, которая называется воркером. Окружение работает как очередь:

  1. Вы создаёте сессию в этом окружении, и Anthropic ставит её в очередь.
  2. Воркер забирает сессию и скачивает скилы агента и подключённые к сессии хранилища памяти.
  3. Claude работает на стороне Anthropic и запрашивает вызовы инструментов. Воркер выполняет каждый у себя и отправляет результат обратно.

Воркер сам опрашивает очередь33Воркер отправляет запрос «есть ли работа», и сервер отвечает, когда работа появляется. Соединение всегда открывает воркер, поэтому машина с ним может стоять за NAT и фаерволом без единого открытого порта., поэтому ему хватает исходящего HTTPS, и входящие порты открывать не нужно. Готовые воркеры есть в CLI ant и в SDK для Python, TypeScript и Go. Свои инструкции выпустили площадки песочниц: Cloudflare, Daytona, E2B, Modal, Vercel, AWS Lambda MicroVMs и другие.

Файл config.yaml лежит на машине воркера, и там же остаются файлы и процессы песочницы. Но вывод cat — это результат инструмента, а результаты инструментов уходят в Managed Agents: иначе модель не узнает, что получилось, и не решит, что делать дальше. Документация говорит об этом прямо: история разговора, результаты инструментов, скилы и хранилища памяти попадают к Anthropic при любом варианте окружения. Инструменты web_search и web_fetch тоже работают на стороне Anthropic, а не в песочнице.

Своя песочница кое-что отнимает. Сессия в таком окружении принимает только ресурсы memory_store: с подключёнными файлами или GitHub-репозиторием она получит ошибку 400, и файлы для неё раскладывают сами. Секреты из хранилища нельзя передать агенту как переменные окружения44В облаке Anthropic подставляет секрет в исходящие запросы песочницы, а в самой песочнице лежит только заглушка. Из своей песочницы запросы идут через сеть компании, мимо этой подстановки. Секрет в таком случае держат на стороне воркера, в собственном инструменте, который воркер обслуживает.. Готовых языков и пакетов облачной песочницы тоже нет: в своей есть только то, что поставили вы. Сетевые правила облачной песочницы задают в настройках окружения, а в своей действует сетевая политика компании.

Как запустить

Для своих песочниц, в отличие от своего Managed Agents, доступ запрашивать не нужно, и быстрый старт из документации можно повторить сразу. Понадобится агент, созданный по быстрому старту Managed Agents, и машина с Linux или macOS, где /bin/bash лежит ровно по этому пути.

  1. В Claude Console на странице Environments создайте окружение и в поле Hosting выберите Self-hosted. Через API это окружение с config: {type: "self_hosted"}.
  2. Там же нажмите Generate environment key. Ключ окружения выдаёт только Console, даже если окружение создано через API.
  3. На машине воркера поставьте ant и запустите воркер. На macOS корневой том доступен только для чтения, поэтому рабочий каталог берут в домашней папке, например ~/workspace.
export ANTHROPIC_ENVIRONMENT_KEY="sk-ant-oat01-..."
export ANTHROPIC_ENVIRONMENT_ID="env_..."
sudo mkdir -p /workspace && sudo chown "$USER" /workspace
ant beta:worker poll --workdir /workspace
  1. На своей машине, с обычным ключом Claude API, проверьте, что воркер подключился: в ответе workers_polling должно быть не меньше 1.
ant beta:environments:work stats --environment-id "$ANTHROPIC_ENVIRONMENT_ID"
  1. Создайте сессию командой ant beta:sessions create --agent "$AGENT_ID" --environment-id "$ANTHROPIC_ENVIRONMENT_ID" и попросите агента записать вывод uname -a в hello.txt. Если файл появился в /workspace и описывает ядро вашей машины, команды агента выполнялись у вас.

Ключ Claude API на машину воркера не кладут: агент выполняет там команды и может его прочитать.

Второй вариант: свой Managed Agents

До чтения. Песочницы у компании уже свои. Ради чего ей брать на себя ещё сервер и базу?

Документация называет две причины. Первая — агенты, сессии и история сессий должны храниться на инфраструктуре компании. Вторая — вызовы модели должны идти через Amazon Bedrock, Claude на Google Cloud, Microsoft Foundry или собственный шлюз. Если нужно только, чтобы инструменты выполнялись у себя, документация советует свои песочницы.

Документация различает три варианта по тому, кто держит песочницы, сервис и модель:

  • Облачные песочницы, вариант по умолчанию: песочницы, сервис и модель у Anthropic.
  • Свои песочницы: песочницы у компании, сервис и модель у Anthropic.
  • Свой Managed Agents: песочницы и сервис у компании, модель у Anthropic или у провайдера, которого компания выбрала.

Сервис здесь — это API, цикл агента и хранилище агентов, сессий и истории. Своя установка состоит из таких частей:

  • Сервер cma-server. Отдаёт API, ведёт цикл агента, хранит агентов, сессии и историю и вызывает провайдера модели, когда агенту нужна модель. Команды и файловые инструменты агента сервер не выполняет никогда.
  • База PostgreSQL 16 или новее. Без базы сервер держит данные в памяти и теряет их при перезапуске.
  • Воркеры. Те же, что у своих песочниц, только опрашивают они ваш сервер. Воркер, который запускается по вебхуку, здесь не заработает: вебхуков сервер не отправляет.
  • Консоль по адресу сервера. В ней без SDK и CLI создают агентов, запускают сессии и управляют окружениями, хранилищами секретов и памяти и скилами. Люди входят через провайдера учётных записей компании по OpenID Connect55OpenID Connect — стандарт входа через внешний сервис учётных записей, например Okta, Microsoft Entra ID или Keycloak. Сервер Managed Agents назначает человеку роль по группам из его токена., а ключ API сервера консоль не принимает.
  • CLI администратора cma-server-admin. Создаёт окружения и их ключи.

API у сервера тот же, что у облачного сервиса, поэтому SDK и ant работают с ним без переделок, и остальная документация Managed Agents к нему применима, за исключениями из отдельного списка отличий. Для пробы на одной машине есть стек Docker Compose: сервер, база и воркеры, которые запускают каждую сессию в отдельном контейнере. Он предназначен для разработки: отдаёт обычный HTTP и по умолчанию слушает порт 8400 только на локальном адресе. Для продакшена Anthropic рекомендует два Helm-чарта для Kubernetes66Helm-чарт — пакет для Kubernetes: шаблоны ресурсов приложения и файл настроек values.yaml, из которых Helm собирает и обновляет установку. Один чарт в релизе ставит сервер, второй, cma-sandboxes, — воркеры с песочницами.. В архив каждого релиза входит operator-guide.md, и документация советует дать его прочитать Claude, чтобы тот помогал настраивать сервер и писать код для него.

Про Evals из поста Фатак публичная документация пока ничего не пишет: на странице консоли описаны агенты, сессии, окружения, хранилища и скилы.

У установки три ключа, и у каждого свой владелец:

  • Ключ API сервера есть у приложений компании, у ant и у CLI администратора. Он открывает запросы к серверу и играет роль ключа Claude API; создаёт его установка.
  • Ключ провайдера модели есть только у сервера. Это ключ Claude API, учётные данные облака или токен шлюза, и нужен он для вызовов модели. Приложениям и воркерам он не нужен.
  • Ключ окружения есть у воркеров. Он открывает очередь одного окружения и его сессии.

Доступ к бете выдаёт команда аккаунта Anthropic, и только подходящим организациям. В анонсе Anthropic называет задачи, для которых этот вариант делали: починка сломанных сборок и разбор алертов, то есть работа, которой нужен доступ к коду и внутренним системам компании.

Что всё равно уходит наружу

Найдите ошибку. «Мы развернули Managed Agents у себя, значит, разговоры агента больше не покидают нашу сеть».

Сервер, база и воркеры действительно стоят в сети компании. Но модель туда не переехала: она работает у Anthropic или у облачного провайдера, а при каждом вызове сервер отправляет ей весь разговор до этого момента, вместе с входами и результатами инструментов. Свой шлюз картину не меняет: он передаёт вызов дальше, тому, кто запускает Claude.

Если провайдер — Claude API, каждый вызов несёт ещё три заголовка с идентификаторами сессии, агента и окружения77По этим заголовкам Anthropic может отнести расход к конкретной сессии, агенту или окружению. Если ANTHROPIC_BASE_URL указывает на прокси или шлюз, заголовки уходят туда.. Имён и содержимого в них нет, но в идентификатор зашито время его создания, и отключить эти заголовки нельзя. Раз в 60 секунд сервер проверяет у Claude API, что его ключ действителен; эти проверки не запускают модель и заголовков не несут. В заголовке User-Agent сервер называет себя и свою версию, и по нему Anthropic может считать использование self-hosted установок. С другими провайдерами сервер к Anthropic не подключается вовсе.

У компании остаются сессии и их история: они лежат в её базе, пока их не удалят, и по возрасту сервер их не удаляет. Если у организации есть с Anthropic соглашение о нулевом хранении данных, ZDR88Zero data retention — соглашение, по которому Anthropic не хранит данные запросов после ответа. На облачный Managed Agents оно не распространяется: сессии там хранятся, пока их не удалят., оно действует для вызовов модели так же, как для любого вызова Messages API.

Сам сервер подключается только к адресам из списка в документации: к провайдеру модели, своей базе, разрешённым MCP-серверам и git-хостам, а также к коллектору OpenTelemetry, провайдеру учётных записей и менеджеру секретов, если их настроили. Этот список можно сверить с журналом своего прокси или фаервола. Воркеров он не касается: у воркера ровно та сеть, которую вы дали его контейнеру, и та же сеть у каждой команды агента.

Безопасность теперь на компании

До чтения. Воркер выполняет команды агента. Что мешает агенту прочитать файлы самого воркера и машины, на которой тот работает?

Сам воркер ничем не мешает. Документация предупреждает, что инструмент bash — настоящая оболочка с правами и сетью процесса воркера, и воркер её не изолирует. Изоляцию даёт то, в чём воркер запущен. Стек Compose и чарт cma-sandboxes запускают воркер каждой сессии в отдельном контейнере или поде. Воркер, запущенный вручную, держат в одноразовом контейнере или виртуальной машине, где нет ничего ценного.

Anthropic в анонсе называет четыре принципа, на которых построен Managed Agents. В своей установке каждый из них обеспечивает компания:

  1. Мозг и руки разделены. Сервер не выполняет команды, а воркеру не нужен ключ провайдера модели.
  2. Секреты не попадают в песочницу. Хранилище секретов подставляет их за пределами песочницы. В своей установке секрет каждой новой записи хранилища можно держать в менеджере секретов компании, а не в базе сервера. Секреты в переменных окружения сервер принимает только после того, как включён шлюз исходящего трафика — прокси между песочницами и интернетом. Ещё сервер умеет подписывать для агента короткоживущий токен, а MCP-сервер проверяет его по открытым ключам, которые публикует компания.
  3. Сеть открыта только для разрешённых адресов. В своей установке за это отвечает фаервол компании. С MCP-серверами и git-хостами сервер не соединяется, пока их не перечислят в настройках, а web_search и web_fetch выключены по умолчанию. Токен git до песочницы не доходит: git-трафик идёт через сервер, и токен добавляет он. Принудительный пуш сервер не запрещает, поэтому ветки защищают на стороне git-хостинга.
  4. Каждая сессия оставляет полную запись: шаги агента, вызовы инструментов и их результаты. Запись выгружается через OpenTelemetry99OpenTelemetry — открытый стандарт для трейсов, метрик и логов. Приложение отправляет их в коллектор, а оттуда они попадают в Grafana, Datadog, Honeycomb или другую систему мониторинга. в системы мониторинга, которыми компания уже пользуется. Трейсы и метрики сервер пишет, только когда их включили стандартными переменными окружения OpenTelemetry.

Отдельное правило касается разделения пользователей. Одна установка обслуживает одного арендатора на одном уровне доверия. Окружения внутри неё уровни доверия не разделяют: ключ API сервера открывает все окружения, а любой пользователь с ролью может запустить сессию в любом окружении и получит ту сеть и те файлы, до которых дотягиваются воркеры этого окружения. Поэтому агента, который работает с чужим кодом из интернета, и агента с доступом к внутренним системам разносят по разным установкам, каждую со своей базой, ключом и воркерами. Внутри одной установки людей разделяют через единый вход: группы из провайдера учётных записей получают роли developer или user, а ключ API сервера остаётся у администраторов. Такие пользователи видят все окружения, но из агентов, сессий, хранилищ и скилов — только то, что создали сами.

Обновления тоже на компании: каждый новый релиз она ставит сама.

Чего нет на своём сервере

По сравнению с облачным сервисом на своём сервере нет:

  • облачных окружений: существуют только self_hosted, а запрос облачного окружения вернёт ошибку 400;
  • остального Claude API: на /v1/messages и /v1/models сервер отвечает 404, такие запросы отправляют провайдеру напрямую;
  • Files API и ресурсов file: файлы кладут в рабочий каталог воркера, а картинки и PDF отправляют в сообщении в base64;
  • готовых скилов docx, pdf, pptx и xlsx: их исходники берут из репозитория anthropics/skills и загружают как свои;
  • запуска по расписанию, функции dreams и вебхуков: сессии по расписанию запускают своим планировщиком, например cron, а у dreams замены нет;
  • учётных данных mcp_oauth: токен хранят как static_bearer и сами обновляют до истечения;
  • динамических workflows и советника в мультиагентной работе: агент передаёт задачи только перечисленным субагентам, от 1 до 20.

Часть инструментов зависит от провайдера. web_search работает только с Claude API, Google Cloud и Foundry, web_fetch — только с Claude API и Foundry. С другим провайдером агент сохраняется и запускается, но модель вызвать эти инструменты не может, и ошибки об этом нет.

Если ни один воркер не опрашивает окружение, модель всё равно отвечает, а первый вызов инструмента без ошибки ждёт, пока его не заберёт воркер.

Как выбрать вариант

  • Облачные песочницы — вариант по умолчанию. Документация советует начинать с него, если нет требования выполнять инструменты у себя: Anthropic поднимает для каждой сессии чистый контейнер с языками и утилитами, и хостить ничего не нужно.
  • Свои песочницы подходят, когда агент работает с данными, которые нельзя выносить из сети (файлы и процессы остаются у компании, результаты инструментов всё равно уходят), когда ему нужны внутренние сервисы, недоступные снаружи, или когда инструменты должны работать под аудитом компании.
  • Свой Managed Agents нужен, когда агенты и история сессий должны храниться у компании или вызовы модели должны идти через Bedrock, Google Cloud, Foundry или свой шлюз. Вместе с ним компания берёт на себя сервер, базу, воркеры, их защиту и обновления.

Проверьте себя

Вопросы идут вперемешку. Ответьте письменно, потом сверьтесь с ответами ниже.

  1. Предскажите. Агент в своей песочнице вызывает web_fetch. С какой машины уйдёт запрос к странице? А на своём сервере Managed Agents с провайдером Claude API?
  2. Объясните. Почему воркеру хватает исходящего HTTPS и не нужно открывать ни одного входящего порта?
  3. Найдите ошибку. «Поставим провайдером модели свой шлюз, и разговоры агента не выйдут за пределы компании».
  4. Примените. В компании две команды. Одна гоняет агента на открытом коде из интернета, другая — по внутренней базе клиентов. Хватит ли им двух окружений в одной установке?
  5. Свяжите. Почему ключ Claude API не кладут на машину воркера и какой из четырёх принципов это нарушило бы?
  6. Найдите причину. Сессия на своём сервере отвечает текстом, но первая же команда висит без ошибки. Что проверить первым?

Задача на всё сразу. Банк хочет агента, который чинит упавшие сборки во внутреннем GitLab. История сессий должна храниться в базе банка, вызовы модели должны идти через Amazon Bedrock, а агент не должен видеть токен GitLab. Опишите установку: какие части развернуть, у кого какой ключ, что прописать в настройках сервера, что уйдёт за пределы банка и чего агент лишится. И что делать, если тот же банк захочет запускать агента на коде из открытых репозиториев.

Ответы

  1. В своей песочнице web_fetch выполняется на стороне Anthropic, как и в облачной: воркер выполняет только bash, файловые инструменты и собственные инструменты, которые обслуживает. На своём сервере web_search и web_fetch выключены, пока их не включат в настройках. После включения их выполняет провайдер модели, а сам сервер для них никуда не подключается.
  2. Соединение открывает сам воркер: он спрашивает очередь, есть ли работа, и забирает её. Сервер к воркеру не подключается, поэтому входящие порты не нужны, и машина может стоять за NAT и фаерволом.
  3. Шлюз передаёт вызов тому, кто запускает Claude, и вместе с вызовом уходит весь разговор: промпты, входы и результаты инструментов. Внутри компании остаются агенты, сессии и история в её базе, а сам разговор при каждом вызове уходит к провайдеру, к которому подключён шлюз.
  4. Не хватит. Окружения внутри установки не разделяют уровни доверия: ключ API сервера открывает все окружения, а любой пользователь с ролью может запустить сессию в любом окружении и получит доступ его воркеров. Нужны две установки, каждая со своей базой, ключом API и воркерами.
  5. Агент выполняет команды на машине воркера и может прочитать там любой файл и любую переменную окружения. Ключ на этой машине нарушил бы принцип «секреты не попадают в песочницу».
  6. Опрашивает ли окружение хоть один воркер. Модель отвечает и без воркеров, а вызов инструмента ждёт, пока его не заберёт воркер. В консоли воркеры окружения видны на его вкладке Workers, в стеке Compose помогает docker compose logs sandbox.

Задача. Банку нужен свой Managed Agents: сервер, PostgreSQL 16 или новее, воркеры из чарта cma-sandboxes, где каждая сессия работает в своём поде, и консоль со входом через провайдера учётных записей банка. Провайдер модели — bedrock: сервер подписывает вызовы учётными данными AWS, например ролью пода, и ключ Claude API ему не нужен. Ключ API сервера получают приложения банка и администраторы, учётные данные AWS есть только у сервера, ключ окружения — только у воркеров.

В настройках сервера GitLab вписывают в список разрешённых git-хостов. Тогда git-трафик идёт через сервер, токен добавляет сервер, и в песочницу токен не попадает. Ветки защищают в самом GitLab, потому что принудительный пуш сервер не запрещает. Трейсы через OpenTelemetry отправляют в мониторинг банка.

За пределы банка при каждом вызове модели уходит весь разговор, с выводом сборок и кусками кода, в Amazon Bedrock. К Anthropic сервер с провайдером bedrock не подключается. Агент лишится web_search и web_fetch: через Bedrock они не работают, и если они нужны, их заменяют собственными инструментами. Агента для кода из открытых репозиториев ставят в отдельную установку, потому что у него другой уровень доверия.

Через пару дней ответьте на вопросы ещё раз, не открывая текст. Скил-репетитор повышает уровень только после проверки по памяти, без подсказки, так что если по какому-то поднавыку выходит меньше четырёх, стоит перечитать его раздел.

Курсы по теме

У каждого курса есть бесплатная часть: оставьте почту и начните сразу.

Рассылка

Раз в месяц — новые курсы, обновления программ и платформы. Отписаться можно в один клик из любого письма.

Начните учиться сегодня

Все курсы за 1500 ₽ в месяц. Доступ откроется сразу после оплаты, отменить можно в любой момент.

Для компаний — 5000 ₽ в месяц за сотрудника