Comment connecter des clés API personnalisées et des abonnements externes à Raycast sans consommer d'AI Credits

Pour les développeurs qui utilisent Raycast comme lanceur de commandes central sur macOS, le quota mensuel d'AI Credits instauré avec Raycast v2 représente souvent un point de friction majeur. Le modèle de tarification officiel alloue 500 crédits par mois avec le forfait Pro, 3 000 avec Pro+ et 7 500 avec Max. Lorsque l'on sollicite quotidiennement Quick AI avec la touche Tab depuis la barre de recherche pour décortiquer des scripts, générer des expressions régulières ou interroger des modèles de raisonnement avancés, cette allocation peut s'épuiser dès le milieu du mois.

Si vous payez déjà 20 dollars par mois pour un abonnement ChatGPT Plus ou Claude Pro, ou si vous disposez d'un solde de développement sur Anthropic Console, OpenAI Platform, Google AI Studio ou OpenRouter, il est inutile d'acheter des recharges de crédits (Top-ups) ou de souscrire à des formules supérieures onéreuses.

Raycast intègre nativement trois mécanismes dits « Bring Your Own AI » permettant d'acheminer vos requêtes directement vers vos comptes existants, sans décompter le moindre crédit de votre solde Raycast.

Comparatif des trois méthodes sans consommation de crédits

Avant d'ouvrir les préférences de l'application, identifiez l'approche correspondant le mieux à vos abonnements actuels et à vos besoins :

Condition préalable essentielle : L'activation de ces fonctionnalités externes nécessite un abonnement payant Raycast actif (comme le forfait de base Raycast Pro). La version gratuite (Raycast Free) n'embarque aucune fonctionnalité d'IA. Une fois configurés sous Raycast Pro, les appels de modèles s'exécutent de façon totalement indépendante du compteur de crédits Raycast.

Méthode 1 : Connecter ses abonnements externes (Claude Pro et ChatGPT Plus)

Pour les développeurs bénéficiant déjà d'un forfait grand public à 20 dollars par mois, Bring Your Own Subscription (BYOS) représente la solution la plus économique. Elle n'engendre aucun surcoût au token et exploite les plafonds de votre abonnement web directement dans Raycast.

Fonctionnement technique sous-jacent

Raycast s'interface localement avec les outils en ligne de commande officiels des éditeurs : Claude Code d'Anthropic ou le Codex CLI d'OpenAI. Lorsque vous saisissez une commande dans Quick AI ou AI Chat, le prompt est directement transmis par le processus local de votre machine aux serveurs d'Anthropic ou d'OpenAI. Raycast ne stocke ni ne transite jamais vos identifiants de connexion.

Étapes de configuration

1. Installer l'outil CLI du fournisseur
   • Pour Claude : Installez Claude Code via npm dans votre terminal :

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

   • Pour ChatGPT : Installez le Codex CLI ou vérifiez que l'application de bureau ChatGPT / Codex est présente sur votre machine.
