Claude в Roo Code. От одной центральной карточки планирования отходят несколько небольших карточек задач по коду, каждая на отдельной аккуратной полке: образ оркестрации подзадач.

Безлимитный Roo Code с API Claude

Roo Code — мощное расширение для VS Code с агентными возможностями программирования, которое разделяет задачи по отдельным режимам работы: Architect, Code, Debug и Ask. Для каждого режима можно настроить собственную модель, температуру и параметры провайдера. Его функция Orchestrator создаёт подзадачи, резко увеличивающие потребление API. Подключение Roo Code к безлимитному шлюзу Claude с фиксированной платой позволяет назначить Opus для режима Architect, Sonnet для режима Code и не беспокоиться о нарастающих расходах при оркестрации рабочих процессов.

Как Roo Code многократно увеличивает потребление API

Архитектура Roo Code принципиально отличается от простых ИИ-редакторов на основе чата. Каждый режим работы (Architect, Code, Debug, Ask) поддерживает собственный контекст и может использовать отдельную модель. Когда активен режим Orchestrator, он разбивает сложную задачу на подзадачи и передаёт каждую подходящему режиму, фактически создавая параллельные диалоги, каждый из которых независимо расходует собственный бюджет токенов.

Одна задача под управлением Orchestrator, например «выполнить рефакторинг модуля аутентификации», может породить подзадачу Architect для планирования новой структуры, три подзадачи Code для реализации разных компонентов и подзадачу Debug для проверки результата. У каждой подзадачи есть собственный системный промпт, определения инструментов и история диалога. Общее потребление токенов растёт не аддитивно, а мультипликативно, поскольку каждая подзадача начинается с нуля с загрузкой полного контекста.

Ситуацию усугубляет то, что Roo Code использует исключительно нативные вызовы инструментов. В отличие от некоторых агентов, которые при сбое нативных вызовов переходят на вызов инструментов через XML, Roo Code требует от API поддержки нативного вызова функций. Каждый вызов инструмента (чтение файла, запись, команда терминала) представляет собой пару из структурированного вызова инструмента и ответа, добавляя накладные расходы к каждому взаимодействию. Сочетание отдельных моделей для режимов, подзадач Orchestrator и нативных вызовов инструментов делает Roo Code одним из самых ресурсоёмких потребителей API в экосистеме VS Code.

Настройка профилей конфигурации API

Roo Code объединяет настройки провайдера в профили конфигурации API. Каждый профиль содержит тип провайдера, базовый URL, ключ API, идентификатор модели и необязательные параметры, такие как температура и бюджет размышления. Откройте панель настроек Roo Code в VS Code и перейдите в раздел «Конфигурация API». Нажмите «Создать новый профиль», чтобы начать.

Для подключения через провайдера Anthropic выберите Anthropic в поле «Провайдер», введите https://unlimited.aiprimetech.io в поле «Базовый URL» (корневой адрес хоста, без /v1 — SDK Anthropic добавляет путь сам) и вставьте свой ключ AI Prime Tech Unlimited. Выберите модель: claude-sonnet-4-5 для сбалансированного профиля или claude-opus-4-6 для максимальных возможностей рассуждения. Установите температуру между 0 и 1 в зависимости от того, что для вас важнее: детерминированность или творческий подход.

Создайте несколько профилей для разных сценариев: быстрый профиль с Haiku для коротких вопросов, стандартный профиль с Sonnet для повседневного программирования и мощный профиль с Opus для архитектурных решений. Дайте им понятные имена (например, 'Unlimited-Sonnet', 'Unlimited-Opus'), поскольку на следующем шаге вы будете назначать эти профили конкретным режимам.

Стратегия назначения моделей для каждого режима

Главное преимущество Roo Code для пользователей безлимитного тарифа — назначение моделей для каждого режима. В настройках каждого режима (Architect, Code, Debug, Ask) есть раскрывающийся список для выбора используемого профиля конфигурации API. Оптимальная стратегия на безлимитном тарифе — не экономить ресурсы: назначьте Opus режимам Architect и Debug, где особенно важны глубокие рассуждения, а Sonnet — режимам Code и Ask, где на первый план выходят скорость и объём работы.

