Gemini CLI: бесплатный ИИ Агент на вашем компьютере

Вот пошаговая инструкция, адаптированная специально для Windows.

Шаг 1: Установка Node.js

 Это главный и единственный предварительный шаг.


-

	 Скачайте Node.js:





	<li>Перейдите на официальный сайт: [https://nodejs.org/](https://nodejs.org/)

	- Скачайте версию LTS (Long-Term Support — Рекомендуется для большинства пользователей). Она самая стабильная.

	 Установите Node.js:





	<li>Запустите скачанный `.msi` файл.

	- Просто нажимайте "Next" на всех этапах установки. Установщик по умолчанию сам добавит `node` и `npm` в системную переменную PATH, что нам и нужно.

	 Проверьте установку:





	<li>Откройте новую командную строку (`cmd`) или PowerShell.

	- Введите поочередно две команды, чтобы убедиться, что все установлено правильно:



 bash

node -v

	 (должна появиться версия, например, `v20.14.0`)



 bash

npm -v

	 (должна появиться версия, например, `10.7.0`)




	 Если обе команды показывают версии, вы готовы к установке Gemini CLI.

Шаг 2: Установка Gemini CLI

 У вас есть два варианта, как указано в инструкции. Рекомендую второй.

Вариант А: Запуск без установки (npx)

 Этот способ хорош, чтобы быстро попробовать инструмент, не устанавливая его в систему.


-

	 Откройте командную строку и выполните:



 bash

npx https://github.com/google-gemini/gemini-cli

	 При каждом запуске он будет скачивать последнюю версию и запускать ее.

Вариант Б: Глобальная установка (Рекомендуется)

 Этот способ установит `gemini` как постоянную команду в вашей системе. Это удобнее для регулярного использования.


- Откройте командную строку или PowerShell.

-

	 Выполните команду:



 bash




	 Ключ `-g` означает "глобально", то есть команда `gemini` будет доступна из любой папки.

Шаг 3: Первая аутентификация

 Это самый простой способ начать работу.


- После установки (или при первом запуске через `npx`) просто введите команду:bash





- Выбор темы: Сначала вас попросят выбрать цветовую схему для интерфейса. Выберите любую с помощью стрелок и нажмите Enter.

- Вход в аккаунт: Сразу после этого в вашем браузере по умолчанию откроется страница входа в Google. Войдите в свой аккаунт.

- Разрешите приложению "Google Gemini CLI" доступ к вашему аккаунту.


 После этого вы будете аутентифицированы. Этот метод дает вам бесплатный доступ с довольно щедрыми лимитами (60 запросов в минуту).

Шаг 4 (Опционально): Использование API-ключа на Windows

 Если вам нужны более высокие лимиты или вы хотите использовать Gemini в автоматизированных скриптах, лучше использовать API-ключ.


 В предоставленной вами инструкции используется команда `export GEMINI_API_KEY="..."`. Эта команда работает в Linux и macOS. В Windows используется другая команда.


-

	 Сгенерируйте ключ в [Google AI Studio](https://aistudio.google.com/app/apikey), как вы делали ранее.





-

	 Установите переменную окружения в Windows:





	<li>Откройте командную строку (`cmd`) или PowerShell.

	- Выполните следующую команду, заменив `ВАШ_КЛЮЧ_API` на ваш реальный ключ:

setx GEMINI_API_KEY "ВАШ_КЛЮЧ_API"

	- Вы увидите сообщение `SUCCESS: Specified value was saved.`

	 ВАЖНО: После выполнения этой команды перезапустите командную строку (или PowerShell), чтобы переменная стала доступна для новых сеансов.






 Теперь Gemini CLI будет автоматически использовать этот ключ вместо входа через аккаунт.

Как пользоваться? (Примеры)

 Теперь вы можете общаться с Gemini прямо из командной строки.


 Простой запрос:

gemini "Объясни, что такое Node.js, как будто мне 5 лет"

 Работа с файлами (одна из киллер-фич): Создайте файл `my_question.txt` с текстом: `"проанализируй этот код и найди возможные ошибки"`. Создайте файл `my_code.js` с вашим кодом.


 Теперь выполните:

gemini prompt < my_question.txt context < my_code.js

 Gemini получит ваш вопрос из первого файла и код для анализа из второго.


 Поздравляю! Теперь у вас установлен и настроен мощный инструмент Gemini CLI на Windows 10.

npx https://github.com/google-gemini/gemini-cli npm error code ENOENT

 Это очень распространенная проблема при первом использовании Node.js в PowerShell на Windows. Вы все сделали правильно, но столкнулись с политикой безопасности PowerShell.

Простыми словами, что произошло:

 По умолчанию PowerShell в Windows очень осторожен и не разрешает запускать никакие скрипты (файлы с расширением `.ps1`), чтобы защитить вас от вредоносных программ.


 Команда `npm` в PowerShell как раз является таким скриптом (`npm.ps1`). Поэтому PowerShell блокирует ее выполнение.

Решение 1: Разрешить выполнение скриптов (Рекомендуемый способ)

 Вам нужно изменить политику выполнения скриптов. Для этого требуются права администратора.


-

	 Откройте PowerShell от имени администратора:





	<li>Нажмите на кнопку "Пуск".

	- Введите "PowerShell".

	- В результатах поиска щелкните правой кнопкой мыши по "Windows PowerShell" и выберите "Запуск от имени администратора".

	 Проверьте текущую политику: В открывшемся синем окне администратора введите команду и нажмите Enter:



 powershell

Get-ExecutionPolicy

	 Скорее всего, вы увидите ответ `Restricted` (Ограничено).







-

	 Установите новую политику: Введите следующую команду и нажмите Enter. Эта команда разрешит запуск локальных скриптов, но по-прежнему будет требовать подпись для скриптов, скачанных из интернета (это безопасно).



 powershell

Set-ExecutionPolicy RemoteSigned

-

	 Подтвердите изменение: PowerShell задаст вам вопрос. Нажмите клавишу `Y` (или `Д`, если у вас русская версия) и затем Enter.

Изменение политики выполнения
Политика выполнения защищает компьютер от ненадежных сценариев. Изменение политики выполнения может поставить под
угрозу безопасность компьютера, как описано в разделе справки, можно узнать из статьи about_Execution_Policies на
веб-странице https:/go.microsoft.com/fwlink/?LinkID=135170. Вы хотите изменить политику выполнения?
[Y] Да - Y  [A] Да для всех - A  [N] Нет - N  [L] Нет для всех - L  [S] Приостановить - S  [?] Справка (значение
по умолчанию - "N"): Y

-

	 Проверьте результат:





	<li>Теперь закройте окно администратора PowerShell.

	- Откройте обычное окно PowerShell (не от имени администратора).

	- Снова введите команду:powershell

npm -v

 Теперь команда должна выполниться успешно и показать вам версию `npm`.

Решение 2: Простой обходной путь (без изменения политик)

 Если вы не хотите изменять политики безопасности или у вас нет прав администратора, просто используйте старую добрую Командную строку (`cmd`) вместо PowerShell.


- Нажмите `Win + R`.

- В появившемся окне введите `cmd` и нажмите Enter.

- В черном окне командной строки введите:cmd Скопировать

  Закрыть блок

npm -v

 В `cmd` нет таких строгих политик, поэтому команда `npm` будет работать без проблем.

Итог:

- Для долгосрочной работы с Node.js в PowerShell лучше использовать Решение 1.

- Для быстрой проверки или если нет прав администратора, используйте Решение 2.


 После того как `npm -v` заработает, вы сможете продолжить установку Gemini CLI командой:

bash Скопировать

Закрыть блок

npm install -g @google/gemini-cli

Установка БитриксВМ и общей папки

вопрос. у меня есть сайт на битриксе, он в сети, а его версии в гитхабе. как с твоей помощью я могу его корректировать локально?

✦ Да, это отличный и правильный способ работы. Редактирование сайта локально с последующей отправкой изменений в GitHub — это стандартная и

безопасная практика веб-разработки.

Вот пошаговый план, как мы можем это организовать:

Шаг 1: Клонирование репозитория из GitHub

Сначала вам нужно скопировать код вашего сайта из GitHub на ваш локальный компьютер. Для этого используется команда git clone.

1. Создайте папку, где будет лежать ваш проект, например, C:\Users\ourja\projects\.

2. Вам понадобится URL вашего репозитория на GitHub. Он выглядит примерно так: [https://github.com/your-username/your-site-repo.git](https://github.com/your-username/your-site-repo.git).

Как только у вас будет URL, я смогу выполнить команду для клонирования.

Шаг 2: Настройка локального веб-сервера

Bitrix — это PHP-система, которой для работы нужен веб-сервер (например, Apache), PHP и база данных (MySQL/MariaDB). Поскольку вы на Windows, у

вас есть два основных пути:





* Рекомендуемый (стандарт для Bitrix): Использовать официальную виртуальную машину "1С-Битрикс: Веб-окружение" (BitrixVM). Это готовая среда

  на Linux, которая запускается на вашем Windows через программу виртуализации (например, VirtualBox). Этот способ гарантирует, что ваше

  локальное окружение будет максимально похоже на реальный хостинг.

* Альтернативный (проще для старта): Установить WAMP-сборку, например XAMPP или Open Server. Это программы, которые устанавливают и

  настраивают Apache, PHP и MySQL прямо в Windows.

Какой путь вам кажется более предпочтительным?

Шаг 3: Настройка сайта локально

После того как код будет на компьютере и веб-сервер настроен, нужно будет:

1. Настроить веб-сервер, чтобы он "указывал" на папку с вашим сайтом.

2. Создать локальную базу данных. Вам нужно будет сделать экспорт (дамп) базы данных с вашего живого сайта и импортировать его в вашу

   локальную базу данных.

3. Отредактировать конфигурационный файл Bitrix (/bitrix/.settings.php), чтобы сайт подключался к вашей локальной базе данных, а не к

   удаленной. Важно: Этот файл с локальными настройками нельзя будет отправлять обратно в GitHub.

Шаг 4: Редактирование и проверка

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

* "Прочитай содержимое файла header.php"

* "В файле style.css измени цвет заголовков на синий"

* "Добавь новый пункт в главное меню"

Я буду выполнять эти команды, изменяя файлы в вашей локальной папке. Вы сможете сразу же открывать ваш локальный сайт в браузере и видеть все

изменения.

Шаг 5: Отправка изменений в GitHub и на живой сайт

Когда вы будете довольны результатом, мы:

1. Сохраним изменения в локальном Git-репозитории (git commit).

2. Отправим их на GitHub (git push).

3. Обновим файлы на вашем живом сервере из GitHub.

Давайте начнем с первого шага.

Пожалуйста, предоставьте URL вашего репозитория на GitHub, и я выполню команду для клонирования проекта в папку C:\Users\ourja\projects. Если

папки projects нет, я предложу ее создать.

посмотри тут уже есть первый проект из гитхаба C:\Users\ourja\OneDrive\Documents\GitHub\eusdmz

✦ Отлично, я вижу директорию C:\Users\ourja\OneDrive\Documents\GitHub\eusdmz.

Прежде чем мы начнем, мне нужно понять структуру этого проекта. Я выведу список файлов и папок в этой директории, чтобы мы могли

сориентироваться.

╭───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮

│ ✔ ReadFolder OneDrive\Documents\GitHub\eusdmz │

│ │

│ Listed 58 item(s). │

╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

✦ Отлично, я вижу стандартную структуру проекта на Битриксе. Здесь есть ядро (/bitrix/), папки с компонентами (/ajax/, /catalog/ и т.д.), меню

(.top.menu.php и другие), а также основные файлы, такие как index.php и urlrewrite.php.

Теперь, чтобы мы могли начать работу, нам нужно убедиться, что этот сайт может работать у вас локально.

Следующий шаг — настройка локального веб-сервера.

Вы уже установили какую-либо программу для веб-разработки, например, XAMPP, Open Server, или, может быть, у вас настроена BitrixVM?

Если нет, я могу помочь вам с установкой. Какой вариант вам кажется более удобным?

а как ты будешь файлы редактировать в BITRIXVM?

✦ Это очень хороший вопрос, который затрагивает важный аспект нашей совместной работы.

Я не могу напрямую редактировать файлы внутри запущенной виртуальной машины BitrixVM, потому что она является изолированной средой. Однако мы

можем настроить общую папку между вашей основной системой Windows и виртуальной машиной.

Вот как это работает:

1. Общая папка: В настройках VirtualBox (или другой программы для виртуализации) вы указываете папку на вашем компьютере с Windows (например,

   C:\Users\ourja\OneDrive\Documents\GitHub\eusdmz), которая будет "видна" внутри BitrixVM.

2. Монтирование в BitrixVM: Внутри BitrixVM эта общая папка подключается (монтируется) в определенную директорию, обычно в /home/bitrix/www/.

   Таким образом, файлы физически остаются на вашем диске в Windows, но веб-сервер внутри BitrixVM работает с ними так, как будто они

   находятся у него.

3. Редактирование в Windows: Я, как Gemini, работаю с вашей файловой системой Windows. Когда вы просите меня отредактировать файл, я изменяю

   его в C:\Users\ourja\OneDrive\Documents\GitHub\eusdmz.

4. Мгновенное отражение: Поскольку это общая папка, любые изменения, которые я вношу в Windows, мгновенно становятся доступны внутри BitrixVM.

   Вам нужно будет просто обновить страницу в браузере, чтобы увидеть результат.

Таким образом, схема выглядит так:

Вы (через меня) -> Редактируете файлы в Windows -> Изменения отражаются в BitrixVM -> Вы видите результат в браузере

Этот подход сочетает в себе удобство редактирования файлов в вашей основной операционной системе и преимущества полностью настроенной и

изолированной серверной среды BitrixVM.

У вас уже установлена BitrixVM, или мне помочь с инструкциями по ее установке и настройке общей папки?

установил virtualbox. как в него пожключить папку из пункта 1 и 2

✦ Отлично! Раз VirtualBox уже установлен, давайте настроим общую папку.

Важно: Эти действия нужно выполнить при выключенной виртуальной машине BitrixVM.

Настройка общей папки в VirtualBox

1. Откройте VirtualBox.

2. Выберите вашу виртуальную машину (например, BitrixVM) в списке слева.

3. Нажмите на иконку "Настроить" (желтая шестеренка).

4. В открывшемся окне перейдите в раздел "Общие папки".

5. Справа вы увидите иконку с синей папкой и зеленым плюсиком. Нажмите на нее, чтобы добавить новую общую папку.

6. В появившемся окне:

    * "Путь к папке": Нажмите на стрелочку и выберите "Другой...". Укажите путь к вашей папке с проектом:

      C:\Users\ourja\OneDrive\Documents\GitHub\eusdmz.

    * "Имя папки": Оно, скорее всего, автоматически заполнится как eusdmz. Можете оставить так. Это имя мы будем использовать для

      монтирования.

    * "Точка монтирования": Оставьте это поле пустым. Мы выполним монтирование командой внутри виртуальной машины.

    * Опции: Поставьте галочку "Авто-подключение". Это позволит папке автоматически подключаться при каждом запуске VM.



7. Нажмите "ОК" в окне добавления папки, а затем еще раз "ОК" в окне настроек виртуальной машины.

Подключение (монтирование) папки внутри BitrixVM

Теперь нужно запустить BitrixVM и сказать ей, куда подключить эту общую папку.

1. Запустите вашу виртуальную машину BitrixVM.

2. Когда появится меню BitrixVM, выберите пункт 6. Manage sites in the pool -> 1. Create a site и следуйте инструкциям мастера. Когда он

   спросит вас про DocumentRoot, укажите /home/bitrix/www.

3. Если у вас уже есть сайт, то вам нужно будет выполнить монтирование вручную. Для этого, когда появится черное окно с меню BitrixVM,

   выберите пункт 0. Exit (или нажмите Ctrl+C), чтобы выйти в командную строку Linux.

4. Теперь нам нужно примонтировать общую папку. Для этого я выполню команду.

[https://www.youtube.com/watch?v=6MBJorBOefk](https://www.youtube.com/watch?v=6MBJorBOefk)