VS Code 1.146 : comment migrer Local harness ? Guide 2026

Les notes officielles de VS Code 1.146 annoncent que Local harness est déprécié et doit être retiré en février 2027 (notes de version). Vous devriez donc préparer la migration vers Copilot harness avant cette échéance, sans supposer que vos réglages, vos Hooks, vos serveurs MCP ou vos anciennes sessions seront convertis automatiquement. Commencez par inventorier et sauvegarder l’existant, puis validez une tâche représentative dans l’espace de travail réellement utilisé.

Cet article s’adresse aux développeurs qui utilisent encore Local harness et doivent vérifier leurs sessions et personnalisations.
Si vous travaillez sur un Mac distant via Remote SSH, contrôlez aussi l’espace de travail ciblé, Agent Host et l’environnement des commandes.
Si vous administrez une équipe, vérifiez les stratégies, les droits et le comportement du bac à sable avant tout déploiement général.

Dernière vérification : 12 novembre 2026, d’après les notes officielles de VS Code 1.146 et la procédure officielle de migration Local vers Copilot. Réexaminez ces informations si la documentation ou le calendrier de retrait évolue.

Local harness déprécié, Copilot harness par défaut : que faut-il retenir ?

VS Code 1.146 marque Local harness comme déprécié et prévoit son retrait en février 2027. Copilot harness est déjà la cible par défaut des nouvelles sessions, mais cela ne signifie ni que chaque ancienne session a été convertie, ni que vos intégrations sont compatibles sans vérification. La documentation officielle sur les harness d’agent aide à distinguer le cadre d’exécution de l’agent des autres choix de configuration.

Pour vous, la décision opérationnelle est simple : ne retardez pas l’essai de Copilot harness jusqu’au retrait annoncé, mais ne basculez pas non plus toute une équipe sur la seule base d’une nouvelle session créée avec le réglage par défaut. Commencez par un projet que vous connaissez et une tâche reproductible. Vous pourrez alors comparer le résultat, les commandes proposées et le comportement des autorisations avec votre référence Local harness.

Il est utile de séparer quatre notions souvent confondues :

• Le harness détermine le cadre dans lequel une session d’agent fonctionne et interagit avec ses outils.
• Le modèle est le modèle choisi pour produire les réponses. Changer de modèle ne prouve pas que le harness a changé.
• L’emplacement d’exécution désigne l’environnement qui accède aux fichiers et exécute les commandes : machine locale ou espace distant, selon votre configuration.
• Agent Host désigne un composant distinct lié à l’exécution de l’agent. L’état de la connexion de l’éditeur ne suffit donc pas à prouver que l’agent utilise le bon hôte.

Cette distinction évite un diagnostic trompeur : une session peut démarrer correctement tout en travaillant dans un autre répertoire, avec un shell différent ou sans un outil indispensable au projet.

Avant la bascule : sauvegardez l’état réel du projet

Le premier risque n’est pas l’absence d’un bouton de migration ; c’est la perte d’une configuration implicite que personne n’a documentée. Un agent peut dépendre de consignes réparties entre le dépôt, le profil utilisateur, des scripts locaux et des secrets injectés dans l’environnement. Changer de cible sans en dresser l’inventaire rend les écarts difficiles à attribuer.

Choisissez une tâche limitée et répétable : par exemple, corriger une erreur dans un module, lancer les tests associés, puis produire un résumé des fichiers modifiés. Notez le dépôt et la branche, le répertoire attendu, les commandes utilisées, les outils nécessaires, les approbations normalement demandées et le résultat considéré comme acceptable. Une bonne référence n’est pas seulement « l’agent a répondu » : elle permet de vérifier les changements et leur effet.

Inventoriez ensuite les éléments propres à votre configuration :

• les fichiers d’instructions du dépôt et les consignes personnelles ;
• les agents personnalisés et leurs descriptions de tâche ;
• les Hooks, scripts et commandes qui sont appelés automatiquement ;
• les serveurs MCP et les outils qu’ils exposent ;
• le shell par défaut, les variables d’environnement et les chemins d’accès ;
• les secrets et autorisations, sans recopier les valeurs sensibles dans un ticket ou un fichier de sauvegarde non protégé ;
• les sessions Local harness actives, les brouillons importants et les espaces de travail associés.

Pour les secrets, sauvegardez la méthode de configuration et l’origine de l’identifiant, pas nécessairement sa valeur. Un fichier de consignes peut être copié dans le dépôt ; un jeton d’accès ne doit pas être ajouté à ce même dépôt. Cette séparation réduit le risque de transformer la migration en incident de sécurité.

À retenir : sélectionnez Copilot harness pour une nouvelle session, mais ne traitez pas cette action comme une conversion automatique des fichiers de configuration. Vérifiez chaque intégration à partir de la documentation officielle de migration.

Pendant l’essai : distinguez la cible de session du modèle

