Lumi einrichten: lokale Suche, CLI und API unterscheiden

Lumi verwendet für die Dateisuche und für KI-Fragen unterschiedliche Wege. Die Suche greift auf den Index des Betriebssystems zu; eine Frage geht an die ausgewählte CLI oder API. Finden Sie zunächst eine bekannte Datei, wählen Sie eine Verbindung und stellen Sie eine kurze Frage ohne vertrauliche Daten. Prüfen Sie anschließend das tatsächliche Modell und die Nutzung. Ein gefundenes Dokument wurde dadurch noch nicht vom Modell gelesen. Auch ein CLI-Name im Menü beweist nicht, dass eine Anfrage über Ihr Abonnement abgerechnet wird.

Die folgenden Bedienelemente und Abläufe beziehen sich auf diese festgelegte Lumi-Revision. Andere Versionen können Einstellungen und Modellmenüs verändern. Übernehmen Sie Modell-IDs aus dem aktuellen Dienst, statt ein älteres Menü als gültigen Modellkatalog zu behandeln.

Lumi installieren und die Dateisuche getrennt testen

Laden Sie die passende Ausgabe unter Releases des Projekts herunter. Unter macOS öffnen Sie die DMG-Datei und ziehen Lumi in den Programme-Ordner. Unter Windows stehen ein Installationsprogramm und eine portable Ausgabe zur Verfügung. Bei einer Signatur- oder Sicherheitswarnung prüfen Sie zuerst die Herkunft und die Vorgaben Ihrer Organisation. Schalten Sie nicht die allgemeinen Schutzfunktionen des Systems ab. Weitere Hinweise enthalten die Anleitungen für macOS und Windows.

Der Standardkurzbefehl ist unter macOS Option zusammen mit der physischen Taste direkt links neben der 1, unter Windows Alt zusammen mit derselben Taste. Das aufgedruckte Zeichen hängt vom Tastaturlayout ab. Bei einem Konflikt ändern Sie den Kurzbefehl über Change im Begrüßungsfenster. Die folgenden Feldnamen entsprechen der englischen Oberfläche.

Suchen Sie nach einer gewöhnlichen Datei oder Anwendung, von der Sie wissen, dass sie existiert und indexiert ist. Prüfen Sie Name und Pfad, wählen Sie den Treffer mit den Pfeiltasten und öffnen Sie ihn mit Enter. Option+Enter unter macOS beziehungsweise Alt+Enter unter Windows zeigt die ausgewählte Datei im Finder oder Explorer. Dafür ist kein Modell-API-Schlüssel erforderlich. Auf dem Mac nutzt Lumi Spotlight; unter Windows werden Anwendungen über Startmenü-Verknüpfungen und Dateien über Windows Search gefunden. Fehlt eine Datei, prüfen Sie den Systemindex und den Suchbereich, statt das Modell zu wechseln. Suche und Kurzbefehle

Verstehen, welche Daten das Modell erhält

Ein Dateitreffer öffnet die Datei oder zeigt ihren Speicherort. Er hängt das Dokument nicht automatisch an eine Modellunterhaltung an. Auch ein Treffer anhand eines Begriffs im Dokumentinhalt ist nicht mit dem Senden dieses Inhalts gleichzusetzen.

Der benutzerdefinierte API-Pfad sendet normalerweise eine Systemanweisung, den bisherigen Verlauf der aktuellen Unterhaltung und die neue Frage. Für die mitgelieferten lumi-Modelle unter Ollama gibt es einen Zweig ohne Systemanweisung. Beim Aufbau der Anfrage werden weder sämtliche Suchtreffer noch beliebige Dateiinhalte automatisch angehängt. Eingefügte Texte, frühere Gesprächsinhalte und die Verarbeitung durch den gewählten Dienst müssen Sie dennoch hinsichtlich des Datenschutzes beurteilen. Aufbau der Anfrage

