Connecter des clés API personnalisées et indexer le contexte de travail dans CodeGPT pour VS Code

Dans Visual Studio Code, utiliser CodeGPT uniquement comme une fenêtre de discussion classique limite l'intelligence artificielle aux seuls fragments copiés et collés manuellement. Pour transformer CodeGPT en un assistant conscient de l'ensemble du dépôt, capable d'expliquer une logique métier distribuée et de mener des refactorisations chirurgicales sur plusieurs fichiers, deux étapes fondamentales sont requises : connecter ses propres clés API (modèle BYOK et points de terminaison personnalisés) et indexer l'espace de travail local (Codebase Indexing). Une fois configuré, CodeGPT s'appuie sur la recherche sémantique intégrée et des modes de profil dédiés pour analyser et restructurer le code directement au sein de l'éditeur.

1. Connecter des clés API personnalisées (BYOK et points de terminaison sur mesure)

CodeGPT fonctionne selon un modèle hybride : les nouveaux utilisateurs bénéficient d'un quota de découverte gratuit (30 interactions par mois), mais les flux de travail professionnels reposent généralement sur le modèle BYOK (Bring Your Own Key) ou sur un abonnement d'équipe. En fournissant vos propres clés d'API, vous vous affranchissez des restrictions de volume de la plateforme tout en réglant directement la consommation de jetons auprès du fournisseur du modèle.

Procédure de configuration des fournisseurs et des clés

1. Installation et synchronisation du compte : Depuis le Marketplace des extensions de VS Code, installez l'extension CodeGPT: AI Coding Agents & Chat (publiée par DanielSanMedium). Ouvrez le panneau latéral CodeGPT et connectez-vous avec Google, GitHub ou votre adresse e-mail pour synchroniser votre profil.
2. Accéder à la gestion des fournisseurs :
   • En bas du volet de discussion CodeGPT, cliquez sur le bouton Manage Models puis accédez à l'onglet Providers.
   • Vous pouvez également ouvrir la palette de commandes de VS Code (Ctrl+Shift+P sous Linux/Windows ou Cmd+Shift+P sous macOS) et exécuter CodeGPT: Set API KEY.
3. Sélectionner votre fournisseur d'IA :
   • CodeGPT propose des connecteurs natifs pour OpenAI, Anthropic, Google AI Studio, DeepSeek, Mistral, Cohere, Groq, Cerebras et Perplexity, ainsi que pour des serveurs locaux comme Ollama et LM Studio.
   • Collez la clé secrète générée depuis la console officielle de votre fournisseur (par exemple sur OpenAI ou Anthropic Console). Si votre compte est rattaché à une organisation, renseignez l'Organization ID.
4. Configurer un point de terminaison personnalisé compatible OpenAI (Custom Provider) :
   • Si vous utilisez une passerelle d'entreprise privée, un serveur auto-hébergé (comme vLLM ou une instance Ollama distante) ou un proxy comme OpenRouter, choisissez l'option Custom dans la liste des fournisseurs.
   • Saisissez le nom du modèle cible (par exemple cognitivecomputations/dolphin3.0-mistral-24b:free ou l'identifiant de votre modèle interne).
   • Renseignez la clé d'API correspondante.
   • Indiquez l'URL complète du point de terminaison de complétion (Custom Link, pointant vers l'URL HTTP /chat/completions).
   • Cliquez sur Connect pour valider la liaison.
5. Prérequis indispensable en mode BYOK : Après avoir enregistré votre clé, vous devez obligatoirement sélectionner un modèle actif dans le menu déroulant en haut de la fenêtre de discussion. L'envoi d'un message sans modèle préalablement sélectionné génère l'erreur suivante : « You must select a model first ».

2. Indexer le contexte de l'espace de travail local (Augmented Context)

Par défaut, un modèle de langage n'a aucune visibilité sur les fichiers fermés ou sur l'arborescence globale du projet. La fonctionnalité Codebase Indexing de CodeGPT génère un index vectoriel local pour doter l'assistant d'une vision d'ensemble du dépôt.

Sélection ponctuelle vs. indexation complète du projet

• Mise en surbrillance (Highlighting) : Parfait pour auditer une fonction autonome, corriger une erreur locale ou poser une question rapide sans avoir besoin de charger l'ensemble de l'application.
• Indexation du Codebase : Indispensable lorsque des modifications traversent plusieurs modules, que les contrats d'interfaces résident dans d'autres répertoires ou qu'il faut préserver les conventions architecturales du projet.

Création de l'index du workspace

1. Dans la barre latérale de CodeGPT, repérez la section Augmented Context et cliquez sur le bouton Codebase.
2. Cliquez sur Create Codebase Index.
3. Dans la boîte de dialogue de sélection de dossier, choisissez la racine de votre projet ouvert dans VS Code.
4. CodeGPT analyse les fichiers sources et génère localement la base de données vectorielle.
5. Dès l'indexation achevée, l'assistant active automatiquement l'outil Semantic Search Tool (Outil de recherche sémantique).