Créez une nouvelle session et examinez sa cible avant de lancer le travail. Choisissez Copilot dans le champ Session Target, puis vérifiez le compte utilisé, les modèles disponibles et les outils dont la tâche a besoin. Les choix proposés peuvent varier selon l’accès et la configuration ; ne déduisez pas la disponibilité d’un modèle à partir d’une capture d’écran ou d’un autre compte.

Relancez ensuite la tâche de référence, sans modifier en même temps le modèle, les consignes et les permissions. Si vous changez plusieurs variables, vous ne saurez plus si un résultat différent vient du harness, du modèle ou de la configuration du projet. Notez les faits observables : fichiers consultés, commandes exécutées, outils appelés, confirmations demandées et résultat produit.

Comparez la session à votre référence selon des critères vérifiables :

• L’agent a-t-il identifié le bon dépôt et les bons fichiers ?
• A-t-il proposé les commandes prévues ou utilisé une autre méthode ?
• Les demandes d’autorisation correspondent-elles à la politique de votre équipe ?
• Les Hooks et outils attendus ont-ils été déclenchés ?
• Le résultat passe-t-il les tests ou contrôles pertinents du projet ?

Une tâche peut produire une réponse convaincante tout en échouant sur l’exécution. Dans un projet iOS, par exemple, un résumé de code ne prouve pas que la compilation ou les tests utilisant Xcode ont abouti. Il faut inspecter les sorties de commande et appliquer les contrôles habituels du dépôt.

Après l’essai : migrez les intégrations et les anciennes sessions séparément

Ne migrez pas « les réglages » comme un bloc unique. Pour chaque élément de l’inventaire, recherchez la compatibilité indiquée par la documentation, puis effectuez un essai isolé. La référence VS Code sur la configuration MCP décrit la configuration des serveurs MCP ; utilisez-la pour contrôler où se trouvent les paramètres et comment ils sont déclarés. Un serveur qui existe dans un fichier ne prouve pas qu’il est chargé, accessible et autorisé dans la session d’essai.

Traitez les catégories une à une :

• Instructions et fichiers d’invite : vérifiez qu’ils sont lus depuis le dépôt ou le profil prévu et qu’ils s’appliquent à la tâche.
• Agents personnalisés : confirmez que leurs outils et leur périmètre sont encore appropriés ; adaptez les définitions qui dépendent d’un comportement propre à l’ancien harness.
• Hooks : contrôlez leur déclenchement, leurs effets secondaires et les autorisations demandées. Ne supposez pas qu’un Hook local fonctionne de la même manière dans une session distante.
• MCP et outils : vérifiez la configuration, l’accessibilité du serveur, les droits et les arguments transmis. Si aucun chemin de conversion n’est documenté, recréez l’intégration dans une branche ou un espace de test et consignez les différences.
• Shell et scripts : comparez le shell effectivement lancé, le répertoire courant, les variables nécessaires et la disponibilité des exécutables.

Les anciennes sessions constituent un autre chantier. Si vous devez reprendre le contexte d’une session Local harness, suivez le chemin de transfert décrit dans le guide de migration officiel. Contrôlez ensuite l’historique, les brouillons, le dépôt ouvert et les permissions visibles dans la session cible. Ne présumez pas que la continuité est bidirectionnelle : un transfert vers Copilot harness ne signifie pas automatiquement qu’une modification ultérieure sera répercutée dans l’ancienne session.

Pour une équipe, gardez une trace des éléments qui n’ont pas de conversion documentée. Il est plus sûr d’assigner à chacun une décision explicite — recréer, remplacer, abandonner ou différer — que de considérer l’absence d’erreur au démarrage comme une preuve de compatibilité.

Dans Remote SSH : validez l’éditeur, Agent Host et les commandes

Une connexion Remote SSH réussie prouve que l’éditeur a atteint un hôte distant ; elle ne prouve pas à elle seule que l’agent lit le bon dépôt ou exécute les commandes dans le bon environnement. La documentation Remote SSH de VS Code décrit le fonctionnement du développement distant. Pour la migration, le contrôle supplémentaire consiste à vérifier le contexte effectif de la session d’agent.

Commencez par confirmer l’indicateur de connexion distante et le chemin du dossier ouvert. Comparez ce chemin au dépôt prévu, puis vérifiez la branche, l’état des modifications non validées et les fichiers réellement visibles. Une fenêtre VS Code peut rester ouverte sur le mauvais dossier, notamment lorsqu’un poste local et un hôte distant contiennent des copies du même projet.

Vérifiez ensuite l’environnement des commandes depuis la session d’agent, et non seulement depuis un terminal séparé que vous avez ouvert vous-même. Confirmez le répertoire courant, le shell, les exécutables, les variables et les permissions nécessaires. Un shell interactif et un processus d’agent peuvent ne pas charger les mêmes fichiers de configuration ; si les résultats diffèrent, documentez quelle commande et quel contexte produisent l’écart.

