Dev ToolsГайд

Настройка Ghostty: полный гайд от установки до конфига

Ставим Ghostty 1.4, собираем конфиг и проверяем его встроенным валидатором: шрифт, темы, сплиты, Quick Terminal, SSH и что поменялось в версиях 1.3 и 1.4.

Настройка Ghostty: полный гайд от установки до конфига

Обновил Ghostty до 1.4, а выделение мышью на Mac перестало копировать и Cmd+↑ прыгает между промптами вместо прокрутки? Так и задумано: в 1.4 поменялись значения по умолчанию, и оба поведения возвращаются парой строк в конфиге.

Сама настройка Ghostty с нуля занимает минут десять: ставишь терминал через Homebrew, создаёшь файл ~/.config/ghostty/config.ghostty и прописываешь в нём тему, шрифт, хоткей для Quick Terminal и интеграцию с SSH. Всё остальное у Ghostty работает из коробки. Шрифт JetBrains Mono, иконки Nerd Fonts и сплиты по Cmd+D уже встроены.

Я пользуюсь Ghostty с февраля, в обзоре терминала рассказывал, почему ушёл на него с iTerm2. С тех пор вышли версии 1.3 и 1.4: часть параметров переименовали, у некоторых поменялись значения по умолчанию, а SSH-интеграцию переписали. Гайд обновлён под Ghostty 1.4.0 от 27 октября 2026 года, каждый параметр из него я прогнал через ghostty +validate-config.

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

  • как установить Ghostty на macOS и Linux;
  • где лежит конфиг и как его проверить;
  • как настроить шрифт, тему и прозрачность;
  • как работают сплиты и Quick Terminal;
  • как настроить SSH и terminfo на сервере;
  • что поменялось в версиях 1.3 и 1.4;
  • какие ошибки ломают настройку;
  • готовый конфиг для копирования.

Как установить Ghostty на macOS и Linux

На Mac проще всего поставить Ghostty через Homebrew. Если его ещё нет, начни с гайда по Homebrew, там установка в одну команду.

brew install --cask ghostty

Каск собирает сообщество, но внутри тот же подписанный .dmg, что и на странице загрузки. Ghostty 1.4 работает на macOS 13 Ventura и новее, включая macOS 27. Разработчики собирались поднять минимум до macOS 14, но в заметках к 1.4 отложили это до следующих версий.

Страница загрузки Ghostty с версией 1.4.0 и кнопками для macOS и Linux
Актуальная версия на ноябрь 2026 года 1.4.0. Для macOS есть готовый бинарник, для Linux пакеты из дистрибутивов. Скриншот: ghostty.org / matveev.tech

На Linux официальных бинарников нет, пакеты собирают дистрибутивы. Вот команды из документации по установке:

# Arch Linux
pacman -S ghostty

# Fedora
dnf copr enable scottames/ghostty
dnf install ghostty

# Ubuntu 26.04 и новее
apt install ghostty

# Любой дистрибутив со Snap
snap install ghostty --classic

С Ubuntu 24.04 есть подвох. Ghostty 1.4 требует GTK 4.18 и libadwaita 1.7, а в 24.04 они старее. Там ставь Flatpak или оставайся на 1.3.

Если хочется свежих фич до релиза, есть предрелизные сборки tip. Их собирают из последнего коммита в main, поэтому иногда они ломаются. Официальный способ перейти на них: строка auto-update-channel = tip в конфиге и перезапуск, через Homebrew это brew install --cask ghostty@tip. Для работы я держу стабильную версию.

Проверь, что встало, командой ghostty --version. На Mac бинарник лежит внутри приложения, поэтому без алиаса команда может не найтись. Тогда вызывай /Applications/Ghostty.app/Contents/MacOS/ghostty.

Вывод команды ghostty --version: версия 1.4.0, канал stable, Zig 0.17.0, рендер шрифтов CoreText
Стабильный канал и версия 1.4.0: можно настраивать по этому гайду. Скриншот: терминал / matveev.tech
Лучший терминал для macOS: Ghostty vs iTerm2 vs Kitty vs WezTerm
Если ещё выбираешь терминал: таблица и попарные сравнения пяти программ для Mac.

Где лежит конфиг и как его проверить

Начиная с версии 1.2.3 файл конфигурации называется config.ghostty. Старое имя config без расширения Ghostty тоже читает, так что переименовывать рабочий файл не обязательно. Ghostty ищет конфиг по порядку из документации:

  1. ~/.config/ghostty/config.ghostty, затем ~/.config/ghostty/config.
  2. Только на macOS: ~/Library/Application Support/com.mitchellh.ghostty/config.ghostty, затем config в той же папке.

