🎯 О чём этот конспект: Пошаговое руководство по интеграции Gemini CLI напрямую в Visual Studio Code. Разбирается процесс установки npm-пакета, активация специального расширения для IDE и использование контекстного управления кодом через терминал.

👤 Кому будет полезно: Разработчикам и вайбкодерам, которые предпочитают работать в терминале, но хотят иметь доступ к контексту открытых файлов и визуальному контролю изменений (diff) без оплаты подписок на Copilot или Cursor.

✨ Что получите: Вы научитесь превращать стандартный терминал VS Code в мощный AI-инструмент, который видит выделенный код, умеет создавать файлы «на лету» и позволяет редактировать предложенные изменения перед их принятием.

1. Установка и базовая настройка Gemini CLI

Контекст: Gemini CLI — это инструмент командной строки от Google, который позволяет взаимодействовать с моделями Gemini. Главная проблема обычных CLI-инструментов заключается в отсутствии связи с редактором кода. Однако Google выпустила обновление, которое позволяет CLI-интерфейсу «общаться» с VS Code. Это дает AI возможность видеть, какие файлы у вас открыты, и предлагать правки прямо в активном окне. Для работы требуется установленная среда Node.js, так как инструмент распространяется через менеджер пакетов npm.

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

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

• Шаг 1: Установка пакета — Откройте терминал в VS Code и выполните команду для глобальной установки Gemini CLI.

npm install -g @google/generative-ai

(Примечание: если команда не найдена, убедитесь, что у вас установлен Node.js).

• Шаг 2: Инициализация — Запустите Gemini впервые. При первом запуске внутри VS Code система сама предложит установить расширение для IDE.

gemini

• Шаг 3: Подтверждение — Когда появится запрос "Would you like to install the extension for your IDE?", выберите Yes и нажмите Enter.

Результат: Установленный CLI-инструмент, готовый к интеграции с вашим редактором.

2. Ручная активация и проверка связи с IDE

Контекст: Иногда автоматическое предложение об установке расширения не появляется (например, если вы уже пользовались Gemini CLI ранее вне VS Code). В этом случае необходимо принудительно связать терминал и редактор с помощью внутренних команд Gemini. Это критически важный этап, так как без него AI будет работать как обычный чат-бот, не видя вашего кода и не имея возможности изменять файлы.

Выгода: Гарантированная синхронизация между терминалом и открытыми файлами проекта.

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

• Шаг 1: Принудительная установка расширения — В терминале, где запущен Gemini, введите специальную команду:

\id install

• Шаг 2: Перезагрузка среды — Если возникла ошибка активации, полностью перезагрузите VS Code (Reload Window).
• Шаг 3: Проверка статуса — Чтобы убедиться, что AI «видит» ваш редактор, выполните:

\id status

Вы должны увидеть сообщение, что Gemini успешно подключен к VS Code.

Результат: Подтвержденное соединение между AI-агентом и вашей рабочей средой.

3. Работа с контекстом и генерация кода

Контекст: Основная мощь Gemini CLI в VS Code — это «context awareness» (осведомленность о контексте). AI понимает, какой текст вы выделили мышкой и какие файлы открыты во вкладках. Вы можете просить его изменить конкретный кусок кода или создать новую структуру. Перед внесением изменений инструмент показывает превью, которое можно отредактировать вручную прямо в процессе генерации, что дает пользователю 100% контроль над финальным результатом.

Выгода: Ускорение написания шаблонного кода и рефакторинга без переключения между браузером и редактором.

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

• Шаг 1: Генерация нового файла — Попросите Gemini создать структуру. Например:

Create a simple HTML file with a login form

• Шаг 2: Работа с выделенным кодом — Выделите фрагмент кода в редакторе мышкой и в терминале спросите:

Explain what this selected code does and optimize it

• Шаг 3: Принятие изменений — После генерации кода вы увидите запрос на подтверждение. Вы можете нажать чекбокс в верхнем правом углу VS Code или подтвердить действие прямо в терминале. Вы также можете отредактировать предложенный AI код в окне превью перед тем, как нажать "Accept".

Результат: Быстрое создание и модификация файлов с использованием AI, который понимает текущее состояние вашего проекта.

FAQ

В: Нужно ли платить за использование Gemini CLI в VS Code? О: На данный момент инструмент является open-source решением и использует бесплатные уровни API Google Gemini. Это отличная бесплатная альтернатива платным AI-редакторам.

В: Что делать, если команда gemini не распознается после установки? О: Убедитесь, что путь к глобальным папкам npm добавлен в системную переменную PATH. Также попробуйте перезапустить терминал или использовать npx @google/generative-ai для запуска.

В: Может ли Gemini CLI удалять файлы в моем проекте? О: Инструмент запрашивает подтверждение на любые деструктивные действия или изменения в файловой системе. Вы всегда видите diff (разницу) и должны явно одобрить изменение.

В: Работает ли это с другими IDE, например, JetBrains? О: В данном видео рассматривается интеграция именно с VS Code через специальное расширение. Для других IDE поддержка может отличаться или требовать других плагинов.

В: Как Gemini понимает, какой текст я выделил? О: Благодаря расширению \id, установленном в VS Code, терминальный процесс получает доступ к API редактора, который передает координаты и содержимое выделенного фрагмента текста в реальном времени.

Конспект создан на основе видео «How to use Gemini CLI inside VS Code» канала Dev-Shed. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=9KwMh9de1nI