🎯 О чём этот конспект: Подробное руководство по установке и настройке Roo Code — мощного open-source агента для VS Code. В видео разбирается, как использовать топовые модели (Gemini 2.0) абсолютно бесплатно и как настроить разные AI-роли для архитектуры, кодинга и дебага.

👤 Кому будет полезно: Вайбкодерам, разработчикам и тем, кто ищет бесплатную, но более гибкую альтернативу Cursor AI без необходимости привязки банковских карт.

✨ Что получите: Вы научитесь настраивать Roo Code «под ключ», подключать бесплатные API ключи Google Gemini и создавать специализированные профили для разных задач разработки.

1. Установка и первичная настройка Roo Code

Контекст: Roo Code (ранее известный как Cline) — это расширение для VS Code, которое превращает редактор в автономного AI-агента. В отличие от Cursor, который требует подписку, Roo Code позволяет подключать любых провайдеров через API. Это дает полный контроль над расходами и выбором моделей. Автор подчеркивает, что это «Cursor для тех, кто не хочет платить», но с более глубокой кастомизацией ролей.

Выгода: Полностью бесплатный доступ к продвинутым AI-моделям внутри привычного VS Code.

Как применить:

• Шаг 1: Установка расширения — Откройте VS Code, перейдите в Marketplace (Ctrl+Shift+X), введите Roo Code и нажмите Install. В боковой панели появится иконка кенгуру.
• Шаг 2: Сброс настроек (опционально) — Если вы уже пробовали расширение и хотите начать с чистого листа, нажмите на шестеренку в Roo Code и выберите Reset to factory settings.

Результат: Чистая установка Roo Code, готовая к подключению мозгов (LLM).

2. Подключение бесплатных моделей через Google Gemini API

Контекст: Для работы агента нужен «мозг». Самый выгодный способ на текущий момент — использование Google Gemini через AI Studio. Google предоставляет щедрые бесплатные лимиты (Free Tier), которых достаточно для ежедневной разработки. Автор рекомендует использовать Gemini 2.0 Flash или Pro в зависимости от сложности задачи.

Выгода: 1500 запросов в день бесплатно (для модели Gemini 2.0 Flash).

Как применить:

• Шаг 1: Получение ключа — Перейдите в Google AI Studio. Нажмите Get API key -> Create API key in new project. Скопируйте полученный ключ.
• Шаг 2: Настройка провайдера — В Roo Code выберите API Provider: Google Gemini.
• Шаг 3: Выбор модели — Вставьте ключ и выберите модель. Автор рекомендует:
  • gemini-2.0-flash-exp (или актуальную Flash версию) — 30 запросов в минуту, 1500 в день. Идеально для кодинга.
  • gemini-1.5-pro — для сложных архитектурных задач (более лимитирована).

Результат: Агент подключен к интернету и готов выполнять команды.

3. Создание конфигурационных профилей под разные задачи

Контекст: Одна из киллер-фич Roo Code — возможность создавать профили. Вы можете настроить один профиль с «умной», но дорогой (или медленной) моделью для планирования, и другой — с быстрой и бесплатной для написания кода. Это позволяет оптимизировать лимиты API и качество кода.

Выгода: Экономия лимитов мощных моделей и высокая скорость работы на простых задачах.

Как применить:

• Шаг 1: Создание профиля «Архитектор» — Нажмите на шестеренку -> Configuration Profiles -> +. Назовите его Thinking Buddy. Выберите модель Gemini 1.5 Pro (она лучше рассуждает).
• Шаг 2: Создание профиля «Кодер» — Создайте профиль Coding Agent. Выберите модель Gemini 2.0 Flash. Она быстрее и имеет больше бесплатных запросов.
• Шаг 3: Переключение — Теперь вы можете мгновенно переключаться между наборами настроек в зависимости от того, проектируете вы систему или фиксите баги.

Результат: Гибкая система, где для каждой задачи используется наиболее подходящая модель.

4. Использование специализированных режимов (Modes)

Контекст: Roo Code предлагает предустановленные роли: Code, Architect, Ask, Debug и Orchestrator. Каждая роль имеет свой системный промпт. Например, Architect сначала составляет план в Markdown и ждет одобрения, прежде чем начать писать код. Orchestrator координирует сложные задачи, делегируя их другим под-агентам.

Выгода: AI ведет себя более профессионально, не совершает необдуманных действий и следует методологии разработки.

Как применить:

• Шаг 1: Режим Architect — Используйте его для начала проекта. Промпт: Make a web-based calculator with HTML, CSS and JS. Архитектор создаст план и спросит: I am pleased with the plan. Please proceed.
• Шаг 2: Режим Code — После одобрения плана переключитесь в Code (или Roo предложит сам). В этом режиме агент начнет создавать файлы и писать логику.
• Шаг 3: Авто-апрув — Чтобы не нажимать «ОК» на каждое действие, в настройках можно включить Auto-approve: Read and Write. Будьте осторожны: агент сам будет менять файлы.

Результат: Структурированный процесс разработки от идеи до реализации без ручного копипаста.

5. Контроль безопасности и «Вайб-кодинг»

Контекст: Автор предупреждает: AI может предлагать небезопасные решения. В примере с калькулятором Roo Code предложил использовать функцию eval(), которая является дырой в безопасности. Важно проверять код и просить AI улучшить его.

Выгода: Безопасный и чистый код даже при использовании AI-агентов.

Как применить:

• Шаг 1: Проверка на безопасность — Если видите сомнительный код, спросите в режиме Ask:

Shouldn't we sanitize the input before using eval? Suggest a safer alternative.

• Шаг 2: Контекстные действия — Выделите кусок кода в редакторе, нажмите на «лампочку» (Quick Fix) и выберите Explain with Roo Code или Add to Roo Code. Это добавит конкретный фрагмент в контекст чата для точечной правки.

Результат: Вы сохраняете контроль над качеством кода, используя AI как мощного ассистента, а не слепо доверяя ему.

FAQ

В: Чем Roo Code лучше Cursor? О: Roo Code полностью бесплатен (при использовании бесплатных API), поддерживает любые модели (через OpenRouter, Ollama, Gemini), имеет открытый исходный код и позволяет гибко настраивать системные промпты для разных ролей (Architect, Debugger и т.д.).

В: Можно ли использовать Roo Code локально? О: Да, вы можете выбрать провайдера Ollama или LM Studio в настройках и использовать локальные модели типа Llama 3 или DeepSeek, если ваше железо позволяет. Это обеспечит полную приватность кода.

В: Что делать, если закончились лимиты Gemini? О: Вы можете создать несколько API ключей на разные аккаунты Google или переключиться на провайдера OpenRouter, где доступны десятки моделей с оплатой только за использованные токены (pay-as-you-go).

В: Как заставить Roo Code видеть все файлы проекта? О: Roo Code автоматически индексирует файлы в открытой папке VS Code. В режиме Architect он может анализировать структуру всего проекта, чтобы предлагать изменения, не нарушающие общую логику.

В: Безопасно ли давать Roo Code доступ к терминалу? О: По умолчанию Roo Code запрашивает разрешение на выполнение команд. Если вы включите Auto-approve для терминала, агент сможет сам устанавливать зависимости и запускать тесты. Рекомендуется использовать это только в доверенных проектах.

Конспект создан на основе видео «Roo Code: The Best FREE AI Coding Tool (Better than Cursor?)» канала AI Code Academy. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=_Rs1kmaUlIQ