Die CLI-Pfade haben unterschiedliche Grenzen. Claude startet im persönlichen Ordner des Benutzers; Lumi legt WebSearch,WebFetch als Werkzeuge fest. Codex verwendet einen eigenen Ordner, --sandbox read-only und eine Anweisung, weder Befehle auszuführen noch Dateien zu lesen. Gemini nutzt einen separaten Ordner und --approval-mode plan. Arbeitsordner, Sandbox und Textanweisung sind verschiedene Kontrollen. Keine davon belegt für sich allein, dass der Prozess keine weiteren Einstellungen lesen oder Netzwerkzugriffe ausführen kann. Die CLIs behalten ihre eigene Authentifizierung und Konfiguration. Unter macOS wird die Prozessumgebung vor dem Anpassen von PATH übernommen; unter Windows werden Authentifizierungsvariablen ebenfalls nicht gelöscht. macOS-Ausführung; Windows-Ausführung

Einen Anfrageweg wählen, keinen Preissieger

Was bereits vorhanden ist	Geeigneter Einstieg	Was geprüft werden muss
Installierte CLI und berechtigter Kontozugang	Claude, Codex oder Gemini CLI	Aktive Authentifizierung und Konto, dessen Kontingent oder Rechnung sich verändert
Heruntergeladene Modellgewichte für den eigenen Rechner	Lokaler Ollama- oder LM-Studio-Server	Geladenes Modell, ausführender Rechner und mögliche Cloud-Weiterleitung; Hardware und Strom bleiben Ressourcen
Ein bestimmtes externes Modell und ein API-Konto	Benutzerdefinierte API-Verbindung	Endpoint, Schlüssel, exakte Modell-ID sowie Nutzung oder Guthaben dieses Kontos

Dies ist eine Entscheidung über die Konfiguration, kein Kostenvergleich. Abonnementzugang, zusätzlich berechnete Nutzung und lokale Rechenressourcen sind keine austauschbaren Kostenpositionen. Bevor ein Weg als günstiger gelten kann, müssten sämtliche erforderlichen Abonnement-, Nutzungs- und Guthabenbedingungen geprüft werden.

Vorhandene CLI: zuerst die Authentifizierung prüfen

Richten Sie nur die CLI ein, die Sie verwenden möchten. Starten Sie für Claude claude, schließen Sie die offizielle Anmeldung ab und prüfen Sie mit /status die Authentifizierung in der interaktiven Oberfläche. Achten Sie besonders auf ANTHROPIC_API_KEY: Laut offizieller Dokumentation wird ein vorhandener Schlüssel im nicht interaktiven Modus -p verwendet; andere Authentifizierungsmechanismen können noch Vorrang haben. Lumi ruft Claude mit -p auf. Eine interaktive Sitzung, die ein Abonnement anzeigt, reicht deshalb nicht als Nachweis für die Abrechnung von Lumi-Anfragen. Prüfen Sie die tatsächlich übernommene Umgebung und die Nutzungsdaten, ohne geheime Werte auszugeben. Authentifizierungsreihenfolge von Claude

Für Codex verwenden Sie codex login und anschließend codex login status. OpenAI unterscheidet die Anmeldung mit ChatGPT für den Abonnementzugang von der nutzungsabhängigen Verwendung eines API-Schlüssels. Prüfen Sie außerdem eine möglicherweise vorhandene Konfiguration für einen eigenen Anbieter. Die Bezeichnung Codex in Lumi identifiziert nicht allein den tatsächlich angesprochenen Dienst. Codex-Authentifizierung

Für Gemini starten Sie gemini und wählen Sign in with Google, sofern Sie diese Anmeldemethode nutzen möchten. Google-Anmeldung, Gemini-API-Schlüssel und Vertex AI sind unterschiedliche Wege. Eine Ausführung ohne interaktive Oberfläche kann gespeicherte Anmeldedaten wiederverwenden; dadurch wird sie nicht automatisch einem bestimmten Abonnement zugeordnet. Gemini-Authentifizierung

Wählen Sie danach in Lumi die entsprechende CLI im Modellmenü. Nach Änderungen an Authentifizierung oder Startumgebung beenden und öffnen Sie Lumi erneut, bevor Sie testen. Vorgaben des Anbieters zu Konto, Region und Organisation bleiben gültig. Weder Lumi noch eine separate API-Verbindung hebt die Anmeldebeschränkungen eines anderen Dienstes auf.

