Roo Code не работает или зависает на API Request: что проверить

Когда Roo Code не работает, он обычно ведёт себя одним из трёх способов: сразу показывает ошибку, бесконечно висит на «API Request» или отвечает, но не выполняет действий. Причины у этих симптомов разные, поэтому ниже диагностика идёт от самого простого к сложному. Опираемся на документацию Roo Code и ответы шлюза Zukko, проверено на 18 октября 2026.

Сначала главное: Roo Code закрыт

По официальной документации Roo Code, расширение закрыто 15 мая 2026 года; репозиторий RooCodeInc/Roo-Code на GitHub переведён в архив. Обновлений и исправлений больше не будет, поэтому часть проблем (новые модели, изменения в API провайдеров, несовместимость с будущими версиями VS Code) может так и остаться нерешённой. В качестве замены документация Roo называет Cline и ZooCode — форк, начатый сообществом. Как подключить Cline к шлюзу, описано в статье Cline: подключение↗. Если вы пока остаётесь на Roo Code, шаги ниже помогут найти причину, которая зависит от настроек, а не от самого расширения.

Шаг 0. Проверьте ключ без Roo Code

Это отсекает половину гипотез за минуту:

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

Ответ 200: ключ, баланс и модель в порядке, ищите причину в расширении. Любой другой код: смотрите таблицу кодов ниже.

Шаг 1. Провайдер и адрес

Самая частая причина «ничего не работает» после настройки: адрес не соответствует выбранному провайдеру. Откройте шестерёнку в панели Roo Code, раздел «Providers», и сверьте:

Перепутанный суффикс даёт 404: ключ принят, но запрос уходит на несуществующий путь. Подробно: base URL с /v1 и без↗. Список поддерживаемых расширений и их адресов есть в документации Zukko↗.

Шаг 2. Имя модели

Поле «Model» должно содержать id точно как в каталоге: регистр и точки важны (claude-sonnet-5-5, gpt-6.1-sol, deepseek-v4.1-flash). Неизвестное имя вернёт 404 model_not_found. Актуальный список: GET https://api.zukko.pro/v1/models.

Шаг 3. Поддерживает ли модель вызов инструментов

Это частая причина «отвечает, но ничего не делает». По документации Roo Code, он использует исключительно нативный вызов инструментов (формат tools как у OpenAI) и запасного XML-варианта нет. Если модель или поставщик реализуют его частично, будут ошибки вызова инструментов, а в худшем случае модель просто не сможет работать в Roo Code. Что делать: переключитесь на другую модель из каталога и повторите ту же задачу. Какая модель подойдёт вашему проекту, заранее сказать нельзя, проверьте на своей задаче.

Шаг 4. Висит на API Request

Это не одна ошибка, а состояние «запрос ушёл, ответа нет». Что проверить по порядку.

Объём контекста. Агент отправляет всю историю и файлы. Чем больше входа, тем дольше модель обрабатывает его до первого ответа. Если задача в сотни тысяч токенов, ожидание закономерно. Начните новую задачу или нажмите кнопку «Condense Context» вверху задачи: по документации, она сжимает ранние сообщения (за это сжатие платите отдельным вызовом модели).

Таймаут запроса. В настройках VS Code есть параметр roo-cline.apiRequestTimeout (в секундах). По документации, значение по умолчанию 600 секунд, диапазон 0–3600, 0 значит «без таймаута». Если вы когда-то поставили 0, зависший запрос будет ждать вечно. Верните разумное значение.

Лимит между запросами. В профиле API-конфигурации есть «Rate Limit»: минимальная пауза в секундах между запросами. По умолчанию 0 (выключен). Если там стоит большое число, Roo Code будет сам ждать перед каждым запросом, и это выглядит как зависание.

Ограничения у провайдера модели. Ошибка 429 может приходить не от лимитов Zukko (своего общего rate limit у шлюза нет), а от поставщика модели. Повторите запрос позже или смените модель.

Сколько стоит лишний повтор? Возьмём контекст 300K токенов входа. Формула: 0,3 × цена входа. claude-sonnet-5-5: 0,3 × 0,4 = $0,12 за каждую отправку; glm-5.3-flash: 0,3 × 0,04 = $0,012; deepseek-v4.1-flash: 0,3 × 0,013 = $0,0039 (цены на 18 октября 2026). Поэтому на больших контекстах не оставляйте автоповторы без присмотра: задайте в ключе дневной лимит в долларах.

Шаг 5. Контекстное окно

Ошибки вроде context length exceeded или 413 значит, что запрос не помещается. В Roo Code для OpenAI Compatible можно задать «Context Window» и «Max Output Tokens» в конфигурации модели: впишите реальные значения. У моделей каталога контекст разный: у большинства 1M, у Grok 256K, у GLM 128K. Roo Code, по документации, при ошибке окна сам обрезает контекст на 25% и повторяет запрос. Если ошибка повторяется, начните новую задачу или включите автоматическое сжатие в настройках контекста. Разбор самой ошибки: context length exceeded↗.

Таблица ошибок шлюза

Шаг 6. Соберите диагностику

Рядом с сообщением об ошибке в Roo Code есть ссылка «Details». Кнопка «Copy basic error info» копирует время, версию расширения, провайдера, модель и текст ошибки, а «Get detailed error info» выдаёт полный отчёт с историей задачи и конфигурацией (в нём могут быть данные проекта, не публикуйте его без просмотра). Отчёт пригодится, если вы обсуждаете проблему в сообществе или с поддержкой шлюза: трекер самого Roo Code после закрытия проекта развития не получает.

Крайняя мера: кнопка «Reset» в настройках. Будьте осторожны, она необратима: стирает профили API, ключи из хранилища, пользовательские режимы и историю задач. Перед этим экспортируйте настройки. Обычно достаточно создать новый профиль провайдера «с нуля» и сравнить его со старым.

Частые вопросы

Roo Code перестал работать после обновления VS Code. Что делать?

Создайте новый профиль провайдера и вручную вставьте адрес, ключ и модель, затем повторите шаг 0 с curl. Если ключ работает, а расширение нет, вероятна несовместимость: исправлений для закрытого Roo Code не выйдет, и разумнее перейти на поддерживаемое расширение.

Ответ приходит, но файлы не меняются

Скорее всего, модель плохо вызывает инструменты (шаг 3) или включён режим, который не может редактировать (например, Architect не меняет код). Смените режим или модель.

Висит только на больших проектах

Дело в объёме контекста. Укажите конкретные файлы через @, начните новую задачу, воспользуйтесь сжатием контекста.

Как оплатить использование из России?

Баланс в долларах пополняется СБП (платёжная страница добавляет 8,5% сверху), картой MasterCard или криптовалютой; минимум $1.