PurpleSchool — курсы программирования онлайн
  • Пути
    • Frontend React разработчик
    • Frontend Vue разработчик
    • Backend разработчик Node.js
    • Fullstack разработчик React / Node.js
    • Mobile разработчик React Native
    • Backend разработчик Golang
    • Devops инженер
    • Backend разработчик Python
  • Подписка
  • AI для кодаНовое
  • О нас
    • Отзывы
    • Реферальная программа
    • О компании
    • Контакты
  • Иконка открытия меню
    • PurpleFlow
    • Сообщество
    • PurpleПлюс
    • AI Собеседование
    • AI тренажёр
    • Проекты
PurpleSchool — платформа бесплатных roadmap и курсов для разработчиков
ютуб иконка
Telegram иконка
VK иконка
VK иконка
Курсы
ГлавнаяКаталог курсовFrontendBackendFullstack
Практика
КарьераПроектыPurpleПлюсPurpleMax
Материалы
БлогБаза знаний
Документы
Договор офертаПолитика конфиденциальностиПроверка сертификатаМиграция курсовРеферальная программа
Реквизиты
ИП Ларичев Антон АндреевичИНН 773373765379contact@purpleschool.ru

PurpleSchool © 2020 -2026 Все права защищены

  • Курсы
    • FrontendИконка стрелки
    • AI разработкаИконка стрелки
    • BackendИконка стрелки
    • DevOpsИконка стрелки
    • MobileИконка стрелки
    • ТестированиеИконка стрелки
    • Soft-skillsИконка стрелки
    • ДизайнИконка стрелки
    Иконка слояПерейти в каталог курсов
  • Бесплатно
    • Курсы
    • JavaScript Основы разработкиPython Основы PythonCSS CSS FlexboxКарта развитияВопросы для собеседований
    • База знанийИконка стрелки
    • Новостные рассылкиИконка стрелки
  • PurpleSchool — курсы программирования онлайн
    • Подписка
    • AI для кодаНовое
    • Сообщество
    Главная
    Сообщество
    Roo Code: что это, установка в VS Code и подключение из России

    Roo Code: что это, установка в VS Code и подключение из России

    Аватар автора Roo Code: что это, установка в VS Code и подключение из России

    Антон Ларичев

    Иконка календаря07 октября 2026
    Claude CodeAI-инструментыDevOpsразработкаapimiddleИконка уровня middle

    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
    1. В API Key — тот же ключ, он один на оба протокола и на все клиенты.
    2. В поле идентификатора модели впишите модель, доступную на вашем тарифе.

    А здесь /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» в природе нет. Деньги уходят за токены, а инструмент, который их тратит, вы меняете свободно: ключ и баланс у всех клиентов общие.

    ТарифЦенаТокенов в месяц
    Помощник499 ₽ / мес2,5 млн
    Напарник1 199 ₽ / мес5,5 млн
    Соавтор2 499 ₽ / мес12,5 млн

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

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

    Коротко

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

    Иконка глаза732

    Комментарии

    0
    Бесплатный курс

    Учитесь программировать с AI-агентом — бесплатно

    Курс «AI в обучении: OpenCode и skills»: поставите агента и разберёте с ним любую тему — как эту статью.

    opencode

    >объясни этот код и дай задачу

    ◆Читаю src/server.ts…

    ✓Разбор готов: 4 шага

    ✓Задача → practice/01.md

    • Установка и настройка OpenCode
    • Агент и skills на практике
    • 13 уроков, 3 модуля
    Начать бесплатно

    0 ₽ · доступ сразу после регистрации

    Бесплатные лекции

    Лучшие курсы по теме

    изображение курса

    CSS Flexbox

    Антон Ларичев
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    бесплатно
    Подробнее
    изображение курса

    Основы JavaScript

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.8
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    Продвинутый JavaScript

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.8
    3 999 ₽ 6 990 ₽
    Подробнее

    Похожие статьи

    Картинка поста Обучение Claude Code: с чего начать, курсы и материалы
    Иконка аватараАнтон
    Иконка календаря09 ноября 2026
    AI-инструментыClaude CodeразработкаjuniorИконка уровня junior

    Обучение Claude Code: с чего начать, курсы и материалы

    С чего начать обучение Claude Code: план на первую неделю, порядок тем, бесплатные материалы, курсы и как получить доступ для практики из России.

    Иконка чипа0
    Иконка глаза686
    Иконка комментариев0
    Картинка поста Как установить OpenCode на Windows
    Иконка аватараАнтон
    Иконка календаря06 ноября 2026
    AI-инструментыapiразработкаjuniorИконка уровня junior

    Как установить OpenCode на Windows

    Как установить OpenCode на Windows через npm, Chocolatey, Scoop или WSL, задать ключ в PowerShell, подключить модель из России и исправить частые ошибки.

    Иконка чипа0
    Иконка глаза3 004
    Иконка комментариев0
    Картинка поста Claude Code в JetBrains: IntelliJ, PyCharm, WebStorm из России
    Иконка аватараАнтон
    Иконка календаря21 ноября 2026
    Claude CodeJetBrainsAI-инструментыjuniorИконка уровня junior

    Claude Code в JetBrains: IntelliJ, PyCharm, WebStorm из России

    Как подключить Claude Code к IDE от JetBrains из России: установка плагина, настройка ключа, запуск и частые проблемы.

    Иконка чипа0
    Иконка глаза11
    Иконка комментариев0
    Иконка чипа0