Roo Code с Claude и GPT: настройка через свой API-ключ

Roo Code — AI-агент для программирования в VS Code с открытым исходным кодом. Он работает в режимах, например Code, Architect и Ask, читает и правит файлы проекта и с вашего разрешения запускает команды. Своей модели у Roo Code нет: вы подключаете API-провайдера, и каждый шаг задачи — это запрос, который оплачивается у него.

APIVAI даёт один ключ для моделей Claude и GPT с оплатой за токены ниже официальных цен, с баланса, который вы пополняете сами. Ключ работает и в формате OpenAI, и в формате Anthropic, поэтому подходит для обоих нужных вариантов провайдера в Roo Code, а каждому режиму можно дать свою модель без нескольких аккаунтов.

Выбирайте OpenAI Compatible, если нужны модели GPT или ID Claude, которого пока нет во встроенном списке Roo Code. Выбирайте Anthropic, если работаете только с Claude: провайдер Anthropic в Roo Code добавляет метки cache_control к системному промпту и последним сообщениям, и повторяющийся контекст читается из кэша по $0.10 за миллион токенов для Claude Sonnet 4.6 вместо полной цены входа. Запись в кэш стоит $1.31 за миллион. С профилями (см. ниже) можно держать оба варианта и переключаться по режимам.

1. Зарегистрируйтесь на apivai.com по email.
2. Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Бесплатного периода и подписки нет.
3. В Панели создайте ключ и скопируйте его. Задайте лимит бюджета, если хотите жёстко ограничить расходы Roo Code.

1. В VS Code откройте панель Roo Code, нажмите на шестерёнку и откройте Providers.
2. В API Provider выберите OpenAI Compatible.
3. Заполните поля по таблице и сохраните.

Base URL заканчивается на /v1 ровно один раз; Roo Code сам добавляет /chat/completions. В настройках модели есть также Context Window, Image Support и Computer Use; оставьте значения по умолчанию, если нет причины их менять. Поля цен меняют только оценку стоимости, которую показывает Roo Code; реальные списания видны в Панели.

Roo Code использует только нативный вызов инструментов, поэтому модель должна поддерживать function calling. APIVAI передаёт вызовы инструментов через /v1/chat/completions, и рекомендованные ниже модели Claude и GPT их поддерживают.

Проверьте, какие ID доступны вашему ключу:

Модели со временем добавляются и снимаются, поэтому копируйте ID из этого списка или со страницы цен.

1. В Providers нажмите кнопку + рядом с выбором профиля и назовите новый профиль, например «APIVAI Claude».
2. В API Provider выберите Anthropic.
3. Вставьте ключ APIVAI в Anthropic API Key.
4. Отметьте Use custom base URL и введите https://api.apivai.com.
5. Выберите модель Claude в списке Model.

Не добавляйте /v1: Roo Code передаёт этот адрес в Anthropic SDK, который сам добавляет /v1/messages, так что https://api.apivai.com/v1 превратится в /v1/v1/messages и вернёт 404. О формате Anthropic — на странице прокси для Claude API.

Roo Code запоминает, какой профиль конфигурации вы последним использовали в каждом режиме, а в настройках режимов профиль можно закрепить явно. Разумное разделение: профиль Claude Opus 5.5 для Architect (планирование), Claude Sonnet 4.6 для Code и дешёвый профиль Claude Haiku 4.5 или GPT-6 Luna для Ask. Все профили могут использовать один и тот же ключ APIVAI.

Цены за 1M входных / выходных токенов на 2026-10-07:

Моделям GPT нужен провайдер OpenAI Compatible. Если задача на Sonnet ходит по кругу, переключите профиль этой задачи на Opus, а не делайте Opus моделью по умолчанию.

Каждый шаг задачи Roo Code заново отправляет переписку и уже прочитанные файлы, поэтому основную часть расходов дают входные токены. Два расчёта:

• Одна задача в режиме Code на Claude Sonnet 4.6: около 25 запросов по 35 000 входных и 2 000 выходных токенов. Стоимость: $1.17 с APIVAI, $3.38 по официальным ценам.
• Рабочий месяц по три такие задачи в день в течение 22 дней (1 650 запросов): $77.29 с APIVAI, $223 по официальным ценам. Если 20 вопросов в день в режиме Ask отдать Claude Haiku 4.5 (по 8 000 входных и 800 выходных токенов, 440 в месяц), это добавит всего $1.84.

В расчётах не учтено кэширование промптов, которое удешевляет повторяющийся контекст при работе через провайдер Anthropic. Токены размышлений считаются выходными. Реальные цифры по каждому запросу — в Панели. Более широкое сравнение — в статье цены Claude API в 2026 году.

• 401 / неверный ключ: ключ неполный, удалён или исчерпал лимит бюджета; проверьте Панель. Для провайдера Anthropic убедитесь, что отмечено Use custom base URL, иначе ключ уйдёт напрямую в Anthropic.
• 404 Not Found: неправильный /v1. OpenAI Compatible: https://api.apivai.com/v1, без /chat/completions в конце. Anthropic: https://api.apivai.com, без /v1.
• Модель не найдена: укажите точный ID, например claude-sonnet-4-6, а не отображаемое название. Сверьтесь с GET /v1/models.
• Ошибки вызова инструментов: выберите модель с поддержкой function calling, например из таблицы выше.
• Пустые или обрезанные ответы: размышления включены по умолчанию и расходуют выходные токены. Установите Max Output Tokens 8192 (минимум 4096).
• 429 Too Many Requests: по умолчанию 60 запросов в минуту на ключ. Подождите немного или попросите поддержку увеличить лимит.

Подробнее о форматах запросов — в документации и на странице OpenAI-совместимый API.

Да. Один ключ APIVAI работает со всеми моделями. Создайте по профилю на модель или меняйте поле Model в профиле OpenAI Compatible.

OpenAI Compatible — для моделей GPT и для любых ID, которых нет в списке Roo Code. Anthropic — для работы только с Claude, где Roo Code запрашивает кэширование промптов; базовый адрес указывается без /v1.

Да. Roo Code связывает профили конфигурации с режимами, так что Architect может работать на Opus, а Code — на Sonnet, и всё с одним ключом.

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

Почти полностью. См. руководство по настройке Cline: названия полей и адреса те же.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Roo Code.