Wie migrieren Sie VS Code 1.146 Local harness? Leitfaden 2026

Mit VS Code 1.146 ist Local harness als veraltet markiert; laut offizieller Versionsmeldung ist die Entfernung für Februar 2027 geplant. Migrieren Sie vor diesem Termin zu Copilot harness, aber schalten Sie nicht blind um: Sichern Sie zuerst Ihre Anpassungen und prüfen Sie anschließend mit einer wiederholbaren Aufgabe, ob Sitzung, Werkzeuge und Remote-SSH-Arbeitsbereich wie erwartet funktionieren.

Stand der Prüfung: 12.11.2026. Die Versionsangabe und der geplante Entfernungstermin beruhen auf der VS-Code-Veröffentlichungsmeldung; Kompatibilität und Verhalten müssen Sie zusätzlich in Ihrer eigenen Arbeitsumgebung prüfen.

Dieser Beitrag ist für Sie gedacht, wenn Sie in VS Code noch Local harness verwenden und wissen müssen, welche Einstellungen betroffen sind.
Wenn Sie per Remote SSH auf einem Mac entwickeln, sollten Sie Arbeitsbereich, Agent Host und tatsächlich ausgeführte Befehle getrennt abnehmen.
Verantwortliche für Teamrichtlinien sollten vor einer breiten Umstellung außerdem Berechtigungen, Sandbox und Unternehmensvorgaben testen.

Zeitplan und Begriffe: Wechseltermin statt Versionsverwechslung

Die kurze Entscheidung lautet: Beginnen Sie die Migration jetzt mit einem begrenzten Test, statt bis zum Entfernungstermin zu warten. Die Ankündigung betrifft den Harness, nicht automatisch jedes Modell, jede Sitzung oder den Ort, an dem ein Befehl ausgeführt wird.

Wann endet Local harness in VS Code? Nach dem derzeitigen offiziellen Stand ist Local harness in VS Code 1.146 veraltet und soll im Februar 2027 entfernt werden. Ein bestimmter Kalendertag ist in der verlinkten Versionsmeldung nicht genannt. Behandeln Sie den Monat daher als Fristfenster und prüfen Sie die offiziellen Hinweise erneut, bevor Sie Ihre interne Abschaltung terminieren.

Die Begriffe sind für die Fehlersuche entscheidend:

• Harness bezeichnet den Ausführungspfad beziehungsweise die Umgebung, über die ein Agent mit Werkzeugen und dem Arbeitsbereich interagiert. Die Dokumentation zu Agent harnesses beschreibt die Rolle des Harness im Agent-Ablauf.
• Modell ist die ausgewählte Modelloption. Ein Wechsel des Modells ist nicht dasselbe wie ein Wechsel des Harness. Halten Sie beides in Ihrem Testprotokoll getrennt.
• Ausführungsort ist der Rechner oder Arbeitsbereich, auf dem Dateien und Befehle tatsächlich bearbeitet beziehungsweise ausgeführt werden.
• Agent Host ist eine weitere Komponente, deren Zustand Sie eigenständig kontrollieren müssen. Die Dokumentation zum Agent Host hilft dabei, diese Rolle nicht mit der Editor-Verbindung gleichzusetzen.

Eine erfolgreiche Anmeldung oder eine gestartete Sitzung belegt deshalb noch nicht, dass Ihr Agent im erwarteten Repository arbeitet oder die gewünschte Shell verwendet. Für die Migration zählt das Ergebnis eines konkreten Projektablaufs.

Vor dem Umschalten: Arbeitsablauf erfassen und Anpassungen sichern

Wählen Sie zuerst eine kleine Aufgabe, die sich ohne Interpretationsspielraum wiederholen lässt. Geeignet ist beispielsweise ein vorhandener Testlauf oder eine eng begrenzte Änderung in einem bekannten Repository. Notieren Sie den Arbeitsbereich, die erwarteten Dateien, nötige Befehle, verwendete Werkzeuge, Freigabeschritte und das erwartete Endergebnis.

Damit erhalten Sie eine Vergleichsbasis: Sie können nach dem Wechsel feststellen, ob sich die Dateiauswahl, die Befehlsausführung oder das Verhalten bei Genehmigungen geändert hat. Schreiben Sie nicht nur „Agent funktioniert“ auf. Halten Sie fest, welcher Befehl im Terminal lief und welche Änderung anschließend geprüft wurde.

