Aller au contenu
Ressources pour développeurs
Ressources pour développeurs

Claude Code dans VS Code & Cursor

Installez l'extension Claude Code dans VS Code ou Cursor et connectez ses paramètres partagés à RunAPI.

Vue d'ensemble

L’extension officielle Claude Code fonctionne à la fois dans VS Code et Cursor. Les deux éditeurs utilisent les mêmes paramètres utilisateur Claude Code, aussi ce guide installe l’extension correspondante et configure RunAPI une seule fois dans ~/.claude/settings.json.

Avant de commencer

  • Installez une version prise en charge de VS Code ou Cursor. La version minimale actuelle de VS Code est indiquée dans le guide officiel de l’extension.
  • Créez une clé API standard dans le Guide d’authentification. Ne la placez pas dans les paramètres de l’espace de travail ni dans le contrôle de source.
  • Copiez un identifiant de modèle prenant en charge Anthropic Messages depuis le Catalogue de modèles.

Installer

Installez l’extension officielle anthropic.claude-code :

  • VS Code : ouvrez la fiche VS Code Marketplace ou recherchez Claude Code dans Extensions.
  • Cursor : ouvrez cursor:extension/anthropic.claude-code ou recherchez Claude Code dans Extensions.

L’extension inclut le runtime nécessaire à son panneau de chat. Installez la CLI autonome uniquement si vous souhaitez également exécuter claude dans le terminal intégré.

Configurer RunAPI

Ouvrez ~/.claude/settings.json et ajoutez les paramètres d’environnement partagés au niveau utilisateur :

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

Dans les paramètres de VS Code ou Cursor, recherchez Claude Code login et activez Disable Login Prompt pour cet endpoint personnalisé. Les paramètres utilisateur sont partagés avec le CLI ; les paramètres de l’extension VS Code ne contrôlent que le comportement de l’extension.

Ne placez pas la vraie clé dans .claude/settings.json ni dans les paramètres d’espace de travail de l’éditeur, car ces fichiers peuvent être commités.

Choisir un modèle

Remplacez YOUR_RUNAPI_MODEL_ID par un identifiant exact du Catalogue de modèles. Dans le panneau Claude Code, /model modifie la sélection actuelle et /status affiche le modèle actif.

Vérifier

  1. Rechargez la fenêtre de l’éditeur après avoir modifié l’extension ou les paramètres.
  2. Ouvrez le panneau Claude Code Spark.
  3. Exécutez /status et vérifiez les paramètres utilisateur et le modèle.
  4. Envoyez Describe this repository in one sentence. et confirmez une réponse normale.

Résoudre les problèmes

  • L’extension ne s’installe pas : confirmez que la version de l’éditeur satisfait les exigences officielles.
  • L’icône Spark est manquante : rechargez la fenêtre de l’éditeur, puis redémarrez l’éditeur.
  • Une invite de connexion s’affiche toujours : activez Désactiver l’invite de connexion dans les paramètres de l’extension Claude Code.
  • Le panneau n’hérite pas des variables du shell : utilisez ~/.claude/settings.json ou lancez l’éditeur depuis le terminal configuré. Les applications graphiques démarrent souvent sans l’environnement du terminal.
  • L’interface CLI fonctionne mais le panneau non : rechargez la fenêtre et utilisez l’interface CLI autonome pour reproduire la requête avec des diagnostics plus détaillés.
  • L’authentification ou la sélection du modèle échoue : vérifiez la clé dans le Guide d’authentification et copiez l’identifiant exact depuis le Catalogue de modèles.

Étapes suivantes

Consultez le Guide de démarrage rapide de l’API LLM pour le comportement du protocole et la Référence de l’API Anthropic Messages pour les champs de requête. Pour ajouter des outils RunAPI dans l’éditeur, poursuivez avec la Vue d’ensemble MCP.