Настройка Ghostty: полный гайд от установки до конфига
Ставим Ghostty 1.4, собираем конфиг и проверяем его встроенным валидатором: шрифт, темы, сплиты, Quick Terminal, SSH и что поменялось в версиях 1.3 и 1.4.
Обновил 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 отложили это до следующих версий.

На 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.


Где лежит конфиг и как его проверить
Начиная с версии 1.2.3 файл конфигурации называется config.ghostty. Старое имя config без расширения Ghostty тоже читает, так что переименовывать рабочий файл не обязательно. Ghostty ищет конфиг по порядку из документации:
~/.config/ghostty/config.ghostty, затем~/.config/ghostty/config.- Только на 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.

Как настроить шрифт, тему и прозрачность
Шрифт
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: тема переключается вслед за системой.
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:

В первой версии этого гайда я советовал повесить создание сплитов на 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

Префикс 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.

Если 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 коммитов. Для настройки важны новые параметры и изменённые значения по умолчанию.

| Что | Было | Стало |
|---|---|---|
| Поиск по выводу | не было | 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 +show-config без флагов показывает итоговую конфигурацию, то есть всё, что отличается от значений по умолчанию. Если параметр там не тот, ищи второй файл.
Опечатка в ключе или значении. Перед перезагрузкой прогони конфиг через ghostty +validate-config. Команда покажет файл, строку и причину, а при ошибке вернёт код 1, так что её можно вставить в pre-commit для dotfiles.

Заметь, что строку 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.
Готовый конфиг для копирования
Это мой конфиг под 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 с другими терминалами, загляни в сравнение 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 и в каталоге гайдов.
Читайте также
- Обзор Ghostty от создателя Terraform: чем Ghostty отличается от других терминалов и кому он подойдёт.
- Homebrew: пакетный менеджер для macOS: как ставить и обновлять Ghostty и другие программы одной командой.
- Cork, графический интерфейс для Homebrew: если пакеты удобнее обновлять мышкой, чем в терминале.
- CLI-инструменты для AI-агентов: почему терминал снова стал главным рабочим местом.