Ghostty загружает все найденные файлы, и при совпадении ключей побеждает тот, что загружен позже. Значит, файл из ~/Library перебивает файл из ~/.config. Я держу один конфиг в ~/.config/ghostty/: он одинаково работает на Mac и Linux и легко уезжает в dotfiles.

mkdir -p ~/.config/ghostty
touch ~/.config/ghostty/config.ghostty

Синтаксис простой: ключ = значение, по параметру на строку, комментарий начинается с # на отдельной строке. Пустое значение (font-family =) сбрасывает параметр к значению по умолчанию. После правки конфиг перечитывается без перезапуска: Cmd+Shift+, на macOS или Ctrl+Shift+, на Linux. Часть параметров, например положение Quick Terminal, всё равно требует полного перезапуска.

Справка по всем параметрам встроена в сам Ghostty. Команда ghostty +show-config --default --docs выводит все параметры с описанием и значением по умолчанию, в 1.4.0 их 211.

Описание параметра font-thicken во встроенной справке Ghostty и подсчёт параметров: 211
Справка встроена в бинарник: описание font-thicken и общее число параметров в Ghostty 1.4.0. Скриншот: терминал / matveev.tech

Как настроить шрифт, тему и прозрачность

Шрифт

Ghostty поставляется со встроенным JetBrains Mono и встроенными символами Nerd Fonts. Поэтому иконки в Starship, Powerlevel10k и eza рисуются без отдельного Nerd Font. Раньше я ставил JetBrainsMono Nerd Font через Homebrew, сейчас это лишний шаг.

Другой шрифт задаётся так:

font-family = "Fira Code"
font-size = 14

Параметр font-family можно повторить. Если в первом шрифте нет символа, Ghostty возьмёт его из следующего:

font-family = "Fira Code"
font-family = "Noto Color Emoji"

Лигатуры включены по умолчанию. Если они мешают читать код, выключи их:

font-feature = -calt
font-feature = -liga

На macOS текст на обычных мониторах без ретины бывает тонковат. Это лечит font-thicken = true, параметр работает только на macOS.

Тема

Список встроенных тем выводит ghostty +list-themes. Без флагов команда открывает интерактивный просмотр с превью: стрелками листаешь темы, / включает поиск, а с 1.4 работают g и G для прыжка в начало и конец списка. С флагом --plain команда печатает просто список.

Число встроенных тем Ghostty 1.4.0 и четыре варианта Catppuccin
В Ghostty 1.4.0 встроена 821 тема, среди них все четыре варианта Catppuccin. Скриншот: терминал / matveev.tech

Моя любимая настройка в Ghostty: тема переключается вслед за системой.

theme = light:Catppuccin Latte,dark:Catppuccin Mocha

Переключил macOS в светлый режим, и терминал посветлел без перезапуска. В 1.4 обновили набор тем: добавилось 356 новых, а у Catppuccin поменялись цвета. Если после обновления палитра выглядит иначе, дело в этом.

Свою тему кладёшь файлом в ~/.config/ghostty/themes/. Внутри обычный конфиг с цветами: background, foreground, cursor-color и шестнадцать строк palette = N=#цвет. Подключается она по имени файла: theme = my-dark. С 1.4 в пути к теме работает ~, так что можно сослаться на файл из dotfiles.

Прозрачность

background-opacity = 0.95
background-blur = 20

На macOS 26 и новее вместо числа в background-blur можно поставить macos-glass-regular или macos-glass-clear, это системное «жидкое стекло». На Linux размытие работает в KDE и композиторах с протоколом ext-background-effect-v1, например в Niri.

Как работают сплиты

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

Стандартные хоткеи сплитов Ghostty: создание, переходы, изменение размера
Cmd+D делит экран вправо, Cmd+Shift+D вниз, Cmd+Alt+стрелки переключают панели, Cmd+Ctrl+стрелки меняют размер. Скриншот: терминал / matveev.tech

В первой версии этого гайда я советовал повесить создание сплитов на Ctrl+Cmd+стрелки. Из вывода видно, что на этих клавишах стоит изменение размера панели, и мой хоткей его затирал. Поэтому в конфиге ниже стандартные сочетания остались как есть.

Неактивные панели Ghostty и так слегка притушает (unfocused-split-opacity = 0.7). Мне нравится контраст посильнее:

unfocused-split-opacity = 0.6
split-divider-color = #3a3b40

С версии 1.3 рабочая папка наследуется раздельно для окон, вкладок и сплитов. Например, новое окно открывается в домашней папке, а сплит в текущей:

window-inherit-working-directory = false
split-inherit-working-directory = true

Тем, кто пришёл из tmux, пригодятся таблицы клавиш из 1.3. Это режимы, как в tmux: нажал Ctrl+A, и стрелки меняют размер панелей, пока не нажмёшь Escape.

keybind = ctrl+a=activate_key_table:resize
keybind = resize/arrow_up=resize_split:up,10
keybind = resize/arrow_down=resize_split:down,10
keybind = resize/arrow_left=resize_split:left,10
keybind = resize/arrow_right=resize_split:right,10
keybind = resize/escape=deactivate_key_table
keybind = resize/catch_all=ignore

Строка с catch_all глушит все остальные клавиши, пока режим включён, иначе они уйдут в терминал. Последовательности клавиш (keybind = ctrl+a>n=new_window) тоже работают. Полный список действий выводит ghostty +list-actions, текущие привязки ghostty +list-keybinds.

Как включить Quick Terminal

Quick Terminal выезжает по хоткею поверх любого приложения, как консоль в Quake. Я держу его для коротких команд: проверить порт, запустить brew upgrade, глянуть лог.

Стандартного хоткея у него нет, его нужно назначить самому:

keybind = global:ctrl+grave_accent=toggle_quick_terminal
quick-terminal-position = right
quick-terminal-size = 40%
quick-terminal-animation-duration = 0.15
quick-terminal-autohide = true
Справка Ghostty по параметру quick-terminal-position с пятью вариантами положения
Положение задаётся одним из пяти значений, а на macOS после его смены нужен полный перезапуск Ghostty. Скриншот: документация Ghostty / matveev.tech

Префикс global: делает хоткей системным, он срабатывает, даже когда Ghostty не в фокусе. На macOS для этого нужно разрешение: «Системные настройки → Конфиденциальность и безопасность → Универсальный доступ», добавь туда Ghostty. Размер принимает проценты (40%) или пиксели (800px), число без единиц Ghostty сочтёт ошибкой. С quick-terminal-autohide = true окно прячется, как только кликаешь в другое приложение.

На Linux Quick Terminal работает только в Wayland. В 1.4 появилась команда ghostty +toggle-quick-terminal: её можно повесить на хоткей оконного менеджера, если тот не поддерживает глобальные сочетания. Ещё в 1.4 Quick Terminal на Wayland открывается на основном мониторе, а прежнее поведение возвращает quick-terminal-screen = mouse.

Как настроить SSH и terminfo на сервере

Shell integration Ghostty подключает сам для bash, zsh, fish, elvish и Nushell. Исключение: встроенный в macOS /bin/bash слишком старый, для него нужен bash из Homebrew. Она открывает новые вкладки в текущей папке, прыгает между промптами по Cmd+↑ и Cmd+↓ и выделяет вывод команды тройным кликом с Cmd. С 1.3 по клику в промпте можно переставить курсор, как в текстовом поле (из коробки в fish 4.1+ и Nushell).

Проблемы начинаются на удалённом сервере. По SSH Ghostty передаёт TERM=xterm-ghostty, а на сервере такого terminfo нет, и программы ругаются:

missing or unsuitable terminal: xterm-ghostty

Лечится двумя функциями shell integration. По умолчанию они выключены, включаются так:

shell-integration-features = ssh-env,ssh-terminfo

В 1.4 эту часть переписали. Функции теперь вызывают новую команду ghostty +ssh: это обёртка над обычным ssh, которая перед подключением ставит на сервер terminfo Ghostty, а если не вышло, переключает TERM на xterm-256color.

Справка команды ghostty +ssh: обёртка над ssh, которая настраивает Ghostty на удалённом хосте
ghostty +ssh передаёт все аргументы в обычный ssh, а включается функциями ssh-env и ssh-terminfo или алиасом. Скриншот: терминал / matveev.tech

Если shell integration у тебя выключена, ту же работу сделает алиас:

alias ssh='ghostty +ssh --'

Что ещё изменилось в 1.4, по заметкам к релизу:

  • Ghostty всегда ставит свой terminfo, даже если на сервере уже лежит старый, и переустанавливает его после обновления.
  • Кэш хранится по паре хост и порт, так что две машины за одним адресом больше не путаются.
  • ssh-env перестал перебивать SetEnv из ~/.ssh/config.