Режим Architect планирует сложные изменения перед их выполнением. Ему особенно полезны превосходные способности Opus анализировать последствия для всей системы, цепочки зависимостей и архитектурные шаблоны. Режим Debug также выигрывает от использования Opus, поскольку диагностика ошибок часто требует одновременно удерживать несколько гипотез и анализировать пути выполнения.

Режим Code выполняет непосредственное редактирование файлов и вызывается чаще всего. Sonnet работает достаточно быстро, чтобы обеспечивать короткий цикл обратной связи, при этом создавая качественный код. Режим Ask предназначен для коротких вопросов и объяснений — Sonnet эффективно справляется с ними. На безлимитном тарифе использование Opus во всех режимах не увеличивает расходы, но разница в задержке важна для интерактивной работы. Такое распределение даёт преимущества обоих подходов: глубокие рассуждения там, где они нужны, и быстрые ответы там, где важна скорость.

Orchestrator и подзадачи Boomerang

Режим Orchestrator (иногда называемый Boomerang) — механизм декомпозиции задач в Roo Code. Когда вы описываете сложную задачу в режиме Orchestrator, он разбивает работу на отдельные подзадачи и передаёт каждую подходящему режиму. Результаты подзадач возвращаются «бумерангом» к Orchestrator, который объединяет их и определяет следующий шаг.

Каждая подзадача выполняется в собственном контексте диалога со своим бюджетом токенов. Это означает, что одна задача Orchestrator может породить пять отдельных диалогов с Claude, каждый из которых независимо расходует десятки тысяч токенов. При оплате за токены сессия Orchestrator для реализации функции средней сложности легко может стоить несколько долларов. На безлимитном тарифе она стоит ровно столько же, сколько одно сообщение в чате: никаких дополнительных расходов.

Чтобы эффективно использовать Orchestrator с безлимитным доступом, не ограничивайте его. Позвольте ему создавать столько подзадач, сколько требует задача. Включите автоматический режим, в котором Orchestrator сам определяет разбиение на подзадачи, не запрашивая подтверждение на каждом шаге. Это улучшает результаты, поскольку Orchestrator может свободно выполнять итерации, перепланируя и повторно выполняя подзадачи по мере получения новой информации.

Пользовательские режимы с .roomodes

Roo Code поддерживает пользовательские режимы на уровне проекта, определённые в файле .roomodes в корне проекта. Для каждого пользовательского режима задаются имя, описание, дополнения к системному промпту, разрешённые инструменты и используемый профиль конфигурации API. Это позволяет создавать специализированных агентов для вашего проекта — например, режим «Миграция базы данных», имеющий доступ только к SQL-файлам и инструментам миграции, или режим «Документация», ориентированный на markdown и использующий промпт, оптимизированный для написания текстов.

Создайте файл .roomodes JSON в корне проекта. Каждая запись режима включает roleDefinition (системный промпт), allowedTools (массив имён инструментов, доступных режиму) и apiConfiguration (используемый профиль). Пользовательские режимы отображаются в списке выбора режимов вместе со встроенными.

На безлимитном тарифе пользовательские режимы позволяют экспериментировать с рабочими процессами. Создайте режим «Исследование», использующий Opus для глубокого анализа незнакомых кодовых баз. Создайте режим «Быстрое исправление», использующий Haiku для простых изменений в одну строку. Создайте режим «Ревью», который читает код и даёт обратную связь без внесения правок. Фиксированная стоимость позволяет свободно экспериментировать с конфигурациями режимов, не беспокоясь о цене неудачных попыток.

Требования к нативному вызову инструментов

