Zum Inhalt springen
kaiport

Schnellstart

Deine ersten zehn Minuten mit kaiport – SSH-Verbindung, Dateibrowser, AI Pilot einrichten und seinen ersten Befehl freigeben.

Auf dieser Seite

Diese Anleitung führt dich durch deine ersten zehn Minuten mit kaiport. Du legst eine SSH-Verbindung an und verbindest dich, schaust dir die Dateien des Servers an, richtest AI Pilot ein und gibst seinen ersten Befehl frei. Danach kennst du die wichtigsten Teile der App.

Bevor du anfängst

Du brauchst:

  • kaiport auf deinem Mac; siehe Installation.
  • Einen SSH-Server, auf dem du dich anmelden kannst: seinen Hostnamen oder seine IP-Adresse, deinen Benutzernamen und ein Passwort oder einen privaten Schlüssel.
  • Für AI Pilot: kaiport Pro und einen API-Schlüssel eines Anbieters wie Anthropic oder OpenAI oder einen lokalen Modellserver wie Ollama oder LM Studio. Die Schritte 4 und 5 brauchen das; der Rest klappt mit der kostenlosen Version.

Schritt 1: Eine SSH-Verbindung anlegen

Das Startfenster begrüßt dich mit Willkommen bei kaiport (Welcome to kaiport) und zwei Schritten: SSH-Verbindung anlegen und AI Pilot einrichten.

  1. Klicke auf SSH-Verbindung anlegen oder oben rechts auf Neue Verbindung (New connection).
  2. Lass unter Verbindungsart die Kachel SSH ausgewählt.
  3. Trag unter Host den Server ein, zum Beispiel server.example.com oder eine IP-Adresse, und unter Benutzername deinen Benutzernamen. Port bleibt auf 22, sofern dein Server keinen anderen Port nutzt.
  4. Wähl unter Authentifizierung, wie du dich anmeldest:
    • Passwort: Trag es ein oder lass das Feld leer; dann fragt kaiport beim Verbinden danach.
    • SSH-Schlüssel: Klicke auf Auswählen und wähl deinen privaten Schlüssel. kaiport importiert ihn verschlüsselt in seinen Tresor. Ist der Schlüssel geschützt, trag seine Passphrase ein.
  5. Gib unter Name auf Wunsch einen Namen ein. Ohne Namen heißt die Verbindung benutzer@host.
  6. Klicke auf Anlegen.

Die Verbindung erscheint jetzt als Karte im Startfenster. Alle Felder, auch Jump-Hosts und Port-Weiterleitungen, erklärt SSH-Verbindungen.

Schritt 2: Verbinden und dem Server vertrauen

  1. Klicke auf die Karte der Verbindung. Ein Terminalfenster öffnet sich, und kaiport verbindet sich. Das Startfenster schließt sich; mit ⌘⇧H holst du es zurück.
  2. Bei der ersten Verbindung zu einem Server erscheint der Dialog Unbekannter Host: Die Echtheit des Servers kann nicht bestätigt werden. Er zeigt Typ und Fingerabdruck des Host-Schlüssels, zum Beispiel SHA256:….
  3. Vergleiche den Fingerabdruck mit dem deines Servers. Dein Hoster oder Administrator kann ihn dir nennen, oder du führst auf dem Server ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub für seinen Ed25519-Schlüssel aus.
  4. Stimmen die Fingerabdrücke überein, klicke auf Vertrauen. kaiport speichert den Schlüssel und fragt bei diesem Server nicht mehr nach.
  5. Hast du kein Passwort gespeichert, fragt der Dialog Passwort erforderlich danach. Setz das Häkchen bei Verschlüsselt für diese Verbindung speichern, wenn kaiport es sich merken soll, und klicke auf Verbinden.

Jetzt siehst du die Shell deines Servers. kaiport führt eine eigene Liste bekannter Hosts, getrennt von ~/.ssh/known_hosts. Deshalb fragt es auch bei Servern einmal nach, die du aus anderen SSH-Programmen kennst. Die gespeicherten Schlüssel findest du unter Einstellungen → Sicherheit → Bekannte Hosts.

