Configuration de l'extension VS Code Claude Code : backend, modèles et sandbox

Claude Code débarque dans VS Code comme un agent de codage complet dans la barre latérale — pas un outil de complétion, mais un résolveur de problèmes multi-étapes qui lit votre projet, modifie des fichiers et exécute des commandes. L’extension VS Code partage son moteur avec le CLI, donc les commandes slash, la prise en compte de CLAUDE.md et les appels d’outils MCP fonctionnent exactement comme dans le terminal. Ce qui rend la configuration utile à comprendre, c’est la couche backend : chaque appel d’inférence passe par un point de terminaison que vous contrôlez, et router ce point de terminaison vers Novita AI ouvre l’accès aux modèles Claude ainsi qu’à un catalogue plus large d’alternatives de codage open source — à des tarifs qui rendent pratiques les tâches d’agent à grand volume.

Ce que fait Claude Code dans VS Code

L’extension VS Code Claude Code est un panneau latéral, pas un moteur de complétion en ligne. Ouvrez-la, décrivez une tâche, et Claude Code exécute un travail multi-étapes : lecture de fichiers, écriture de modifications, exécution de commandes shell et attente de votre approbation sur les diffs avant de les appliquer. Cette distinction est importante, car les développeurs recherchent souvent « claude code vs code » en s’attendant à une expérience de type Copilot — des suggestions sur une seule ligne qui se complètent pendant la frappe. Ce n’est pas le cas. Pour les complétions, d’autres outils remplissent ce rôle. Claude Code dans VS Code est fait pour les tâches : écrire des tests pour ce module, refactoriser le gestionnaire d’authentification, expliquer pourquoi cette requête est lente, créer une pull request avec les modifications du jour.

Capacités concrètes de l’extension :

• Modifications multi-fichiers avec diffs en ligne. Claude Code propose des modifications sur plusieurs fichiers et affiche des diffs que vous pouvez accepter ou rejeter sans quitter l’éditeur.
• Commandes slash. /compact, /clear, /init, /memory, ainsi que les commandes slash personnalisées que vous avez définies fonctionnent exactement comme dans le CLI.
• Épinglage de contexte. Le préfixe # attache des fichiers, symboles ou dossiers spécifiques à une requête. Saisir #src/auth/handler.ts fix the race condition donne immédiatement le bon contexte à Claude Code.
• Prise en compte de CLAUDE.md. Les normes de codage du projet, les notes d’architecture, les bibliothèques préférées — tout ce qui se trouve dans CLAUDE.md est chargé au début de la session. Vous l’écrivez une fois ; l’agent en tient compte à chaque session.
• Appels d’outils MCP. Les serveurs MCP enregistrés dans votre configuration Claude Code sont disponibles dans le panneau de l’extension.

Ce que l’extension ne fait pas : remplacer vos raccourcis clavier existants, modifier votre coloration syntaxique ou ajouter des complétions frappe par frappe. C’est une interface d’agent superposée à votre flux de travail VS Code habituel.

Comment ajouter Claude Code à VS Code

Ouvrez le panneau Extensions (Ctrl+Shift+X sous Windows/Linux, Cmd+Shift+X sous macOS). Recherchez Claude Code et cherchez l’éditeur Anthropic. Cliquez sur Installer.

Si vous préférez la ligne de commande :

code --install-extension Anthropic.claude-code

Après l’installation, l’icône Claude apparaît dans la barre d’activités sur le côté gauche de VS Code. Cliquez dessus pour ouvrir le panneau de l’agent.

Authentification au premier lancement. L’extension vous invite à vous connecter à la première ouverture. Deux possibilités :

• Compte Anthropic : flux OAuth dans le navigateur — fonctionne si vous avez une clé API Anthropic Console ou un abonnement Claude actif.
• Clé API Novita AI : définissez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN dans votre environnement shell avant de lancer VS Code à partir de ce terminal. L’extension les lit au démarrage et contourne entièrement la connexion Anthropic. Détails dans la section suivante.

VS Code met à jour l’extension automatiquement en arrière-plan. Pas besoin de suivre les versions manuellement.

Comment fonctionne le backend de l’API LLM

Comprendre l’architecture en trois couches clarifie chaque décision de configuration :

1. Couche interface utilisateur : l’extension VS Code (ou le CLI, ou l’application de bureau — ce sont des surfaces interchangeables).
2. Couche logique de l’agent : le moteur Claude Code — définitions d’outils, gestion de session, lecture de fichiers, exécution de commandes.
3. Couche API LLM : le point de terminaison d’inférence qui gère chaque appel de modèle de langage.

