Eigene API-Keys und externe Abonnements in Raycast nutzen – ohne AI Credits zu verbrauchen

Für Entwickler, die Raycast als primären Befehls-Launcher unter macOS nutzen, wird das in Raycast v2 eingeführte Kontingent an AI Credits schnell zum Engpass. Raycasts Standard-Pläne beinhalten feste monatliche Guthaben: 500 Credits im Pro-Tarif, 3.000 in Pro+ und 7.500 in Max. Wer Quick AI mehrmals täglich per Tab aus der Suchleiste aufruft, um Shell-Befehle nachzuschlagen, Code zu refaktorisieren oder große Kontexte durch moderne Reasoning-Modelle analysieren zu lassen, erreicht das Kontingent oft schon Mitte des Monats.

Wer ohnehin monatlich rund 20 Dollar für ChatGPT Plus oder Claude Pro bezahlt oder über Guthaben bei der Anthropic Console, OpenAI Platform, Google AI Studio oder OpenRouter verfügt, muss keine teuren Credit-Zukäufe (Top-ups) tätigen oder in kostspieligere Raycast-Tarife wechseln.

Raycast unterstützt nativ drei „Bring Your Own AI“-Modelle, mit denen sich vorhandene Konten und API-Schlüssel einbinden lassen, ohne einen einzigen Raycast AI Credit zu verbrauchen.

Die drei Integrationsmethoden im Überblick

Bevor Sie die Einstellungen öffnen, empfiehlt sich die Wahl der Methode, die am besten zu Ihren vorhandenen Abonnements und Ihrem Setup passt:

Wichtige Voraussetzung: Die Anbindung externer Abonnements, Schlüssel oder Provider setzt ein aktives kostenpflichtiges Raycast-Abonnement (wie das reguläre Raycast Pro) voraus. Der kostenlose Raycast Free-Tarif enthält keine KI-Funktionen. Einmal unter Pro verknüpft, belasten die Modellaufrufe jedoch nicht mehr das Raycast-Monatsguthaben.

Methode 1: Bring Your Own Subscription (Claude Pro & ChatGPT Plus)

Für Entwickler, die bereits monatlich 20 Dollar für ein Web-Abonnement zahlen, ist Bring Your Own Subscription (BYOS) die kostengünstigste Option. Es fallen keine Abrechnungen pro Token an, und die regulären Modellkontingente des Web-Tarifs stehen direkt in Raycast zur Verfügung.

Funktionsweise im Hintergrund

Raycast kommuniziert lokal mit den offiziellen CLI-Tools der Anbieter: Claude Code von Anthropic oder der Codex CLI von OpenAI. Wenn Sie eine Anfrage in Quick AI oder im AI Chat stellen, wird der Prompt direkt vom lokalen Prozess auf Ihrem Rechner an die Server von Anthropic oder OpenAI gesendet. Raycast fängt Ihre Zugangsdaten zu keinem Zeitpunkt ab und speichert sie nicht.

Schritt-für-Schritt-Einrichtung

1. Offizielle CLI-Tools installieren
   • Für Claude: Installieren Sie Claude Code global über npm im Terminal:

     npm install -g @anthropic-ai/claude-code
     

   • Für ChatGPT: Installieren Sie die Codex CLI oder stellen Sie sicher, dass die ChatGPT-/Codex-Desktop-App auf Ihrem System installiert ist.
2. Im Terminal authentifizieren
   • Claude: Führen Sie claude im Terminal aus und geben Sie den Befehl /login ein. Schließen Sie die OAuth-Anmeldung im Browser mit Ihrem Claude Pro- oder Team-Konto ab.
   • ChatGPT: Führen Sie codex login im Terminal aus und melden Sie sich mit Ihrem ChatGPT Plus- oder Team-Konto an (nutzen Sie Ihr Endnutzerkonto, keinen API-Schlüssel).
3. Lokale Abonnements in Raycast aktivieren
   • Öffnen Sie die Raycast-Einstellungen (⌘ ,) und wechseln Sie zu AI → Models & Providers.
   • Scrollen Sie zum Bereich Local AI Subscriptions und aktivieren Sie den Schalter Enable Local AI Subscriptions.
   • Überprüfen Sie, ob in den Zeilen Claude Account oder ChatGPT Account Ihr Konto und Tarifname angezeigt werden. Klicken Sie andernfalls auf Refresh account status.
