FR ▾
API compatible OpenAI, une alternative à Claude Codehttps://api.claudecodeapikey.com/v1
Obtenir une clé API

AccueilGuide

API Claude Code pour Cursor : configuration d'un endpoint personnalisé

Vous cherchez une configuration d'API Claude Code pour Cursor qui ne dépende pas d'un seul fournisseur ? Cursor peut se connecter à n'importe quel endpoint compatible OpenAI, et ce guide montre chaque paramètre à configurer.

Mis à jour le

Illustration isométrique d'un éditeur de code connecté à un serveur API, montrant une configuration d'endpoint personnalisé

Ce que vous configurez

Cursor est un éditeur avec des fonctionnalités IA intégrées. Parmi ses paramètres de modèle, il y a un champ qui vous permet de remplacer l'URL de base OpenAI par la vôtre, ainsi qu'un endroit pour saisir votre propre clé. Cela permet d'envoyer des requêtes de chat à tout service qui suit le format chat-completions d'OpenAI. Ce service le fait, donc Cursor peut l'utiliser comme modèle pour le chat et les modifications en ligne.

Les valeurs à saisir sont fixes. URL de base : https://api.claudecodeapikey.com/v1. Nom du modèle : uncensored. Clé : celle de votre compte, envoyée en tant que jeton Bearer. Rien d'autre ne nécessite de configuration côté serveur.

Soyons clairs sur ce dont il s'agit. Le modèle derrière l'endpoint est un modèle à poids ouverts d'un fournisseur indépendant. Ce n'est pas un modèle Claude et ce n'est pas l'API officielle d'Anthropic ou d'un autre. Si vous vous attendiez à trouver Claude lui-même dans Cursor, il s'agit d'une chose différente, et les sections finales expliquent comment juger si cela suffit pour votre travail.

Avant d'ouvrir Cursor

Préparez ces éléments d'abord, pour ne pas vous arrêter en cours de route.

  1. Créez un compte avec Google ou avec adresse e-mail et mot de passe.
  2. Ouvrez la page clé API et créez une clé. Le guide des clés indique où se trouve chaque bouton.
  3. Réclamez le crédit d'essai de 0,50 $ si vous souhaitez tester sans payer. Cela prend un clic, ne nécessite pas de carte et dure 7 jours.
  4. Exécutez une vérification rapide depuis un terminal pour confirmer que la clé fonctionne avant d'accuser l'éditeur.
curl https://api.claudecodeapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'

Une réponse JSON avec un message signifie que la clé et l'URL sont bonnes. Un HTTP 401 signifie que la clé est incorrecte ou contient un espace parasite. Corrigez cela ici, car les messages d'erreur de Cursor sont moins précis que ceux de curl.

Configuration étape par étape dans Cursor

Les noms de menu varient selon les versions de Cursor, considérez donc les étiquettes ci-dessous comme un guide et recherchez la correspondance la plus proche.

  1. Ouvrez les paramètres de Cursor et accédez à la section des modèles.
  2. Trouvez le champ pour une clé API OpenAI et collez votre clé de ce service.
  3. Activez l'option pour remplacer l'URL de base OpenAI, et saisissez https://api.claudecodeapikey.com/v1. Incluez le /v1 à la fin et omettez tout chemin final tel que /chat/completions.
  4. Utilisez l'option pour ajouter un modèle personnalisé, et tapez uncensored exactement, en minuscules.
  5. Appuyez sur le bouton vérifier ou enregistrer à côté du champ de clé. Cursor envoie une petite requête de test.
  6. Ouvrez un panneau de chat, sélectionnez uncensored dans le menu déroulant du modèle, et envoyez un prompt court.

Si l'étape de vérification échoue mais que la vérification curl a réussi, vérifiez que vous avez saisi l'URL dans le champ URL de base et non dans le champ clé, et que votre version de Cursor n'a pas réinitialisé le remplacement après une mise à jour. Le guide de démarrage rapide conserve les étapes actuelles pour cet éditeur.

Un détail à connaître : un seul remplacement s'applique à l'emplacement du fournisseur OpenAI. Si vous utilisez également de vrais modèles OpenAI via cet emplacement, ils seront désormais routés vers cet endpoint aussi. Beaucoup de gens conservent un profil Cursor séparé ou désactivent le remplacement lorsqu'ils veulent revenir en arrière.

Test avec un prompt de codage réel

Une salutation prouve peu. Utilisez un prompt qui sollicite la fenêtre de contexte et les instructions. Sélectionnez une fonction dans votre projet, ouvrez le chat, et demandez quelque chose de concret, comme ajouter une validation des entrées et un test unitaire. Surveillez trois éléments.

  • Streaming. La réponse doit apparaître token par token. L'endpoint effectue du streaming via SSE, donc une longue attente suivie d'un bloc de texte suggère qu'un proxy ou un paramètre met en mémoire tampon.
  • Utilisation du contexte. Joignez deux ou trois fichiers et posez une question qui en nécessite l'ensemble. La fenêtre de contexte est de 100 000 tokens, ce qui contient beaucoup de code source, mais votre éditeur décide de combien il envoie réellement.
  • Respect des instructions. Demandez une réponse en diff uniquement ou un format de sortie strict et voyez si le modèle s'y tient. Les modèles à poids ouverts diffèrent ici, et vous voulez l'apprendre dès le premier jour.

Conservez une courte liste de cinq tâches réelles de votre propre dépôt, et relancez-les chaque fois que vous modifiez un paramètre tel que la température. Juger à partir de votre propre code bat toute affirmation générale, y compris la nôtre.

