К содержимому
Блог

Агенты Claude Code: задачи, права и расходы через API

Агенты Claude Code: задачи, права и расходы через API

Агенты Claude Code выполняют задачи внутри вашего проекта: читают файлы, предлагают изменения и используют разрешённые инструменты. Субагенту можно поручить отдельный разбор, чтобы основной сеанс получил короткий результат вместо всей истории поиска. Через Relay оплачиваются вызовы модели; доступ к файлам, запуск команд и проверку патчей настраивают в Claude Code и операционной системе. Начните с одного помощника для чтения кода, затем проверьте его результат и расход.

Коротко

  • Субагент получает отдельную задачу, инструкции и набор инструментов.

  • Разделение контекста не создаёт изолированную файловую систему.

  • Несколько агентов требуют проверки моделей, изменений и общего расхода.

Агенты Claude Code: какие задачи им поручать

Хорошая задача для первого субагента: «Найди, где проверяется статус заказа. Верни пути, строки и условия отказа. Файлы не меняй». У неё есть вход, ограниченная область и проверяемый ответ. Основной сеанс сможет прочитать найденные места и принять решение о правке.

Субагенты Claude Code полезны для отдельного поиска или проверки. Однако любой результат нужно проверять: ссылка может вести не на тот обработчик, а вывод о поведении строиться на одном из нескольких путей. Просите доказательство конкретного сценария, а не общую оценку «всё безопасно».

ПоручениеОжидаемый результатКак проверить
Найти обработчик ошибкиФайл, строка, условиеПрочитать ветку и вызывающий код
Предложить исправлениеПричина и небольшой планСопоставить с воспроизводимым сбоем
Подготовить тестВход и ожидаемое поведениеЗапустить тест и увидеть отказ до правки
Проверить патчСценарий дефекта или отсутствие находокПрочитать diff и повторить сценарий

Не поручайте сразу рефакторинг, выпуск и удаление старых данных. Такое задание объединяет разные права и не даёт понятного момента остановки. Начните с результата, который можно принять без выполнения внешних действий.

Как создать субагента без выдуманных настроек

В Claude Code настройку субагентов открывают командой /agents. Выберите создание агента, задайте назначение, инструкцию и доступные инструменты. Точные названия полей и способы хранения сверяйте с официальным руководством субагентов для вашей версии.

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

text
Задача: найти проверку статуса заказа перед отменой.
Область: server/internal/orders.
Разрешено: читать файлы и искать по тексту.
Результат: пути, строки, условия допуска и отказа.
Если проверки нет: перечисли просмотренные обработчики.
Остановись после ответа. Код не меняй, команды не запускай.

Текст «не меняй код» дополняет настройку инструментов, но не заменяет её. Если действие не требуется задаче, уберите соответствующий инструмент. Не рассчитывайте, что текущая папка или отдельный контекст сами запрещают чтение соседних каталогов.

Как подключить модели через Relay

Проверьте основной сеанс по руководству интеграции Relay: для Messages нужен адрес https://relay-llm.ru без /v1, ключ передаётся через ANTHROPIC_AUTH_TOKEN. Модель выбирайте по точному ID и списку протоколов из каталога.

При добавлении субагента проверьте его собственную настройку модели. Она может отличаться от основной. Псевдоним, который клиент разворачивает во встроенный ID, способен привести к model_not_found, если такого идентификатора нет у Relay. Один успешный ответ основного сеанса не проверяет все фоновые вызовы.

Укажите совместимую модель явно там, где это позволяет ваша версия. Не копируйте настройки чужого агента с неизвестным ID. Полный набор переменных для основного сеанса, псевдонимов и субагентов приведён в интеграции; после изменения сделайте короткий запуск именно нужного помощника.

Каталог моделей

Как не столкнуть параллельные правки

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

Если задачи зависят от общего изменения, выполняйте их последовательно. Сначала исправьте контракт, затем обновите потребителей. Параллельная работа оправдана, когда результаты можно проверить и объединить независимо, без догадок о промежуточном состоянии.

Перед задачей сохраните исходное состояние Git. После неё посмотрите diff и незапланированные файлы. Для проверки кода запустите целевой тест сами: утверждение агента о зелёных проверках не подтверждает, что он запускал нужную команду на текущей версии.

Как контролировать расходы нескольких агентов

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

В журнале запросов видны вызовы ключа, модели, токены и стоимость. Имя роли из вашего задания не заменяет ID запроса и не обязано отображаться в журнале. Для связи сохраните время запуска и результат в журнале своего процесса.

Параллельные сеансы делят ограничения аккаунта. При 429 concurrency_limit уменьшите число одновременно открытых потоков, при 402 key_limit_exceeded проверьте бюджет. Правила отказов и повторов есть в справочнике ошибок. Больше агентов означает больше возможных вызовов, поэтому сравнивайте расход на принятый результат.

Агенты Claude Code изолированы друг от друга как контейнеры?

Отдельный контекст не означает отдельную файловую систему. Изоляцию каталогов и права нужно настраивать средствами клиента, Git и окружения.

Нужен ли Claude Code agent отдельный ключ Relay?

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

Почему основной Claude Code отвечает, а субагент получает 404?

Проверьте ID модели субагента и псевдонимы. Он может запрашивать другую модель, которой нет в каталоге Relay.

Подключить модели для агентских задач

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.