Schritt 3: Den Dateibrowser öffnen

  1. Drück ⌘B oder klicke auf Dateien in der Leiste am rechten Rand des Fensters.
  2. Der Dateibrowser öffnet sich neben dem Terminal und zeigt per SFTP dein Home-Verzeichnis auf dem Server.
  3. Doppelklicke auf einen Ordner, um ihn zu öffnen. Ein Doppelklick auf eine Textdatei öffnet sie im Editorfenster; andere Dateien lädt kaiport in einen Ordner deiner Wahl herunter.
  4. Zum Hochladen ziehst du Dateien aus dem Finder in die Liste.

Bei einem Ordner wechselt Im Terminal öffnen das Terminal per cd dorthin, und KI zu dieser Datei fragen übergibt eine Datei an AI Pilot. Mehr unter Dateibrowser.

Schritt 4: AI Pilot einrichten

AI Pilot gehört zu kaiport Pro. Die Einstellungen kannst du auch ohne Pro ausfüllen; fragst du AI Pilot, öffnet sich das Angebot für kaiport Pro, mit 14 kostenlosen Tagen für neue Abonnenten.

  1. Drück ⌘,, um die Einstellungen zu öffnen, und wähl den Tab AI Pilot. Auch der Schritt AI Pilot einrichten im Startfenster öffnet die Einstellungen.
  2. Klicke unter Anbieter auf deinen Anbieter: Anthropic, OpenAI, OpenRouter, Groq, Mistral, DeepSeek, Together, Ollama (local) oder LM Studio (local). Für einen anderen OpenAI-kompatiblen Dienst trägst du stattdessen seine API-URL ein.
  3. Füg deinen API-Schlüssel unter API-Token ein. Schlüssel von Anthropic beginnen mit sk-ant-. Lokale Server wie Ollama und LM Studio brauchen keinen Token.
  4. Klicke auf Modelle laden und wähl ein Modell aus der Liste. Du kannst den Namen eines Modells auch eintippen.
  5. Klicke auf Verbindung testen. Die Meldung „Verbindung erfolgreich – das Modell antwortet.“ bestätigt, dass alles funktioniert.
  6. Klicke auf Speichern.

Dein Token wird verschlüsselt gespeichert. Alle weiteren Einstellungen, etwa den Autopilot und ob AI Pilot Dateiinhalte lesen darf, erklärt AI Pilot einrichten.

Schritt 5: AI Pilot fragen und den ersten Befehl freigeben

  1. Wechsle zurück in das Terminalfenster deines Servers.
  2. Drück ⌘J oder klicke in der Leiste am rechten Rand auf AI Pilot. Der Bereich fragt Womit kann ich helfen? und macht dir Vorschläge.
  3. Klicke auf den Vorschlag „Wie ist die Festplatten- und Speicherauslastung?“ oder tippe deine eigene Frage ein und drück Enter. Mit ShiftEnter beginnst du eine neue Zeile.
  4. AI Pilot schlägt seinen ersten Befehl vor und wartet. Die Karte zeigt Wartet auf Freigabe und fragt: „Soll dieser Befehl im Terminal ausgeführt werden?“
  5. Prüf den Befehl. Klicke auf Ausführen (Run), damit er in deinem Terminal läuft, oder auf Ablehnen (Deny).
  6. AI Pilot liest die Ausgabe, macht Schritt für Schritt weiter und fasst das Ergebnis zusammen. Jeder weitere Befehl braucht wieder deine Freigabe.
AI Pilot fragt, bevor er einen Befehl ausführt
AI Pilot wartet auf die Freigabe eines Befehls, mit den Schaltflächen Run und DenyAI Pilot wartet auf die Freigabe eines Befehls, mit den Schaltflächen Run und Deny

AI Pilot fragt, bevor er einen Befehl ausführt

Der Befehl läuft in dem Terminal, das du siehst – du kannst also zuschauen und jederzeit eingreifen. Nach Passwörtern fragt AI Pilot nie im Chat: Braucht ein Befehl wie sudo eines, tippst du es im Terminal ein, und AI Pilot macht weiter.

Wie es weitergeht