Три части одной сборки
Cursor - это всё в одном приложении. Здесь то же самое собирается из трёх бесплатных частей: редактор VS Code, ИИ-расширение Cline и модель, к которой Cline обращается. Каждую часть ставим по очереди.
VS Code бесплатен и работает на Windows, macOS и Linux. Сайт code.visualstudio.com открывается из России напрямую, VPN не нужен.
- Откройте code.visualstudio.com. Нажмите большую кнопку Download for Windows.
- Запустите скачанный
VSCodeUserSetup-....exe. Это User Installer - не требует прав администратора. - Примите условия, оставьте галочки по умолчанию (полезно включить «Add to PATH» и пункты контекстного меню). Нажмите Install.
- Дождитесь завершения, нажмите Finish - VS Code запустится.
- Откройте code.visualstudio.com. Нажмите Download for macOS (вариант Universal подойдёт и для Intel, и для Apple Silicon).
- Скачается
.zip. Откройте его - появится приложение Visual Studio Code. - Перетащите иконку в папку Applications (Программы).
- Launchpad → Visual Studio Code. При первом запуске macOS спросит «открыть приложение из интернета?» - нажмите «Открыть».
- Откройте code.visualstudio.com и скачайте пакет под ваш дистрибутив:
.deb(Ubuntu/Debian) или.rpm(Fedora/SUSE). - Ubuntu/Debian:
sudo apt install ./code_*.deb - Fedora:
sudo dnf install ./code-*.rpm - Запустите из меню приложений или командой
code.
Cline - бесплатное расширение с открытым кодом и полноценным агентным режимом. Ставится из встроенного магазина VS Code (Marketplace) - он открывается из России свободно.
- Слева в вертикальной панели значков нажмите Extensions (иконка из четырёх квадратиков). Или горячие клавиши
Ctrl+Shift+X(Windows/Linux) /Cmd+Shift+X(Mac). - В строке поиска наберите Cline.
- В первом результате (издатель Cline, миллионы установок) нажмите синюю кнопку Install.
- Через несколько секунд слева на панели значков появится иконка Cline - нажмите на неё, откроется панель агента.
Cline - это «руки» агента, а «мозг» - модель, к которой он обращается. При первом открытии Cline попросит выбрать провайдера модели. Для не-разработчика самый простой рабочий вариант - OpenRouter: один ключ открывает десятки моделей, включая бесплатные.
3.1. Получить API-ключ OpenRouter
- Откройте openrouter.ai и войдите через Google или GitHub.
- Перейдите в раздел Keys → Create Key. Скопируйте ключ (строка вида
sk-or-...) - он показывается один раз.
3.2. Вставить ключ в Cline
- В панели Cline выберите API Provider → OpenRouter.
- Вставьте ключ в поле OpenRouter API Key.
- В поле Model выберите модель. Чтобы не платить - ищите модели с пометкой
:free. Для более умного агента - платные Claude или GPT (списываются копейки за запрос). - Нажмите Done / «Let's go» - агент готов.
Какие бывают варианты по модели:
4.1. Открыть рабочую папку
- Создайте на компьютере пустую папку - например,
ai-mastersна Рабочем столе. - В VS Code: File → Open Folder и выберите её. Если появится вопрос «Trust the authors?» - нажмите Yes, I trust.
4.2. Написать сообщение агенту
Нажмите иконку Cline на левой панели значков - откроется чат агента. Внизу есть поле ввода.
Что написать: «Привет, отвечай по-русски. Расскажи в двух словах, что ты умеешь.»
Результат: через несколько секунд агент пришлёт ответ. Если ответ есть - вся сборка работает. Если нет - смотрите раздел «Типовые проблемы» ниже или пишите в чат программы со скриншотом.
Типовые проблемы и решения
Сгруппировано по этапам. Если вашей проблемы нет - пишите в чат программы со скриншотом.
Сайт code.visualstudio.com не открывается
- Попробуйте другой браузер (Chrome, Edge, Firefox).
- Отключите расширения-блокировщики (AdBlock и корпоративные плагины).
- Если корпоративный ноутбук - попросите IT добавить
visualstudio.comв исключения фильтра.
Не понимаю, какой файл скачивать
- Windows: кнопка Download for Windows (User Installer) - подходит большинству.
- macOS: вариант Universal - работает и на Intel, и на Apple Silicon.
- Linux:
.debдля Ubuntu/Debian,.rpmдля Fedora/SUSE.
Windows требует пароль администратора
Скачивайте User Installer (не System Installer) - он ставится без прав администратора, в профиль пользователя.
Если всё равно требует - это политика организации. Отправьте ссылку code.visualstudio.com в IT, попросите установить.
macOS: «Не удаётся открыть приложение от непроверенного разработчика»
- Системные настройки → Конфиденциальность и безопасность.
- Внизу появится сообщение о блокировке → кнопка «Открыть всё равно».
- Снова запустите Visual Studio Code из Applications.
В поиске несколько расширений с похожим названием
Выбирайте то, у которого издатель Cline и миллионы установок (самое большое число загрузок). Остальные - копии или дополнения.
Установил, но иконки Cline не видно
- Иконка появляется на левой вертикальной панели значков (Activity Bar). Прокрутите её или нажмите «…» внизу.
- Или откройте палитру команд (
Ctrl+Shift+P/Cmd+Shift+P) и наберите Cline: Open. - Если не помогло - перезапустите VS Code.
Агент отвечает ошибкой про API-ключ или доступ
- Проверьте, что ключ вставлен целиком, без лишних пробелов.
- На OpenRouter проверьте, что ключ активен (раздел Keys) и на счету есть средства - или выбрана модель с пометкой
:free. - Если ошибка про регион/доступ - включите VPN и повторите запрос.
Не хочу платить - как совсем бесплатно?
- OpenRouter: выбирайте модели с суффиксом
:free- их хватает для учёбы. - Российские модели: GigaChat или YandexGPT - работают из РФ без VPN (нужен их ключ).
- Полностью локально и бесплатно: поставьте Ollama и выберите провайдера Ollama в Cline - модель крутится на вашем компьютере.
Из России не открывается сайт модели
VS Code и Marketplace работают без VPN. Доступ к модели зависит от провайдера: Anthropic и OpenAI напрямую обычно требуют VPN, OpenRouter часто открывается напрямую. Если ваш провайдер не отвечает - включите VPN или переключитесь на российскую/локальную модель.
Написал агенту - он не отвечает / крутится бесконечно
- Убедитесь, что открыта папка (File → Open Folder) - слева видно её название.
- Проверьте, что модель подключена (в настройках Cline выбран провайдер и вставлен ключ).
- Проверьте интернет; если доступ к модели требует VPN - включите его.
- Перезапустите VS Code.
- Если ничего не помогает - пришлите скриншот в чат программы.
Агент отвечает на английском
Напишите: «Отвечай по-русски» - и дальше диалог будет на русском.
Cline постоянно спрашивает разрешение на каждое действие
Так и задумано - агент показывает каждый шаг, чтобы вы контролировали, что он делает. Жмите Approve, чтобы разрешить. В настройках есть режим авто-подтверждения (Auto-approve) - включайте его, только когда освоитесь.
FAQ
Общие вопросы про VS Code с ИИ-агентом. Технические проблемы установки - в разделе выше.
Это правда бесплатно?
Да. VS Code бесплатен и с открытым кодом. Расширение Cline тоже бесплатное и открытое. Платить можно только за обращения к модели - и то не обязательно: у OpenRouter есть модели с пометкой :free, а локальные модели через Ollama работают вообще без оплаты.
Какое ИИ-расширение ставить?
Cline - бесплатное расширение с открытым кодом (5 млн+ установок). У него полноценный агентный режим: читает проект, создаёт и правит файлы, запускает команды и спрашивает разрешение на каждый шаг. Для не-разработчика это самый близкий к Cursor вариант - ставится в пару кликов и работает по-русски.
Нужно ли уметь программировать?
Нет. Достаточно объяснять задачу словами по-русски. Cline сам пишет и правит код, а вы подтверждаете шаги. Технику освоим в процессе работы над проектом.
Нужен ли VPN из России и какие модели доступны?
Сам VS Code и магазин расширений открываются из России свободно, без VPN. Доступ к модели зависит от провайдера:
- Зарубежные напрямую (Anthropic Claude, OpenAI GPT) - обычно нужен VPN.
- OpenRouter - часто открывается из РФ напрямую; если нет - через VPN. Есть бесплатные модели.
- Российские (GigaChat, YandexGPT) и локальные (Ollama на вашем компьютере) - работают без VPN.
Чем это отличается от Cursor?
Cursor - готовое приложение со встроенным агентом и своей подпиской: скачал, зарегистрировался, всё работает. VS Code с Cline - бесплатный конструктор: редактор ставите отдельно, агент отдельно, модель подключаете сами.
Настроек чуть больше, зато полностью бесплатно, гибко и можно подключить любую модель - включая российские и локальные. Логика вайбкодинга одинаковая: объясняете задачу словами, агент делает.
У меня старый MacBook / Windows - потянет?
Да. VS Code лёгкий и работает на Windows 10/11, macOS 12+ (Intel и Apple Silicon), Linux. Обычного рабочего ноутбука хватает. Ресурсоёмкая часть - модель - считается на стороне провайдера, а не на вашем компьютере (кроме варианта с локальной Ollama).
Сколько занимает вся установка?
Если всё гладко - 20-35 минут: скачать и установить VS Code (5-7 мин), поставить расширение Cline (2-3 мин), подключить модель (5-10 мин), проверить агента (3-5 мин). Заложите час с запасом.