Cursor

Cursor peut appeler les modèles TokenHub via l’interface OpenAI compatible. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.

L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/chat/completions.

Quand l’utiliser

Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.

Installer ou ouvrir l’outil

Suivez la documentation officielle Cursor pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.

Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :

# open the tool, then open its model or provider settings

Préparer les identifiants TokenHub

Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.

export TOKENHUB_API_KEY="sk-..."

Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.

Configurer le fournisseur TokenHub

Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.

Valeurs du provider

Champ	Valeur
Fournisseur	OpenAI Compatible ou Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	La valeur de `TOKENHUB_API_KEY`
Modèle	`gpt-4.1` ou un autre model ID TokenHub

Emplacements des réglages

Champ	Valeur
macOS	`~/Library/Application Support/Cursor/User/settings.json`
Windows	`%APPDATA%\Cursor\User\settings.json`
Linux	`~/.config/Cursor/User/settings.json`

Utilisez d’abord l’interface de réglages quand l’extension possède son propre schéma. Elle stocke les mêmes valeurs au niveau utilisateur et évite de deviner des clés privées qui peuvent changer.

Enregistrez le provider TokenHub dans l’interface de l’outil. Si l’outil sépare Chat, Edit, Apply, Fast ou Autocomplete, pointez tous les emplacements vers TokenHub pour le premier test.

Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.

Variables temporaires pour le diagnostic

Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.

Vérifier la connexion

Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.

Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.

Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.

Dépannage

Symptôme	Correction
401 ou échec d’authentification	Vérifiez que `TOKENHUB_API_KEY` est valide et enregistré dans le même terminal, IDE ou profil client.
404 ou modèle introuvable	Utilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi.
Endpoint incorrect	Gardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement `/v1`; les outils compatibles Claude non.
Timeout	Vérifiez le réseau vers `https://us-api.tokenhub.com`, les paramètres proxy et l’allowlist de l’espace de travail.
L’outil utilise un autre modèle	Revérifiez tous les emplacements chat, edit, apply, fast ou autocomplete.

Sur cette page