---
title: "Ghostty Terminal: Der komplette Mac-Setup-Guide (2026)"
description: "Installiere und konfiguriere das Ghostty-Terminal auf dem Mac: Nerd Fonts, Config-Datei, Themes, 1.4-Status und das libghostty-Ökosystem mit cmux für AI-Coding-Agents."
date: 2026-10-13
categories: ["linux"]
tags: ["ghostty","libghostty","cmux"]
---

**Affiliate-Hinweis**

Einige Links in dieser Anleitung sind Affiliate-Links. Wenn du darüber kaufst, erhalten wir möglicherweise eine kleine Provision – ohne zusätzliche Kosten für dich. Das hilft uns, diese Empfehlungen weiter zu testen und zu aktualisieren.

Das **Ghostty-Terminal** ist ein moderner, GPU-beschleunigter Terminal-Emulator, der sich unter macOS nativ anfühlt, mit einem Befehl installiert ist und über eine schlichte Textdatei konfiguriert wird. Es ist außerdem die Referenzimplementierung von **libghostty**, der Rendering-Engine, die inzwischen cmux und über 130 weitere Projekte antreibt. Wenn du deinen Tag auf einem Mac im Terminal verbringst, ist das der Setup-Guide, den ich dir in die Hand drücken würde.

In dieser Anleitung wirst du:

- Ghostty und einen Nerd Font installieren, damit Icons korrekt rendern

- Eine saubere ~/.config/ghostty/config einrichten

- Die herausragenden Ghostty-Features kennenlernen: Themes, Inspector, Shader, Bild-Support

- Das libghostty-Ökosystem verstehen: cmux und über 130 Projekte auf Ghosttys Engine

- Optional einen modernen Prompt plus tmux und zoxide dazulegen

Wenn du speziell **Starship + Ghostty** mit Presets und einem kompletten Prompt-Setup willst, schau in meine Begleitanleitung: [Starship + Ghostty: Das ultimative Mac-Terminal-Setup](/de/starship-ghostty-terminal/).

**Stand Oktober 2026:** Das aktuelle Release ist 1.3.1, 1.4.0 wird für Ende Oktober 2026 erwartet, und die Entwicklung ist im April 2026 von GitHub weggezogen (ein Read-Only-Mirror bleibt dort). Details im Status-Abschnitt unten.

## Die wichtigsten Features von Ghostty

### GPU-Beschleunigung

Ghostty rendert über deine GPU, was schnelles Scrollen und flüssige Performance bedeutet. Komplexe Terminal-Ausgabe bleibt responsiv, und die Arbeit mit großen Dateien bremst nicht.

### Native UI

Ghostty versucht nicht, eine One-size-fits-all-UI zu sein. Unter macOS nutzt es natives Swift, SwiftUI und AppKit. Unter Linux GTK4. Es dockt richtig ans System an: AppleScript- und Shortcuts-Support auf dem Mac, systemd-Integration unter Linux (cgroup-Isolation, Single Instance). Ghostty fühlt sich wie ein Teil deines Systems an statt wie ein Fremdkörper.

### Einfache Config-Datei (Key-Value)