Par défaut, la couche API LLM pointe vers api.anthropic.com. Claude Code envoie ses requêtes au format de l’API Messages d’Anthropic. Le détail essentiel : ANTHROPIC_BASE_URL redirige toutes ces requêtes vers n’importe quel point de terminaison compatible Anthropic. Novita AI expose le même format d’API Messages à l’adresse https://api.novita.ai/anthropic, de sorte que le changement est transparent pour la couche logique de l’agent — Claude Code ne sait ni ne se soucie de savoir si la réponse provient des serveurs d’Anthropic ou de ceux de Novita.

Trois autres variables d’environnement complètent la configuration :

• ANTHROPIC_AUTH_TOKEN — votre clé API pour le fournisseur choisi.
• ANTHROPIC_MODEL — l’identifiant du modèle à utiliser pour les tâches principales.
• ANTHROPIC_SMALL_FAST_MODEL — l’identifiant du modèle pour les tâches d’arrière-plan rapides comme la synthèse et la compression du contexte.

Définissez ces variables avant de lancer VS Code, et l’extension les héritera de l’environnement shell.

Connecter Claude Code à Novita AI

Étape 1 : Obtenir une clé API Novita AI

Inscrivez-vous sur novita.ai et accédez à la page Key Management. Générez une nouvelle clé et copiez-la immédiatement — elle ne sera plus affichée.

Étape 2 : Définir les variables d’environnement

Sous macOS ou Linux, exportez les variables dans votre terminal avant de lancer VS Code :

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"

Sous Windows (invite de commandes) :

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<your-novita-api-key>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6

Puis lancez VS Code depuis la même session de terminal :

code .

Étape 3 : Vérifier la connexion

Ouvrez le panneau Claude Code et envoyez un court message de test. Si l’extension renvoie une réponse, le routage fonctionne. Vous êtes désormais facturé via Novita AI — votre compte Anthropic n’est pas débité.

Pour rendre la configuration permanente, ajoutez les exports à votre profil shell (~/.zshrc, ~/.bashrc ou équivalent) ou utilisez un fichier .env au niveau du projet géré par direnv pour changer de modèle par projet.

Des modèles open source qui rivalisent avec les performances de codage des modèles propriétaires

Une fois que vous routez via Novita AI, vous n’êtes plus limité aux modèles Claude. Le catalogue LLM de Novita comprend des modèles de codage open source qui concurrencent directement les alternatives propriétaires sur les benchmarks qui comptent pour les tâches de codage agentiques.

GLM-4.6 de Zhiyu AI est un exemple concret. Il offre une fenêtre de contexte de 200 000 tokens et atteint un taux de victoire de 48,6 % face à Claude Sonnet 4 dans des évaluations de codage en conditions réelles. Pour les flux de travail agentiques où le contexte long compte (débogage dans de grandes bases de code, lecture de suites de tests complètes), cette fenêtre de contexte est un avantage pratique, pas seulement un chiffre sur une fiche technique. L’identifiant du modèle Novita est zai-org/glm-4.6.

D’autres modèles de la plateforme Novita méritent d’être évalués pour les charges de travail de codage, notamment DeepSeek R1 et Qwen 3 Coder, qui ont tous deux démontré des performances compétitives sur les benchmarks de génération de code et de suivi d’instructions. La même variable d’environnement ANTHROPIC_MODEL permet de basculer entre eux — sans réinstallation, sans nouvelle intégration.

L’argument économique des modèles open source : les équipes qui font tourner Claude Code à grande échelle — de nombreuses exécutions d’agents dans les pipelines CI, des configurations multi-développeurs avec des clés API Novita partagées, ou de longues sessions agentiques qui consomment beaucoup de tokens — constatent que les modèles open source aux tarifs de Novita créent une marge significative dans le budget d’infrastructure. Un modèle qui offre 90 % du niveau de Claude Sonnet 4 à 40 % du coût change l’économie d’une exécution continue des agents.

Novita Agent Sandbox comme environnement d’exécution

Claude Code dans VS Code peut exécuter des commandes shell localement — il compilera votre projet, exécutera les tests, installera des paquets et créera des fichiers sur votre machine. Pour la plupart des tâches quotidiennes, c’est très bien. Mais certaines tâches agentiques sont mieux gérées dans un environnement de calcul isolé : les suites de tests lourdes qui bloquent votre machine, les étapes de build qui installent des paquets système, les commandes qui modifient la configuration système, ou les exécutions d’agents en parallèle où vous avez besoin de reproductibilité.

Novita Agent Sandbox fournit des environnements d’exécution cloud spécialement conçus pour ce cas d’usage. Un sandbox est une microVM qui démarre en quelques millisecondes, exécute le code en isolation de votre système hôte et se termine proprement une fois la tâche terminée. Aucun état résiduel, aucun impact sur votre environnement local, pas d’attente que le CPU de votre machine récupère.