Sichern Sie vor der Testmigration die Konfiguration, die für Ihre Arbeit tatsächlich relevant ist:

1. Erfassen Sie persönliche Agenten, Anweisungsdateien und projektbezogene Prompts.
2. Notieren Sie Hooks einschließlich ihrer Auslöser, Eingaben, erwarteten Ausgaben und Berechtigungen.
3. Prüfen Sie MCP-Server, Werkzeuge und deren Startparameter. Die VS-Code-Dokumentation zur MCP-Konfiguration beschreibt, wo diese Einstellungen verwaltet werden.
4. Dokumentieren Sie die verwendete Terminal-Shell sowie relevante Umgebungsvariablen, ohne geheime Werte in ein frei zugängliches Protokoll zu kopieren.
5. Halten Sie fest, welche Konten, Richtlinien oder Freigaben vorausgesetzt werden; sichern Sie Anmeldedaten ausschließlich nach den für Ihr Team zugelassenen Verfahren.

Werden eigene Einstellungen beim Wechsel automatisch übernommen? Verlassen Sie sich nicht darauf. Die Auswahl von Copilot harness ist keine vollständige Konvertierung aller persönlichen Agenten, Hooks, MCP-Einträge, Prompts, Rechte und alten Sitzungen. Vergleichen Sie jeden benötigten Bestandteil mit der offiziellen Anleitung für den Wechsel von Local zu Copilot harness. Wo diese keine automatische Übernahme vorsieht, behandeln Sie die Anpassung als eigene Migration mit separater Prüfung.

Der Vorteil dieser Inventur ist, dass Sie später Abweichungen einer konkreten Einstellung zuordnen können. Der Nachteil ist zusätzlicher Dokumentationsaufwand. Bei einem Team mit gemeinsam genutzten Hooks oder MCP-Werkzeugen ist dieser Aufwand jedoch meist geringer als die Fehlersuche nach einem stillschweigend veränderten Ausführungs- oder Freigabeverhalten.

Testlauf: Copilot harness mit einer bekannten Aufgabe prüfen

Öffnen Sie eine neue Sitzung und wählen Sie im Session Target Copilot. Kontrollieren Sie, ob das erwartete Konto verfügbar ist, welche Modelle angeboten werden und ob die für Ihre Aufgabe benötigten Werkzeuge erreichbar sind. Die Modellwahl sollten Sie protokollieren, aber nicht als Beleg dafür werten, dass die Migration des Harness abgeschlossen ist.

Woran erkennen Sie, dass eine neue Sitzung Copilot harness verwendet? Prüfen Sie die Auswahl im Session Target der neuen Sitzung und gleichen Sie sie mit der offiziellen Wechselanleitung ab. Verlassen Sie sich nicht auf eine alte Sitzung, einen Modellnamen oder eine erfolgreiche Agent-Antwort als einzigen Nachweis. Notieren Sie die angezeigte Auswahl sowie Sitzung und Arbeitsbereich, in denen Sie den Test ausführen.

Führen Sie danach genau die zuvor erfasste Aufgabe aus. Prüfen Sie mindestens vier Dinge:

• Wurden die erwarteten Dateien gelesen und geändert?
• Wurden die vorgesehenen Befehle in der erwarteten Shell ausgeführt?
• Wurden Werkzeuge und Hooks aufgerufen, die in der Baseline dokumentiert sind?
• Verhielt sich die Freigabe wie geplant, insbesondere vor Änderungen oder Befehlen mit Nebenwirkungen?

Vergleichen Sie nicht bloß die Antwort des Agenten. Prüfen Sie Änderungen im Versionskontrollsystem, Terminal-Ausgaben und das Ergebnis der Projektprüfung. Falls sich das Resultat unterscheidet, ändern Sie nicht gleichzeitig Harness, Modell und Werkzeuge. Isolieren Sie die Ursache durch einen kontrollierten Wiederholungslauf mit möglichst wenigen veränderten Bedingungen.

Sitzungsübergabe und Integrationen: Altbestand nicht mit Neuaufbau verwechseln