Кэш серверов, куда terminfo уже поставлен, смотрит ghostty +ssh-cache. Старые записи чистит ghostty +ssh-cache --prune=30d. Если пишешь скрипты поверх +ssh-cache, проверь их: формат вывода в 1.4 поменялся.

Что поменялось в Ghostty 1.3 и 1.4 для конфига

Ghostty 1.3.0 вышел 9 марта 2026 года, 1.4.0 вышел 27 октября 2026 года. По словам разработчиков, 1.4 это семь месяцев работы, 172 участника и 2889 коммитов. Для настройки важны новые параметры и изменённые значения по умолчанию.

Заметки к релизу Ghostty 1.4.0 от 27 октября 2026 года со списком разделов
В оглавлении 1.4.0 есть отдельные разделы Breaking Changes и Deprecations: их стоит прочитать до обновления. Скриншот: ghostty.org / matveev.tech
Что Было Стало
Поиск по выводу не было Cmd+F на macOS, Ctrl+Shift+F на Linux (1.3)
Полоса прокрутки не было параметр scrollbar, по умолчанию решает система (1.3)
Уведомление о долгой команде не было notify-on-command-finish (1.3)
copy-on-select на macOS копировал выделение по умолчанию none, ничего не копирует (1.4)
Cmd+↑ и Cmd+↓ на macOS в 1.3 прокрутка к началу и концу снова переход между промптами (1.4)
Лимит прокрутки scrollback-limit, 10 МБ scrollback-limit-bytes, 50 МБ со сжатием (1.4)
Копирование в буфер только текст текст и HTML с цветами (1.3)

Сильнее всего на привычки влияет copy-on-select. После обновления до 1.4 выделение мышью на Mac больше ничего не копирует. Вернуть поведение можно так: copy-on-select = clipboard копирует в системный буфер, а primary возвращает вариант из 1.3.

Уведомление о завершении команды я включил сразу. Запускаю длинную сборку или агента в терминале, ухожу в браузер, и macOS присылает уведомление, когда всё готово:

notify-on-command-finish = unfocused
notify-on-command-finish-action = no-bell,notify
notify-on-command-finish-after = 30s

Для агентов в терминале это особенно удобно: про то, почему CLI-инструменты снова стали важны из-за AI-агентов, я писал отдельно. Старое имя scrollback-limit пока работает через слой совместимости, но лучше перейти на scrollback-limit-bytes или новый scrollback-limit-lines.

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

На macOS Ghostty при загрузке показывает окно с ошибками конфига, но ловит он только синтаксис. Второй файл с другой темой или неверно названный шрифт ошибкой не считаются, и ты гадаешь, почему ничего не поменялось. Вот что ломается чаще всего.

Два конфига перебивают друг друга. Так было у меня самого. В ~/.config/ghostty/config стояла тема Monokai Pro, а в ~/Library/Application Support/... лежал автоматически созданный файл с Catppuccin Mocha. Файл из ~/Library грузится последним, поэтому правки в ~/.config не давали результата.

Тема в двух конфигах Ghostty и итоговое значение из ghostty +show-config
В ~/.config стоит Monokai Pro, в ~/Library стоит Catppuccin Mocha, и действует вторая. Скриншот: терминал / matveev.tech

Команда ghostty +show-config без флагов показывает итоговую конфигурацию, то есть всё, что отличается от значений по умолчанию. Если параметр там не тот, ищи второй файл.

Опечатка в ключе или значении. Перед перезагрузкой прогони конфиг через ghostty +validate-config. Команда покажет файл, строку и причину, а при ошибке вернёт код 1, так что её можно вставить в pre-commit для dotfiles.

Вывод ghostty +validate-config для конфига с тремя ошибками
Валидатор поймал неверное значение copy-on-select, опечатку в quick-terminal-sise и несуществующую тему. Скриншот: терминал / matveev.tech

Заметь, что строку background-opacity = 1.5 валидатор пропустил, хотя прозрачность выше 1 смысла не имеет. Проверка ловит не всё, результат всё равно смотри глазами.

Неверное имя шрифта. Ghostty чувствителен к названию. Точное имя покажет ghostty +list-fonts. Частая путаница: JetBrainsMono Nerd Font пишется слитно, а JetBrains Mono с пробелом.

Quick Terminal не реагирует на хоткей. Либо у Ghostty нет доступа в «Универсальном доступе», либо ты поменял quick-terminal-position и не перезапустил приложение полностью. Перезагрузки конфига тут мало.

