Quick Start: Get OmniRoute Running in 3 Minutes

Schritt 1: OmniRoute installieren

Wählen Sie Ihre bevorzugte Methode:

Option A: npm (empfohlen)

npm install -g omniroute

Option B: Docker

docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest

:latest ist die höchste veröffentlichte stabile SemVer-Version. Das Tag folgt nicht dem Git-Branch main. Verwenden Sie für GitOps eine feste Version wie diegosouzapw/omniroute:X.Y.Z. Siehe Image-Tags/Release-Kanäle.

Option C: Aus dem Quellcode

git clone https://github.com/diegosouzapw/OmniRoute.git
cd OmniRoute
npm install
npm run dev

---

Schritt 2: OmniRoute starten

omniroute

OmniRoute startet unter http://localhost:20128. Das Dashboard wird automatisch geöffnet.

---

Schritt 3: Einen kostenlosen Anbieter verbinden

Sie können OmniRoute völlig kostenlos verwenden, indem Sie einen kostenlosen Anbieter verbinden.

Option A: Kiro (kostenloses Claude — keine Kreditkarte)

1. Öffnen Sie das Dashboard unter http://localhost:20128
2. Gehen Sie zu Anbieter → Anbieter hinzufügen
3. Wählen Sie Kiro AI
4. Klicken Sie auf Verbinden (kein API-Schlüssel erforderlich!)
5. Fertig! Sie haben jetzt kostenlosen Zugriff auf Claude-Modelle.

Option B: OpenCode Free (keine Authentifizierung)

1. Öffnen Sie das Dashboard unter http://localhost:20128
2. Gehen Sie zu Anbieter → Anbieter hinzufügen
3. Wählen Sie OpenCode Free
4. Klicken Sie auf Verbinden (kein API-Schlüssel erforderlich!)
5. Fertig! Sie haben jetzt kostenlosen Zugriff auf mehrere Modelle.

Option C: Pollinations (kein Schlüssel erforderlich)

1. Öffnen Sie das Dashboard unter http://localhost:20128
2. Gehen Sie zu Anbieter → Anbieter hinzufügen
3. Wählen Sie Pollinations
4. Klicken Sie auf Verbinden (kein API-Schlüssel erforderlich!)
5. Fertig! Sie haben jetzt kostenlosen Zugriff auf GPT-5, Claude, Gemini und weitere Modelle.

---

Schritt 4: Funktion überprüfen

Erstellen Sie unter API-Schlüssel einen neuen Schlüssel. Speichern Sie diesen Schlüssel, da er später nicht erneut angezeigt wird. Beachten Sie, dass dieser Schlüssel Tools den Zugriff auf OmniRoute ermöglicht und nicht für den Zugriff auf vorgelagerte Anbieter bestimmt ist.

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

Ihre verbundenen Modelle sollten nun aufgelistet werden.

---

Schritt 5: Ihre IDE oder CLI auf OmniRoute verweisen

Legen Sie in Ihrer IDE oder Ihrem CLI-Tool Folgendes fest:

Basis-URL:    http://localhost:20128/v1
API-Schlüssel: [aus Dashboard → Endpunkte kopieren]
Modell:        auto

Das war’s! Ihre IDE verwendet nun OmniRoute mit automatischer Anbieterauswahl.

IDE-Beispiel: VSCode/Continue.dev

1. Installieren Sie in VSCode die Erweiterung Continue.dev.
2. Aktualisieren Sie Ihre Datei ~/.continue/config.yaml, indem Sie die folgenden Zeilen hinzufügen:

  - name: OmniRoute - Auto
    provider: openai
    model: auto
    apiBase: http://localhost:20128/v1
    apiKey: <YOUR_KEY>

3. Wählen Sie im Chatbereich von Continue.dev OmniRoute - Auto aus, um Anfragen an OmniRoute zu senden.
4. (Optional) Übung für die Leser: Lassen Sie Ihre IDE die Datei config.yaml mit allen anderen vorkonfigurierten Konfigurationen aktualisieren 😊

