РазработкаГайд

iTerm2 + Zsh + Oh My Zsh: настройка терминала на Mac в 2026

Ставлю iTerm2 3.7, Oh My Zsh, тему и два плагина Zsh по шагам с настоящим выводом команд. Плюс что случилось с Powerlevel10k и какие ошибки ломают настройку.

iTerm2 + Zsh + Oh My Zsh: настройка терминала на Mac в 2026

Ты открываешь терминал на новом Mac и видишь голое приглашение: ни ветки Git, ни подсказок из истории, а опечатку замечаешь только после Enter. Настройка iTerm2, Zsh и Oh My Zsh чинит это минут за десять: ставишь iTerm2 через Homebrew, проверяешь, что оболочка по умолчанию уже Zsh, одной командой ставишь Oh My Zsh, потом выбираешь тему и включаешь два плагина.

Я начинал с этой связки, а потом сменил терминал на Ghostty. Zsh с Oh My Zsh, Powerlevel10k и теми же двумя плагинами остались в моём ~/.zshrc: они работают в любом терминале. Для этого обновления я заново поставил Oh My Zsh в чистую папку, проверил версии на 6 ноября 2026 года и снял каждый шаг с настоящего вывода команд.

В статье разберём:

  • зачем менять Terminal.app на iTerm2 и что даёт Oh My Zsh;
  • шаг 1: установка iTerm2 через Homebrew;
  • шаг 2: проверка Zsh и установка Oh My Zsh;
  • шаг 3: тема Oh My Zsh и цвета терминала;
  • что сейчас с Powerlevel10k и чем его заменить;
  • шаг 4: плагины Oh My Zsh;
  • шаг 5: алиасы в Zsh;
  • какие ошибки ломают настройку.

Зачем менять Terminal.app на iTerm2 и ставить Oh My Zsh

В связке три части, и каждая отвечает за своё.

iTerm2. Это программа-терминал, то есть окно, в котором работает оболочка. Встроенный Terminal.app тоже с этим справляется, но в iTerm2 есть сплиты окна, горячее окно по сочетанию клавиш, поиск по выводу, история вставок, профили и триггеры. Он бесплатный, распространяется под лицензией GPL v2 и работает только на macOS.

Zsh. Это оболочка: программа, которая читает твои команды и запускает их. Отдельно её ставить не нужно, Apple сделала Zsh оболочкой по умолчанию для новых пользователей ещё в macOS 10.15 Catalina. Bash остался только на системах 10.14 и старше.

Oh My Zsh. Это фреймворк для настройки Zsh: готовые темы, плагины и автодополнения, которые включаются одной строкой в ~/.zshrc. По данным GitHub API на 6 ноября 2026 года у репозитория Oh My Zsh больше 190 тысяч звёзд, в нём 372 папки с плагинами и 143 встроенные темы. Последний коммит был 2 ноября, проект живой.

Что изменилось за год? iTerm2 сильно ушёл в сторону AI. В версии 3.6 от сентября 2025 года появился AI-чат, который с твоего разрешения выполняет команды, а в версии 3.7 добавили интеграцию с Claude Code и группы вкладок. Если ты запускаешь в терминале агентов для кода, iTerm2 покажет на вкладке, какая сессия ждёт ответа. Подробнее про это и про соседей iTerm2 я писал в сравнении терминалов для macOS.

Окно iTerm2, разделённое на две панели: слева Vim с кодом на C, справа вывод компилятора
Сплиты iTerm2: в одном окне редактор и сборка проекта, без tmux. Изображение: iTerm2

Шаг 1. Установить iTerm2 через Homebrew

Проще всего ставить iTerm2 через Homebrew: так его легко обновлять и удалять. Если Homebrew ещё нет, команда установки с brew.sh за год не поменялась:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Потом ставишь сам iTerm2:

brew install --cask iterm2

Перед установкой полезно заглянуть в brew info. Там видно версию, требования к системе и то, сколько людей ставили приложение. На 6 ноября 2026 года в Homebrew лежит iTerm2 3.7.7, ему нужна macOS 13 или новее, а за последние 30 дней его установили через Homebrew 18 010 раз.

Терминал с выводом zsh --version, echo $SHELL и brew info --cask iterm2
Zsh 5.9 уже стоит в системе и выбран оболочкой, а iTerm2 3.7.7 требует macOS 13+. Скриншот: терминал / matveev.tech

