Invitez des amis et gagnez des tokens gratuits !En savoir plus

🚀 Connecter les modèles personnalisés CodingPlanX à Cursor

> Introduction : Cursor est un outil de programmation d'IA très apprécié par les développeurs, intégrant de puissantes capacités de grands modèles. Cependant, pour des raisons de restrictions réseau, de contrôle des coûts (utilisation d'API proxy tierces ou de modèles moins chers comme DeepSeek) ou de déploiement en réseau d'entreprise, nous avons parfois besoin de configurer une URL d'API et une clé API personnalisées. > > Ce tutoriel vous guidera pas à pas pour accomplir cette configuration facilement.

📋 Prérequis

Avant de commencer la configuration, assurez-vous d'avoir préparé les informations suivantes :

  1. Cursor installé : Assurez-vous que votre Cursor est dans sa version la plus récente.
  2. Clé API (API Key) : Par exemple sk-xxxxxxxxxxxxxxxxxxxxxxxx.
  3. URL de base (Base URL) : L'adresse de votre proxy API personnalisé.
    • Note : Elle doit généralement se terminer par /v1, par exemple https://api.codingplanx.ai/v1.
  4. Nom du modèle (Model Name) : Le nom standard du modèle que vous prévoyez d'utiliser (comme gpt-4o, claude-3-5-sonnet, deepseek-chat, etc.).

⚙️ Étapes de configuration détaillées

Étape 1 : Ouvrir les paramètres de Cursor

  1. Lancez l'éditeur Cursor.
  2. Cliquez sur l'icône d'engrenage ⚙️ en haut à droite, ou utilisez le raccourci pour ouvrir les paramètres :
    • Windows / Linux : Ctrl + ,
    • macOS : Cmd + ,

Étape 2 : Accéder à la page de configuration des modèles (Models)

Dans le menu de navigation à gauche du panneau de paramètres qui s'affiche, trouvez et cliquez sur l'onglet Models (Modèles).

Étape 3 : Configurer la clé API (API Key)

  1. Faites défiler la page Models vers le bas et trouvez la section OpenAI API Key.
  2. Collez votre Clé API personnalisée dans le champ de saisie.
  3. Cliquez sur le bouton Verify (Vérifier) sur la droite. (Si la vérification échoue à ce stade, ce n'est pas grave, car nous n'avons pas encore configuré l'URL).
  4. ⚠️ Remarque importante : Veuillez vous assurer que le commutateur officiel Cursor Tab de Cursor ci-dessus et les autres commutateurs nécessitant un abonnement payant sont dans l'état approprié (si vous utilisez une API tierce gratuitement, il est recommandé de désactiver les commutateurs des modèles officiels).

Étape 4 : Configurer l'URL de base (Remplacer l'interface par défaut)

C'est l'étape la plus cruciale, elle détermine où vos requêtes seront envoyées :

  1. Sous le champ de saisie OpenAI API Key, trouvez l'option Override OpenAI Base URL (Remplacer l'URL de base OpenAI).
  2. Développez cette option et saisissez l'adresse de votre interface personnalisée dans le champ. > 💡 Exemple de format à saisir : > - CodingplanX AI : https://api.codingplanx.ai/v1
  3. Une fois la saisie terminée, vous devez impérativement appuyer sur la touche Entrée (Enter) pour enregistrer les paramètres.

Étape 5 : Ajouter un nom de modèle personnalisé (Optionnel mais recommandé)

Si le modèle que vous utilisez ne figure pas dans la liste par défaut de Cursor (par exemple deepseek-coder), vous devez l'ajouter manuellement :

  1. Faites défiler jusqu'en haut de la page Models, trouvez la section Model Names.
  2. Cliquez sur + Add Model (Ajouter un modèle).
  3. Saisissez avec précision le nom de votre modèle (par exemple deepseek-chat), puis appuyez sur Entrée pour confirmer.
  4. Activez le commutateur devant le modèle que vous venez d'ajouter, et il est recommandé de désactiver les autres modèles que vous n'utilisez pas, afin d'éviter de vous tromper.

✅ Test et Vérification

Une fois la configuration terminée, nous devons tester si elle fonctionne :

  1. Retournez à l'interface d'édition de code.
  2. Appuyez sur Ctrl + L (Windows) ou Cmd + L (macOS) pour faire apparaître la fenêtre de Chat sur la droite.
  3. En bas de la fenêtre de discussion, cliquez sur le nom du modèle actuellement affiché pour passer au modèle que vous venez de configurer (comme gpt-4o ou deepseek-chat).
  4. Envoyez un message de salutation simple, par exemple : "Qui es-tu ? Dis-moi quelle est la version de ton modèle."
  5. Si l'IA peut répondre normalement et rapidement, félicitations, la configuration est réussie ! 🎉

❓ Résolution des problèmes fréquents (FAQ)

SymptômeCause possibleSolution
Délai d'attente / 404 Not FoundFormat de la Base URL incorrect.Vérifiez si l'URL manque le suffixe /v1, ou a un /chat/completions en trop. Le format correct devrait être https://xxx.com/v1.
Model not found (Modèle introuvable)Le nom du modèle demandé n'est pas pris en charge par votre fournisseur d'API.Vérifiez que le nom du modèle sélectionné dans Cursor est exactement le même (sensible à la casse) que celui pris en charge par votre fournisseur d'API.
Authentication failed (Échec de l'authentification)Clé API incorrecte ou solde insuffisant.Vérifiez si la clé a été copiée dans son intégralité (sans espaces superflus) et allez sur le tableau de bord de votre fournisseur d'API pour vérifier le solde de votre compte.
Impossible d'utiliser Cursor Tab (Complétion de code)La complétion de code en ligne (Copilot) de Cursor utilise un modèle indépendant.L'API tierce ne peut prendre en charge que les fonctionnalités Chat et Cmd+K. La fonctionnalité de complétion Cursor Tab dépend généralement toujours du service officiel de Cursor ou nécessite une configuration spéciale pour les modèles prenant en charge FIM.

> 📝 Conclusion : > Maîtriser la configuration d'API personnalisées permet non seulement de réduire considérablement les coûts d'utilisation de l'IA pour l'assistance à la programmation, mais vous permet également de basculer librement entre divers grands modèles de pointe. Si vous trouvez ce tutoriel utile, n'hésitez pas à le partager avec vos amis développeurs !