Roo Code: быстрая настройка за пять минут

Roo Code — форк Cline, и настройки провайдера у него устроены почти так же. Разница в основном в названиях пунктов меню, а логика — какой base URL куда вписывать — одна и та же. Ниже пять шагов, без лишних отступлений.

Шаг 1. Получить ключ

Зайдите в кабинет https://zukko.pro/app/api-keys↗ и создайте ключ. Он покажется один раз, в формате fetch_... — скопируйте сразу, второй раз его не покажут.

Шаг 2. Открыть настройки провайдера

В панели Roo Code откройте Settings (иконка шестерёнки) → Providers. В списке API Provider выберите один из двух вариантов в зависимости от того, какие модели нужны:

• Anthropic — для моделей Claude через /v1/messages.
• OpenAI Compatible — для GPT, GLM или того же Claude через /v1/chat/completions.

Шаг 3. Base URL — самый важный шаг

Это место, где чаще всего теряют время. Base URL зависит от выбранного провайдера:

• Anthropic: https://api.zukko.pro — без /v1, Roo Code сам добавит нужный путь.
• OpenAI Compatible: https://api.zukko.pro/v1 — с суффиксом.

Перепутанный суффикс — самая частая причина 404 при первом подключении: ключ принимается, но любой запрос уходит в никуда.

Шаг 4. Вписать ключ и выбрать модель

API Key: вставьте fetch_... без пробелов до и после.

Model:

• Через Anthropic-провайдер — claude-opus-5-5 (Claude Opus 5.5, контекст 1,000,000 токенов) или claude-sonnet-5.
• Через OpenAI Compatible — gpt-5.6-sol, gpt-5.6-luna, glm-5.3, glm-5.3-flash или те же модели Claude.

Актуальный список моделей без ключа:

curl https://api.zukko.pro/v1/models

Шаг 5. Проверить, что всё работает

Задайте Roo Code любой простой вопрос в чате. Если ответ пришёл — готово. Если нет, проверьте ключ отдельно от расширения:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"ping"}]}'

Ответил curl, но не Roo Code — проблема в настройках расширения. Не ответил и curl — ошибка в теле ответа скажет, что чинить.

Частые ошибки на старте

• 401 — ключ не принят: {"error":{"message":"Invalid API key. Use Authorization: Bearer fetch_*","type":"authentication_error"}}. Обычно это опечатка или обрезанный при копировании ключ.
• 402 — баланс пуст: {"error":{"message":"Недостаточно средств на балансе","code":"insufficient_balance"}}. Проверка происходит до похода к модели — неудачный запрос ничего не стоит.
• 404 model_not_found — модель не совпадает с каталогом, регистр и точки в версии значимы.
• 400 model_retired — модель снята с обслуживания, замена указана в тексте ошибки.
• 503 model_disabled — модель выключена в каталоге; выберите другую из /v1/models.
• 403 model_not_allowed_for_key — на этот ключ в кабинете настроен список разрешённых моделей, и запрошенной модели в нём нет.
• 429 — от Zukko это только лимит конкретного ключа (key_daily_limit_reached со сбросом в 00:00 UTC / key_monthly_limit_reached); общего rate limit на шлюзе нет, прочие 429 приходят от провайдера модели.

Что полезно включить сразу

Если Roo Code генерирует по многу полностью одинаковых запросов при агентном режиме — например, повторные проверки одного и того же файла, — включите кэш: заголовок X-Zukko-Cache: true (temperature: 0 тоже включает кэш, но только у моделей, которые его принимают, — модели Claude могут отклонить temperature, отличный от 1). Запросы одного пользователя с полностью совпадающим телом кэшируются на срок до 7 суток для чата (похожие, но не идентичные — нет), повторный ответ приходит мгновенно и бесплатно, в ответе будет X-Zukko-Cache: hit.

Если сеть нестабильна и Roo Code иногда дублирует запрос при разрыве соединения, добавьте заголовок Idempotency-Key со своим уникальным значением на каждый логический запрос (одинаковым при его повторах) — повтор с тем же ключом за 24 часа вернёт тот же ответ без повторного списания.

Лимиты и деньги

На странице ключа в кабинете можно задать дневной или месячный лимит расхода в долларах и ограничить список разрешённых моделей — полезно, если ключ используется в общем проекте. Заголовки X-Zukko-Cost-Micros (стоимость запроса в микродолларах, 1,000,000 = $1) и X-Fetch-Balance-Cents (остаток после списания, тоже в микродолларах) сервер присылает только в обычных JSON-ответах, а Roo Code получает ответы потоково — у потоковых ответов этих заголовков нет. Расход для Roo Code смотрите в кабинете, через GET /v1/usage или GET /v1/balance.

Пополнение — СБП, карта через PayPear, крипта, иностранная карта Mastercard EU через Fride (комиссия около 13%, суммы $2–$594); минимум — $1. Разовый бонус $0.50 — за подписку на @zukkopro↗: привязка Telegram в кабинете, подписка, кнопка «Проверить»; один раз на Telegram-аккаунт. Стартового баланса при обычной регистрации больше нет.

Бесплатный подсчёт токенов перед запуском

Roo Code в агентном режиме может собрать в один запрос сразу несколько файлов проекта, и полезно заранее знать, во сколько токенов это выльется. Эндпоинт /v1/messages/count_tokens считает токены без выполнения самого запроса и без списания денег:

curl https://api.zukko.pro/v1/messages/count_tokens \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"текст задачи"}]}'

Полная история расходов

GET /v1/usage отдаёт историю списаний по всему аккаунту (все ключи вместе, фильтра по ключу нет) с курсорной пагинацией — удобно посмотреть, какая именно задача в Roo Code потратила больше всего токенов, если несколько прогонов шли подряд. Если ключ общий на команду, стоит сразу выставить лимиты на странице ключа в кабинете, а не разбираться постфактум, кто и сколько потратил.