После установки открой iTerm2 из Launchpad или через Spotlight. Обновления он ставит сам (в brew info это пометка auto_updates), поэтому brew upgrade для него можно не запускать.

Homebrew для macOS: обзор пакетного менеджера
Как устроен Homebrew, чем cask отличается от формулы и как держать программы на Mac обновлёнными.

Шаг 2. Проверить Zsh и установить Oh My Zsh

Сначала убедись, что работаешь в Zsh. Это видно по двум командам на скриншоте выше: zsh --version покажет версию, echo $SHELL покажет оболочку по умолчанию. Если там /bin/bash (так бывает на учётных записях, перенесённых со старых Mac), переключись командой из той же справки Apple:

chsh -s /bin/zsh

Ставить Zsh из Homebrew ради Oh My Zsh не нужно: системной версии 5.9 хватает. В старой версии статьи я советовал brew install zsh «на всякий случай», сейчас бы этого не делал. Вторая копия оболочки только путает, какая из них запускается.

Теперь сам Oh My Zsh. Команда из README проекта:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Установщик клонирует репозиторий в ~/.oh-my-zsh и создаёт новый ~/.zshrc из шаблона. Если старый ~/.zshrc у тебя был, он не пропадёт: установщик сохранит его как ~/.zshrc.pre-oh-my-zsh. Оттуда потом можно перенести свои переменные и PATH.

Вывод установщика Oh My Zsh с цветным логотипом и надписью is now installed
Установщик сам создал ~/.zshrc и предлагает сначала посмотреть плагины и темы. Скриншот: терминал / matveev.tech

После установки открой новую вкладку. Приглашение сменится на тему по умолчанию robbyrussell: стрелка, имя папки и ветка Git, а жёлтый крестик означает, что в репозитории есть незакоммиченные изменения.

Приглашение Zsh с темой robbyrussell в папке project на ветке main
Тема robbyrussell показывает папку и ветку, а крестик говорит о незакоммиченных правках. Скриншот: терминал / matveev.tech

Шаг 3. Выбрать тему Oh My Zsh и цвета терминала

Внешний вид терминала задают две независимые настройки. Тема Oh My Zsh отвечает за приглашение: что в нём показано и в каком порядке. Цветовая схема iTerm2 отвечает за палитру: фон, текст и 16 цветов ANSI, которыми программы раскрашивают вывод.

Тема меняется одной строкой в ~/.zshrc:

ZSH_THEME="agnoster"

Все 143 встроенные темы со скриншотами собраны в вики Oh My Zsh. Если не можешь выбрать, поставь ZSH_THEME="random": каждая новая вкладка откроется со случайной темой, а её название Oh My Zsh напишет при запуске.

Цвета в iTerm2 настраиваются в профиле: Settings → Profiles → Colors (в старых версиях окно называлось Preferences, открывается сочетанием Cmd+,). Справа внизу есть меню Color Presets…, через пункт Import… в него загружается файл .itermcolors.

Вкладка Colors в настройках профиля iTerm2 с базовыми цветами, цветами ANSI и меню Color Presets
Готовую схему загружают через Color Presets справа внизу. Скриншот старой версии окна с сайта iTerm2. Изображение: iTerm2

Где брать схемы? Самый большой каталог это iTerm2-Color-Schemes: на 6 ноября 2026 года в нём 909 файлов .itermcolors. Смотреть их удобнее на новом сайте авторов, terminalthemes.com. Он пока в открытой бете, зато показывает каждую схему на одном и том же выводе ls -la и отдаёт файл сразу под iTerm2, Ghostty и другие терминалы.

Каталог terminalthemes.com: шесть карточек цветовых схем с превью вывода ls -la
Каждая схема показана на одном и том же выводе, их удобно сравнивать между собой. Скриншот: terminalthemes.com / matveev.tech

В старой версии статьи я ставил Material Design. Схема по-прежнему работает, но её репозиторий не обновлялся с сентября 2022 года. Для цветовой схемы это не страшно, это просто файл с палитрой. Популярная Dracula тоже на месте. Ну и в самом iTerm2 есть встроенные пресеты, например Solarized и Tango.

Что сейчас с Powerlevel10k и чем его заменить

