Qu’est-ce que le curseur ?
Cursor est un éditeur de code axé sur l'IA avec des fonctionnalités de chat, de flux de travail d'agent, d'édition de code et de développement basées sur des modèles.
La documentation actuelle de Cursor n’établit pas d’itinéraire général de fournisseur personnalisé. Ce guide traite TokenHub comme conditionnel : configurez-le uniquement lorsque votre client installé fournit visiblement un remplacement d'URL de base personnalisé, puis testez chaque fonctionnalité indépendamment. Cursor ne documente pas de chemin d'accès universel à un fournisseur tiers pour chaque version, compte et fonctionnalité. Traitez l'itinéraire TokenHub comme conditionnel aux contrôles visibles de la clé API et de l'URL de base, et testez indépendamment les fonctionnalités standard de chat, d'agent, d'application et d'onglet, car les fonctionnalités spécifiques au curseur peuvent continuer à utiliser des services distincts.
Cursor peut acheminer ses requêtes de modèle via la passerelle API OpenAI compatible de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.
Use https://us-api.tokenhub.com/v1 as the OpenAI Base URL override. Depending on the Cursor version and selected model, Cursor may use Chat Completions or Responses-style requests, so do not assume a single endpoint path.
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 settingsPré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
Cursor officially supports BYOK for specific providers and standard chat models. A custom OpenAI-compatible endpoint is currently a limited Base URL override, not a first-class custom provider.
| Champ | Valeur |
|---|---|
| Settings | Cursor Settings → Models → API Keys |
| API key field | OpenAI API Key |
| Base URL option | Override OpenAI Base URL |
| Base URL | https://us-api.tokenhub.com/v1 |
| Modèle | A TokenHub model compatible with the request format Cursor sends |
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.
Custom keys apply only to standard chat models. Tab Completion and Cursor-owned models continue through Cursor. Some current Cursor versions can also send a Responses-shaped body to a Chat Completions path through the override, so verify a read-only chat before relying on Agent mode. If the Base URL override is absent or the request format is rejected, that Cursor version cannot connect to TokenHub reliably.
Do not map Chat, Agent, Composer, Apply, Fast, or Tab as if they were equivalent custom-provider slots. Start with one standard chat model and treat every other feature as unsupported until its requests appear successfully in TokenHub logs.
Variables temporaires pour le diagnostic
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.
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. |
Choisir un modèle
FAQ sur la compatibilité des API personnalisées du curseur
Pourquoi n'y a-t-il pas de paramètre Remplacer l'URL de base OpenAI dans le curseur ?
Le paramètre varie selon la version du curseur et le compte. Sans contrôles de remplacement visibles, cette page n'établit pas de route de configuration directe de TokenHub.
Pourquoi la complétion des onglets peut-elle toujours utiliser le curseur après avoir configuré TokenHub ?
Une clé API personnalisée ou un remplacement d'URL de base ne s'applique pas nécessairement à la complétion des onglets et aux autres fonctionnalités spécifiques au curseur.
Une discussion réussie signifie-t-elle que Cursor Agent est également compatible ?
Non. Les fonctionnalités du curseur peuvent utiliser différents formats de requête et chemins de modèle. Testez le chat, les modifications et l'agent séparément et consultez les journaux de requêtes TokenHub.
Comment puis-je dépanner un modèle personnalisé Cursor 404 ?
Vérifiez que l'URL de base se termine par /v1 et que l'ID de modèle est accepté par l'interface utilisateur actuelle. Si TokenHub ne reçoit aucune demande, cette fonctionnalité de curseur ne peut pas utiliser le remplacement.
Quelles fonctionnalités du curseur dois-je tester séparément ?
Testez indépendamment le chat standard, l'agent, l'application et la complétion des onglets. Un paramètre de fournisseur personnalisé peut affecter uniquement certains chemins de requête.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。
