Configuration de Cursor

Cursor est un éditeur de code intégrant l’IA, qui prend en charge des fournisseurs d’API personnalisés. En configurant OfoxAI, vous pouvez utiliser Claude, GPT-4o, Gemini et plus de 100 autres modèles dans Cursor, sans souscrire séparément à chaque service.

Prérequis

Un compte OfoxAI avec une clé API（Obtenir une clé ）
Cursor installé（Téléchargement ）

Le plan gratuit de Cursor ne prend en charge que le mode Auto et ne permet pas d’utiliser des modèles personnalisés. La configuration d’OfoxAI nécessite un abonnement Cursor Pro ou supérieur.

Étapes de configuration

Étape 1 : Ouvrir les paramètres de modèles

Cliquez sur l’icône d’engrenage en haut à droite → Cursor Settings → sélectionnez Models dans la barre latérale gauche (repéré ① sur la capture ci-dessous).

Vous pouvez également utiliser le raccourci Cmd + , (macOS) / Ctrl + , (Windows/Linux) pour ouvrir directement les paramètres, puis basculer vers l’onglet Models.

Étape 2 : Saisir la clé API et activer le commutateur

Sur la page Models, repérez la section OpenAI API Key. Activez d’abord le commutateur à droite (toggle ON), puis collez votre clé API OfoxAI dans le champ de saisie (repéré ② sur la capture ci-dessous).

Votre clé API OfoxAI peut être saisie directement dans le champ OpenAI API Key de Cursor, car OfoxAI est entièrement compatible avec le protocole OpenAI.

Étape 3 : Saisir la Base URL et activer le commutateur

Sur la même page, repérez l’option Override OpenAI Base URL. Activez d’abord le commutateur à droite (toggle ON), puis entrez l’adresse API d’OfoxAI (repéré ③ sur la capture ci-dessous).

Récapitulatif des deux paramètres de configuration :

Paramètre	Valeur
OpenAI API Key (commutateur ON)	Votre clé API OfoxAI
Override OpenAI Base URL (commutateur ON)	`https://api.ofox.ai/v1`

Interface de configuration Cursor Models

La Base URL dans la capture ci-dessus est une adresse d’exemple. Veuillez entrer l’adresse d’OfoxAI : https://api.ofox.ai/v1

Étape 4 : Ajouter des modèles personnalisés

Dans la section Model Names, cliquez sur le champ Add or search model (repéré ④ sur la capture ci-dessus) et ajoutez les modèles que vous souhaitez utiliser :


anthropic/claude-sonnet-4.6
anthropic/claude-opus-4.6
openai/gpt-4o
openai/gpt-4o-mini
google/gemini-3.1-flash-lite-preview

Les noms de modèles par défaut de Cursor (comme gpt-4o ou claude-3-5-sonnet) ne fonctionnent pas avec OfoxAI. Utilisez impérativement les identifiants de modèles au format OfoxAI, comme openai/gpt-4o ou anthropic/claude-sonnet-4.6.

Étape 5 : Vérifier la configuration

Ouvrez la fenêtre de chat IA (Cmd+L / Ctrl+L), désactivez le mode Auto, puis sélectionnez un modèle récemment ajouté dans la liste déroulante et envoyez un message de test :

Bonjour, veuillez vous présenter.

Si vous recevez une réponse normale, la configuration est réussie.

Modèles recommandés

ID du modèle	Cas d’utilisation
`anthropic/claude-sonnet-4.6`	Génération et refactorisation de code, capacités polyvalentes
`anthropic/claude-opus-4.6`	Analyse d’architecture complexe, performance de pointe
`openai/gpt-4o`	Assistant de programmation polyvalent
`openai/gpt-4o-mini`	Complétion rapide, faible coût
`google/gemini-3.1-flash-lite-preview`	Utilisation fréquente, réponse rapide

Consultez le Catalogue de modèles pour la liste complète.

Questions fréquentes

Q : En cliquant sur Verify, le message « Invalid API Key » s’affiche

Vérifiez les points suivants :

La clé API a-t-elle été copiée intégralement depuis la Console OfoxAI ? (Attention aux espaces en début ou en fin)
La Base URL est-elle correctement définie sur https://api.ofox.ai/v1 ? (Sans barre oblique finale)
Les deux commutateurs pour OpenAI API Key et Override OpenAI Base URL sont-ils tous les deux activés ?

Q : Les modèles ajoutés n’apparaissent pas dans le panneau de chat

Désactivez le mode Auto dans le panneau de chat pour voir les modèles personnalisés dans la liste déroulante.

Q : Erreur « The model does not work with your current plan »

Cette erreur indique que votre plan Cursor actuel ne prend pas en charge les modèles personnalisés. Vous devez passer au plan Cursor Pro pour utiliser des fournisseurs d’API personnalisés.

Q : La complétion de code en ligne ne fonctionne pas, seul le chat est disponible

La complétion en ligne de Cursor (complétion par Tab) utilise par défaut les modèles propres à Cursor. Les modèles personnalisés sont principalement utilisés pour AI Chat (Cmd+L) et Composer (Cmd+I).