SSH пишет missing or unsuitable terminal: xterm-ghostty. Включи ssh-env,ssh-terminfo из раздела про SSH. Быстрый обход для одного подключения: TERM=xterm-256color ssh user@host.

Cmd+↑ перестал прокручивать к началу. Это изменение 1.4. Вернуть прокрутку можно строками keybind = cmd+arrow_up=scroll_to_top и keybind = cmd+arrow_down=scroll_to_bottom.

Короткие заметки про терминал, CLI и агентов, которые в нём работают, выкладываю в Telegram-канале, подписывайся.

Готовый конфиг для копирования

Это мой конфиг под Ghostty 1.4. Он работает на Mac, а параметры с префиксом macos- на Linux просто игнорируются.

# ~/.config/ghostty/config.ghostty

# Тема: светлая днём, тёмная вечером
theme = light:Catppuccin Latte,dark:Catppuccin Mocha

# Шрифт
font-family = "JetBrains Mono"
font-size = 14
font-thicken = true

# Прозрачность
background-opacity = 0.95
background-blur = 20

# Окно
macos-titlebar-style = transparent
macos-option-as-alt = true
window-padding-x = 8
window-padding-y = 4
window-padding-color = extend
window-save-state = always

# Курсор и мышь
cursor-style = bar
cursor-style-blink = false
mouse-hide-while-typing = true

# Сплиты: хоткеи по умолчанию оставляем, только затемняем неактивные
unfocused-split-opacity = 0.6

# Quick Terminal
keybind = global:ctrl+grave_accent=toggle_quick_terminal
quick-terminal-position = right
quick-terminal-size = 40%
quick-terminal-animation-duration = 0.15
quick-terminal-autohide = true

# Shell integration и SSH
shell-integration = detect
shell-integration-features = ssh-env,ssh-terminfo

# Уведомление о долгой команде, когда окно не в фокусе
notify-on-command-finish = unfocused
notify-on-command-finish-action = no-bell,notify
notify-on-command-finish-after = 30s

# Буфер обмена
copy-on-select = clipboard
clipboard-trim-trailing-spaces = true

Пара пояснений. macos-option-as-alt = true нужен, если в Vim или tmux ты пользуешься сочетаниями с Alt. window-padding-color = extend растягивает цвет фона до краёв окна, без светлой рамки. cursor-style я задал вручную, поэтому shell integration перестаёт сама менять форму курсора: так Ghostty работает с версии 1.3.

Проверка готового конфига: ghostty +validate-config завершилась без ошибок
Готовый конфиг проходит валидацию в Ghostty 1.4.0 без единой ошибки. Скриншот: терминал / matveev.tech

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

Частые вопросы о настройке Ghostty

Как сбросить настройки Ghostty

Переименуй файлы конфига в ~/.config/ghostty/ и в ~/Library/Application Support/com.mitchellh.ghostty/, затем перезапусти Ghostty. Он вернётся к значениям по умолчанию: встроенный JetBrains Mono, стандартная тема, сплиты на Cmd+D. Посмотреть, что осталось изменённым, можно командой ghostty +show-config.

Можно ли заменить tmux на Ghostty

Для локальной работы во многом да: сплиты, вкладки и таблицы клавиш из 1.3 закрывают привычные сценарии tmux. На удалённом сервере tmux незаменим, потому что сессия живёт на сервере и переживает обрыв связи. Я пользуюсь обоими: Ghostty локально, tmux на серверах.

Нужен ли отдельный Nerd Font для Ghostty

Нет. Символы Nerd Fonts встроены в Ghostty, иконки в Starship, Powerlevel10k и eza рисуются со стандартным шрифтом. Ставить отдельный Nerd Font стоит, только если тебе нравится сам шрифт.

Главное о настройке Ghostty в 4 пунктах

  • Конфиг лучше держать одним файлом ~/.config/ghostty/config.ghostty и удалить второй из ~/Library, иначе он перебьёт настройки.
  • Перед перезагрузкой конфиг стоит прогонять через ghostty +validate-config: он находит опечатки, но числа вне диапазона пропускает.
  • Сплиты и шрифт с иконками уже работают из коробки, а Quick Terminal, SSH-интеграцию и уведомления о командах нужно включать самому.
  • На Ubuntu 24.04 версия 1.4 не встанет из-за старых GTK и libadwaita: там остаётся Flatpak или 1.3.

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

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

CTO говорит

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

Читать в Telegram

Ещё в разделе Dev Tools

Весь раздел