раздел 02

Запуск и установка

Чаще всего терминал нужен ровно для двух вещей: что-то установить и что-то запустить. Разберём обе.

Запуск программ и скриптов

Запуск - это когда вы пишете имя программы, а она начинает работать. Например, чтобы запустить локальный сервер проекта, который вы собрали с ИИ, часто пишут что-то вроде:

npm run dev

Скрипт - это файл с набором команд. Запускают его, указав программу и имя файла. Например, скрипт на Python:

python script.py

Главное не пугаться, если после запуска терминал «завис» и не возвращает курсор. Часто это значит, что программа работает - например, держит сервер. Так и должно быть.

Установка инструментов

Установить инструмент почти всегда проще одной командой, чем искать его на сайте. Есть три самых частых менеджера установки, и выбор зависит от того, что ставите.

brew
Для приложений и программ на Mac. Homebrew - менеджер пакетов для macOS.
npm
Для инструментов и библиотек мира JavaScript и Node.js.
pip
Для библиотек языка Python.

Команды выглядят похоже - слово, потом install, потом что ставим:

brew install git
npm install -g some-tool
pip install requests

Не нужно запоминать, какой менеджер для чего. Инструкция к любому инструменту обычно прямо говорит, какую команду выполнить. Ваша задача - скопировать её осознанно (см. раздел про безопасность).

Переменные окружения и файл .env

Переменная окружения - это пара «имя - значение», которую программы могут прочитать. Чаще всего так хранят секреты: ключи доступа к API, пароли. Их не пишут прямо в код, чтобы случайно не утекли.

Обычно такие переменные складывают в файл с именем .env в папке проекта. Внутри он выглядит так:

OPENAI_API_KEY=sk-...
DATABASE_URL=postgres://...

Программа при запуске читает этот файл и берёт оттуда значения. Вам как невайбкодеру достаточно понимать: если инструкция просит «положить ключ в .env» - это значит создать или открыть этот файл и вписать туда строчку вида имя равно значение.

Как остановить процесс

Если программа работает и не отдаёт курсор обратно (например, запущенный сервер), её можно остановить. Нажмите две клавиши одновременно:

Ctrl+C

Это безопасный способ сказать программе «остановись». Курсор вернётся, и можно вводить новые команды. Запомните это сочетание - оно выручает, когда непонятно, что происходит и как выйти.