Roo Code использует исключительно нативный вызов функций — в отличие от некоторых других агентов, он не переходит к вызову инструментов на основе XML. Это означает, что провайдер API должен корректно поддерживать параметр tools в Messages API, включая блоки tool_use и tool_result в многошаговых диалогах. Шлюз AI Prime Tech Unlimited полностью поддерживает это для всех моделей Claude.

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

Набор инструментов Roo Code включает операции с файлами (чтение, запись, просмотр списка), команды терминала (выполнение, чтение вывода), действия в браузере (если включены) и инструменты MCP (если настроены). Каждый вызов инструмента добавляет в диалог структурированные данные — обычно 200-500 токенов на вызов, включая результат. В сложной задаче с десятками вызовов инструментов этот объём существенно накапливается.

Устранение проблем с конфигурацией Roo Code

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

Если подзадачи Orchestrator завершаются ошибкой, а прямое использование режимов работает, причина обычно в том, что режимы подзадач наследуют профиль Orchestrator, если явно не настроено иное. Убедитесь, что каждому режиму, который может вызвать Orchestrator, назначен собственный действующий профиль. Распространённый подход — использовать конфигурацию Sonnet в качестве профиля по умолчанию и назначить Opus только режимам Architect и Debug.

Ошибки тайм-аута подключения во время длительных сеансов Orchestrator обычно означают, что одновременно выполняется слишком много подзадач и достигаются лимиты частоты запросов. Шлюз ставит избыточные запросы в очередь и возвращает результаты по мере их готовности, но VS Code может расценить задержку как тайм-аут. Если это происходит регулярно, уменьшите число одновременно выполняемых подзадач Orchestrator в настройках или просто подождите — шлюз со временем обработает все запросы в пределах ограничений добросовестного использования.

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-opus-4-6
#
# Mode Assignment:
#   Architect -> Unlimited-Opus
#   Code      -> Unlimited-Sonnet
#   Debug     -> Unlimited-Opus
#   Ask       -> Unlimited-Sonnet

Часто задаваемые вопросы

В чём преимущество назначения отдельных моделей режимам на безлимитном тарифе?

Вы можете назначать дорогие модели, такие как Opus, режимам, требующим сложных рассуждений (Architect, Debug), не беспокоясь о стоимости, а в часто используемых режимах (Code, Ask) оставить более быстрые модели для сокращения задержки. При оплате за токены такая стратегия обходится дорого; на безлимитном тарифе оптимизация качества не требует дополнительных затрат.

Как режим Orchestrator влияет на использование API?

Orchestrator разбивает задачи на подзадачи, каждая из которых выполняется в отдельном диалоге с собственным бюджетом токенов. Одна сложная задача может породить 5-10 отдельных диалогов с Claude. При оплате за токены это многократно увеличивает стоимость; на безлимитном тарифе всё покрывается фиксированной платой.

Работает ли Roo Code с эндпоинтом, совместимым с OpenAI?

Да. Создайте профиль, выберите провайдера «Совместимый с OpenAI», задайте базовый URL https://unlimited.aiprimetech.io/v1, и вручную введите идентификатор модели. Однако для наилучшей совместимости при вызове инструментов рекомендуется использовать подключение через провайдера Anthropic.

Что такое .roomodes и стоит ли их использовать?

Файл .roomodes в корне проекта определяет пользовательские режимы с конкретными инструментами, промптами и назначенными моделями. На безлимитном тарифе свободно используйте их для создания специализированных агентов под разные рабочие процессы — исследование, ревью, миграцию, документацию — не беспокоясь о дополнительных расходах на токены из-за подробных системных промптов.

Почему в Roo Code возникают ошибки вызова инструментов?

Roo Code требует нативного вызова функций и не поддерживает запасной вариант на основе XML. Убедитесь, что идентификатор модели соответствует актуальной модели Claude (claude-sonnet-4-5 или новее), а базовый URL правильно настроен для выбранного типа провайдера. В старых версиях моделей поддержка вызова инструментов может быть менее надёжной.

Начните использовать Claude за несколько минут

Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.

Получить ключ API

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.