SDK для Claude сами ведут цикл computer use, браузер ваш
Anthropic 7 октября добавила в Python и TypeScript SDK для Claude по классу на каждый из двух инструментов, browser use и computer use. Агентный цикл теперь ведёт SDK, а от вас нужен наследник класса с одним методом на каждое действие, например navigate или left_click, написанным поверх вашей собственной автоматизации браузера или рабочего стола. Раньше, как напоминает ClaudeDevs в Twitter, API только сообщал, куда Claude хочет кликнуть и что набрать, а цикл и перевод кликов и нажатий клавиш в команды каждый писал сам.
Теперь SDK сам направляет вызов в нужный метод, прогоняет переданные вами политики, спрашивает callback подтверждения и собирает каждый tool_result. Браузера, рабочего стола, готового драйвера и URL-политики в комплекте нет, подчёркивается в документации Anthropic. Минимальный пример лежит в репозитории claude-quickstarts на обоих языках: он управляет Chromium через Chrome DevTools Protocol, интерфейс отладки и автоматизации Chrome, и для продакшна не предназначен. Своими интеграциями с новыми классами в документации названы Browser Use, Browserbase и E2B, а в анонсе ClaudeDevs к совместимым драйверам добавлен ещё Daytona.
Как устроен драйвер
Драйвер - это ваш наследник BetaAbstractBrowserToolset20260801. В примере из документации он реализует navigate, screenshot и left_click, а также _browser_state, отчёт о состоянии браузера, который обязателен для любого драйвера. За вызовами стоит backend, ваша обёртка над библиотекой автоматизации вроде Playwright. Суффикс в имени класса совпадает с версией инструментов, которые в августе вышли из беты и научили Claude делать несколько действий за ход. Новые классы закрывают ту часть, которую после выхода из беты всё ещё приходилось писать самому.
Экземпляр драйвера передаётся прямо в tools. Каждое действие, которое вы не реализовали, уходит в API как отключённое. Если Claude всё же его вызовет, SDK вернёт ошибку, и прогон продолжится. Раннер никогда не закрывает набор инструментов сам, поэтому один экземпляр может обслуживать несколько прогонов, а закрыть его по окончании работы нужно вам.
Включать и отключать отдельные действия можно через configs, перечисляя только то, что меняете. Вызов отключённого действия SDK отклоняет ещё до вашего кода. Включить действие, которого в классе нет, нельзя: это ошибка конфигурации, если только класс не переопределяет execute.
Переопределённый execute служит для хуков до и после вызова. Вы вызываете родительский execute, а код перед ним выполняется уже после URL-политики, файловой политики и подтверждения. Он может поменять входные данные, и SDK их повторно не проверяет. Код после вызова получает результат и тоже может его поменять. Чтобы отклонить вызов, поднимите ToolError (в TypeScript его бросают через throw).
У хуков есть побочный эффект, который легко пропустить. Как только execute переопределён, SDK считает реализованными все действия и предлагает Claude каждое, что включено по умолчанию. Драйвер из примера умеет три действия, так что его вариант с трассировкой начнёт предлагать модели то, чего не умеет. Лишнее придётся отключить через configs до запуска.
Каждый метод получает контекст вызова и входные данные действия в виде типизированного объекта, например BetaBrowserNavigateInput из anthropic.types.beta. В TypeScript действия нужно писать методами класса, а не полями со стрелочными функциями: SDK ищет их в прототипе. Там же действие type называется type_, в Python оно остаётся type.
Что видит Claude
От того, что вернёт метод, зависит, что прочитает модель. Успешный результат заканчивается блоком browser_state, который SDK собирает из вашего отчёта о состоянии, у ошибки такого блока нет. screenshot и zoom дают один блок с изображением, navigate превращается в строку с адресом, заголовком страницы и HTTP-статусом. Методы вроде read_page, find или javascript_exec возвращают строку как есть, а пустую строку Claude видит как (empty). Клики и прочие действия отвечают коротким подтверждением вроде Clicked. и, если метод вернул строку текста, отдельным текстовым блоком с ней.
_browser_state SDK вызывает после каждого вызова, который вернул результат, включая отклонённые и упавшие. В отчёт идут все открытые вкладки и то, что изменилось с прошлого раза: новые вкладки, события загрузок, отметка о каждой навигации, которую заблокировал ваш хук запросов, и о каждом нативном диалоге, который закрыл драйвер. Последние два вида изменений SDK передаёт Claude текстом вне блока состояния: одну строку на все отклонённые навигации без указания URL и по строке на первые три закрытых диалога, а дальше только их число. Если открыта хотя бы одна вкладка, активной должна быть ровно одна, и любое действие с tab_id обязано работать именно с этой вкладкой.
С адресами SDK почти ничего не делает. URL вкладок, загрузок и тот, что вернул ваш navigate, Claude читает в том виде, в каком их записал драйвер: SDK заменяет переводы строк и другие управляющие символы пробелами, обрезает края и укорачивает каждый адрес до 4 096 символов, но не разбирает его. Поэтому до модели доходят содержимое data:-адреса, путь из file:-адреса, а также логин и пароль, если они вшиты в URL.
Ошибки делятся на три вида. ToolError из метода Claude получает как результат с ошибкой и её текстом, прогон идёт дальше. Любое другое исключение тоже доходит до модели, в виде ClassName: message в Python или Error: message в TypeScript, и прогон тоже продолжается. ToolsetUsageError останавливает всё: SDK поднимает его при ошибке конфигурации, неправильном использовании во время вызова, вызове после закрытия, а ещё когда исключение, хоть бы и ToolError, бросил _browser_state. Ни раннер, ни tool_result его не ловят, и он уходит к вызывающему коду.
Локальные пути SDK не маскирует нигде: ни в тексте ошибки метода, ни в строке, которую вернул left_click, ни в ошибке неудачной загрузки, ни в тексте закрытого диалога. Текст ToolError из URL-политики, файловой политики или подтверждения тоже уходит модели как написан. Документация советует ловить исключения в методах самим и поднимать ToolError со своим текстом без путей.
Ранний старт и клик, который нельзя отменить
По умолчанию раннер выполняет вызовы хода после того, как ответ Claude закончился. С ранним стартом он может запустить действие в браузере или на рабочем столе, пока ответ ещё стримится. Включается он флагами stream=True и run_tools_eagerly=True, как в примере из документации, и тогда каждый проход по раннеру даёт вам поток вместо сообщения.
Меняется только момент запуска. Проверки по-прежнему идут первыми: URL-политика, файловая политика и подтверждение вызываются до действия, причём подтверждение может прийти, пока ответ ещё не дописан. Вызовы внутри одного набора инструментов выполняются по одному, в том порядке, в каком их написал Claude, и упавший вызов отменяет следующие за ним в этом ходе. Но начатое действие уже не отыграть: если ответ оборвётся, например на max_tokens, или ваш цикл остановится раньше времени, клик всё равно произойдёт, а результата Claude не увидит.
Без раннера экземпляр передаётся в tools (в TypeScript через browser.toJSON()), а на каждый вызов вы отвечаете tool_result сами. Инструмент browser use требует остановиться на первом упавшем вызове. Остальные вызовы хода получают ответ без выполнения: с is_error, именем набора в toolset_name и точным текстом, который предписывает раздел о пакетных действиях. Раннер отвечает на пропущенные вызовы тем же.
Шесть шагов перед продакшном
Следующее действие Claude зависит от того, что он прочитал на странице. Страница или текст, внедрённый в неё, может попытаться достучаться до внутренних сервисов, вытащить файлы с хоста или запустить действие с реальными последствиями. Поэтому прежде чем пускать драйвер куда-то кроме одноразового браузера, документация требует шести шагов:
- URL-политика, которая отклоняет любой адрес в
navigate, не нужный для задачи; - перехват запросов в драйвере с проверкой каждого по тем же правилам;
- egress-политика на контейнере, правила для исходящего трафика, чтобы сеть блокировала то, чего не видит драйвер;
- ограниченные загрузки и выгрузки, либо выгрузки выключены совсем;
- подтверждение через
confirmдля действий с последствиями; - отдельный контейнер или виртуальная машина под браузер на каждую сессию.
Из шести шагов SDK берёт на себя только три, первый, четвёртый и пятый, через переданные политики и callback. Перехват запросов, egress и изоляция остаются на вашем драйвере и вашей инфраструктуре.
URL-политика - это функция, которую вы передаёте как url_policy, и за её готовность к продакшну отвечаете тоже вы. SDK вызывает её перед navigate с контекстом и адресом в том виде, в каком его написал Claude. Ничего не вернула - адрес разрешён, подняла ToolError - Claude читает текст ошибки, а navigate не выполняется. Для «назад», «вперёд» и перезагрузки политика не вызывается. Пример из документации пропускает about:blank и два сайта с поддоменами по http и https. Claude может написать адрес без схемы, вроде example.com, поэтому пример дописывает https:// перед разбором хоста, и то же самое советуют делать в самом navigate, чтобы браузер открыл ровно тот адрес, который проверила политика.
Настоящей политике, по словам Anthropic, нужно гораздо больше. Ссылки, по которым кликает Claude, отправленные формы, редиректы и запросы, которые страница делает сама, видит только драйвер. Хосты и адреса из содержимого страницы может подобрать атакующий. Разбирать URL надо так же, как это делает браузер, а не искать хост простым split по строке. Схемы SDK не проверяет, так что отклонять нужно все, которые драйвер не собирается открывать. Если передать url_policy=None, SDK откажет в любой навигации по URL, так что None, случайно прочитанный из конфига, не оставит адреса без проверки. В TypeScript undefined означает, что опция не задана, как если бы её не передавали вовсе.
Хук запросов, функция, которую библиотека автоматизации вызывает перед каждым запросом, должен звать ту же проверку, что и политика, чтобы правила жили в одном месте. Но и он видит не всё: рукопожатия WebSocket, запросы service worker и промежуточные шаги редиректов проходят мимо. Service workers документация советует блокировать, а WebSocket и редиректы проверять хуком, который их видит. Пример политики отклоняет ws:// и wss://, поэтому перед проверкой адрес WebSocket нужно переписать на http:// и https:// соответственно.
Что не поймал перехват и куда на самом деле резолвится имя, закрывает только сеть контейнера. Первое правило egress-политики в документации: заблокировать link-local и частные диапазоны адресов в IPv4 и IPv6, куда входит и облачный сервис метаданных.
Дальше
AI-индустрияИнструменты разработчика
Copilot на Copilot+ PC начнёт считать часть задач локально, Видео
Разработчик ставит задачу в VS Code, а GitHub HydraFusion решает, отправить её в облако или отдать модели на самом ПК. Превью выйдет позже в октябре, и Microsoft обещает, что токенов будет уходить меньше.
Читайте также
- MCP Apps в Claude: панель, встроенные сайты и инструменты
- Anthropic передаёт Agent Skills фонду, где уже живёт MCP
- Claude сам собирает команду агентов, но бюджета не знает
- Anthropic учит агентов не путать сбой с тихим днём
- Opus 5.5 подешевел, но ломает агентов ошибкой 400
- Просмотрщик сессий в ant CLI и режим auto у агентов Claude
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