Enfin, vérifiez séparément Agent Host. La documentation consacrée à Agent Host présente ce composant et aide à ne pas le confondre avec la connexion Remote SSH de l’éditeur. Inspectez son état dans l’interface et associez-le à la session testée. Si l’éditeur est connecté au Mac mais que l’agent s’exécute ailleurs, l’agent peut ne pas disposer des mêmes fichiers, outils ou commandes.

Cas concret : si votre tâche génère un projet iOS ou lance une étape audio ou vidéo dépendant d’outils macOS, ne validez pas la migration à partir d’une simple modification de fichier. Lancez la commande propre au projet sur l’hôte visé, examinez son code de sortie et les artefacts attendus, puis vérifiez que le résultat correspond à celui que votre équipe accepte normalement.

Les politiques d’entreprise doivent aussi être testées dans le contexte où elles seront utilisées. La documentation VS Code sur la gestion des paramètres d’IA en entreprise sert de référence pour les réglages administrés. Comparez les paramètres effectifs du poste ou du compte de test aux règles de l’organisation, et vérifiez le comportement du bac à sable, des outils autorisés et des approbations. Une configuration fonctionnelle pour un développeur ne démontre pas que la politique d’équipe est correctement appliquée.

Avant le retrait annoncé : choisissez entre poursuite, correction et déploiement

Le tableau suivant sert à choisir la prochaine action, pas à établir un classement abstrait des harness. Conservez l’essai en cours tant que les écarts n’ont pas de cause connue ; élargissez le déploiement seulement lorsque les critères de validation correspondent à votre contexte de travail.

Pour limiter les faux positifs, faites varier un seul élément à la fois. Si une commande échoue après la migration, reproduisez-la dans le même répertoire et avec le même environnement, puis comparez le shell et les autorisations avant de modifier les instructions de l’agent. Si un Hook semble absent, cherchez d’abord s’il est pris en charge et chargé dans ce contexte plutôt que de le remplacer immédiatement par un autre outil.

La diffusion à l’équipe peut se faire par étapes : sélectionnez des projets qui représentent des dépendances différentes, documentez les écarts, puis faites relire les points de sécurité et de politique par la personne responsable. La page officielle sur l’administration des paramètres d’IA est particulièrement utile lorsque des réglages sont imposés au niveau de l’organisation. Avant le retrait annoncé, revoyez aussi les éléments encore bloqués et surveillez les mises à jour de la documentation officielle ; ne transformez pas une date annoncée en garantie que chaque détail restera inchangé.

FAQ : dates, réglages et validation distante

Quand Local harness doit-il être retiré de VS Code ?
Les notes de version de VS Code 1.146 annoncent un retrait prévu en février 2027. Vérifiez cette date dans la documentation officielle lorsque vous planifiez votre migration, car le calendrier ou les consignes peuvent être actualisés.

Les configurations personnalisées passent-elles automatiquement à Copilot harness ?
Ne partez pas de cette hypothèse. Sauvegardez et vérifiez séparément instructions, agents, Hooks, serveurs MCP, outils et paramètres de secrets. La documentation peut décrire des procédures pour certains éléments ; pour les autres, prévoyez un test de recréation ou une décision de remplacement.

Comment confirmer le harness d’une nouvelle session ?
Contrôlez Session Target lors de la création et sélectionnez Copilot. Vérifiez ensuite le harness affiché et exécutez une tâche connue. Le modèle sélectionné est un choix distinct : il ne permet pas, à lui seul, d’identifier le harness.

Comment valider une session sur Remote SSH ?
Vérifiez le dossier distant et le dépôt avant d’exécuter une tâche. Contrôlez ensuite Agent Host, le shell et les commandes depuis le contexte de l’agent. Pour conclure, exécutez les tests ou la construction propres au projet ; la seule connexion de l’éditeur ne vaut pas validation du travail.

Pour un environnement macOS temporaire, arbitrez selon la charge réelle

Si votre environnement actuel est un poste Windows ou Linux relié à une machine distante, il peut convenir tant que les outils et commandes correspondent au projet. Ses limites apparaissent lorsque la tâche dépend d’outils macOS, que la puissance disponible est partagée avec votre travail quotidien, ou que l’accès à une machine précise doit être maintenu. Une machine personnelle dédiée règle certains problèmes de disponibilité, mais immobilise du matériel et demande une gestion continue.

Après avoir validé Copilot harness et vos commandes dans le bon espace de travail, vous pouvez comparer les solutions Mac distantes disponibles. Si votre projet exige réellement un environnement macOS accessible pendant une période de test ou de migration, la location d’un Mac distant peut éviter l’achat immédiat d’une machine et fournir un hôte distinct de votre poste principal. En revanche, pour une charge soutenue nécessitant un accès physique ou une configuration matérielle durable, l’achat d’un Mac peut être plus adapté. Le choix dépend de la durée d’usage, des outils requis et de la nécessité de garder l’environnement en ligne.

Questions fréquentes