Eine neue Copilot-Sitzung ist nicht automatisch eine Fortsetzung einer Local-Sitzung. Wenn Sie den bisherigen Kontext benötigen, nutzen Sie den in der offiziellen Migrationsanleitung beschriebenen Übergabepfad und kontrollieren Sie anschließend, was tatsächlich verfügbar ist. Prüfen Sie den Gesprächsverlauf, nicht abgeschlossene Entwürfe, den aktiven Arbeitsbereich und geltende Berechtigungen. Planen Sie nicht mit einer bidirektionalen Umschaltung, solange die Dokumentation diese nicht ausdrücklich für Ihren Ablauf bestätigt.

Legen Sie für jede Integration einen Status fest: unverändert nutzbar, manuell anzupassen, durch eine andere Lösung zu ersetzen oder für den Test nicht erforderlich. Das verhindert, dass ein funktionierender Agent fälschlich als Beweis für die vollständige Übernahme aller Erweiterungen gilt.

Bei MCP sollten Sie insbesondere Serveradresse beziehungsweise Startkonfiguration, benötigte Werkzeuge und Zugriffsrechte überprüfen. Testen Sie zuerst mit einem ungefährlichen, eng begrenzten Vorgang. Hooks verdienen eine eigene Prüfung, weil sie an bestimmte Ereignisse gebunden sein können und vor oder nach einer Aktion zusätzliche Befehle ausführen. Ein Hook, der in einer neuen Sitzung nicht ausgelöst wird, ist nicht durch einen erfolgreichen Chat-Test abgedeckt.

Für Unternehmensumgebungen gehören Richtlinien in dieselbe Abnahme. Prüfen Sie, ob erlaubte Modelle, deaktivierte Funktionen, Freigaberegeln und Sandbox-Vorgaben im neuen Ablauf greifen. Die Dokumentation zur Verwaltung von KI-Einstellungen in Unternehmen ist dafür die Referenz; die Wirkung sollten Sie in der Richtlinienkonfiguration Ihrer Organisation nachvollziehen, nicht aus einem einzelnen lokalen Test ableiten.

Remote SSH und Mac-Arbeitsbereich: Verbindung und Ausführung separat abnehmen

Bei Remote SSH kann der Editor mit einem entfernten Rechner verbunden sein, während Sie dennoch nicht nachgewiesen haben, wo der Agent seine Arbeit ausführt. Prüfen Sie daher die Verbindung, den Arbeitsbereich und den Agent Host getrennt. Die Remote-SSH-Dokumentation erläutert die Verbindung zu einem entfernten Entwicklungsrechner; die Agent-Host-Dokumentation beschreibt eine andere Ebene des Agent-Ablaufs.

Wie prüfen Sie Agent Host und Projektbefehle nach einer Remote-SSH-Migration? Öffnen Sie das vorgesehene Repository über die Remote-SSH-Verbindung, kontrollieren Sie den aktiven Arbeitsbereich und führen Sie einen harmlosen Befehl aus, der den Projektkontext eindeutig erkennen lässt. Prüfen Sie anschließend, ob der Agent dieselbe Umgebung verwendet und ob das projektspezifische Build- oder Testergebnis erfolgreich ist. Ein sichtbarer Remote-Status allein reicht nicht.

Ein konkreter Abnahmelauf für ein macOS-Projekt sollte diese Reihenfolge einhalten:

1. Verbinden Sie sich über Remote SSH mit dem vorgesehenen Mac und öffnen Sie das richtige Repository.
2. Kontrollieren Sie Arbeitsverzeichnis, Branch und relevante Shell-Konfiguration. Achten Sie darauf, dass keine lokale Kopie des Projekts versehentlich als Testgrundlage dient.
3. Starten Sie eine neue Copilot-Sitzung im Arbeitsbereich und dokumentieren Sie Session Target sowie den angezeigten Agent-Host-Zustand.
4. Lassen Sie den Agenten zunächst einen ungefährlichen Projektbefehl ausführen, etwa einen vorhandenen Status- oder Testbefehl. Prüfen Sie die Ausgabe im Terminal des tatsächlich verbundenen Arbeitsbereichs.
5. Wiederholen Sie die Baseline-Aufgabe und kontrollieren Sie Dateidiff, Tool-Aufrufe und Genehmigungen.
6. Führen Sie anschließend den für das Projekt maßgeblichen Build oder Test aus. Bei einer Aufgabe, die Apples Entwicklungswerkzeuge erfordert, ist deren tatsächliches Projektergebnis ausschlaggebend; eine erfolgreiche SSH-Verbindung ist kein Ersatz dafür.