4. Abonnement-Modelle auswählen
   • Öffnen Sie Quick AI mit Ihrem Launcher-Shortcut und drücken Sie Tab, oder starten Sie AI Chat.
   • Wählen Sie im Dropdown-Menü Modelle aus den Abschnitten Claude Subscription oder ChatGPT Subscription (z. B. Claude 3.7 Sonnet, Claude 3.5 Sonnet, GPT-4o oder OpenAI Reasoning-Modelle).

Kontingente und Nutzungslimits

Abonnementmodelle unterliegen den rollierenden Nutzungslimits des jeweiligen Anbieters (wie dem 5-Stunden-Fenster von Claude oder den Anfragelimits von OpenAI) und nicht den Raycast-Credits:

• Geben Sie /usage im AI Chat ein, um die prozentuale Auslastung und die Zeit bis zum Reset des Fensters einzusehen.
• Alternativ können Sie in der Raycast-Hauptsuche den Befehl Show Claude Usage oder Show ChatGPT Usage ausführen.

Methode 2: Eigene API-Keys einbinden (BYOK)

Wenn Sie eine Abrechnung nach tatsächlichem Token-Verbrauch bevorzugen oder Modelle auch in der Raycast iOS-App auf iPhone oder iPad nutzen möchten, ist Bring Your Own Key (BYOK) die passendste Option.

Abrechnung und Netzwerkverkehr

• Direkte Abrechnung: Die Kosten werden direkt über Ihr Entwicklerkonto beim jeweiligen Anbieter (Kreditkarte oder Prepaid-Guthaben) nach den regulären Token-Preisen abgerechnet. Raycast AI Credits bleiben unberührt.
• Routing: Anfragen mit einem OpenRouter-Key werden direkt von Ihrem Gerät an OpenRouter gesendet. Bei Anthropic, OpenAI und Google laufen die Anfragen zur Standardisierung von Parametern und Fallback-Verhalten über Raycast-Server, werden jedoch mit Ihrem persönlichen Schlüssel autorisiert.
• Modellvielfalt: Ein OpenRouter-Schlüssel schaltet den gesamten Katalog von Hunderten Modellen frei (einschließlich Open-Weight-Flaggschiffen wie DeepSeek-V3, DeepSeek-R1 und Meta Llama), ohne auf Raycast-Releases warten zu müssen.

Schritt-für-Schritt-Einrichtung

1. API-Schlüssel in den Entwickler-Konsolen abrufen
   • Anthropic: Console → Settings → API Keys
   • OpenAI: Platform → API Keys
   • Google: Google AI Studio → Get API Key
   • OpenRouter: Account Settings → Keys
2. Desktop-Konfiguration (macOS / Windows)
   • Öffnen Sie in Raycast Settings → AI → Models & Providers.
   • Klicken Sie im Bereich API Keys auf das + (Plus)-Symbol.
   • Wählen Sie den Provider aus, fügen Sie den Schlüssel ein und klicken Sie auf Verify. Nach erfolgreicher Prüfung klicken Sie auf Save.
3. iOS-Konfiguration
   • Tippen Sie in der Raycast iOS-App oben rechts auf Ihr Account-Avatar → AI → Custom API Keys.
   • Wählen Sie den Provider aus, tragen Sie den Key ein und tippen Sie auf Verify.

Kennzeichnung in der Benutzeroberfläche

Modelle, die über einen eigenen API-Key laufen, sind in der Modellauswahl mit einem deutlichen Schlüssel-Symbol (Key-Icon) gekennzeichnet. Solange ein solches Modell aktiv ist, wird Ihr monatliches Kontingent von 500, 3.000 oder 7.500 Raycast Credits nicht belastet.

Methode 3: Eigene Provider über providers.yaml (Gateways & lokale LLMs)

Für professionelle Entwicklungsumgebungen – etwa das Routing über einen geteilten Team-Proxy (LiteLLM), Multi-Model-Gateways (Vercel AI Gateway, Cloudflare AI Gateway), Enterprise-Dienste (AWS Bedrock) oder lokal ausgeführte Offline-Modelle mit LM Studio – bietet Raycast volle Flexibilität über eine lokale YAML-Konfiguration.