2. S'authentifier dans le terminal
   • Claude : Lancez claude dans votre terminal et entrez la commande /login. Finalisez l'authentification OAuth dans votre navigateur avec votre compte Claude Pro ou Team.
   • ChatGPT : Lancez codex login dans votre terminal et connectez-vous avec votre compte ChatGPT Plus ou Team (veillez à utiliser votre compte d'abonnement grand public et non une clé API).
3. Activer les abonnements locaux dans Raycast
   • Ouvrez les réglages de Raycast (⌘ ,) et rendez-vous dans AI → Models & Providers.
   • Faites défiler la page jusqu'à la section Local AI Subscriptions et activez l'interrupteur Enable Local AI Subscriptions.
   • Vérifiez que la ligne Claude Account ou ChatGPT Account affiche votre compte et votre formule. Si vous venez de vous connecter en ligne de commande, cliquez sur Refresh account status.
4. Sélectionner les modèles de votre abonnement
   • Ouvrez Quick AI avec votre raccourci puis la touche Tab, ou ouvrez AI Chat.
   • Dans le sélecteur de modèles, choisissez les éléments répertoriés sous les rubriques Claude Subscription ou ChatGPT Subscription (par exemple Claude 3.7 Sonnet, Claude 3.5 Sonnet, GPT-4o ou les modèles de raisonnement d'OpenAI).

Suivi des quotas et limites d'utilisation

Les modèles d'abonnement obéissent aux règles d'usage de chaque éditeur (telles que la fenêtre glissante de 5 heures chez Anthropic ou les plafonds de requêtes d'OpenAI), et non aux crédits Raycast :

• Tapez /usage dans AI Chat pour afficher le pourcentage consommé et le décompte avant réinitialisation.
• Vous pouvez également exécuter les commandes Show Claude Usage ou Show ChatGPT Usage depuis la recherche racine de Raycast.

Méthode 2 : Enregistrer ses propres clés API (BYOK)

Si vous préférez une tarification exacte au jeton (Pay-as-you-go) ou si vous utilisez également Raycast sur votre iPhone ou iPad, la méthode Bring Your Own Key (BYOK) offre une configuration homogène sur l'ensemble de vos appareils.

Facturation et comportement réseau

• Facturation directe : Le coût des inférences est directement prélevé sur votre solde ou votre carte bancaire enregistrée sur la console du fournisseur. Les AI Credits de Raycast restent intacts.
• Routage des données : Les requêtes avec une clé OpenRouter partent directement de votre terminal vers les serveurs d'OpenRouter. Pour Anthropic, OpenAI et Google, les requêtes transitent par les serveurs de Raycast afin d'homogénéiser les formats d'API, mais l'authentification repose exclusivement sur votre clé personnelle.
• Étendue du catalogue : Une clé OpenRouter donne un accès immédiat à l'ensemble du catalogue de la plateforme (incluant des modèles open-weight majeurs comme DeepSeek-V3, DeepSeek-R1 ou Meta Llama), sans attendre de mise à jour de Raycast.

Étapes de configuration

1. Générer sa clé API sur la console de l'éditeur
   • Anthropic : Console → Settings → API Keys
   • OpenAI : Platform → API Keys
   • Google : Google AI Studio → Get API Key
   • OpenRouter : Account Settings → Keys
2. Configuration sur ordinateur (macOS / Windows)
   • Ouvrez Raycast Settings → AI → Models & Providers.
   • Dans la section API Keys, cliquez sur le bouton + (Plus).
   • Sélectionnez votre fournisseur, collez la clé secrète, cliquez sur Verify, puis validez avec Save.
3. Configuration sur iOS
   • Dans l'application Raycast iOS, touchez votre Avatar de compte → AI → Custom API Keys.
   • Sélectionnez le fournisseur, collez la clé et touchez Verify.

Repérage visuel dans l'interface

Dans la liste de sélection des modèles, ceux qui s'exécutent avec votre clé API personnelle affichent une icône de clé (Key icon) à côté de leur nom. Tant qu'un modèle doté de cette icône est sélectionné, vos 500, 3 000 ou 7 500 crédits mensuels restent intégralement protégés.

Méthode 3 : Configurer des fournisseurs personnalisés avec providers.yaml (Proxys et LLMs locaux)

Pour les architectures d'ingénierie avancées — comme le passage par un proxy d'équipe (LiteLLM), une passerelle unifiée (Vercel AI Gateway, Cloudflare AI Gateway), un service cloud d'entreprise (AWS Bedrock) ou un modèle local hors ligne exécuté via LM Studio —, Raycast prend en charge n'importe quel point de terminaison compatible avec l'API OpenAI via un simple fichier YAML.

Procédure de configuration

1. Ouvrez Raycast Settings → AI → Models & Providers.
2. Faites défiler jusqu'à Custom Providers et cliquez sur Reveal Providers Config.
3. Le Finder s'ouvre sur le dossier ~/.config/raycast/ai/, contenant le fichier modèle providers.template.yaml.
4. Dupliquez ce fichier et renommez-le en providers.yaml dans ce même dossier.
5. Éditez le fichier pour déclarer vos points de terminaison et modèles.

Exemple pour Vercel AI Gateway :

providers:
  - id: vercel_gateway
    name: "Vercel AI Gateway"
    base_url: https://ai-gateway.vercel.sh/v1
    api_keys:
      vercel: VOTRE_CLE_DE_PASSERELLE
    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

Exemple pour un serveur local LM Studio (totalement gratuit et sans fuite de données) :

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. Sauvegardez le fichier. Raycast applique les modifications instantanément sans redémarrage de l'application. Vos modèles personnalisés apparaissent aussitôt dans Quick AI et AI Chat.

Points de vigilance et dépannage

Avant de finaliser votre installation, prenez note de ces particularités techniques :

1. Forfait Raycast Pro requis Le forfait gratuit Raycast Free n'embarquant pas de fonctionnalités d'intelligence artificielle, il ne permet pas d'activer BYOK ou BYOS. Combiner le forfait d'entrée Raycast Pro avec votre abonnement existant Claude Pro ou ChatGPT Plus s'avère toutefois beaucoup plus avantageux que de payer pour des forfaits Raycast supérieurs ou des packs de crédits supplémentaires.
2. Consommation de crédits par certains outils cloud natifs La génération de code, la rédaction textuelle et la consultation de pages web n'entament aucun crédit lorsqu'elles sont déléguées à vos abonnements ou clés. En revanche, certaines fonctions spécifiques exécutées sur les serveurs de Raycast (comme la génération d'images native) mobilisent des modèles hébergés par Raycast et continuent de prélever des crédits mensuels.
3. Plafonds de débit (Rate Limit) de l'éditeur Si vous rencontrez une erreur de fréquence de requêtes lors de l'utilisation d'un abonnement externe, celle-ci émane des plafonds d'Anthropic ou d'OpenAI. Acheter des crédits Raycast ne résoudra pas cette limitation. Tapez /usage pour voir l'heure de réinitialisation ou basculez temporairement sur un modèle BYOK.
4. Reconnaissance du PATH sous macOS Si Raycast indique qu'il ne trouve pas Claude Code ou Codex CLI, l'application graphique n'a peut-être pas hérité des chemins personnalisés de votre shell. Raycast vérifie automatiquement le PATH système, les dossiers de Homebrew (/opt/homebrew/bin sur les Mac Apple Silicon), les dossiers globaux de npm et ~/.local/bin. Redémarrez Raycast après avoir vérifié que la commande s'exécute correctement dans un terminal standard.

En déléguant vos requêtes à vos abonnements ou clés personnelles, vous conservez toute la rapidité d'exécution et l'ergonomie clavier de Raycast sur macOS, tout en faisant disparaître la contrainte des quotas mensuels de crédits.

Références

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