gh0stcli installieren

gh0stcli unter macOS, Linux oder Windows installieren und prüfen, ob es läuft.

gh0stcli verbindet deinen Rechner und deinen KI-Assistenten mit gh0stcloud. Die Installation dauert ein paar Minuten. Diese Seite beschreibt alle Wege — auch den Fall, dass der benötigte Paketmanager noch fehlt.

Wenn du einfach nur schnell starten willst: Die Starter-Seite wählt den passenden Weg für dich aus.

Welcher Weg passt zu dir

Dein SystemNimm
macOSHomebrew
LinuxHomebrew
WindowsDen Installer zum Herunterladen
Windows, von der IT mit Chocolatey verwaltetChocolatey

macOS und Linux

gh0stcli wird über Homebrew veröffentlicht.

1. Prüfen, ob Homebrew da ist

Öffne das Terminal und führe aus:

brew --version

Erscheint eine Versionsnummer, mach weiter. Meldet die Shell, dass der Befehl unbekannt ist, installiere zuerst Homebrew nach der offiziellen Anleitung auf brew.sh. Wir bauen dafür keinen eigenen Installer — nimm den von Homebrew.

2. gh0stcli installieren

brew install gh0stservice/tap/gh0stcli

3. Prüfen, ob es geklappt hat

gh0stcli --version

Windows: der Installer

Diesen Weg empfehlen wir. Er braucht weder einen Paketmanager noch Administratorrechte.

1. Herunterladen

2. Installer starten

Windows warnt eventuell, dass der Herausgeber nicht verifiziert ist. Wir richten die Windows-Code-Signierung gerade erst ein, deshalb ist diese Warnung im Moment normal. Wähle Weitere Informationen und dann Trotzdem ausführen.

Der Installer richtet gh0stcli nur für dein Windows-Konto ein. Für andere Benutzer auf dem Rechner ändert sich nichts, und Administratorrechte sind nicht nötig.

3. Neues Terminal öffnen und prüfen

Der Installer trägt gh0stcli in deinen PATH ein. Bereits geöffnete Terminals bekommen davon nichts mit. Öffne also ein neues PowerShell- oder Terminal-Fenster und führe aus:

gh0stcli --version

Später wieder entfernen

Öffne Einstellungen → Apps → Installierte Apps, suche gh0stcli und wähle Deinstallieren. Alternativ führst du im Installationsordner uninstall-gh0stcli.exe --uninstall aus.

Windows: Chocolatey

Nimm diesen Weg, wenn auf deinem Rechner Software ohnehin über Chocolatey verwaltet wird.

Noch nicht empfohlen. Eine erste Version hat die Freigabe im Chocolatey-Community-Feed durchlaufen, aber wir veröffentlichen schneller, als der Feed prüft — was dort liegt, ist deshalb regelmäßig mehrere Versionen alt. Nimm den Installer von oben, bis wir das anders lösen.

1. Prüfen, ob Chocolatey da ist

Öffne PowerShell und führe aus:

choco --version

Ist der Befehl unbekannt, installiere zuerst Chocolatey nach der offiziellen Anleitung auf chocolatey.org/install.

2. PowerShell als Administrator öffnen

Chocolatey installiert Software für den ganzen Rechner und braucht dafür erhöhte Rechte. Klicke mit der rechten Maustaste auf den Start-Button und wähle Terminal (Administrator). Oder suche nach PowerShell, Rechtsklick, Als Administrator ausführen.

3. gh0stcli installieren

choco install gh0stcli

Danach: KI-Assistenten verbinden

Ein Befehl prüft die Werkzeuge, die du für ein Deployment brauchst, installiert die fehlenden nach deiner Zustimmung und verbindet deinen Assistenten:

gh0stcli setup

Vor jeder Installation fragt es dich. Bei GitHub meldet es dich nie selbst an: gh auth login bleibt dein eigener Schritt. Wenn du Claude Code und Codex installiert hast, wähle mit --agent claude oder --agent codex den Assistenten aus, den du wirklich benutzt.

Dein Assistent bekommt damit zwei Zugänge:

  • Dein Konto — deine Projekte, Apps, Deployments und deren Status.
  • Deine Logs und Metriken — damit er dir sagen kann, was deine App gerade tut, und nicht nur, was du angefordert hast. Dieser Zugang bleibt still, bis du gh0steye im Portal unter Managed Applications startest. gh0stcli setup weist dich darauf hin.

Starte deinen Assistenten danach neu, damit er die neuen Werkzeuge sieht.

Wenn du Claude Code oder Codex noch nie benutzt hast, lies zuerst Sicher mit KI-Assistenten arbeiten. Dort steht, welche Assistenten unterstützt werden und wie du die Kontrolle behältst.

Lieber Schritt für Schritt

Wenn du jeden Schritt sehen möchtest: gh0stcli deps zeigt dir die Werkzeuge, --fix installiert sie. gh0stcli setup --help zeigt dir vorab genau, was verbunden wird.

Danach: anmelden

gh0stcli auth login

Die Anmeldung öffnet sich im Browser. Passwort und Sitzung bleiben außerhalb des Gesprächs mit deinem Assistenten.

Wenn etwas nicht funktioniert

Der Befehl wird nach der Installation nicht gefunden. Öffne ein neues Terminal-Fenster. Änderungen am PATH gelten nur für Terminals, die danach gestartet werden.

Homebrew findet den Tap nicht. Prüfe die Schreibweise: Die Formel heißt gh0stservice/tap/gh0stcli, mit einer Null in gh0stservice.

Windows blockiert den Download. Manche Browser und Virenscanner halten Programme zurück, die bisher selten heruntergeladen wurden. Behalte die Datei und führe sie dann aus. Der Download kommt immer von gh0stcloud.

Es klemmt weiterhin. Lass deinen Assistenten gh0stcli deps ausführen und beschreibe, was dabei herauskommt, oder melde dich bei uns.