Pour les utilisateurs de Claude Code, le flux de travail pratique est le suivant : routez l’inférence vers le point de terminaison LLM de Novita AI pour les appels de modèle de langage, et pour les tâches d’exécution lourdes — builds, exécutions de tests, évaluation de code — lancez une instance Agent Sandbox via l’API Novita Agent Sandbox. Les deux services partagent la même authentification (la même clé API Novita), donc aucune gestion d’identifiants séparée n’est nécessaire.

Les équipes qui construisent des pipelines de revue de code automatisée ou des agents Claude Code intégrés au CI trouvent cette combinaison particulièrement utile : le coût LLM reste prévisible grâce à la tarification au token de Novita, et le coût de calcul reste prévisible grâce à la facturation à la seconde d’Agent Sandbox.

Conseils pour le flux de travail quotidien dans VS Code

Quelques pratiques qui rendent l’extension utile plutôt qu’accessoire :

Commencez les nouveaux projets avec /init. Exécuter /init dans un nouveau dépôt génère un fichier de démarrage CLAUDE.md. C’est le moyen le plus efficace d’indiquer à Claude Code les conventions de votre projet avant qu’il ne commence à éditer.

Épinglez le contexte avec #. Au lieu de décrire quel fichier consulter, saisissez #filename pour l’attacher directement. Pour une refactorisation, #src/components/Button.tsx update the onClick handler to use the new event type est plus rapide que « regarde le composant Button et… »

Utilisez /compact de manière proactive. Dans une longue session, Claude Code accumule du contexte. /compact résume la conversation et réduit la surcharge de tokens. Exécutez-le après une tâche importante, avant de passer à la suivante.

Acceptez ou rejetez les diffs en ligne. Avant que Claude Code ne modifie un fichier, il affiche le diff dans le panneau. Vous n’êtes pas obligé d’accepter chaque modification — rejetez les diffs partiels et demandez une approche révisée. Considérer chaque réponse comme un point de départ plutôt que comme une réponse finale donne de meilleurs résultats.

Séparez les instructions du projet des instructions de session. CLAUDE.md est destiné au contexte stable du projet (commandes de build, architecture, style de code). Les instructions temporaires pour la tâche en cours vont dans le prompt de session. N’encombrez pas CLAUDE.md avec des consignes liées à une seule tâche.

FAQ

Où se trouve la documentation de l’extension VS Code Claude Code ?

La documentation officielle de l’extension est maintenue par Anthropic sur claude.ai/code. Les notes de version et le journal des modifications sont visibles dans le panneau Extensions de VS Code sous la rubrique Claude Code.

L’extension VS Code Claude Code est-elle gratuite ?

L’extension elle-même est gratuite à installer. Les coûts d’utilisation dépendent de votre configuration backend. Avec un compte Anthropic, vous payez au token ou utilisez des crédits d’abonnement. Avec le routage Novita AI, vous payez le tarif au token de Novita et aucun frais Anthropic ne s’applique. Les nouveaux comptes Novita reçoivent des crédits d’essai gratuits à l’inscription.

Puis-je utiliser l’extension VS Code et le CLI Claude Code en même temps ?

Oui, mais ils s’exécutent dans des sessions séparées. L’extension VS Code ne partage pas une session active avec une instance CLI ouverte. Si vous avez besoin d’une continuité de session entre les deux, utilisez claude -c dans le CLI pour reprendre la session la plus récente depuis ce répertoire.

Quelle est la différence entre Claude Code et Cline dans VS Code ?

Cline est une extension VS Code qui route le travail de l’agent via n’importe quel backend compatible OpenAI — elle offre une flexibilité maximale en matière de fournisseurs, mais nécessite plus de configuration. Claude Code est l’agent d’Anthropic avec un ensemble d’outils étroitement intégré. La redirection ANTHROPIC_BASE_URL donne en pratique à Claude Code une flexibilité de backend similaire. Si vous avez déjà configuré Novita AI pour Claude Code, vous n’avez pas besoin d’une installation séparée de Cline pour accéder au catalogue de modèles de Novita.

Puis-je utiliser des modèles différents pour des projets différents ?

Oui. Utilisez direnv avec des fichiers .env au niveau du projet pour limiter ANTHROPIC_MODEL à un répertoire spécifique. Lorsque vous ouvrez ce projet dans VS Code depuis un terminal avec direnv actif, l’extension hérite du paramètre de modèle spécifique au projet.

Novita AI est une plateforme cloud d’IA qui offre aux développeurs un moyen simple de déployer des modèles d’IA grâce à son API facile à utiliser, tout en fournissant un cloud GPU abordable et fiable pour créer et passer à l’échelle.

Articles recommandés

• Claude Code dans VS Code : installer l’extension, configurer l’IDE et passer à Novita AI
• Documentation du CLI Claude Code : installation, commandes slash et intégration de l’API LLM
• Comment intégrer l’API LLM Novita AI avec Cline dans VS Code