Konfigurationsschritte

1. Öffnen Sie Raycast Settings → AI → Models & Providers.
2. Scrollen Sie zu Custom Providers und klicken Sie auf Reveal Providers Config.
3. Der Finder öffnet das Verzeichnis ~/.config/raycast/ai/, in dem sich die Vorlage providers.template.yaml befindet.
4. Kopieren Sie die Vorlage und benennen Sie die Kopie im selben Verzeichnis in providers.yaml um.
5. Bearbeiten Sie die Datei und hinterlegen Sie Ihre Endpunkte und Modelle.

Beispiel für das Vercel AI Gateway:

providers:
  - id: vercel_gateway
    name: "Vercel AI Gateway"
    base_url: https://ai-gateway.vercel.sh/v1
    api_keys:
      vercel: IHR_GATEWAY_API_KEY
    models:
      - id: anthropic/claude-3-7-sonnet
        name: "Claude 3.7 Sonnet"
        context: 200000
        abilities:
          temperature:
            supported: true
          vision:
            supported: true
          system_message:
            supported: true
          tools:
            supported: true
          reasoning_effort:
            supported: true

Beispiel für einen lokalen, privaten LM Studio-Server:

providers:
  - id: lmstudio_local
    name: "LM Studio Local"
    base_url: http://localhost:1234/v1
    models:
      - id: qwen2.5-coder-32b-instruct
        name: "Qwen 2.5 Coder 32B"
        context: 32768
        abilities:
          temperature:
            supported: true
          system_message:
            supported: true

6. Speichern Sie die Datei. Raycast lädt die Änderungen automatisch neu (Hot-Reload). Die Modelle stehen anschließend sofort in Quick AI und AI Chat bereit.

Wichtige Richtlinien und Fehlerbehebung

Beachten Sie bei der Nutzung von Bring Your Own AI folgende technische Rahmenbedingungen:

1. Raycast Pro als Mindestanforderung Der kostenlose Plan Raycast Free bietet keinen Zugriff auf die KI-Engine. Daher können BYOK oder externe Abonnements dort nicht aktiviert werden. Das Basispaket Raycast Pro in Kombination mit einem vorhandenen ChatGPT Plus- oder Claude Pro-Abonnement ist jedoch wesentlich günstiger als ein Upgrade auf Raycast Pro+ oder Max.
2. Serverseitige Cloud-Tools verbrauchen Credits Reine Textkonversationen, Code-Analysen und das Lesen von Webinhalten belasten Ihre Raycast-Credits nicht. Einige Funktionen, die zwingend auf Raycast-eigenen Servern laufen (wie die native Bildgenerierung), greifen jedoch weiterhin auf Raycast-eigene Modelle zu und verbrauchen anteilig Credits.
3. Provider-Ratenbegrenzungen vs. Credit-Mangel Wenn Sie bei der Nutzung eines externen Abonnements eine Fehlermeldung bezüglich einer Ratenbegrenzung (Rate Limit) erhalten, liegt dies an den Zeitfenstern von Anthropic oder OpenAI. Ein Zukauf von Raycast-Credits hebt diese Sperre nicht auf. Nutzen Sie /usage zur Kontrolle der Wartezeit oder wechseln Sie kurzzeitig zu einem BYOK-Modell.
4. PATH-Erkennung unter macOS Falls Raycast meldet, dass Claude Code oder Codex CLI nicht gefunden werden, hat die GUI-App die Shell-Umgebung eventuell nicht vollständig übernommen. Raycast durchsucht die Standardpfade: PATH, Homebrew (/opt/homebrew/bin auf Apple Silicon), globale npm-Pfade und ~/.local/bin. Starten Sie Raycast nach erfolgreichem Test im Terminal neu.

Durch die direkte Einbindung externer Abonnements und eigener API-Schlüssel behalten Entwickler die herausragende Arbeitsgeschwindigkeit von Raycast bei und eliminieren zugleich jede Sorge vor frühzeitig aufgebrauchten Monats-Credits.

Referenzen

• AI | Raycast Manual
• Bring Your Own Subscription | Raycast Manual
• Bring Your Own Key | Raycast Manual
• Custom Providers | Raycast Manual
• AI Credits | Raycast Manual