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 System | Nimm |
|---|---|
| macOS | Homebrew |
| Linux | Homebrew |
| Windows | Den Installer zum Herunterladen |
| Windows, von der IT mit Chocolatey verwaltet | Chocolatey |
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
- Für Windows herunterladen — passt für fast jeden PC
- Für Windows on Arm herunterladen — nur, wenn dein PC unter Einstellungen → System → Info einen Arm-Prozessor meldet
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 setupweist 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.