Configuration Cursor

1. Ce qu’est Cursor et ce qu’il faut préparer

Cursor est un IDE IA basé sur VS Code. Il permet d’effectuer dans l’éditeur des opérations courantes de développement comme le chat, la génération de code, les modifications et les explications.

Avant de connecter Cursor via RouteAPI, préparez de préférence :

• L’application de bureau Cursor installée et connectée
• Votre clé RouteAPI
• Un modèle de chat standard au protocole OpenAI disponible dans la console RouteAPI
• L’adresse OpenAI-compatible de RouteAPI : https://www.routeapi.ai/v1

Note officielle de compatibilité

Selon la documentation officielle Cursor API Keys, l’entrée de configuration d’une API key personnalisée se trouve dans Cursor Settings > Models et s’active avec Verify.

À noter également :

• Les API key personnalisées ne s’appliquent qu’aux modèles de chat standard.
• Les fonctions comme Tab Completion, qui nécessitent des modèles dédiés, continuent d’utiliser les modèles intégrés de Cursor.
• Le provider OpenAI ne prend en charge que les modèles de chat standard non reasoning.

2. Installer et ouvrir les paramètres de modèle

Installer Cursor et se connecter

Installez l’application de bureau depuis le site officiel de Cursor, puis connectez-vous avec votre compte Cursor.

Ouvrir Cursor Settings > Models

Dans Cursor, ouvrez la page Settings, puis accédez à Models.

3. Configurer RouteAPI

3.1 Renseigner les informations d’accès du provider OpenAI

Dans la page Models, trouvez les paramètres liés à OpenAI. Le nom des champs peut varier légèrement selon la version de Cursor, mais les informations essentielles à renseigner sont :

• OpenAI API Key : votre clé RouteAPI
• OpenAI Base URL : https://www.routeapi.ai/v1

Après saisie, cliquez sur Verify.

Les noms de champs peuvent varier

Certaines versions de Cursor affichent le champ d’adresse sous le nom Base URL, OpenAI Base URL ou un nom similaire. Dans tous les cas, il faut renseigner l’adresse OpenAI-compatible de RouteAPI : https://www.routeapi.ai/v1.

3.2 Choisir un modèle

Une fois la vérification réussie, ouvrez le sélecteur de modèles Cursor et choisissez un modèle OpenAI-compatible disponible retourné par RouteAPI.

La méthode la plus prudente consiste à :

• Choisir en priorité un modèle standard marqué dans la console RouteAPI comme compatible avec le protocole OpenAI et adapté au chat ou au codage.
• Ne pas privilégier les modèles reasoning, car la documentation officielle Cursor indique que les API key OpenAI personnalisées ne prennent en charge que les modèles de chat standard non reasoning.

3.3 Commencer à l’utiliser

Après la configuration, vous pouvez utiliser directement les modèles fournis par RouteAPI dans Chat ou Composer de Cursor.

4. Notes

• La méthode API key personnalisée affecte principalement les capacités de modèles de chat standard comme Chat / Composer ; elle ne remplace pas toutes les capacités intégrées de Cursor.
• Si vous activez Tab Completion, certaines capacités Agent ou d’autres fonctions nécessitant des modèles dédiés, Cursor peut continuer à utiliser ses modèles intégrés.
• Selon la FAQ officielle Cursor, l’API key n’est pas stockée, mais chaque requête est tout de même envoyée aux serveurs de Cursor, qui assemblent le prompt final.

5. Dépannage courant

• Si Verify échoue, vérifiez d’abord que l’API key est correcte et que l’adresse est bien https://www.routeapi.ai/v1.
• Si la liste de modèles n’affiche pas le modèle attendu, vérifiez que ce modèle prend en charge le protocole OpenAI et qu’il s’agit d’un modèle de chat standard, non reasoning.
• Si vous avez mis à jour la key ou l’adresse mais que Cursor affiche encore l’ancien état, fermez puis rouvrez Cursor et exécutez de nouveau Verify.
• Si vous avez besoin d’une intégration d’agent de codage dans le terminal, consultez aussi la documentation de configuration Codex, la documentation de configuration Claude et la documentation de configuration OpenCode.