Die Config ist straightforward: `~/.config/ghostty/config` nutzt schlichte Key-Value-Paare. Keine Skriptsprache, keine komplexe Syntax. Fonts wechseln, Theme wählen, Opazität anpassen. Der komplette Durchlauf steht im Abschnitt [Config-Datei-Setup](#ghostty-config-datei-einrichten) unten.

### Eingebauter Multiplexer

Ghostty hat eingebautes Multiplexing, du kannst also Panes splitten und mehrere Sessions verwalten, ohne zu tmux zu greifen. Wenn du diese Idee für AI-Workflows mit Agent-Benachrichtigungen, vertikalen Workspaces und eingebautem Browser weiterführen willst, sieh dir meine Anleitung zu [cmux Terminal: Ein praktischer Guide für AI-Coding-Agents unter macOS](/cmux-terminal/) an.

### Umfangreicher Farb-Support

Unterstützt True Color und kommt mit über 100 eingebauten Themes. Du kannst auch eigene hinzufügen, wenn du etwas Bestimmtes willst.

### Bild-Support

Ghostty unterstützt das Kitty Graphics Protocol, du kannst also Bilder direkt im Terminal rendern. Praktisch für Preview-Tools oder visuelle Ausgabe inline. Animierte Bild-Frames stehen auf dem 1.4-Milestone – das kommt also noch, ist aber noch nicht draußen.

## Was ist neu in Ghostty (Stand Oktober 2026)

Das aktuelle Release ist **1.3.1**. Ghostty 1.3.0 erschien am 9. März 2026 nach 6 Monaten Arbeit: **180 Contributors, 2.858 Commits**. Die Headline-Features aus 1.3:

- Scrollback-Suche: `Cmd+F` unter macOS oder `Ctrl+Shift+F` unter GTK durchsucht deine Terminal-History. Alle Treffer werden gehighlightet; springe mit `Cmd+G` / `Shift+Cmd+G` oder den Pfeiltasten zwischen ihnen. Unter macOS lässt sich die Suchleiste in jede Ecke ziehen.
- Native Scrollbars: Sie sehen aus und verhalten sich, wie dein OS es erwartet, erscheinen beim Scrollen und blenden bei Inaktivität aus.
- Click-to-move-Cursor: Wenn deine Shell OSC-133-Prompt-Detection unterstützt, kannst du klicken, um den Cursor im Prompt zu positionieren. Funktioniert mit zsh, fish und bash bei passendem Prompt-Setup.
- Key-Overlay für Leader-Keys: Nach dem Drücken eines Leader-Keys erscheint ein visuelles Overlay mit den verfügbaren Bindings. Nützlich bei eigenen Keybindings oder tmux-Prefix-Keys.
- Auto-Update unter macOS: Ghostty kann sich selbst aktualisieren, ohne Homebrew oder manuellen Download.
- Text-Shaping-Verbesserungen: besserer Umgang mit komplexen Schriften (Arabisch, Devanagari, Thai) und Ligaturen.

**1.3.1** (13. März 2026) war ein Patch-Release, das Phantom-Maus-, Selektions- und Scroll-Events unter macOS nach Fokuswechseln fixte. Es brachte außerdem `progress-style` (OSC-9;4-Fortschrittsbalken steuern oder deaktivieren), die Keybind-Aktionen `set_surface_title` und `set_tab_title`, `~/`-Expansion in `working-directory` und Multiline-Handling in `jump_to_prompt:next`.

### Security-Fix, den du einspielen solltest

CVE-2026-26982 fixte ein Problem, bei dem Steuerzeichen (wie 0x03, Ctrl+C) in eingefügtem oder per Drag & Drop übergebenem Text beliebige Befehle ausführen konnten. Veröffentlicht am 10. März 2026 im [NVD](https://nvd.nist.gov/vuln/detail/CVE-2026-26982). Wenn du noch auf etwas Älterem als 1.3.1 bist, update jetzt:

```sh
brew upgrade --cask ghostty
```

### Ghostty-1.4.0-Zeitplan

Ghostty 1.4.0 wird für den **23. Oktober 2026** erwartet (der Milestone zeigte Mitte Oktober 2026 1.220 geschlossene Issues; 1.5.0 ist für den 31. März 2027 gemilestoned). Die 6-Monats-Release-Kadenz hält; sie ist nur über die ursprüngliche September-Schätzung hinausgerutscht.

**1.4.0-Kandidaten sind nicht ausgeliefert**

Die Punkte unten sind geschlossene Issues auf dem 1.4.0-Milestone, keine veröffentlichten Features. Geh nicht davon aus, dass eines davon in deinem Build existiert. Prüfe die Release Notes auf ghostty.org, wenn 1.4 landet.

Sichtbare Kandidaten auf dem Milestone:

- Kitty-Graphics-**Animations-Frames**
- Einen Tab in ein neues Fenster verschieben
- GTK: Split-**Drag-and-Drop-Reorder**
- Flexibleres `copy-on-select` und `middle-click-action`
- Möglichkeit, **ein Fenster zu benennen oder umzubenennen**
- GTK/Wayland-Hintergrund-Blur via `ext-background-effects-v1`
- Runtime-Änderung an `max_scrollback` (die zu beobachtende, wenn du dagegen skriptest)
- Zig-0.16-Migration (intern, aber sie erhöht die Anforderungen fürs Bauen aus Source)

### Ghostty hat GitHub im April 2026 verlassen

**Das GitHub-Repo ist ein Mirror**

Ein Read-Only-Mirror bleibt auf GitHub. Die Entwicklung passiert auf der eigenen Infrastruktur des Projekts.

Am 28. April 2026 kündigte Hashimoto an, dass Ghostty GitHub wegen chronischer Ausfälle verlässt – er konnte während eines GitHub-Actions-Ausfalls stundenlang kein PR-Review machen, und „this is no longer a place for serious work". Die GitHub-URL funktioniert weiter als täglich synchronisierter Read-Only-Mirror (immer noch rund 62k Stars), aber die Entwicklung passiert nicht mehr dort.

Die Auswirkung für Leser ist klein, aber real: Eröffne keine neuen GitHub-Issues. Melde Bugs über ghostty.org oder den Projekt-Discord. `CONTRIBUTING.md` enthält jetzt ein Vouch-System für Erst-Contributors und eine strikte AI-Policy („you must understand your code... no agent-generated slop"). Gute Policy.

Währenddessen baut Hashimotos neue Firma **Superlogical** (angekündigt am 29. Juli 2026) einen Terminal-Multiplexer auf libghostty. Ghostty selbst bleibt bei der Non-Profit, der es im Dezember 2025 gespendet wurde. Ich habe die Multiplexer-Pläne in [Superlogical Rex, der neue Terminal-Multiplexer des Ghostty-Schöpfers](/de/superlogical-rex/) behandelt. Die macOS-App sieht weiterhin rund eine Million Downloads pro Woche (Hashimoto, 2026).

## Performance

Ghostty ist in Zig geschrieben, und man merkt es. Der ehrliche Vergleich kommt aus dem [Projekt-README](https://github.com/ghostty-org/ghostty): Ghostty und Alacritty liegen meist innerhalb weniger Prozentpunkte, und beide sind bei Large-Output-Workloads grob 100x schneller als Terminal.app und iTerm. Das ist die Obergrenze dessen, was ich aus irgendeinem Benchmark behaupten würde.

In der Praxis sind die Unterschiede kleiner, als Zahlen suggerieren. Dein Font, Shader, Opazität und der tatsächliche Workload zählen mehr als eine ms-Zahl aus einem Unicode-Dump-Test. Wenn du eine Alternative zum direkten Vergleich auf dem Mac willst, sieh dir meinen [WezTerm auf Mac mit tmux, zoxide und Starship](/install-wezterm-mac/)-Guide an.

## Einzigartige Features

### Terminal Inspector

Der Terminal Inspector ist eines von Ghosttys besten Features. Öffne ihn mit `Cmd+Option+I` und du bekommst Echtzeit-Debugging-Infos: Tastenanschläge, Render-Timings, alles, was unter der Haube passiert. Praktisch, wenn du einen Keybind oder ein Rendering-Problem troubleshootest statt zu raten.

### Shader

Du kannst eigene Shader schreiben, um visuelle Effekte anzuwenden: Glow, CRT-Filter, was immer du ausprobieren willst. Macht Spaß, wenn du gerne optisch tweakst, und ein gutes Beispiel dafür, wie viel von der Rendering-Pipeline offengelegt ist.

## Das libghostty-Ökosystem: die Engine hinter den Apps

![libghostty-Ökosystem-Diagramm: die libghostty-Engine im Zentrum, die Ghostty GUI, cmux, SSH-Clients, eingebettete Terminals, Plattform-Ports und Produktions-Tools antreibt](@assets/images/25/01/libghostty-ecosystem.svg)

Alles oben beschreibt Ghostty die App. Seit Ende 2025 gibt es eine zweite, wohl größere Geschichte: **libghostty**. Es ist die plattformübergreifende, C-ABI-kompatible Library (in Zig geschrieben), die Ghostty selbst antreibt: Terminal-Emulation, Font-Handling und Rendering. Jede Anwendung kann sie einbetten. Stell es dir wie WebKit für Terminals vor: Die Ghostty-GUI ist nur ein Consumer der Engine.

Mitchell Hashimoto kündigte libghostty im September 2025 an, beginnend mit `libghostty-vt`, einer Zero-Dependency-Library, die Terminal-Sequenzen parst und den Terminal-State hält. Das Ökosystem wuchs danach schnell.

**Mitchell Hashimoto, Schöpfer von Ghostty**

"I suspect by the middle of 2027, the number of people using Ghostty via libghostty will dwarf the number of users that actually use the Ghostty GUI."

Die [awesome-libghostty-Liste](https://github.com/Uzaaft/awesome-libghostty) trackt **137 Projekte**, die auf der Engine aufbauen. Die interessantesten:

| Projekt | Plattform | Was es beiträgt |
| --- | --- | --- |
| **cmux** | macOS + iOS beta | Vertikale Tabs, Notification-Ringe, wenn Agents Input brauchen, in-app skriptbarer Browser, Remote-Workspaces, Attach an Remote-tmux, Subagents als native Panes, CLI- und Unix-Socket-API. 28k+ GitHub-Sterne. Benachrichtigungen feuern via OSC 9/99/777 oder die `cmux`-CLI. |
| **blink, Zentty, Forge, in0, Supacode** | macOS | Agent-zentrische Workspaces: Live-Session-Status, Worktrees, Orchestrierung |
| **Muxy, ykmx, it-shell3** | macOS | Terminal-Multiplexer auf dem libghostty-Kern |
| **Enso, macterm, justty** | macOS | Verschiedene Varianten eines leichten nativen Ghostty-Terminals |
| **Echo, Geistty, Spectty** | iOS/iPadOS | SSH-/Mosh-Clients mit Ghostty-Rendering |
| **Umbra** | Android | GPU-beschleunigtes Android-Terminal |
| **mightty, phantty** | Windows | Experimentelle Windows-Ports und -Renderer |
| **deepin-terminal-ghostty, Husk, forgetty** | Linux | GTK-/Wayland-Terminals auf dem Ghostty-Kern |
| **OrbStack** | macOS | Ghostty-powered Terminal in seiner Docker-/Linux-VM-App |
| **vscode-bootty** | VS Code | libghostty-Terminal in VS Code |
| **obsidian-ghostty-terminal** | Obsidian | Echtes Terminal in deinen Notizen |
| **Godotty** | Godot Engine | Terminal-Emulator für die Game-Engine |
| **ghostty-web, browstty** | Browser | Ghostty zu WebAssembly kompiliert, läuft in einer Webseite |
| **expo-libghostty** | React Native | Terminal-View für Expo/React Native auf iOS und Android |
| **emacs-libgterm, Ghostel** | Emacs | Terminal-Backends auf libghostty |
| **RoyalTerminal** | .NET / Avalonia | Plattformübergreifendes Terminal auf .NET 10 |
| **Ghostree** | macOS | Fork mit nativem Git-Worktree- und AI-Agent-Support |
| **Zmx, hauntty, vanish** | Any | Session-Persistenz: Attach-, Restore-, Muxing-Utilities |
| **vterm-mcp** | Any | MCP-Server, der TUI-Apps durch ein libghostty-PTY steuert und testet |
| **mdnb, pynb** | macOS | Markdown- und Jupyter-Apps, die Ghostty-Terminals einbetten |

Es gibt außerdem Bindings für Rust, Go, .NET, Python, TypeScript, React Native/Expo, Flutter/Dart, Elixir, Odin, C++, MoonBit und HarmonyOS. Ein eigenes Terminal zu bauen ist jetzt ein Wochenendprojekt statt eines mehrjährigen.

**libghostty-API ist nicht stabil**

libghostty-vt ist in Entwicklung und die API ist noch nicht stabil. Breaking Changes sind in zukünftigen Versionen zu erwarten. Ok für Experimente. Pinne deine Versionen für alles, was du shipst.

Dieser Hinweis hat Produktions-Adoption jenseits von Terminals nicht gestoppt: Vercels **Turborepo** und Antithesis' **bombadil** betten beide libghostty ein (von Hashimoto als impactful Consumers genannt). Das sind keine Wochenend-Spielzeuge.

### Was das für dein Setup bedeutet

Deine Ghostty-Config ist portabel. **cmux**, bei Weitem die populärste libghostty-App (28k+ GitHub-Sterne), liest deine bestehende `~/.config/ghostty/config` für Themes, Fonts und Farben. Du bekommst eine komplett andere App mit null Neukonfiguration. Kompletter Durchlauf hier: [cmux Terminal: Ein praktischer Guide für AI-Coding-Agents unter macOS](/cmux-terminal/).

Wichtiger noch: Terminals müssen nicht mehr generisch sein. Behalte Ghostty als Daily Driver und fahre eine spezialisierte App (ein Agent-Workspace, ein SSH-Client, ein eingebettetes Terminal), wenn der Job es verlangt – ohne Rendering-Macken, Config-Syntax oder Fonts neu zu lernen. Jede libghostty-App erbt dieselbe Korrektheit und Performance.

**Weiterführende Lektüre:** [ghostty.org/docs/about](https://ghostty.org/docs/about) · [libghostty-Ankündigung](https://mitchellh.com/writing/libghostty-is-coming) · [awesome-libghostty](https://github.com/Uzaaft/awesome-libghostty)

### Agent-Benachrichtigungen bekommen ein Protokoll (OSC 7501)

Wenn du AI-Coding-Agents in deinem Terminal laufen lässt, kennst du das Problem: Der Agent blockiert und wartet auf Erlaubnis oder Input, und nichts sagt es dir. Du wechselst zurück zum Tab, liest den Prompt, handelst, wechselst weg. Repeat.

Heute erkennen Tools diesen Zustand auf zwei fragile Arten:

1. **Screen-Scraping-Heuristiken.** [Agentic Inboxes wie Herdr](/best-herdr-clients/) liefern TOML-Detection-Manifeste, die Fenstertitel und Output pattern-matchen. Diese Manifeste brauchten 10 Änderungen in 3 Monaten, nur um mit Claude Codes Titel-Mustern Schritt zu halten.
2. **Socket-APIs pro App.** `cmux notify` und die Herdr-Socket-API funktionieren, aber ein Socket traversiert kein SSH und betritt keinen Container. Sobald dein Agent auf einer Remote-Box läuft, bricht der Benachrichtigungspfad.

Am 6. Oktober 2026 veröffentlichte Hashimoto das **OSC 7501 Program Status Protocol** als generischen Fix. Jedes Programm meldet seinen Zustand durch das PTY mit einer Standard-Escape-Sequenz: `idle`, `working`, `blocked` (mit Grund), `finished` oder `failed`. Die Payload-Form sieht so aus:

```
state=blocked:kind=permission:app=terraform:msg=<base64>
```

Terminals und agentic Inboxes (die Ankündigung nennt **Herdr, cmux und Agent Deck**) rendern es, wie sie wollen: ein Notification-Ring, ein Badge, ein Phone-Push.

**Stand Oktober 2026**

Das Protokoll ist eine Woche alt. Ghosttys eigener Support für OSC 7501 ist Stand Mitte Oktober 2026 nicht bestätigt. Prüfe die Release Notes, bevor du annimmst, dass irgendein Terminal es rendert.

![OSC-7501-Flow: Ein Coding-Agent meldet einen blocked-Zustand durch das PTY, empfangen von einem Terminal oder einer agentic Inbox](@assets/images/25/01/osc7501-flow.svg)

Warum es zählt: Ein echtes Protokoll bedeutet, dass Agent-Status über SSH, in Containern und über Maschinen hinweg funktioniert. Agent-Tooling hört auf, von Prompt-Titel-Scraping abzuhängen. Wenn du Agent-Benachrichtigungen heute schon weiter treiben willst, schau dir [Herdr-Plugins an, die Agent-State erkennen](/de/beste-herdr-plugins/), oder [steuere AI-Agents von deinem Handy mit Moshi + Herdr](/control-ai-agents-from-phone-moshi-herdr/). Terminals und Coding-Agents (Claude Code, Codex CLI, Open-Source-Optionen wie [OpenCode Go](https://go.bitdoze.com/opencode-go)) bewegen sich alle in diese Richtung.

Spec: [program-status OSC 7501](https://mitchellh.com/writing/program-status-osc7501) · [Rex-Doku](https://superlogical.com/rex/docs/build/program-status)

## Ghostty-Terminal-Setup: Installation und Konfiguration

Video: [Ghostty Terminal: A Complete Setup Guide for Modern Mac Development](https://www.youtube.com/embed/NR25BdXR6mE)

> Wenn du dir ein paar kostenlose, coole Mac-Apps ansehen willst, schau in den [Mac-Apps-Bereich von toolhunt.net](https://toolhunt.net/mac/).

### Voraussetzungen

- macOS 13 (Ventura) oder neuer für offizielle Builds (Universal Binary, signiert und notarisiert)

- Homebrew installiert

- Admin-Rechte (die Font-Installation schreibt in System-Font-Verzeichnisse)

- Rund 200 MB Plattenplatz für die App und einen Nerd Font

- Linux-Weg: Ubuntu 26.04+ oder eine Distro mit GTK 4.14 / Adwaita 1.5

Kostenhinweis: Ghostty ist kostenlos und MIT-lizenziert. Kein Account, kein Lizenzschlüssel, keine Telemetrie.

Wenn du Nix auf einer Nicht-NixOS-Distro fährst: Ghostty braucht extra OpenGL-Treiber-Setup, sonst startet es nicht (siehe den Troubleshooting-Abschnitt).

### Quickstart (TL;DR)

Schnell-Setup, wenn du Ghostty einfach laufen willst:

```sh
brew install --cask ghostty
brew install font-meslo-lg-nerd-font
mkdir -p ~/.config/ghostty
```

Dann erstelle `~/.config/ghostty/config` mit der Basis-Config unten und starte Ghostty neu. Verifiziere die Version: `ghostty --version` (oder Ghostty → About in der Menüleiste). Du willst **1.3.1 oder neuer**.

### Ghostty auf dem Mac installieren

  
### Homebrew

    ```sh
    brew install --cask ghostty
    ```
    Der Cask ist community-gepflegt und verpackt nur das offizielle .dmg neu, das Sicherheitsniveau ist also dasselbe wie beim Direkt-Download. Er setzt `auto_updates: true`, Ghostty kann sich danach also in-app selbst aktualisieren.
  

  
### Direktes .dmg

    Download von [ghostty.org/download](https://ghostty.org/download). Offizielle Builds sind Universal Binaries (Apple Silicon + Intel), signiert und notarisiert und erfordern macOS 13 (Ventura) oder neuer. Ziehe Ghostty nach `/Applications`.
  

  
### Nix

    Unter macOS ist `ghostty-bin` das neu verpackte offizielle .dmg. Unter Linux ist das `ghostty`-Paket die GTK-App. Fährst du Nix auf einer Nicht-NixOS-Distro, brauchst du extra GL-Treiber-Setup, sonst startet Ghostty nicht. Details in den [Install-Docs](https://ghostty.org/docs/install/binary).
  

**Verifiziere die Installation, bevor du deine Config beschuldigst:**

```sh
ghostty --version
```

Du willst 1.3.1 oder neuer (das Release mit dem Pasted-Text-CVE-Fix). Öffne dann einen neuen Tab mit `Cmd+T`, um zu bestätigen, dass das Fenster rendert. Wenn der Cask mit „already an app at /Applications" fehlschlägt, sieh den Troubleshooting-Abschnitt.

macOS-Builds aktualisieren sich außerdem in-app selbst, du musst Homebrew bei Point-Releases also nicht babysitten.

### Ghostty unter Linux

Die offiziellen Docs bestätigen ein Paket-Repository **ab Ubuntu 26.04**:

```sh
sudo apt install ghostty
```

Prüfe die Docs für aktuelle Architekturen und Paketdetails. Unter Linux braucht Ghostty mindestens GTK 4.14 und Adwaita 1.5 (das Projekt trackt die Minima von Debian/Fedora/Ubuntu LTS). Schlägt die GPU-Initialisierung auf alter Hardware fehl, schau in den Linux-Docs nach Software-Rendering-Optionen, statt an Env-Vars zu raten.

Wenn du aus Source baust, Achtung: Der 1.4-Milestone enthält eine Zig-0.16-Migration, die die Toolchain-Anforderung erhöhen wird, wenn sie landet.

### Meslo Nerd Font installieren

Nerd Fonts enthalten Programming-Icons und -Symbole. Installiere Meslo LG über Homebrew:

```sh
brew install font-meslo-lg-nerd-font
```

Der Font installiert sich automatisch. Verifiziere ihn bei Bedarf im Font Book. Eventuell musst du Ghostty nach der Installation neu starten.

Wenn Icons als Kästchen oder Fragezeichen rendern, nutzt Ghostty den Nerd Font nicht: Dein `font-family`-Wert muss exakt der Ausgabe von `ghostty +list-fonts` entsprechen.

### Ghostty-Config-Datei einrichten

Erstelle die Config-Datei und füge Basiseinstellungen hinzu:

```bash
mkdir -p ~/.config/ghostty
vim ~/.config/ghostty/config
```

Füge das der Config hinzu:

```
font-family = MesloLGS Nerd Font Mono
font-size = 18
background-opacity = 0.9
theme = Argonaut
```

Verfügbare Fonts und Themes finden:

```sh
ghostty +list-fonts
ghostty +list-themes
```

**Config-Änderungen brauchen einen Reload**

Drücke `Cmd+Shift+,` unter macOS, um die Config neu zu laden, oder starte Ghostty neu. Vertippte Keys tun still nichts – wenn eine Einstellung ignoriert scheint, prüfe zuerst den Key-Namen.

**Verifizieren:** Nach dem Reload sollten Theme und Opazität sofort wechseln. Wenn nicht, ist der Config-Pfad falsch (er muss unter `~/.config/ghostty/config` liegen) oder ein Key-Name ist falsch geschrieben.

**Tipp:** Halte deine Ghostty-Config minimal. Pack schwere Anpassungen stattdessen in deine Shell-rc-Dateien oder das Prompt-Setup. Das macht das Syncen zwischen Maschinen einfacher.

### Weitere Einstellungen, die sich lohnen

Die Basis-Config bringt dich zum Laufen. Diese Optionen decken die meistgewünschten Tweaks ab:

| Option | Beispiel | Was sie tut |
| --- | --- | --- |
| `window-padding-x` / `window-padding-y` | `window-padding-x = 12` | Luft um deinen Text |
| `cursor-style` | `cursor-style = bar` | Balken-, Block- oder Unterstrich-Cursor |
| `copy-on-select` | `copy-on-select = true` | Sofort kopieren, wenn du Text markierst |
| `mouse-hide-while-typing` | `mouse-hide-while-typing = true` | Mauszeiger beim Tippen ausblenden |
| `background-blur-radius` | `background-blur-radius = 20` | Blur hinter Transparenz (macOS) |
| `confirm-close-surface` | `confirm-close-surface = false` | Schließen-Bestätigungsdialog überspringen |
| `shell-integration-features` | `shell-integration-features = true` | OSC-133-Marks: aktiviert Click-to-move-Cursor und Prompt-Jumping |
| `keybind` | `keybind = global:cmd+backquote=toggle_quick_terminal` | Drop-down-„Quake"-Terminal von überall |
| `progress-style` | siehe Config-Docs | Neu in 1.3.1: OSC-9;4-Fortschrittsbalken in Fenster- und Tab-Titeln steuern oder deaktivieren |

### Wichtige Shortcuts (macOS-Defaults)

| Aktion | Shortcut |
| --- | --- |
| Neuer Tab | `Cmd+T` |
| Neuer Split (rechts / unten) | `Cmd+D` / `Cmd+Shift+D` |
| Surface schließen | `Cmd+W` |
| Vollbild umschalten | `Cmd+Enter` oder `Cmd+Ctrl+F` |
| Scrollback-Suche | `Cmd+F` |
| Nächster / vorheriger Treffer | `Cmd+G` / `Shift+Cmd+G` |
| Terminal Inspector | `Cmd+Option+I` |
| Font-Größe erhöhen / verringern | `Cmd+=` / `Cmd+-` |
| Config öffnen / neu laden | `Cmd+,` / `Cmd+Shift+,` |

Alle sind per `keybind`-Zeilen rebindbar. Führe `ghostty +list-keybinds --default` aus, um deine aktuellen Defaults zu sehen.

## Prompt-Optionen (wähl eine)

Jetzt brauchst du einen Prompt. Wähl einen:

- Starship funktioniert mit jeder Shell, hat fertige Themes und ist schnell. Ich habe eine volle Anleitung für Starship + Ghostty: [Starship + Ghostty: Das ultimative Mac-Terminal-Setup](/de/starship-ghostty-terminal/).
- Powerlevel10k ist für zsh gebaut und hochgradig konfigurierbar – deshalb wählen es zsh-Nutzer immer wieder.

Wenn du den zsh-Weg gehst, lohnt es sich auch, die [besten Oh-My-Zsh-Plugins für 2026](/de/beste-oh-my-zsh-plugins/) für Completions und Quality-of-Life-Bits durchzugehen.

### Powerlevel10k-Theme installieren

Installiere Powerlevel10k:

```sh
brew install powerlevel10k
echo "source $(brew --prefix)/share/powerlevel10k/powerlevel10k.zsh-theme" >> ~/.zshrc
source ~/.zshrc
```

Der erste Lauf zeigt einen Konfigurations-Wizard. Geh ihn durch, um deinen Prompt anzupassen: welche Segmente angezeigt werden, Farben, Icons usw. Du kannst später jederzeit `p10k configure` erneut ausführen, um es zu tweaken.

Der Prompt zeigt Git-Status und Befehlsausführungszeit ohne langsamer zu werden. Editiere `~/.p10k.zsh`, wenn du es weiter feintunen willst.

### zsh-autosuggestions-Plugin einrichten

zsh-autosuggestions schlägt Befehle während des Tippens vor, basierend auf deiner History. So bringst du es zum Laufen:

```sh
brew install zsh-autosuggestions
echo "source $(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh" >> ~/.zshrc
source ~/.zshrc
```

Jetzt siehst du beim Tippen ausgeblendete Vorschläge. Drücke die rechte Pfeiltaste oder Ende, um sie anzunehmen. Verifizieren: Tippe den Anfang eines kürzlich genutzten Befehls und der Vorschlag sollte sofort erscheinen. Du kannst die Vorschläge in `.zshrc` anpassen: Farben ändern, Keybindings tweaken usw.

Siehe auch: [Command Autocomplete in Zsh aktivieren](/enable-command-autocomplete-in-zsh/)

### zsh-syntax-highlighting einrichten

zsh-syntax-highlighting färbt deine Befehle beim Tippen: grün für gültige Befehle, rot für Fehler. Installiere es:

```sh
brew install zsh-syntax-highlighting
echo "source $(brew --prefix)/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh" >> ~/.zshrc
source ~/.zshrc
```

Es highlightet gültige Befehle und Optionen, unterstreicht existierende Dateipfade und matcht Klammerpaare. Fange Tippfehler, bevor du Enter drückst. Verifizieren: Führe `ls` (grün) und dann `lss` (rot) nach `source ~/.zshrc` aus.

Siehe auch: [Syntax Highlighting in Zsh aktivieren](/enable-syntax-highlighting-zsh/)

## Ghostty mit tmux und zoxide erweitern

Ghostty hat eingebautes Multiplexing, aber **tmux** lohnt sich, wenn du Folgendes brauchst:
- Remote-Attach-/Detach-Workflows über SSH
- Session-Sharing über Maschinen oder Teams hinweg
- Ein größeres Ökosystem und Doku

Eine Sache im Blick behalten: Hashimotos Firma Superlogical baut einen First-Party-Terminal-Multiplexer auf libghostty – der natürliche Upgrade-Pfad für Session-Persistenz ohne tmux. Behandelt in [Superlogical Rex, der neue Terminal-Multiplexer des Ghostty-Schöpfers](/de/superlogical-rex/). Bis es shipped, bleibt tmux die langweilige, zuverlässige Wahl.

Wenn dein Workflow eher lokal und Agent-lastig als remote ist, ist `cmux` ein weiterer Weg, den es sich anzusehen lohnt.

**zoxide** macht das Springen zwischen Verzeichnissen schneller.

### Was ist tmux und wie hilft es

tmux lässt dich mehrere Terminal-Sessions in einem Fenster verwalten. Nützlich für Hintergrundprozesse, Sessions mit anderen teilen oder dein Setup über Reboots hinweg behalten.

```sh
brew install tmux
```

Dann tippe einfach `tmux`, um eine neue Session zu starten. Mehr Details: [tmux unter macOS installieren und die wichtigsten Befehle lernen](/tmux-basics/)

Wenn du eine Remote-Box zum Attachen willst, fängt ein [Hetzner-Cloud-VPS](https://go.bitdoze.com/hetzner) bei wenigen Euro im Monat an (Größenordnung: 4–5 EUR/Monat für eine kleine VM).

### Was ist zoxide und wie hilft es

zoxide ersetzt `cd` durch smartere Navigation. Es trackt deine meistgenutzten Verzeichnisse, damit du per Fuzzy-Matching schnell dorthin springen kannst.

```sh
brew install zoxide
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
source ~/.zshrc
```

Nutze jetzt `z` statt `cd`, um herumzuspringen. Siehe: [Zoxide-Tutorial: smartere Terminal-Navigation](/zoxide/)

Mit tmux, zoxide und Ghostty zusammen hast du einen soliden Terminal-Workflow: Multiplexing, schnelle Navigation und GPU-powered Rendering.

## Bekannte Ghostty-Fehler

### 'xterm-ghostty': unknown terminal type

Auf manchen Remote-Linux-Maschinen erkennen Tools Ghosttys Terminal-Typ nicht, und du siehst Fehler wie: `'xterm-ghostty': unknown terminal type.`

Quick-Fix für die aktuelle Session:

```sh
export TERM=xterm-256color
```

Dauerhafter Fix auf dieser Maschine:

```sh
echo "export TERM=xterm-256color" >> ~/.bashrc
source ~/.bashrc
```

Wenn es nur über SSH passiert, setze `TERM` stattdessen konditional in deiner Shell-Config.

### Icons rendern als Kästchen

Der Nerd Font ist nicht aktiv. Prüfe, dass `font-family` in `~/.config/ghostty/config` exakt der Ausgabe von `ghostty +list-fonts` entspricht, dann starte Ghostty neu. Den Font zu installieren reicht nicht, wenn die Config noch auf einen anderen Familiennamen zeigt.

### Config-Änderungen greifen nicht

Drei übliche Verdächtige: falscher Pfad (muss `~/.config/ghostty/config` sein), ein vertippter Key-Name (wird still ignoriert) oder du hast vergessen, mit `Cmd+Shift+,` neu zu laden. Ändere zuerst etwas Offensichtliches wie `theme`, um zu beweisen, dass der Reload-Pfad funktioniert.

### Homebrew-Cask-Konflikte

Wenn `brew install --cask ghostty` mit „already an app at /Applications" fehlschlägt, liegt eine manuelle Kopie im Weg. Lösche `/Applications/Ghostty.app` und führe den Cask-Install erneut aus.

### Ghostty startet nicht unter Nix (non-NixOS)

Du brauchst extra OpenGL-Treiber-Setup, damit die Libraries aus dem Nix-Store deine GPU-Treiber finden. Siehe die [offiziellen Install-Docs](https://ghostty.org/docs/install/binary) für den aktuellen Workaround.

### Rollback / Rückgängig machen

Ein Terminal lässt sich risikoarm entfernen. Kompletter Abriss:

```sh
brew uninstall --cask ghostty
rm -rf ~/.config/ghostty
```

Dann lösche den Meslo Nerd Font aus dem Font Book, wenn du ihn loswerden willst. Deine Shell-rc-Änderungen (powerlevel10k, zsh-Plugins, zoxide) sind unabhängig; drehe diese Zeilen in `~/.zshrc` eine nach der anderen zurück.

## FAQ

**Ist Ghostty kostenlos? Was ist die Lizenz?**

Ja. Ghostty ist MIT-lizenziert und kostenlos, ohne Account oder Lizenzschlüssel. Seit Dezember 2025 wird das Projekt von einer staatlich anerkannten Non-Profit-Organisation getragen, und einige Maintainer werden über sie bezahlt. Die macOS-App ist ein normaler Download (oder ein Homebrew-Cask), und die Linux-Builds kommen von der Distro oder den Install-Docs des Projekts.

**Hat Ghostty GitHub wirklich verlassen?**

Ja. Im April 2026 kündigte Hashimoto den Umzug nach einer Reihe von GitHub-Ausfällen an. Ein Read-Only-Mirror bleibt unter der GitHub-URL und wird täglich synchronisiert, alte Links und Stars funktionieren also weiter. Die Entwicklung passiert auf der eigenen Infrastruktur des Projekts. Für Bugs nutze ghostty.org oder den Projekt-Discord, statt neue GitHub-Issues zu eröffnen.

**Wird Ghostty 1.4.0 meine Config brechen?**

Es gibt keine Hinweise auf einen Config-Format-Bruch. Die sichtbaren Milestone-Punkte wirken additiv: Animations-Frames, Fenster-Benennung, Drag-Reorder, Blur. Die zu beobachtende ist die Runtime-Änderung an `max_scrollback`, wenn du dagegen skriptest. Wie immer: Überflieg die 1.4-Release-Notes, bevor du eine Maschine aktualisierst, auf die du angewiesen bist, und bewahre eine Kopie deiner `~/.config/ghostty/config`.

**Unterstützt Ghostty OSC-7501-Agent-Benachrichtigungen?**

Stand Mitte Oktober 2026 nicht bestätigt. Das Protokoll wurde am 6. Oktober 2026 veröffentlicht, es ist also eine Woche alt. Die Ankündigung nennt Herdr, cmux und Agent Deck als Inbox-Ziele, die es rendern werden. Geh nicht davon aus, dass irgendein Terminal es schon implementiert; prüfe die Release Notes, wenn Ghostty 1.4 landet.

## Fazit

GPU-Rendering, native UI und der Terminal Inspector stellen Ghostty aktuell vor die meisten Terminals auf dem Mac. Die größere Verschiebung ist libghostty: spezialisierte Apps für Agents, SSH und eingebettete Nutzung laufen alle auf derselben Engine und lesen dieselbe Config. Ghostty 1.4.0 wird für Ende Oktober 2026 erwartet, und Hashimotos Vorhersage steht, dass bis Mitte 2027 mehr Leute Ghostty über libghostty-Apps nutzen werden als die GUI selbst.

Wenn du Zeit im Terminal verbringst, installiere es und schau, wie es sich anfühlt. Und wenn du AI-Coding-Agents laufen lässt, behalte cmux und das OSC-7501-Protokoll im Auge – agent-bewusste Terminals werden gleich viel weniger nervig.

[Ghostty herunterladen](https://ghostty.org/download)

Ghostty funktioniert auch großartig mit [Fish Shell](/install-fish-shell-ubuntu/). Wenn du ein Shell-Upgrade suchst, sieh dir meinen [Fish Shell vs Bash vs Zsh](/de/fish-shell-vs-bash-vs-zsh/)-Vergleich an, die [Fish-Shell-unter-macOS-Setup-Anleitung](/fish-shell-macos-setup/) oder [Starship-Prompt mit Fish einrichten](/fish-shell-starship-prompt/).