Konsolity CLI installieren

Aktualisiert am 10. November 2026

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

  1. Die Maschine aktivieren mit einem Code, den Sie über Ihr Konto freigeben.
  2. Ihren Bereich wählen: Hosts, Snippets, Befehlsregeln.
  3. Die Befehle entdecken, Claude Code anbinden oder als Dienst ausführen.