Powerlevel10k одна из самых популярных тем для Zsh: на 6 ноября 2026 года у неё 55 тысяч звёзд на GitHub. Он показывает в приглашении папку, ветку и статус Git, время выполнения долгих команд и код ошибки, а настраивается мастером p10k configure без правки конфигов. Вот так выглядит его стиль Rainbow у меня в демо-папке.

Приглашение Powerlevel10k: папка ~/project, ветка main с одним изменённым файлом, время 3s и код ошибки 1
Powerlevel10k показал !1 (один изменённый файл), время команды sleep 3 и код ошибки после ls несуществующей папки. Скриншот: терминал / matveev.tech

Ставится он клоном в папку тем Oh My Zsh:

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

Затем в ~/.zshrc пишешь ZSH_THEME="powerlevel10k/powerlevel10k", открываешь новую вкладку, и мастер сам задаст вопросы про стиль. Если терминал iTerm2, мастер сам поставит шрифт MesloLGS NF со значками.

Но есть оговорка. С 21 мая 2024 года в начале README Powerlevel10k висит предупреждение: поддержка очень ограничена, новых функций не будет, большинство багов не исправят. Последний релиз v1.20.0 вышел 26 января 2024 года. Мелкие исправления автор всё же вносит, последнее было 4 ноября 2026 года.

Начало README Powerlevel10k на GitHub с четырьмя строками о том, что поддержка проекта ограничена
Автор прямо пишет, что новых функций не будет, а просьбы о помощи останутся без ответа. Скриншот: GitHub / matveev.tech

Что с этим делать? Если Powerlevel10k уже стоит и работает, менять его срочно не нужно. У меня он до сих пор подключён в ~/.zshrc. А для новой установки я бы посмотрел на Starship: это приглашение на Rust, которое работает в Zsh, Bash и Fish. Он активно развивается, версия 1.27.0 вышла 17 октября 2026 года. Starship подключается строкой eval "$(starship init zsh)" в конце ~/.zshrc, а в ZSH_THEME оставляют пустые кавычки.

Шаг 4. Включить плагины Oh My Zsh

Плагины перечисляются в одной строке ~/.zshrc. Из коробки включён только git, и он сам по себе полезен: в нём 204 алиаса для частых команд Git. Например, gst это git status, а glog рисует граф коммитов.

Вывод alias в Zsh: 203 алиаса на g, расшифровка gst, gcm, glog и граф коммитов от glog
Плагин git даёт двести с лишним коротких команд, glog сразу рисует граф веток. Скриншот: терминал / matveev.tech

Ещё два плагина стоят у меня в конфиге, и с них я советую начать. Они не входят в Oh My Zsh, поэтому их сначала клонируют в папку custom:

git clone https://github.com/zsh-users/zsh-autosuggestions \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

zsh-autosuggestions. Пока ты печатаешь, плагин серым дописывает команду из истории. Стрелка вправо принимает подсказку целиком. Для длинных команд вроде docker compose logs -f web это экономит больше всего времени.

zsh-syntax-highlighting. Подсвечивает команду до запуска: существующая программа зелёная, опечатка красная. Ошибку видно ещё до нажатия Enter.

Zsh с плагинами: опечатка dokcer подсвечена красным, а к docker co серым дописано mpose logs -f web
Красным подсвечена опечатка, серым дописана команда из истории. Скриншот: терминал / matveev.tech

У меня в списке ещё composer и laravel под PHP-проекты, а базовый набор такой:

plugins=(
  git
  docker
  docker-compose
  npm
  zsh-autosuggestions
  zsh-syntax-highlighting
)

Плагины docker, docker-compose и npm уже лежат внутри Oh My Zsh и добавляют автодополнение для этих команд. Полный список с описаниями есть в вики плагинов. Плагин kubectl из старой версии статьи я убрал: если ты не работаешь с Kubernetes, он только удлиняет запуск оболочки.

После правки ~/.zshrc открой новую вкладку или выполни exec zsh, чтобы оболочка перезапустилась с новым конфигом.

Короткие находки про терминал, CLI и агентов для кода я выкладываю в канале — подписывайся в телеге.

Шаг 5. Настроить алиасы в Zsh

