Claude Code dans Cursor
Faites tourner l'extension Claude Code dans Cursor avec une seule clé API AI in IDE.
Cursor est un fork de VS Code, donc l'extension officielle s'installe et se comporte de la même façon — mais Cursor embarque ses propres fonctions IA, son propre registre d'extensions et sa propre synchronisation de réglages, et chacun de ces points change le dépannage.
Si vous utilisez VS Code classique, lisez plutôt Claude Code dans VS Code : le bloc de configuration est identique et cette page couvre les cas généraux. Ici, nous traitons les différences propres à Cursor.
Versions et prérequis
| Composant | Exigence | Remarque |
|---|---|---|
| Cursor | une version basée sur VS Code 1.94.0 ou plus | Cursor → About Cursor indique la base VS Code |
| Extension Claude Code | version à jour depuis Open VSX ou le marché intégré | la version suit le CLI embarqué |
| Clé AI in IDE | canal AWSQ ou CCMAX | tableau de bord |
| Compte Anthropic | inutile | la clé API remplace la connexion |
Cursor ne place pas claude dans votre PATH, et l'extension non plus. N'installez le CLI séparément que pour les sessions en terminal ou claude mcp add.
Installer l'extension
- Lien direct : Installer pour Cursor — Cursor résout l'identifiant de l'extension, puis affiche l'étape de confirmation habituelle.
- Manuellement :
Cmd+Shift+X/Ctrl+Shift+X, cherchez Claude Code, Installer. - Si la recherche ne donne rien, la vue du marché dans Cursor est peut-être filtrée. Installez depuis Open VSX Registry : même build, publié pour les forks qui n'utilisent pas le Visual Studio Marketplace.
Après l'installation, exécutez Developer: Reload Window si l'icône Spark n'apparaît pas. Elle ne s'affiche que lorsqu'un fichier est ouvert ; un simple dossier ne suffit pas.
Créer et copier la clé API
Ouvrez API Keys, créez une clé et choisissez AWSQ ou CCMAX. Ce sont les canaux Claude Code — une clé Codex ou Gemini s'authentifie sur un autre point d'entrée et échouera ici. Vous pouvez ensuite retrouver la clé complète dans la liste API Keys pour l’afficher ou la copier.
Tous les extraits ci-dessous utilisent YOUR_DASHBOARD_API_KEY comme remplacement.
Configuration
1. Réglages de connexion
Créez ou fusionnez ~/.claude/settings.json (macOS/Linux) ou C:/Users/<UserName>/.claude/settings.json (Windows) :
1 {2 "$schema": "https://json.schemastore.org/claude-code-settings.json",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",6 "API_TIMEOUT_MS": "600000",7 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"8 }9 }
ANTHROPIC_BASE_URL s'arrête à l'hôte : Claude Code ajoute /v1/messages lui-même. Ajouter /v1 ici envoie la requête vers /v1/v1/messages.
Ce fichier est partagé par l'extension et le CLI, ce qui en fait le bon endroit pour un montage proxy : il survit aux mises à jour de Cursor, aux changements de profil et aux rechargements de fenêtre.
2. Désactiver l'écran de connexion
L'extension est pensée pour un compte claude.ai. Ajoutez dans le settings.json utilisateur de Cursor (Cmd+, / Ctrl+,) :
1 "claudeCode.disableLoginPrompt": true
Sans cela, la première ouverture propose Sign in et l'extension n'atteint jamais votre URL de base.
3. Ne pas mélanger avec l'IA intégrée de Cursor
Le chat et la complétion Tab de Cursor sont des produits distincts et ne partagent pas cette clé. Deux conséquences concrètes :
- Deux panneaux, deux facturations. L'accès Claude de Cursor est facturé par Cursor ; le panneau Claude Code est facturé par AI in IDE sur le quota de votre clé. Restez cohérent par tâche, sinon vos statistiques d'usage seront fausses dans les deux tableaux de bord.
- Collisions de
settings.json. Cursor stocke les réglages d'extension dans son propre profil ; changer de profil peut supprimer silencieusement les valeursclaudeCode.*. Vérifiez après chaque bascule.
4. Facultatif : modèle et parité shell
1 {2 "model": "claude-sonnet-5-5",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY"6 }7 }
Sous macOS, un Cursor lancé depuis le Dock hérite de l'environnement système, pas de votre profil shell : les lignes export de ~/.zshrc atteignent le terminal intégré mais pas le panneau de discussion. Le fichier ci-dessus corrige cela. Si vous tenez aux exports shell, lancez cursor . depuis un terminal.
Vérifier
Commencez par lister les modèles pour vérifier la clé et son canal Claude. Cette requête ne consomme pas de quota.
1 curl --globoff -i 'https://api.aiinide.com/v1/models' \2 -H "x-api-key: YOUR_DASHBOARD_API_KEY" \3 -H "anthropic-version: 2023-06-01"
Le statut HTTP 200 renvoie la liste des modèles. Un statut 401 indique une clé absente, invalide ou expirée. Un statut 400 indique que la clé appartient à un autre canal. Dans l’exemple Messages ci-dessous, utilisez un identifiant de la liste.
- Le panneau s'ouvre sans connexion. Icône Spark → panneau. Si l'écran de connexion revient,
disableLoginPromptn'est pas dans les réglages utilisateur. /statusdans la zone de saisie affiche la version et le modèle.- Envoyez une courte demande dans l’éditeur, puis vérifiez la consommation de cette clé dans le tableau de bord.
- Testez un appel au modèle avec la clé vérifiée.
1 curl --globoff 'https://api.aiinide.com/v1/messages' \2 -H "x-api-key: YOUR_DASHBOARD_API_KEY" \3 -H "anthropic-version: 2023-06-01" \4 -H "Content-Type: application/json" \5 -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'
- Consommation. Utilisation progresse sur cette clé après un message réussi.
Dépannage
Utilisez un identifiant exact renvoyé par GET /v1/models. Une faute dans un nom claude-* peut diriger la requête vers le modèle Claude configuré par défaut, qui sera alors facturé à son propre tarif.
API Error: 404
Réglez ANTHROPIC_BASE_URL sur https://api.aiinide.com. Ajouter /v1 envoie la requête vers /v1/v1/messages, qui renvoie une erreur 404.
API Error: 400
- Cursor a installé un build obsolète. Une extension ancienne venue d'un registre de fork peut être en retard ; mettez-la à jour dans la vue Extensions et rechargez.
settings.jsonmal formé. Cursor ne vous dira pas que le fichier est cassé — il l'ignorera. Ouvrez-le dans Cursor ; la ligne$schemafait apparaître les erreurs de validation.
Vérification de la clé API
Utilisez le statut de GET /v1/models pour vérifier la clé. Si elle est absente ou invalide, le point d’entrée natif POST /v1/messages peut renvoyer HTTP 200 avec un message d’authentification dans content.
- Connexion encore active. Si un compte Claude était connecté auparavant, déconnectez-vous (
/logout), activezdisableLoginPrompt, puis rechargez. - Un autre
ANTHROPIC_AUTH_TOKENdans l'environnement. L'environnement de Cursor peut venir d'un shell, d'un profil ou d'un agent de lancement. Dans le terminal intégré de Cursor,echo $ANTHROPIC_AUTH_TOKEN— si une ancienne valeur s'affiche, c'est elle qui gagne. - Clé expirée ou canal modifié. Une clé passée de CCMAX à Codex échouera ici. Recréez-la plutôt que de changer le canal.
Problèmes réseau propres à Cursor
| Symptôme | Cause | Correctif |
|---|---|---|
| Le panneau fonctionne mais la complétion Tab échoue (ou l'inverse) | un seul des deux clients IA a des réglages de proxy | le proxy HTTP de Cursor et HTTPS_PROXY se règlent séparément ; configurez les deux |
| L'extension disparaît après une mise à jour de Cursor | profil réinitialisé | réinstallez depuis la vue Extensions et remettez les réglages claudeCode.* |
| Première réponse très lente, puis normale | l'indexeur de Cursor sature CPU et réseau | attendez la fin de l'indexation, ou excluez les gros dossiers |
Certificate is not trusted uniquement dans Cursor | proxy qui inspecte le TLS avec une autorité non approuvée par Cursor | ajoutez NODE_EXTRA_CA_CERTS dans env de settings.json, pointant vers l'autorité racine |
| Requêtes bloquées jusqu'au délai dans une fenêtre Remote-SSH | réglages restés en local | modifiez ~/.claude/settings.json sur l'hôte distant |
Conflits avec d'autres extensions
Les installations de Cursor embarquent souvent plusieurs extensions IA à la fois. Deux extensions qui enregistrent un panneau de chat ou les mêmes raccourcis se disputent la place : Cmd+Esc peut ouvrir le chat de Cursor au lieu de Claude Code, et l'icône Spark de la barre d'outils peut être masquée. Désactivez temporairement l'autre extension pour confirmer, puis gardez-en une ou rebindez le raccourci dans l'éditeur de raccourcis clavier.
Modèles et tarifs
| Modèle | Canal | Usage |
|---|---|---|
claude-opus-5-5 / claude-opus-5.5 | AWSQ, CCMAX | refactorisations complexes, longues exécutions autonomes |
claude-sonnet-5-5 / claude-sonnet-5.5 | AWSQ, CCMAX | le choix quotidien par défaut |
claude-haiku-4-5-20251001 | AWSQ, CCMAX | modifications rapides, vérifications peu coûteuses |
Opus 5.5 est affiché à 4 $ en entrée / 0,20 $ en lecture de cache / 20 $ en sortie par million de tokens ; la consommation de quota est de 0,8× sur AWSQ et 2× sur CCMAX. En mode Fast, lorsque l'amont l'utilise, les tarifs de base et de cache doublent.
- Offres et quotas : tarifs
- Gestion des clés : API Keys
- Points d'entrée et tarifs : Configuration
- Référence officielle de l'extension : code.claude.com VS Code (le support de Cursor figure sur la même page)
Questions fréquentes
L'extension est-elle officiellement prise en charge dans Cursor ? Anthropic la publie sur le Visual Studio Marketplace et Open VSX et documente Cursor comme cible d'installation. Côté Anthropic, il s'agit de logiciel tiers : l'installation passe par une place de marché qu'Anthropic n'exploite pas.
Faut-il installer à la fois l'accès Claude de Cursor et cette extension ? Seulement si vous voulez deux circuits de facturation. Pour des chiffres d'usage cohérents, choisissez-en un.
Peut-on partager la clé avec un collègue ? Utilisez plutôt les champs de quota et d'expiration de la clé au lieu de partager une clé personnelle, et consultez Utilisation par clé.