AI Pilot einrichten

AI Pilot braucht ein Modell, und das bringst du selbst mit: einen API-Key von Anthropic oder einem anderen Anbieter oder ein Modell, das auf deinem Rechner läuft. Diese Seite zeigt, wie du es in der Mac-App unter Einstellungen → AI Pilot verbindest, was die übrigen Einstellungen bewirken und wie du AI Pilot Regeln für eine einzelne Verbindung mitgibst.

Was du brauchst

• kaiport Pro. Die Einstellungen auf dieser Seite kannst du auch ohne ausfüllen; AI Pilot selbst braucht Pro.
• Einen API-Key eines Anbieters oder einen lokalen Modellserver wie Ollama oder LM Studio.
• Ein Modell, das Tool-Calling (auch Function-Calling genannt) beherrscht. AI Pilot erledigt seine ganze Arbeit über solche Werkzeugaufrufe.

Die Nutzung des Modells rechnet dein Anbieter über dein Konto ab; sie ist nicht in kaiport Pro enthalten.

Anbieter verbinden

1. Öffne Einstellungen → AI Pilot: Klicke im Startfenster auf Einstellungen oder drücke ⌘,.
2. Klicke unter Anbieter (Provider) auf deinen Anbieter, zum Beispiel Anthropic oder OpenAI. Damit ist die API-URL ausgefüllt.
3. Füge deinen Key in API-Token ein. Für einen lokalen Modellserver lässt du das Feld leer.
4. Klicke auf Modelle laden (Load models) und wähle unter Modell ein Modell aus.
5. Klicke auf Verbindung testen (Test connection) und warte auf Verbindung erfolgreich – das Modell antwortet.
6. Klicke auf Speichern.

EN

Einstellungen → AI Pilot

Vorlagen für Anbieter

Andere Anbieter und Gateways mit OpenAI-kompatibler API funktionieren ebenfalls, etwa ein vLLM-Server: Trage ihre Basis-URL unter API-URL ein.

Anthropic oder OpenAI-kompatibel: an der URL erkannt

kaiport spricht zwei Arten von API: die Messages API von Anthropic und die OpenAI-kompatible Chat-Completions-API. Welche gemeint ist, wählst du nicht selbst – kaiport erkennt das an der URL:

• api.anthropic.com ist Anthropic.
• Eine URL, die mit der URL einer Vorlage beginnt, bekommt deren Art.
• URLs, die auf /v1 enden, /openai enthalten oder OpenRouter, Groq, Mistral, DeepSeek, Together, Ollama oder LM Studio nennen (auch localhost:1234 und localhost:11434), sind OpenAI-kompatibel.
• Jede andere URL, etwa ein Proxy in deiner Firma, behält die Art, die vorher ausgewählt war.

Für einen Proxy klickst du deshalb zuerst die passende Vorlage an – Anthropic für einen Claude-Proxy, OpenAI für ein OpenAI-kompatibles Gateway – und ersetzt dann die URL. Wechselt die Art, leert kaiport die Modellliste, weil diese Modelle zur anderen API gehören.

API-URL und Token

API-URL ist die Basisadresse der API. Bei OpenAI-kompatiblen APIs ruft kaiport darunter /models und /chat/completions auf; nimm also einen Versionsteil wie /v1 mit auf, wenn dein Anbieter einen verwendet. Bei Anthropic bleibt https://api.anthropic.com stehen, außer du gehst über einen Proxy.

API-Token ist dein API-Key. kaiport speichert ihn verschlüsselt über den macOS-Schlüsselbund und zeigt ihn nie wieder an. Ist ein Token gespeichert, bleibt das Feld maskiert und zeigt Ein Token ist gespeichert. Leer lassen, um ihn zu behalten. Um den Key zu ersetzen, tippst du den neuen ein und klickst auf Speichern. Unter Einstellungen → Über siehst du bei Verschlüsselung, ob der Systemschlüsselbund verfügbar ist; ohne ihn werden Secrets nur kodiert gespeichert.

Modell

Modelle laden fragt beim Anbieter die Modellliste ab – mit der URL und dem Token, die gerade im Formular stehen. Danach meldet kaiport, wie viele Modelle es geladen hat. Steht das bisher gewählte Modell nicht in der neuen Liste, wählt kaiport das erste aus.

Das Feld Modell ist eine durchsuchbare Liste: Tippe einen Teil des Namens, um sie zu filtern. Fehlt ein Modell in der Liste, tippe seine vollständige ID und wähle den Eintrag in Anführungszeichen, um es trotzdem zu verwenden. Die geladene Liste wird mit den Einstellungen gespeichert; genau diese Modelle bietet auch die Modellauswahl im AI-Pilot-Panel an.

Verbindung testen

Verbindung testen schickt eine winzige Anfrage an das Modell – „Reply with the single word: OK“ – mit den Werten, die gerade im Formular stehen. Du kannst also testen, bevor du speicherst. Die Anfrage enthält die echten Werkzeugdefinitionen von AI Pilot. So prüft der Test alles, was ein echter Chat braucht: URL, Token, Zugriff auf das Modell und ob das Modell Werkzeugdefinitionen akzeptiert.