Eine lokale oder externe API-Verbindung speichern

Verlassen Sie eine vorhandene Antwort und kehren Sie zu einem leeren Eingabefeld zurück, bevor Sie im Modellmenü Connect a model… öffnen. Wählen Sie unter Service Ollama, LM Studio oder Other address. Tragen Sie Name, Address, Model und API key ein, klicken Sie auf Connect und prüfen Sie, ob die gespeicherte Verbindung im Modellmenü ausgewählt ist. Verbindungsformular

In Address gehört die Base URL, nicht der vollständige Anfrage-Endpoint. Lumi hängt /chat/completions selbst an. Wird der vollständige Endpoint eingefügt, entsteht ein doppelter Pfadabschnitt. Name ist Ihre frei gewählte Bezeichnung; Model muss eine exakte, vom Server akzeptierte Kennung sein.

Ziel	Beispiel für Address	Modell und Schlüssel
Lokales Ollama	`http://localhost:11434/v1`	Name eines tatsächlich heruntergeladenen lokalen Modells; der lokale Standardserver benötigt keinen Cloud-API-Schlüssel
Lokales LM Studio	`http://localhost:1234/v1`	Modellkennung aus LM Studio; bei aktivierter Serverauthentifizierung dessen Zugangstoken angeben
Eigene BetterToken-Verbindung	`https://www.bettertoken.ai/v1`	Ihr eigener API-Schlüssel und eine aktuelle Modell-ID aus dem Modellkatalog oder Key Setup

Starten Sie zunächst den Ollama- oder LM-Studio-Server und bereiten Sie ein nutzbares Modell vor. Die genannten Ports stammen aus den offiziellen Beispielen; bei geänderter Konfiguration verwenden Sie den tatsächlichen Port. localhost bezeichnet nur das erste Verbindungsziel und beweist nicht den Ort der gesamten Inferenz. Für Offline-Arbeit müssen die Gewichte lokal ausgeführt werden und der Server darf die Frage nicht an ein Cloud-Modell weiterreichen. Ollama-Kompatibilität; LM-Studio-Server und API

BetterToken ist hier ein optionales API-Konto, kein Ersatz für eine Abonnementanmeldung. Prüfen Sie die Nutzungsvoraussetzungen, erstellen Sie einen Schlüssel im eigenen Konto, folgen Sie der aktuellen Einrichtung und kontrollieren Sie Kontingent oder Guthaben sowie die Modellverfügbarkeit. YOUR_API_KEY und YOUR_MODEL_ID sind Platzhalter, keine gültigen Zugangsdaten. Der echte Schlüssel gehört in das verdeckte Schlüsselfeld, nicht in Fragen, Bildschirmfotos oder Protokolle. Die Dokumentation nennt derzeit Russland als bediente Region; außerhalb davon sollten Sie die Nutzungsberechtigung Ihres Kontos zunächst beim Dienst klären.

Die Tabelle für Entwicklerzugänge in der BetterToken-Dokumentation nennt https://www.bettertoken.ai/v1. Zusammen mit Lumis Pfadergänzung ergibt sich https://www.bettertoken.ai/v1/chat/completions, entsprechend der Chat-Completions-Dokumentation. Das ist eine Herleitung des Anfrageformats, kein Nachweis eines erfolgreichen Ende-zu-Ende-Tests mit Ihrem Konto und keine Garantie für sämtliche Modellfunktionen. Eine gespeicherte Lumi-Verbindung überschreibt nicht die bestehende Anbieterkonfiguration Ihrer CLI.

Eine vollständige Antwort und ihre Nutzung verifizieren

