Claude Desktop : connecter Claude avec BetterToken
Connectez Claude Desktop à BetterToken avec un endpoint Gateway, une API Key et un modèle Claude. Vérifiez l’authentification, les modèles et le redémarrage.
Claude Desktop prend uniquement en charge les modèles Claude. Il s’agit d’une limitation du client Claude Desktop.
Copiez un Model ID Claude disponible dans la model plaza, enregistrez et redémarrez Claude Desktop.
Paramètres clés
| Champ | Valeur |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai |
| Model | Claude |
Prérequis
- Créez et copiez une BetterToken API Key
- Copiez le Model ID exact depuis la model plaza.
Séparer l’abonnement de la facturation API
Les requêtes Gateway utilisent votre BetterToken API Key et votre solde BetterToken. Elles ne consomment ni ne prolongent le quota d’un abonnement Claude. Considérez l’abonnement et l’API comme deux voies distinctes d’accès et de facturation.
Avant d’utiliser cette configuration pour un travail réel :
- Créez une BetterToken API Key dédiée à Claude Desktop.
- Envoyez un court message de test sans données sensibles via Gateway.
- Ouvrez le Dashboard BetterToken et vérifiez le modèle, le statut, les Token input, output et cache, ainsi que le débit.
- Révoquez la Key et créez-en une nouvelle si elle apparaît dans une capture, un dépôt ou un journal public.
Installation
Installez ou mettez à jour la dernière version depuis le site de Claude Desktop, puis démarrez Claude Desktop.
Configuration manuelle
Activer le mode développeur
Dans Claude Desktop, choisissez Help → Troubleshooting → Enable Developer Mode dans la barre de menus macOS.
Cliquez sur Enable dans la fenêtre de confirmation, puis redémarrez Claude Desktop.
Ouvrir les paramètres d’inférence tierce
Après le redémarrage, choisissez Developer → Configure Third-Party Inference… dans la barre de menus macOS.
Saisir les paramètres API de BetterToken
Sélectionnez Gateway, puis saisissez :
| Champ | Valeur |
|---|---|
| Gateway base URL | https://bettertoken.ai |
| Credential kind | Static API key |
| Gateway API key | Votre BetterToken API Key |
| Gateway auth scheme | x-api-key |
Claude Desktop récupère les modèles Claude disponibles après la sélection du schéma d’authentification. Cliquez sur Apply Changes pour enregistrer la configuration sur cet appareil et relancer Claude Desktop. Les anciennes versions peuvent afficher Apply locally, puis Save & Restart.
Vérifier la connexion
Après le redémarrage de Claude Desktop, sélectionnez Continue with Gateway, puis envoyez un court message. La configuration est active lorsque Gateway apparaît en bas à gauche et que le message reçoit une réponse normale.
Changer de modèle
Ouvrez le sélecteur de modèles et choisissez un autre modèle Claude renvoyé par la passerelle. Si le modèle manque, rouvrez Configure Third-Party Inference… et cliquez sur Apply Changes pour enregistrer et relancer Claude Desktop.
Erreurs courantes
| Problème | Solution |
|---|---|
| La passerelle ne peut pas se connecter | Utilisez exactement https://bettertoken.ai pour Gateway base URL. N’ajoutez pas /v1. |
La requête renvoie 401 | Copiez à nouveau la BetterToken API Key et vérifiez que le schéma d’authentification est x-api-key. |
| Aucun modèle Claude n’apparaît | Copiez un Model ID Claude disponible dans la model plaza, enregistrez et redémarrez Claude Desktop. |
| La configuration ne s’applique pas | Quittez complètement Claude Desktop, ouvrez-le à nouveau et choisissez Continue with Gateway. |
Configuration avancée
Pour gérer plusieurs configurations dans une application, consultez CC Switch.
Guides associés
Détails techniques
Point de terminaison et authentification de la passerelle
Utilisez l’adresse compatible Anthropic https://bettertoken.ai comme Gateway base URL, sans /v1. Sélectionnez x-api-key comme schéma d’authentification.