So finden Sie typische Fehler früher: falsches Repository, lokale statt entfernte Shell, fehlende Werkzeuge, abweichende Umgebungsvariablen oder ein Agent Host, der nicht dem erwarteten Kontext entspricht. Geben Sie Geheimnisse nicht in Prompts oder Testprotokolle ein; verwenden Sie für Zugangsdaten die freigegebenen Mechanismen Ihres Teams und prüfen Sie, welche Daten an den Agenten übermittelt werden dürfen.

Vergleich vor der Freigabe: Einzeltest, gestaffelte Einführung oder Rückfall

Die folgende Tabelle hilft, den nächsten Schritt an den tatsächlich erzielten Prüfergebnissen auszurichten. Die Optionen sind keine unterschiedlichen Harness-Arten, sondern Vorgehensweisen für die Migration.

Für die Teamfreigabe sollten Sie nicht nur „grün“ oder „rot“ erfassen. Halten Sie pro repräsentativem Projekt die benötigten Werkzeuge, die Freigabepunkte, den Zustand der Sitzung und das Ergebnis des eigenen Projektprüflaufs fest. So kann ein Teammitglied erkennen, ob ein Fehler aus der Harness-Umstellung oder aus einer projektspezifischen Abhängigkeit stammt.

Ein gestaffelter Rollout ist meist die bessere Wahl, wenn ein Team mehrere Projekte oder eigene Integrationen betreibt. Ein einzelner Test genügt nur dann als Startpunkt, nicht als Beleg für die gesamte Organisation. Wenn ein sicherheitsrelevanter Hook oder eine Zugriffsbeschränkung fehlt, halten Sie die Verbreitung an, statt das Problem durch breitere Freigaben zu umgehen.

Umstellung bis Februar 2027: Abhängigkeiten abbauen und Plan aktuell halten

Planen Sie die interne Umstellung rückwärts vom offiziell angekündigten Entfernungsfenster im Februar 2027. Da die offizielle Versionsmeldung keinen bestimmten Tag nennt, sollten Sie keinen selbst erfundenen Stichtag als VS-Code-Termin ausgeben. Legen Sie stattdessen interne Prüfpunkte fest: Inventur abgeschlossen, Testmigration bestanden, Remote-SSH-Projekte abgenommen und verbleibende Local-Abhängigkeiten einer verantwortlichen Person zugeordnet.

Prüfen Sie die offizielle Versionsmeldung und Migrationsanleitung erneut, wenn Sie den Teamplan aktualisieren. Änderungen am Entfernungstermin, an der Kompatibilität oder an Unternehmensrichtlinien können die Reihenfolge Ihrer Arbeit beeinflussen. Bis die betroffenen Projekte erfolgreich geprüft sind, behalten Sie die dokumentierte Baseline und einen nachvollziehbaren Rückfallplan bei; verwenden Sie eine alte Sitzung jedoch nicht als Ersatz für die eigentliche Migration.

Wenn Ihr Test einen stabilen macOS-Arbeitsbereich benötigt, können Sie die laufende Umgebung mit anderen Optionen vergleichen: ein vorhandener Mac vermeidet zusätzliche Mietabhängigkeit, bindet Sie aber an Verfügbarkeit, Wartung und Investition in eigene Hardware; ein Linux-Host deckt allgemeine CI-Aufgaben ab, ersetzt jedoch keine macOS-spezifischen Werkzeuge; ein kurzfristig bereitgestellter Mac kann für einen begrenzten Abnahme- oder Build-Zeitraum sinnvoll sein, sofern Zugriff und Datenschutz zu Ihrem Team passen. Für eine Remote-Mac-Option finden Sie auf der Seite zu Cloud-Mac-Angeboten in Hongkong weitere Informationen; vergleichen Sie vorab auch die Unterschiede zwischen den verfügbaren Optionen.

Eine gemietete Mac-Umgebung ist besonders dann zu prüfen, wenn Sie für Tests oder Builds zeitweise einen erreichbaren macOS-Rechner brauchen, aber keinen zusätzlichen Mac kaufen möchten. Bei dauerhaft hoher, planbarer Last oder zwingendem Bedarf an lokaler physischer Hardware kann ein eigener Rechner die passendere Lösung bleiben. Entscheidend ist, dass Ihre Copilot-harness-Migration zuerst im echten Projekt und im vorgesehenen Remote-Arbeitsbereich bestanden hat; erst danach sollte ein anderer Ausführungsort Teil des Plans werden.