Beginnen Sie eine leere Unterhaltung, wählen Sie die beabsichtigte Verbindung und fragen Sie: „Rechne 2.5 Zoll in Zentimeter um. Antworte in einem Satz, ohne im Web zu suchen.“ Senden Sie mit Cmd+Enter unter macOS oder Ctrl+Enter unter Windows, damit Enter nicht stattdessen eine ausgewählte Datei öffnet. Ask in ChatGPT, Cmd+Shift+Enter und Ctrl+Shift+Enter nutzen den Browserweg, nicht die hier geprüfte API-Verbindung. Tastaturaktionen

Warten Sie bis zum Ende der Antwort. Das erwartete Ergebnis beträgt 6,35 Zentimeter. Bei leerem Eingabefeld und ohne markierten Text kopiert Cmd+C beziehungsweise Ctrl+C die vollständige Antwort. Speichern Sie sie privat mit Anfragezeit und Verbindungsname, ohne Schlüssel. Das richtige Rechenergebnis prüft nur den Inhalt. Kontrollieren Sie getrennt: einen sichtbaren lokalen Treffer, die vollständige Antwort, den tatsächlichen Anbieter und das Modell sowie die passende Nutzung im richtigen Konto.

Vergleichen Sie bei einer API die Anfrage- und Nutzungsdaten dieses Kontos. Das BetterToken-Dashboard zeigt Anfragen, Tokenverbrauch und Guthaben. Bei einer CLI prüfen Sie das Kontingent des angemeldeten Kontos oder dessen API-Abrechnung. Bei lokaler Inferenz prüfen Sie stattdessen die Verarbeitung im lokalen Server und das geladene Modell. Bietet der Dienst nur Gesamtnutzung ohne Modellnachweis pro Anfrage, halten Sie das Modell als unbestätigt fest. Eine Selbstauskunft des Modells ersetzt diesen Nachweis nicht. Nutzungsübersicht bei BetterToken

Vor einem neuen Versuch die Fehlerursache bestimmen

Esc stoppt eine laufende Antwort; ein weiteres Esc verlässt die Antwort- oder Fehleransicht. In dieser Revision kann ein Modellwechsel nach einem Fehler — ebenso wie Enter bei leerem Eingabefeld — die vorherige Frage erneut senden. Verlassen Sie daher zuerst den Fehlerzustand und wechseln Sie erst danach die Verbindung. So vermeiden Sie, die letzte Frage unbeabsichtigt an einen anderen Dienst zu schicken. Ein angehaltener Client beweist nicht, dass serverseitig keine Nutzung entstanden ist. Wiederholung und Esc-Verhalten

Symptom	Nächste Prüfung
Anwendungen erscheinen, eine Datei aber nicht	Systemindex und Suchbereich kontrollieren; nicht den API-Schlüssel wechseln
CLI fehlt oder Anmeldung scheitert	Diese CLI über den offiziellen Terminalablauf nutzbar machen und den von Lumi gefundenen Programmpfad prüfen, nicht alle Werkzeuge neu installieren
`401` oder `403`	Fehlertext lesen; Zugangsdaten von Netzwerk-, Regions- und Organisationsvorgaben unterscheiden
`404` oder unbekanntes Modell	Doppelte `/chat/completions`-Ergänzung entfernen, genaue Modell-ID und lokale Modellbereitschaft prüfen
`429` oder Kontingentfehler	Kontingent, Guthaben und Ratenbegrenzung prüfen; Wiederholungsanweisungen des Servers statt einer Dauerschleife beachten
HTTP `200`, aber leere, unvollständige oder fehlerhafte Ausgabe	Gesamten Stream und abschließenden Fehler prüfen; Annahme der Anfrage ist kein erfolgreicher Abschluss

Der API-Pfad behandelt ausdrücklich Fehler innerhalb eines Streams und leere Antworten. Kurz sichtbarer Text genügt daher nicht. Beheben Sie ein erkanntes Problem, stellen Sie eine neue kurze Frage und wiederholen Sie dieselben vier Prüfungen. Fehlerbehandlung

Bevor Sie die Verbindung im Alltag einsetzen, sollten eine gewöhnliche Dateisuche und eine harmlose Frage funktionieren — mit eindeutig zugeordnetem Verarbeitungsweg und Abrechnungskonto.