Алиас это короткое имя для длинной команды. Они пишутся в конец ~/.zshrc, после строки source $ZSH/oh-my-zsh.sh, иначе алиасы плагинов могут их перезаписать:

# Мои алиасы
alias ll="ls -la"
alias dc="docker compose"
alias zshrc="${EDITOR:-nano} ~/.zshrc"

В старой версии статьи был алиас dc="docker-compose". Отдельная утилита docker-compose (Compose v1) давно не поддерживается, сейчас Compose работает как подкоманда docker compose, и на 6 ноября 2026 года её актуальная версия 5.7.0. Плагин docker-compose из Oh My Zsh это учитывает: его алиасы dco, dcup и другие сами вызывают новую команду, если старой в системе нет.

Алиасы gs и gp для Git, которые я раньше заводил руками, тоже больше не нужны. Плагин git уже даёт gst и gp, а свои алиасы с теми же именами только запутают.

Посмотреть, во что разворачивается любой алиас, можно командой alias имя, как на скриншоте с gst и glog выше. Если алиас мешает, его отключает unalias имя в конце ~/.zshrc.

Какие ошибки ломают настройку Zsh и iTerm2

Почти все проблемы со связкой повторяются. Вот самые частые и как их заметить.

Квадратики вместо значков. Тема вроде Powerlevel10k или agnoster рисует символы, которых нет в обычном шрифте. Лечится установкой шрифта с набором Nerd Fonts (MesloLGS NF) и выбором его в Settings → Profiles → Text → Font. В Ghostty и kitty такие символы уже встроены, там ставить ничего не нужно (подробнее в гайде по настройке Ghostty).

Подсветка синтаксиса не работает. Документация zsh-syntax-highlighting требует, чтобы плагин загружался последним. В Oh My Zsh это значит последний пункт в списке plugins=(...).

Плагин не найден. Сообщение plugin 'zsh-autosuggestions' not found значит, что плагин указан в .zshrc, но не склонирован в ~/.oh-my-zsh/custom/plugins. Сторонние плагины Oh My Zsh сам не скачивает.

Пропали переменные и PATH. Установщик Oh My Zsh заменяет ~/.zshrc шаблоном. Если после установки перестали находиться node, pyenv или другие программы, открой ~/.zshrc.pre-oh-my-zsh и перенеси оттуда нужные строки.

Оболочка долго запускается. Каждый плагин добавляет время. Проверить можно командой time zsh -i -c exit. Если вкладка открывается дольше полсекунды, отключай плагины по одному и смотри, какой даёт задержку. Сильнее всего тормозят плагины, которые при старте запускают внешние программы. У плагина nvm для этого есть ленивая загрузка: строка zstyle ':omz:plugins:nvm' lazy yes до подключения Oh My Zsh.

Powerlevel10k ругается на вывод при запуске. У него есть мгновенное приглашение (instant prompt), которое не любит, когда что-то печатает в консоль во время загрузки .zshrc. Команды с выводом переноси выше блока instant prompt в начале файла или убирай.

Настройка Ghostty: полный гайд от установки до конфига
Если хочешь сменить iTerm2 на Ghostty: конфиг, шрифт, темы и сплиты, а Zsh с Oh My Zsh переедут без изменений.

Чек-лист: терминал настроен, если

Сохрани список и пройди по нему после настройки или переезда на новый Mac:

  • echo $SHELL выводит /bin/zsh;
  • iTerm2 поставлен через brew install --cask iterm2 и обновляется сам;
  • в приглашении видна ветка Git, а крестик появляется при незакоммиченных правках;
  • нужные переменные и PATH перенесены из ~/.zshrc.pre-oh-my-zsh;
  • на месте значков темы нет квадратиков, в профиле выбран шрифт MesloLGS NF;
  • zsh-syntax-highlighting стоит последним в plugins=(...), опечатка подсвечивается красным;
  • серая подсказка из истории принимается стрелкой вправо;
  • свои алиасы стоят после source $ZSH/oh-my-zsh.sh и не повторяют имена из плагина git;
  • time zsh -i -c exit укладывается в полсекунды.

Другие гайды по инструментам разработчика собраны в разделе «Разработка» и в каталоге гайдов.

Читайте также

CTO говорит

Разбираю релизы моделей и инструментов: что вышло и стоит ли переходить.

Читать в Telegram

Ещё в разделе Разработка

Весь раздел