Konsolity CLI installieren
Konsolity CLI ist der Befehl konsolity, den Sie auf einem Server oder einer Maschine ohne grafische Oberfläche installieren. Einmal über Ihr Konto aktiviert, gibt er Zugriff auf die Hosts, Snippets und Sitzungen Ihres Tresors innerhalb des Bereichs, den Sie ihm zugewiesen haben, und dient Claude-Agenten (zum Beispiel Claude Code) als lokaler MCP-Server. Er funktioniert wie Claude Code auf der Kommandozeile: installieren, einmal mit einem Code aktivieren, dann verwenden.
Erforderlicher Tarif
Konsolity CLI ist dem Tarif Studio und seiner kostenlosen Testphase vorbehalten. Der Server prüft den Tarif bei jedem Aufruf der Maschine: Ohne ihn antwortet jeder Befehl mit „Abonnement erforderlich“. Die Liste der Maschinen und der Widerruf bleiben immer verfügbar, auch ohne den Tarif.
Die Maschine wählen
Jeder Computer, der Ihre Hosts per SSH erreicht: ein Administrationsserver, eine kleine virtuelle Maschine, ein Mac mini, ein Entwicklungsrechner, ein CI-Runner. Die Maschine benötigt keinen eingehenden Port, nur ausgehenden HTTPS-Zugriff auf api.konsolity.com.
| System | Architekturen | Formate |
|---|---|---|
| Linux (Debian, Ubuntu, Fedora, RHEL und Derivate, jede Distribution über das Archiv) | x64, arm64 | Skript, .deb, .rpm, .tar.gz |
| macOS (Intel und Apple Silicon) | ein Archiv pro Architektur (x64, arm64), mit Developer ID signierte und notarisierte Binärdatei · macOS 11 oder neuer | Skript, Homebrew, .tar.gz |
| Windows | x64 | PowerShell-Skript, .zip |
Linux und macOS: Installationsskript
Der einfachste Weg. Das Skript erkennt das System und die Architektur, lädt die passende Datei herunter, prüft ihren SHA-256-Hash und die Ed25519-Signatur des Herausgebers und installiert sie dann:
curl -fsSL https://konsolity.com/cli/install.sh | sh
Um das Skript vor der Ausführung zu lesen:
curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh
Das Skript bricht ab, ohne etwas zu installieren, wenn Hash oder Signatur nicht übereinstimmen.
Linux: .deb-Paket (Debian, Ubuntu)
Laden Sie das Paket für Ihre Architektur herunter, dann:
sudo apt install ./konsolity_<version>_amd64.deb
Auf arm64 (Raspberry Pi 4 oder 5, Graviton- oder Ampere-Server) nehmen Sie konsolity_<version>_arm64.deb. Aktualisierungen laufen danach über apt.
Linux: .rpm-Paket (Fedora, RHEL, Rocky, Alma)
sudo dnf install ./konsolity-<version>.x86_64.rpm
Auf arm64 endet die Datei auf .aarch64.rpm. Aktualisierungen laufen danach über dnf.
Linux: .tar.gz-Archiv
Für jede andere Distribution enthält das Archiv nur das Binary:
tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity
Ersetzen Sie auf einer ARM-Maschine amd64 durch arm64.
macOS: Homebrew
brew install konsolity/tap/konsolity
Aktualisierungen laufen danach über brew upgrade konsolity. Das Installationsskript und das Archiv konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) funktionieren ebenfalls.
Windows: PowerShell
In PowerShell (keine Administratorrechte erforderlich):
irm https://konsolity.com/cli/install.ps1 | iex
Das Skript führt dieselben Prüfungen wie unter Linux durch, installiert konsolity.exe in Ihrem Profil und fügt es dem PATH des Benutzers hinzu. Öffnen Sie ein neues Terminal, um es zu verwenden.
Windows: .zip-Archiv
Das Archiv konsolity_<version>_windows_amd64.zip enthält konsolity.exe. Entpacken Sie es in einen Ordner Ihrer Wahl und fügen Sie diesen Ordner Ihrem PATH hinzu.
Einen Download prüfen
Jede Version wird durch das signierte Manifest https://konsolity.com/cli/latest.json beschrieben: Version, Liste der Dateien (System, Architektur, Format, Adresse, SHA-256-Hash) und die Ed25519-Signatur des Herausgebers. Die Skripte und konsolity update lehnen eine Datei ab, deren Hash oder Signatur nicht übereinstimmt. Um ein von Hand heruntergeladenes Paket selbst zu prüfen:
curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb
Unter macOS verwenden Sie shasum -a 256, unter Windows Get-FileHash konsolity_<version>_windows_amd64.zip. Der angezeigte Hash muss genau dem im Manifest entsprechen.
Die Installation prüfen
konsolity version
Der Befehl zeigt die Version, das System und die Architektur an.
Aktualisieren
konsolity update
konsolity update liest das Manifest, prüft den Hash und die Signatur der neuen Version und ersetzt dann das Binary. Wurde konsolity mit apt, dnf oder Homebrew installiert, verweist Sie der Befehl auf diesen Paketmanager, statt die Datei selbst zu ersetzen.
Ist der systemd-Dienst installiert, führen Sie sudo konsolity update aus: Der Befehl aktualisiert /usr/local/bin/konsolity und startet den Dienst neu. Der Timer konsolity-update.timer erledigt das zweimal täglich auch selbst.
Weiter
- Die Maschine aktivieren mit einem Code, den Sie über Ihr Konto freigeben.
- Ihren Bereich wählen: Hosts, Snippets, Befehlsregeln.
- Die Befehle entdecken, Claude Code anbinden oder als Dienst ausführen.