Méthodes d'injection de contexte dans la discussion

• Recherche sémantique automatique : Lors de questions relatives aux dépendances du projet, CodeGPT appelle de manière autonome le Semantic Search Tool pour extraire les blocs de code pertinents et les intégrer au prompt.
• Épinglage manuel de fichiers : Cliquez sur le bouton +Add Context et choisissez #Files pour cibler des fichiers clés, ou tapez le symbole @ dans le champ de saisie pour référencer des fichiers ouverts et des symboles précis.
• Ajout systématique du fichier courant : Dans les paramètres de CodeGPT (icône d'engrenage ⚙️), activez l'option qui joint automatiquement le fichier actuellement actif dans l'éditeur à chaque requête.

3. Expliquer le code à l'échelle de l'espace de travail

Comprendre du code hérité ou des mécanismes d'architecture avancés exige de corréler la syntaxe immédiate avec les flux de données répartis dans le dépôt.

Mode de profil recommandé : Search Mode

CodeGPT intègre trois profils de fonctionnement dans son interface :

• Chat Mode : Mode conversationnel standard sans accès aux outils du système de fichiers.
• Search Mode (Recommandé pour l'explication de code) : Mode de lecture seule. Il permet à l'IA d'explorer l'arborescence, d'effectuer des recherches sémantiques et de lire des fichiers sans risquer d'altérer le code sur le disque.
• Agent Mode : Mode disposant de droits complets pour créer, modifier, supprimer des fichiers et exécuter des commandes dans le terminal intégré.

Déroulement d'une explication de code

1. Sélectionner le code : Dans l'éditeur VS Code, mettez en surbrillance la fonction, la classe ou le bloc d'instructions que vous souhaitez analyser.
2. Lancer la commande /Explain :
   • Dans le champ de texte de CodeGPT, tapez /Explain et validez par Entrée.
   • Ou faites un clic droit sur la sélection et choisissez Explain CodeGPT dans le menu contextuel.
3. Analyse enrichie par le contexte global : Grâce à l'indexation de l'espace de travail, l'explication indique l'origine des paramètres reçus, localise les fonctions utilitaires appelées dans d'autres modules et détaille les motifs d'architecture appliqués.
4. Questions d'approfondissement : Toujours en Search Mode, vous pouvez prolonger l'exploration avec des demandes précises, par exemple :
   • « Dans quelles routes de l'API ce middleware est-il invoqué ? »
   • « Explique le lien entre ce modèle de données et la couche d'accès aux bases de données. »

4. Mener des refactorisations fiables et progressives

Refactoriser du code sans visibilité d'ensemble expose à des ruptures de contrats d'API ou à des incohérences avec les règles de nommage du projet. CodeGPT associe des commandes dédiées et une gestion fine des autorisations pour sécuriser les modifications.

Processus de refactorisation

1. Identifier le périmètre : Mettez en surbrillance le code nécessitant une modernisation, une simplification ou une factorisation.
2. Déclencher /Refactor :
   • Dans le chat, tapez /Refactor accompagné de consignes précises (exemple : /Refactor transforme cette cascade de rappels en async/await et sépare la validation des données dans une fonction dédiée), puis appuyez sur Entrée.
   • Ou cliquez avec le bouton droit de la souris et sélectionnez Refactor CodeGPT.
3. Contrôle et application des propositions :
   • En Search Mode ou Chat Mode : CodeGPT génère dans le panneau de discussion le bloc de code refactorisé accompagné d'explications. Cliquez sur le bouton Insert code (icône de flèche située en haut à droite du bloc de code) pour injecter directement le résultat dans le fichier actif.
   • En Agent Mode : CodeGPT fait appel à son outil interne Edit File pour appliquer les modifications directement sur le disque. Si l'approbation automatique n'est pas activée, vous serez invité à examiner et approuver la modification avant son écriture.

Conseils pratiques pour sécuriser la refactorisation

• Approche progressive (Search → Agent) : Utilisez d'abord le Search Mode pour identifier les composants périphériques susceptibles d'être impactés par la refactorisation. Une fois la stratégie confirmée, passez en Agent Mode pour appliquer les modifications physiques.
• Validation par les tests du terminal : En Agent Mode, demandez à CodeGPT d'exécuter la suite de tests (npm test, pytest, etc.) via l'outil interne Run Terminal Command pour vous assurer qu'aucune régression n'a été introduite.
• Maintien de l'index à jour : Après une vague de refactorisations majeures ou la fusion d'une branche Git conséquente, réindexez le projet depuis le menu Codebase afin de garder la base vectorielle synchronisée avec l'état réel de votre code.

Références

• Configuration | CodeGPT
• CodeGPT Chat | CodeGPT
• Profile Modes | CodeGPT
• Internal Tools | CodeGPT
• Explain CodeGPT | CodeGPT
• Refactor CodeGPT | CodeGPT
• 🤖 AI Providers | CodeGPT
• Custom | CodeGPT
• CodeGPT: AI Coding Agents & Chat - Visual Studio Marketplace