Correction des erreurs courantes

401 ou clé invalide

La clé est incorrecte, expirée depuis votre presse-papiers, ou contient des espaces autour. Recopiez-la. Assurez-vous que le schéma Authorization est Bearer, ce que Cursor fait pour vous lorsque vous utilisez le champ clé OpenAI.

404 ou modèle introuvable

Presque toujours un problème d'URL de base. Un /v1 manquant ou un /chat/completions supplémentaire casse le chemin. Le nom du modèle doit aussi être uncensored, sans majuscules ni espaces.

429 avec rate_limited ou concurrency

Vous avez atteint une limite. La clé d'essai permet 2 requêtes simultanées et 60 par minute, et une clé complète permet 8 simultanées et 300 par minute. Un éditeur peut déclencher plusieurs requêtes à la fois, par exemple chat plus des modifications en arrière-plan, et les flux maintiennent leur slot jusqu'à leur fin. Le code d'erreur indique quelle limite : rate_limited concerne les requêtes par minute, concurrency concerne trop de requêtes à la fois. Une surcharge temporaire renvoie aussi 429 avec Retry-After: 5, donc attendre cinq secondes et réessayer est correct.

La réponse est coupée

La fenêtre de contexte est de 100 000 tokens, prompt plus complétion. Une pièce jointe très volumineuse laisse peu de place pour la réponse. Envoyez moins de fichiers, ou commencez un nouveau chat.

Fonctionnalités qui ne font rien

L'API est textuelle uniquement, et ne propose pas d'embeddings. Si une fonctionnalité de Cursor nécessite un modèle d'embedding ou une entrée image, elle ne fonctionnera pas via cet endpoint.

Paramètres à ajuster une fois le fonctionnement confirmé

Après le premier chat réussi, quelques ajustements rendent l'utilisation quotidienne plus fluide.

Baissez la température pour les tâches d'édition. Si votre éditeur l'expose, une valeur autour de 0,2 donne du code plus stable. Pour le brainstorming, augmentez-la. Ensuite, surveillez la quantité de contexte que vous joignez. La fenêtre de contexte est généreuse, mais chaque fichier joint est facturé en entrée, donc fermer les onglets non pertinents et exclure les dossiers de build réduit les coûts et concentre les réponses.

Si vous utilisez les modes agent ou multi-étapes, gardez à l'esprit le support de l'appel de fonctions : l'endpoint accepte tools et tool_choice et fait du streaming de tool_calls. Le fait qu'une fonctionnalité Cursor donnée les utilise dépend de la version, alors exécutez une petite tâche agent et lisez ce qui se passe avant de lui faire confiance pour un changement important. Enfin, jetez un œil à l'en-tête X-Balance-USD lors d'un test en ligne de commande de temps en temps, afin qu'un solde faible ne vous surprenne jamais en plein travail.

Utilisation de la même clé dans des scripts

Un avantage d'un endpoint compatible OpenAI est que la clé que vous configurez dans Cursor fonctionne aussi dans le code. Voici un exemple Node, utile pour les scripts de build ou les outils de message de commit.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.claudecodeapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const out = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
  ],
});

console.log(out.choices[0].message.content);

Stockez la clé dans une variable d'environnement, pas dans un fichier que vous commitez. Chaque réponse inclut un en-tête X-Balance-USD, donc un script peut vous avertir lorsque le crédit est faible.

Coût et quand rester sur sa configuration

L'utilisation dans l'éditeur est intensive en entrée car chaque requête inclut le contexte du fichier. À 0,15 $ par 1 M de tokens d'entrée et 0,50 $ par 1 M de tokens de sortie, une requête avec 15 000 tokens d'entrée et 1 000 tokens de sortie coûte 0,015 x 0,15 $ + 0,001 x 0,50 $ = 0,00225 $ + 0,0005 $ = 0,00275 $. Cent de ces requêtes coûtent 0,275 $. La page de tarification propose des montants de rechargement, à partir de 20 $, avec des bonus à partir de 50 $.

Conservez votre configuration existante si vous dépendez du modèle d'un fournisseur spécifique pour des refontes complexes, ou si votre flux de travail repose sur des fonctionnalités qu'un simple endpoint de chat ne peut pas offrir. Utilisez celui-ci lorsque vous souhaitez un prix par token faible, une API simple et moins de refus de contenu pour un travail légitime. De nombreux développeurs conservent les deux configurés et basculent en fonction de la tâche.

Questions et réponses

Quelle URL de base dois-je saisir dans Cursor ?

Saisissez https://api.claudecodeapikey.com/v1 en incluant le /v1. N'ajoutez pas /chat/completions à la fin.

Quel nom de modèle dois-je ajouter ?

Ajoutez un modèle personnalisé nommé uncensored, en minuscules. C'est le seul ID de modèle que l'API propose.

Cela me donne-t-il les modèles Claude dans Cursor ?

Non. L'endpoint propose un seul modèle à poids ouverts provenant d'un fournisseur indépendant. Il ne s'agit pas de l'API officielle d'Anthropic ou de tout autre fournisseur.

Pourquoi obtiens-je des erreurs 429 dans l'éditeur ?

Vous avez soit dépassé la limite par minute, soit vous effectuez trop de requêtes simultanées. Une clé d'essai permet 2 requêtes simultanées et 60 par minute, une clé complète 8 et 300.

Puis-je l'essayer sans payer ?

Oui. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai sur la page de la clé API. Aucune carte n'est nécessaire et le crédit est valable 7 jours.

Votre clé n'est qu'à un formulaire d'ici

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API