Roo Code в VS Code: подключение Claude из России

Roo Code начинает работать из России после одной правки в настройках: провайдер — Anthropic, в поле ключа — ваш API-ключ, в поле адреса — прокси, который отвечает без VPN и берёт оплату рублями. Само расширение ставится из Marketplace обычным порядком и остаётся нетронутым: ни форка, ни патча, ни туннеля. Ключ и адрес выдаёт AI для кода. Ниже — установка, настройка провайдера, режимы Roo Code и ошибки, на которых спотыкается первое подключение.

Почему Roo Code не начинает работать сразу после установки

Roo Code — открытое расширение, которое встраивает в VS Code агента. Разница с автодополнением принципиальная: подсказки по символу тут ни при чём, вы ставите задачу текстом, а расширение само ходит по проекту, собирает контекст, предъявляет план и показывает готовый дифф, прежде чем что-то записать. Запуск команд в терминале тоже идёт через подтверждение. Прежнее имя расширения — Roo Cline: от Cline оно и отделилось, этим сходство интерфейсов и объясняется.

Модели внутри нет. Roo Code умеет только разговаривать с чужим API, поэтому расходы ложатся не на расширение — оно бесплатное, — а на провайдера модели, которого вы подключаете сами: Anthropic или OpenAI напрямую, агрегатор, локальный сервер.

Дальше российский разработчик упирается сразу в два препятствия. Платёж в Anthropic не проходит без зарубежной карты, а до платежа дело обычно и не доходит: обращение к их API с российского адреса отбивается на входе. Локальный путь бесплатный, но обманчивый — агенту нужно удержать план из десятка шагов и свериться с результатом каждого, и на слабой модели этот план рассыпается уже к середине.

Отсюда и запрос «roo code не работает», с которым приходят в поиск. Расширение исправно, недоступна модель, а чинится это в настройках провайдера.

Установка расширения

С установкой проблем нет: под ограничения попали API моделей, а каталог расширений VS Code открывается из России как обычно.

1. Откройте панель расширений: Ctrl+Shift+X, на macOS Cmd+Shift+X.
2. Введите в поиск Roo Code.
3. Поставьте расширение, но посмотрите на название внимательно: рядом в выдаче будут Cline, от которого Roo Code произошёл, и Kilo Code — ещё один форк того же предка. Имена похожи, расширения разные.
4. На боковой панели добавится иконка Roo Code — по ней открывается чат.

Иконки нет — не торопитесь переустанавливать, обычно хватает перезапуска окна редактора. Нажмите Ctrl+Shift+P и выполните Developer: Reload Window.

Подключение Claude через провайдера Anthropic

Где взять ключ и адрес прокси

Понадобится ключ и адрес, который этот ключ принимает. И то и другое даёт AI для кода — сервис PurpleSchool: он проксирует Claude и GPT, отвечает на запросы из России без VPN и принимает российские карты.

Roo Code с провайдером Anthropic ждёт такой адрес:

https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic

Ключ появляется в личном кабинете сразу после оплаты подписки, в разделе «AI для кода». Пробовали завести ключ прямо у Anthropic и застряли на платёжной форме — этот сюжет разобран отдельно, в статье про API-ключ Claude из России.

Настройка провайдера в Roo Code

Заполнить нужно четыре поля, и ни одно не требует догадок.

1. В панели Roo Code нажмите шестерёнку в верхней части — она ведёт в настройки.
2. Провайдером в списке выберите Anthropic.
3. Ключ из кабинета вставьте в поле API Key.
4. Разрешите собственный адрес API: у провайдера Anthropic для этого есть переключатель, и он открывает поле Base URL. Туда положите адрес из блока выше.
5. Остаётся выбрать модель Claude и сохранить настройки.

Копируйте адрес буквально. В конец ничего дописывать не надо — ни слэша, ни /v1. Хвост /v1 принадлежит OpenAI-совместимому контракту, у Anthropic-протокола его нет, и лишний /v1 валит первое подключение чаще всего остального.

Проверять лучше не кнопкой, а делом: откройте проект и попросите агента объяснить, что происходит в конкретном файле. Ответ по вашему коду означает, что связка собрана.

Второй путь: OpenAI-совместимый адрес

Переключателя своего адреса у Anthropic не нашлось — или вам просто ближе OpenAI-совместимый контракт? У сервиса есть и такая точка входа, а Roo Code держит её отдельным провайдером в том же списке.

1. Выберите в списке вариант для OpenAI-совместимого API.
2. В Base URL положите адрес:

https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1

3. В API Key — тот же ключ, он один на оба протокола и на все клиенты.
4. В поле идентификатора модели впишите модель, доступную на вашем тарифе.

А здесь /v1 наоборот обязателен: без него Roo Code построит пути мимо API и упрётся в 404.

Оба варианта держат ключ в настройках редактора, то есть вне проекта, — коммитом его не зацепить. Риск появляется, когда ключ переезжает в файл репозитория: .env, локальный конфиг, скрипт запуска. Такой файл исключайте из индекса до первого коммита: попав в историю git, ключ останется в ней и после того, как вы удалите строку. Механика описана в справочнике по .gitignore.