Das Ergebnis erscheint unter den Feldern: Verbindung erfolgreich – das Modell antwortet. oder Test fehlgeschlagen: mit der Fehlermeldung des Anbieters. Der Knopf ist aktiv, sobald API-URL und Modell ausgefüllt sind.

Speichern und Verfügbarkeit

Speichern sichert Anbieter, URL, Token und Modell gemeinsam; der Knopf wird aktiv, sobald du etwas davon änderst. kaiport bestätigt mit KI-Einstellungen gespeichert.

AI Pilot steht bereit – in Terminal- und Speicher-Tabs und im Editor –, sobald die gespeicherten Einstellungen ein Modell, eine API-URL und einen Token enthalten. Nur URLs mit localhost oder 127.0.0.1 kommen ohne Token aus; Anthropic braucht immer einen. Bis dahin zeigt der Abschnitt AI Pilot ist im Terminal erst verfügbar, wenn URL, Token (falls nötig) und Modell gespeichert sind., und das AI-Pilot-Panel zeigt KI-Provider einrichten mit dem Knopf Einstellungen öffnen.

Anthropic (Claude)

Mit Anthropic nutzt kaiport das offizielle SDK von Anthropic und die Messages API mit Streaming.

• Token: ein API-Key von Anthropic (sk-ant-…).
• API-URL: https://api.anthropic.com. Ändere sie nur für einen Proxy.
• Modelle: Modelle laden listet die Modelle, die dein Key nutzen darf.
• Denken: Bei Modellen, die adaptives Denken (Adaptive Thinking) unterstützen, schaltet kaiport es ein, und Claude entscheidet selbst, wie viel Denkarbeit jeder Schritt braucht. Eine Zusammenfassung dieser Überlegungen erscheint im Chat als aufklappbarer Block Überlegung.
• Kontextfenster: kaiport fragt bei Anthropic nach dem Kontextfenster des Modells, damit die Kontextanzeige im Panel einen genauen Prozentwert zeigt.
• Kreativität (Temperature) wird nicht an Anthropic gesendet; Claude nutzt dann den Standardwert.

OpenAI-kompatible APIs

Für alle anderen Anbieter nutzt kaiport die OpenAI-kompatible Chat-Completions-API. Dabei sendet kaiport den Token als Bearer-Token, streamt die Antwort und bittet den Server, den Token-Verbrauch zu melden. Server ohne diese Option funktionieren trotzdem; die Token-Zahlen werden dann geschätzt. Streamt der Anbieter die Überlegungen des Modells mit, erscheinen sie als Block Überlegung. Das Kontextfenster kommt aus der Modellliste des Anbieters, wenn sie es enthält (bei OpenRouter zum Beispiel); sonst schätzt kaiport es anhand des Modellnamens.

Lokale Modelle

Mit Ollama oder LM Studio bleiben deine Anfragen auf deinem Rechner.

1. Starte den Modellserver und lade ein Modell, das Tool-Calling beherrscht.
2. Klicke unter Einstellungen → AI Pilot auf Ollama (local) oder LM Studio (local).
3. Lass API-Token leer.
4. Klicke auf Modelle laden und wähle das Modell.
5. Klicke auf Verbindung testen und danach auf Speichern.

Einen leeren Token akzeptiert kaiport nur für URLs mit localhost oder 127.0.0.1. Läuft der Modellserver auf einem anderen Rechner in deinem Netzwerk, trage einen Token ein: den, den dein Server erwartet, oder einen beliebigen Platzhalter, wenn er keine Tokens prüft.

Weitere Einstellungen

Diese Einstellungen gelten sofort, wenn du sie änderst; Speichern ist dafür nicht nötig.

Was Dateiinhalte für deinen Datenschutz bedeuten, steht unter Kontext, Tokens und Datenschutz.

Anweisungen für eine Verbindung

Manche Regeln gelten nur für einen Server: „Das ist ein Produktionssystem“, „Der Webroot liegt unter /var/www“. Speichere sie bei der Verbindung:

1. Öffne im Startfenster das Menü der Verbindung (…) und wähle Bearbeiten.
2. Wechsle zum Tab KI (AI).
3. Schreibe deine Regeln in KI-Anweisungen für diese Verbindung.
4. Klicke auf Speichern.

AI Pilot hängt diese Anweisungen an seinen System-Prompt an, sobald er in einem Tab dieser Verbindung arbeitet. Den Tab KI gibt es für SSH-Verbindungen, nicht für Speicherverbindungen. Im selben Tab stehen Verbotene Befehle (KI) und Erlaubte Befehle (KI), siehe Freigaben und Sicherheit.

Modell pro Chat wählen

Das Modell in den Einstellungen ist der Standard. In der Werkzeugleiste des AI-Pilot-Panels wechselst du mit der Modellauswahl das Modell für den Chat in diesem Tab. Sie bietet die Modelle an, die du mit Modelle laden geladen hast. Anbieter, URL und Token kommen immer aus den Einstellungen; du wechselst also nur zwischen Modellen desselben Anbieters. Neue Tabs starten wieder mit dem Standardmodell, und der Editor-Assistent nutzt immer das Standardmodell.

Wenn etwas nicht klappt