CLI-Beispiel: Codex CLI

1. Legen Sie die Umgebungsvariable dauerhaft in Ihrem Betriebssystem fest. Für macOS/Linux (zu Ihrer ~/.bashrc oder ~/.zshrc hinzufügen):

export OMNIROUTE_API_KEY="<YOUR_KEY>"

Für Windows (Eingabeaufforderung):

setx OMNIROUTE_API_KEY <YOUR_KEY>

2. Starten wir nun Codex, allerdings für OmniRoute konfiguriert. Führen Sie Folgendes aus:

omniroute launch-codex --model auto

Sie können dies manuell über codex und Befehlszeilenparameter erledigen, um Endpunkt und API-Schlüssel anzugeben. Mit dem obigen Befehl übernimmt OmniRoute jedoch alles für Sie.

Der Start mit einem einzigen Befehl funktioniert über den generischen Launcher auch für andere CLIs: omniroute run <target> unterstützt claude, codex, aider, goose, opencode, qwen und gemini (siehe CLI-Integrationen).

3. Die CLI sollte nun Anfragen an OmniRoute senden.

Prüfen, ob Ihr Tool Anfragen an OmniRoute weiterleitet

Sie können die Details der Anfrage einsehen, indem Sie in der linken Seitenleiste auf Überwachung/Protokolle klicken. Durch Anklicken der Einträge werden weitere Details angezeigt. Nebenbei können Sie sehen, welche Informationen von Ihrem bevorzugten Tool übertragen werden. Dies ist sowohl zu Lern- als auch zu Debugging-Zwecken hilfreich.

---

Wie geht es weiter?

• Auto-Combo-Leitfaden — Lassen Sie OmniRoute die beste KI für Sie auswählen
• Anbieterleitfaden — Weitere Anbieter verbinden (kostenlos und kostenpflichtig)
• Leitfaden zu kostenlosen Tarifen — Kostenlose KI ohne Kreditkarte nutzen
• Fehlerbehebung — Häufige Probleme beheben

---

Häufig gestellte Fragen

„Benötige ich einen API-Schlüssel?“

Nein! Sie können kostenlose Anbieter (Kiro, OpenCode Free, Pollinations) ohne API-Schlüssel verwenden. Verbinden Sie diese einfach im Dashboard.

„Was ist auto?“

auto weist OmniRoute an, automatisch den besten Anbieter für jede Anfrage auszuwählen. Dabei werden Geschwindigkeit, Kosten, Qualität und Verfügbarkeit berücksichtigt. Weitere Informationen finden Sie im Auto-Combo-Leitfaden.

„Wie viel kostet es?“

OmniRoute selbst ist kostenlos und quelloffen. Sie zahlen lediglich für die von Ihnen verwendeten Anbieter. Viele Anbieter bieten kostenlose Tarife an — siehe den Leitfaden zu kostenlosen Tarifen.

„Kann ich es mit Claude Code / Cursor / Copilot verwenden?“

Ja! OmniRoute funktioniert mit jedem Tool, das das OpenAI-Format unterstützt. Legen Sie die Basis-URL einfach auf http://localhost:20128/v1 fest. Spezifische Einrichtungsanweisungen finden Sie im Leitfaden zu CLI-Tools.

„Was passiert, wenn ein Anbieter ausfällt?“

OmniRoute überspringt fehlgeschlagene Anbieter automatisch und versucht es mit dem nächsten. Sie müssen nichts unternehmen. Weitere Informationen finden Sie im Auto-Combo-Leitfaden.

---

Benötigen Sie Hilfe?

• Fehlerbehebung — Häufige Probleme und Lösungen
• Discord — Unterstützung durch die Community
• GitHub Issues — Fehler melden

---

undefined (a58000c7685f)