Режимы Roo Code: Code, Architect, Ask, Debug и Orchestrator

Вот чем Roo Code отличается от родственников по-настоящему. У Cline один универсальный агент, здесь же работа разложена по режимам, и режим переключается прямо в чате.

• Code — режим по умолчанию: пишет и правит код.
• Architect — нацелен на план, а не на правку. Годится, когда задачу надо сперва разложить на шаги и обсудить, а писать уже потом.
• Ask — вопросы по коду без изменений в проекте. Безопасный способ разобраться в незнакомом репозитории.
• Debug — диагностика: выдвинуть гипотезы, сузить область поиска, добавить отладочный вывод.
• Orchestrator — делит большую задачу на подзадачи и раздаёт их подходящим режимам, вместо того чтобы тащить всё одним длинным диалогом.

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

Там же задаются собственные инструкции — общие и отдельные для каждого режима. В них удобно держать то, что иначе придётся повторять в каждом запросе: стек проекта, соглашения по стилю, запрет трогать сгенерированные файлы. Если вам ближе подход «инструкции лежат в репозитории и работают в любом агенте», посмотрите разбор AGENTS.md для Codex и OpenCode — идея та же, но файл один на разные инструменты.

Почему Roo Code нет в списке инструкций на странице сервиса

Ещё одна вещь, которая вызывает вопросы. У сервиса есть автонастройка одной командой:

npx @purpleschool/ai-for-code

Ей нужен установленный Node.js 22 или новее, и прописывает она ключ с адресом только тем клиентам, для которых на странице подключения лежит готовая инструкция. Roo Code среди них нет: там Claude Code, расширение для VS Code, Cursor, Windsurf, Cline в версии для JetBrains, Codex CLI, OpenCode, Pi и плагин для Neovim.

Для работоспособности это ничего не значит. Со стороны сервиса Roo Code — обычный клиент с поддержкой Anthropic и OpenAI, со стороны Roo Code сервис — обычный провайдер. Единственное следствие: два поля вы заполняете руками, как описано выше.

Частые ошибки подключения

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

403. Сервер ответил, но отказал. Три причины по частоте: закончилась подписка, закончились токены на балансе, выбранная модель не входит в ваш тариф. Четвёртая — адрес так и остался оригинальным: прямое обращение к Anthropic из России даёт ровно 403.

404. Путь собран неправильно, и проверять надо /v1: у Anthropic-адреса его быть не должно, у OpenAI-совместимого он обязан быть. Там же посмотрите, не остался ли лишний слэш в конце.

API Request Failed без внятного текста. Так выглядит почти любой сбой на пути до модели, поэтому начинайте не с модели: сверьте Base URL посимвольно вместе с хвостом, затем переставьте ключ.

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

Агент не видит файлы. К API это отношения не имеет. Агент читает рабочую папку, а не вкладку: с одним открытым файлом без папки ему просто неоткуда брать контекст. Откройте каталог проекта через File → Open Folder.

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

Roo Code или Cline: в чём разница на практике

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

• Roo Code — режимы и отдельный профиль подключения на режим. Берите, если задачи разного масштаба и хочется развести «обсудить» и «сделать», в том числе по расходу токенов.
• Cline — один агент без деления на роли, зато предельно предсказуемый: каждое действие подтверждается отдельно. Разбор — в статье про Cline в VS Code.
• Kilo Code — тот же механизм подключения, свой набор режимов и интерфейсных решений. Разбор — в статье про Kilo Code в VS Code.

Особняком стоит Claude Code — инструмент самой Anthropic. Он живёт в терминале, настраивается переменными окружения, а в VS Code приходит отдельным расширением: не чат в сайдбаре, а агент в консоли. Как устроен этот вариант, показано в статье про Claude Code и Codex в VS Code. Если же планируете прицепить к агенту внешние инструменты — базу, трекер, браузер, — протокол MCP понимают все перечисленные клиенты, меняется только место, где описан сервер: разбор подключения MCP-серверов.

Сколько стоит Roo Code через PurpleSchool

Расширение ничего не стоит, и подписки «на Roo Code» в природе нет. Деньги уходят за токены, а инструмент, который их тратит, вы меняете свободно: ключ и баланс у всех клиентов общие.

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

Про безопасность: держите по отдельному ключу на машину. Тогда утёкший ключ с ноутбука гасится сам по себе, а рабочий стол и CI продолжают работать. Деактивируются ключи там же, в личном кабинете.

Коротко

Поставить расширение, выбрать провайдера Anthropic, положить в два поля ключ и адрес прокси — на этом подключение заканчивается. Не заработало — подозреваемых тоже два: ключ, скопированный не целиком, и /v1, который нужен OpenAI-совместимому адресу и лишний у Anthropic-адреса. А дальше стоит потратить вечер на режимы: именно из-за них в Roo Code и переходят из Cline.