Claude Code Agent Routing: управление плагинами и OTEL-аудит

Релиз Claude Code v2.1.157 от 29 мая — один из наиболее значимых с операционной точки зрения за последние месяцы. Не из-за обновления модели, а потому что в нём появились три механизма, меняющих подход к управлению, routing и наблюдаемости в multi-agent coding-пайплайнах. Если вы запускаете Claude Code в командном масштабе, эти изменения влияют на вашу инфраструктуру уже сегодня.

Что изменилось

В changelog v2.1.157 выделяются три ключевых нововведения:

1. Плагины автоматически загружаются из .claude/skills — без marketplace

Раньше распространение плагина Claude Code внутри команды требовало прохождения через marketplace или ручной установки. Теперь любой плагин, помещённый в директорию .claude/skills, загружается автоматически при запуске Claude Code. Новая команда claude plugin init <name> создаёт структуру плагина прямо в этой директории.

Это смена модели управления: команды теперь могут распространять внутренние плагины — кастомные инструменты, корпоративные workflow, проприетарные интеграции — через собственный репозиторий или общую файловую систему, не завися от инфраструктуры marketplace Anthropic.

2. Поле agent в settings.json теперь учитывается при dispatch-сессиях

Когда Claude Code запускает фоновую agent-сессию через claude agents, он теперь читает поле agent из settings.json, чтобы определить, какой agent-профиль использовать. Переопределить его для конкретного вызова можно флагом --agent <name>.

Это точка принятия routing-решения: операторы теперь могут декларативно задать, какой agent-профиль запускается в dispatch-сессиях — на уровне конфигурации, а не через runtime-флаги. Для команд, использующих несколько профилей (например, строгий агент для code review и более свободный для исследования), это означает, что routing при dispatch теперь декларативен и поддаётся аудиту.

3. При OTEL_LOG_TOOL_DETAILS=1 события tool_decision включают параметры инструментов

Claude Code уже отправлял OTEL-телеметрию для решений об использовании инструментов. После этого обновления установка OTEL_LOG_TOOL_DETAILS=1 добавляет в эти события фактические параметры: выполненные bash-команды, имена вызванных MCP-инструментов, имена использованных skill.

Это закрывает существенный пробел в наблюдаемости. Раньше можно было видеть, что инструмент был вызван; теперь видно, с какими параметрами. Для команд, маршрутизирующих Claude Code через API gateway или запускающих его в CI/CD-пайплайнах, это означает возможность строить полноценные audit trail и атрибуцию затрат на уровне вызовов инструментов.

Почему это важно для AI-инженерных команд

Три изменения затрагивают разные уровни operator-стека:

Управление плагинами устраняет зависимость от внешней инфраструктуры для внутреннего инструментария. Команды, которые избегали создания проприетарных расширений Claude Code из-за сложности распространения, теперь имеют чёткий путь: зафиксировать плагины в общем репозитории, смонтировать директорию .claude/skills — готово. Особенно актуально для предприятий с изолированными или ограниченными сетевыми средами.

Routing agent-конфигурации делает multi-agent dispatch поддающимся аудиту. Поле agent в settings.json означает, что ваш CI/CD-пайплайн, общая конфигурация команды или управляемый оператором деплой могут декларировать, какой agent-профиль запускается — и эта декларация версионируется. Разница между «мы думаем, что запустился правильный агент» и «мы можем доказать, что запустился правильный агент».

OTEL-телеметрия инструментов обеспечивает реальную атрибуцию затрат и аудит безопасности. При масштабном использовании Claude Code — десятки разработчиков, сотни agent-сессий в день — знать, какие bash-команды выполнялись и какие MCP-инструменты вызывались, не опционально. Это основа для сверки биллинга, обнаружения аномалий и compliance-отчётности.

Router/operator-перспектива

Поле agent в settings.json — наиболее недооценённое изменение в этом релизе. Оно вводит routing-слой внутри собственного механизма dispatch Claude Code: оператор декларирует agent-идентичность, runtime её соблюдает. Это аналог того, как routing gateway позволяет фиксировать модель или provider на уровне запроса — только здесь фиксируется agent-профиль, а не модель.

Для команд, использующих Claude Code через API gateway вроде TheRouter, комбинация routing-конфигурации агентов и OTEL-телеметрии инструментов создаёт более полную картину наблюдаемости:

• Gateway видит модель, количество токенов и задержку на уровне API.
• OTEL-телеметрия инструментов (при OTEL_LOG_TOOL_DETAILS=1) добавляет уровень вызовов: какие команды выполнялись, какие MCP-инструменты вызывались, какие skill использовались.
• Поле agent в settings.json добавляет уровень идентичности: какой agent-профиль отвечал за сессию.

Вместе эти три уровня дают данные для ответа на вопрос: «что именно сделала эта agent-сессия и кто её авторизовал?»

Чеклист управления плагинами для операторов:

• Проведите аудит директорий .claude/skills — всё, что там находится, теперь загружается автоматически. Относитесь к этому как к записи в PATH.
• Если вы распространяете внутренние плагины, перенесите их в .claude/skills в общем конфигурационном репозитории.
• Установите OTEL_LOG_TOOL_DETAILS=1 в CI/CD-среде, если нужны audit trail на уровне инструментов.
• Добавьте поле agent в settings.json команды, чтобы зафиксировать agent-профиль для dispatch-сессий.
• Изучите структуру, создаваемую claude plugin init, прежде чем деплоить кастомные инструменты.

На что обратить внимание пользователям TheRouter

Если вы маршрутизируете Claude Code через TheRouter, изменение OTEL-телеметрии инструментов напрямую касается вашей конфигурации наблюдаемости. Данные на уровне gateway (модель, токены, задержка) и данные на уровне инструментов (bash-команды, MCP-вызовы) теперь поступают из разных слоёв — но при правильной настройке доступны оба.

Следите за тем, как Anthropic будет расширять семантику поля agent в будущих релизах. Если agent-профили получат возможность фиксировать модель или маршрутизировать по provider, этот конфигурационный параметр станет первоклассным routing-контролем, которым операторы захотят управлять централизованно.

Автозагрузка плагинов также заслуживает внимания с точки зрения безопасности: любая директория .claude/skills в области видимости теперь является поверхностью выполнения. Команды должны подходить к управлению плагинами с той же строгостью, что и к управлению зависимостями.