Skip to main content
VS Code-Editor mit dem geöffneten Claude Code-Erweiterungspanel auf der rechten Seite, das eine Konversation mit Claude zeigt Die VS Code-Erweiterung bietet eine native grafische Benutzeroberfläche für Claude Code, die direkt in Ihre IDE integriert ist. Dies ist die empfohlene Methode, um Claude Code in VS Code zu verwenden. Mit der Erweiterung können Sie:
  • Claudes Pläne überprüfen und bearbeiten, bevor Sie sie akzeptieren
  • Bearbeitungen automatisch akzeptieren, während sie vorgenommen werden
  • Dateien mit bestimmten Zeilenbereichen aus Ihrer Auswahl per @-Erwähnung hinzufügen
  • Auf den Konversationsverlauf zugreifen
  • Mehrere Konversationen in separaten Registerkarten oder Fenstern öffnen

Voraussetzungen

Stellen Sie vor der Installation sicher, dass Sie folgende Voraussetzungen erfüllen:
  • VS Code 1.94.0 oder höher
  • Ein Anthropic-Konto: Jedes bezahlte Claude-Abonnement (Pro, Max, Team oder Enterprise) oder ein Claude Console-Konto funktioniert, und es ist kein API-Schlüssel erforderlich. Sie melden sich an mit diesem Konto an, wenn Sie die Erweiterung zum ersten Mal öffnen. Wenn Sie Claude über einen Drittanbieter wie Amazon Bedrock oder Google Cloud’s Agent Platform nutzen, siehe Drittanbieter verwenden für Setupanweisungen.
Die Erweiterung enthält eine eigene Kopie der CLI (Befehlszeilenschnittstelle) für das Chat-Panel. Um claude im integrierten Terminal von VS Code auszuführen, benötigen Sie auch die eigenständige CLI-Installation. Siehe VS Code-Erweiterung vs. Claude Code CLI für Details.

Erweiterung installieren

Klicken Sie auf den Link für Ihre IDE, um die Erweiterung direkt zu installieren: Alternativ drücken Sie in VS Code Cmd+Shift+X (Mac) oder Ctrl+Shift+X (Windows/Linux), um die Erweiterungsansicht zu öffnen, suchen nach „Claude Code“ und klicken auf Install. Die Versionsnummer der Erweiterung entspricht der Claude Code-Version, die sie enthält. Eine Funktion, die beispielsweise Claude Code v2.1.286 oder höher erfordert, benötigt Version 2.1.286 oder höher der Erweiterung, die in der Erweiterungsansicht angezeigt wird. Claude Code läuft auch in anderen Editoren und Containern:
  • Andere VS Code-Forks: Die Erweiterung lässt sich auch in Forks wie Devin Desktop oder Kiro installieren. Suchen Sie in der Erweiterungsansicht des Editors nach „Claude Code“ oder installieren Sie sie aus der Open VSX Registry.
  • Editoren, in denen die Erweiterung nicht installiert werden kann: Installieren Sie die CLI und führen Sie stattdessen claude im integrierten Terminal des Editors aus. Die CLI funktioniert in jedem Terminal.
  • Dev Container: Informationen zum Ausführen von Claude Code in einem Dev Container finden Sie unter Entwicklungscontainer.
Wenn die Erweiterung nach der Installation nicht angezeigt wird, starten Sie VS Code neu oder führen Sie „Developer: Reload Window“ über die Befehlspalette aus.

Erste Schritte

Nach der Installation können Sie Claude Code über die VS Code-Oberfläche verwenden:
1

Das Claude Code-Panel öffnen

In ganz VS Code kennzeichnet das Spark-Symbol Claude Code: Spark-SymbolAm schnellsten öffnen Sie Claude, indem Sie auf das Spark-Symbol in der Editor-Symbolleiste (obere rechte Ecke des Editors) klicken. Das Symbol erscheint nur, wenn eine Datei geöffnet ist.VS Code-Editor mit dem Spark-Symbol in der Editor-SymbolleisteWeitere Möglichkeiten, Claude Code zu öffnen:
  • Aktivitätsleiste: Klicken Sie auf das Spark-Symbol in der linken Seitenleiste, um die Sitzungsliste zu öffnen. Klicken Sie auf eine beliebige Sitzung, um sie an Ihrem bevorzugten Ort zu öffnen, oder starten Sie eine neue. Dieses Symbol ist in der Aktivitätsleiste immer sichtbar.
  • Befehlspalette: Cmd+Shift+P (Mac) oder Ctrl+Shift+P (Windows/Linux), geben Sie „Claude Code“ ein und wählen Sie eine Option wie „Open in New Tab“
  • Statusleiste: Klicken Sie auf ✻ Claude Code in der unteren rechten Ecke des Fensters. Dies funktioniert auch, wenn keine Datei geöffnet ist.
Sie können das Claude-Panel an eine beliebige Stelle in VS Code ziehen. Details finden Sie unter Workflow anpassen.
2

Anmelden

Wenn Sie das Panel zum ersten Mal öffnen, erscheint ein Anmeldebildschirm. Klicken Sie auf Sign in und schließen Sie die Autorisierung in Ihrem Browser ab.Wenn Sie später Not logged in · Please run /login sehen, öffnet die Erweiterung den Anmeldebildschirm automatisch erneut. Falls er nicht erscheint, laden Sie das Fenster über die Befehlspalette mit Developer: Reload Window neu.Wenn Sie ANTHROPIC_API_KEY in Ihrer Shell gesetzt haben, aber trotzdem die Anmeldeaufforderung sehen, hat VS Code Ihre Shell-Umgebung möglicherweise nicht übernommen. Starten Sie VS Code aus einem Terminal mit code ., damit es Ihre Umgebungsvariablen übernimmt, oder melden Sie sich stattdessen mit Ihrem Claude-Konto an.Nach der Anmeldung erscheint eine Checkliste Learn Claude Code. Arbeiten Sie die einzelnen Punkte ab, indem Sie auf Show me klicken, oder schließen Sie sie mit dem X. Um sie später erneut zu öffnen, deaktivieren Sie Hide Onboarding in den VS Code-Einstellungen unter Extensions > Claude Code.
3

Einen Prompt senden

Bitten Sie Claude um Hilfe bei Ihrem Code oder Ihren Dateien, sei es, um zu erklären, wie etwas funktioniert, ein Problem zu debuggen oder Änderungen vorzunehmen.
Claude sieht Ihren markierten Text automatisch. Drücken Sie Option+K (Mac) / Alt+K (Windows/Linux), um zusätzlich eine @-Erwähnungsreferenz (wie @file.ts#5-10) in Ihren Prompt einzufügen.
Hier ein Beispiel für eine Frage zu einer bestimmten Zeile in einer Datei:VS Code-Editor mit markierten Zeilen 2-3 in einer Python-Datei und dem Claude Code-Panel, das eine Frage zu diesen Zeilen mit einer @-Erwähnungsreferenz zeigt
4

Änderungen überprüfen

Prüfen Sie den Berechtigungsmodus, der unten im Eingabefeld angezeigt wird:
  • Im Modus Auto oder Edit automatically bearbeitet Claude die meisten Dateien in Ihrem Arbeitsbereich, ohne nachzufragen.
  • Im Modus Manual zeigt Claude, wenn es eine Datei bearbeiten möchte, einen Vergleich des Originals und der vorgeschlagenen Änderungen nebeneinander an und bittet dann um Erlaubnis. Sie können akzeptieren, ablehnen oder Claude mitteilen, was es stattdessen tun soll. Wenn Sie den vorgeschlagenen Inhalt vor dem Akzeptieren direkt in der Diff-Ansicht bearbeiten, wird Claude mitgeteilt, dass Sie ihn geändert haben, damit es nicht davon ausgeht, dass die Datei seinem ursprünglichen Vorschlag entspricht. VS Code mit einem Diff der von Claude vorgeschlagenen Änderungen und einer Berechtigungsabfrage, ob die Bearbeitung vorgenommen werden soll
Um eine vorgeschlagene Bearbeitung Änderung für Änderung zu überprüfen, verwenden Sie die Schaltflächen Accept this change und Reject this change unter jeder Änderung im Diff. Das Ablehnen einer Änderung macht sie im vorgeschlagenen Inhalt rückgängig; das Akzeptieren markiert sie als überprüft. Die Überprüfung einzelner Änderungen erfordert Claude Code v2.1.275 oder höher.Das Akzeptieren oder Ablehnen der gesamten Datei schließt die Überprüfung weiterhin ab. Ein Diff mit mehr als 100 Änderungen wird ohne die Schaltflächen für einzelne Änderungen geöffnet, überprüfen Sie ihn daher als ganze Datei.Dieselben Aktionen stehen an der Cursorposition über das Kontextmenü des Editors sowie in der Befehlspalette als Claude Code: Accept Change at Cursor und Claude Code: Reject Change at Cursor zur Verfügung.
Weitere Ideen, was Sie mit Claude Code tun können, finden Sie unter Häufige Workflows.
Führen Sie „Claude Code: Open Walkthrough“ über die Befehlspalette aus, um eine geführte Tour durch die Grundlagen zu erhalten.

Das Eingabefeld verwenden

Das Eingabefeld unterstützt mehrere Funktionen:
  • Berechtigungsmodi: Klicken Sie auf die Modusanzeige unten im Eingabefeld, um den Berechtigungsmodus zu wechseln. Ab Claude Code v2.1.283 ist Auto der integrierte Start-Berechtigungsmodus, in früheren Versionen nur in den Plänen Pro, Max und Team. Unter wie die Erweiterung den Start-Berechtigungsmodus wählt erfahren Sie, was daran etwas ändert, und finden alle Berechtigungsmodi, die die Anzeige anbietet.
    • Auto: Ein Klassifikator prüft die meisten Aktionen, anstatt Sie zu fragen. Unter Auto-Modus erfahren Sie, was er prüft und blockiert.
    • Manual: Claude fragt vor Dateibearbeitungen und den meisten Shell-Befehlen um Erlaubnis.
    • Plan: Claude beschreibt, was es tun wird, und wartet auf Ihre Genehmigung, bevor es Änderungen vornimmt. VS Code öffnet den Plan automatisch als vollständiges Markdown-Dokument, in dem Sie Inline-Kommentare hinzufügen können, um Feedback zu geben, bevor Claude beginnt. Sie können auch /plan in das Eingabefeld eingeben. Erfordert Claude Code v2.1.280 oder höher.
      • /plan: wechselt in den Plan-Modus. Wenn Sie sich bereits im Plan-Modus befinden, wird stattdessen der aktuelle Plan angezeigt.
      • /plan mit einer Aufgabe, z. B. /plan fix the auth bug: wechselt in den Plan-Modus und beginnt mit der Planung dieser Aufgabe.
      • /plan open: öffnet die Plandatei im Editor, wenn Sie sich bereits im Plan-Modus befinden.
    • Edit automatically: Claude nimmt Bearbeitungen vor, ohne nachzufragen.
  • Modell: Wählen Sie im Befehlsmenü Switch model…, um das Modell mitten in der Sitzung zu wechseln. Sie können auch auf den Modellnamen unten im Eingabefeld klicken, um dieselbe Auswahl zu öffnen. Ab Claude Code v2.1.284 öffnet auch die Eingabe von /model allein im Eingabefeld die Auswahl. Wenn das aktuelle Modell Effort-Stufen unterstützt, zeigt die Auswahl zusätzlich eine Zeile Effort an, und die Schaltfläche mit dem Modellnamen zeigt die gewählte Stufe. Wenn Sie eine andere Stufe als max wählen, speichert Claude Code sie für das aktuelle Modell als Ihren Standard unter modelSettings in Ihren Benutzereinstellungen; max gilt nur für die aktuelle Sitzung. Die Schaltfläche mit dem Modellnamen und die Zeile Effort erfordern Claude Code v2.1.257 oder höher. Wenn dynamische Workflows aktiviert sind und das aktuelle Modell dies unterstützt, erscheint unter der Zeile Effort ein Schalter Ultracode. Schalten Sie ihn ein, damit Claude für jede umfangreichere Aufgabe in dieser Sitzung einen Workflow mit der gewählten Effort-Stufe plant. Solange er eingeschaltet ist, zeigt die Schaltfläche mit dem Modellnamen nach der Stufe · Ultracode an. Der Schalter erfordert Claude Code v2.1.284 oder höher.
  • Befehlsmenü: Klicken Sie auf / oder geben Sie / ein, um das Befehlsmenü zu öffnen. Zu den Optionen gehören das Anhängen von Dateien, das Wechseln von Modellen und das Ein- und Ausschalten von Extended Thinking. Der Bereich Customize enthält Einträge wie MCP-Server, Befehle, Ausgabestile, Hooks, Memory, Anweisungen, Berechtigungen und Plugins. Einträge mit einem Terminal-Symbol werden im integrierten Terminal geöffnet.
    • Um Befehle wie /usage oder /remote-control zu durchsuchen, wählen Sie im Bereich Customize Slash commands. Ein Dialog listet sie mit einem Filterfeld auf. Wählen Sie einen aus, um ihn auszuführen. Die Eingabe von / im Eingabefeld schlägt weiterhin Befehle inline vor. Erfordert Claude Code v2.1.257 oder höher. Auch die Eingabe von /skills öffnet diesen Dialog. Jede Zeile eines Skills zeigt dessen Sichtbarkeit an, z. B. On oder Name only. Klicken Sie auf die Sichtbarkeit, um sie zu ändern, außer in Zeilen mit der Kennzeichnung locked, etwa bei Plugin-Skills. Die Verknüpfung /skills und die Sichtbarkeitssteuerung erfordern Claude Code v2.1.280 oder höher.
    • Wählen Sie im Bereich Customize Output styles, um einen Ausgabestil auszuwählen, einschließlich Ihrer benutzerdefinierten Stile. Erfordert Claude Code v2.1.257 oder höher. Um stattdessen einen benutzerdefinierten Stil zu erstellen, wählen Sie im Menü Output styles den Eintrag Build a custom style. Claude Code schreibt die Stildatei für Sie auf Projekt- oder Benutzerebene. Erfordert Claude Code v2.1.261 oder höher.
    • Wählen Sie im Bereich Customize Hooks, um die in der Sitzung geladenen Hooks nach Ereignis gruppiert anzuzeigen. Sie können Hooks hinzufügen, bearbeiten oder entfernen, die in Ihren Benutzer-, Projekt- und lokalen Einstellungsdateien gespeichert sind. Hooks aus anderen Quellen, etwa aus verwalteten Einstellungen oder Plugins, sind schreibgeschützt. Erfordert Claude Code v2.1.269 oder höher.
    • Wählen Sie im Bereich Customize Permissions, um die Berechtigungsregeln der Sitzung anzuzeigen, gruppiert in Allow, Ask und Deny. Sie können Regeln zu Ihren Benutzer-, Projekt- oder lokalen Einstellungen hinzufügen und dort gespeicherte Regeln entfernen. Regeln aus anderen Quellen, etwa aus verwalteten Einstellungen oder aus Genehmigungen, die nur für diese Sitzung erteilt wurden, sind schreibgeschützt. Erfordert Claude Code v2.1.269 oder höher.
    • Wählen Sie im Bereich Customize Memory, um Auto-Memory ein- oder auszuschalten. Solange es eingeschaltet ist, können Sie auch die von Claude gespeicherten Memorys durchsuchen und die Ordner, in denen sie gespeichert sind, in Ihrem Dateimanager anzeigen. Erfordert Claude Code v2.1.274 oder höher. Klicken Sie auf ein gespeichertes Memory, um es im Dialog zu lesen. Dort können Sie den Text bearbeiten, das Memory löschen oder seine Datei im Editor öffnen. Das Anzeigen, Bearbeiten und Löschen eines Memorys im Dialog erfordert Claude Code v2.1.275 oder höher.
    • Wählen Sie im Bereich Customize Instructions, um die CLAUDE.md-Dateien zu bearbeiten, die Claude liest. Wählen Sie eine Datei aus, um sie im Editor zu öffnen. Wenn die Datei noch nicht existiert, erstellt Claude Code sie zuerst. Erfordert Claude Code v2.1.274 oder höher.
    • Wählen Sie im Bereich Customize Status oder geben Sie /status ein, um die Claude-Code-Version, das Konto, das Modell und die MCP-Server-Details der Sitzung zu prüfen. Erfordert Claude Code v2.1.280 oder höher.
    • Wählen Sie im Bereich Customize Sandbox oder geben Sie /sandbox ein, um zu sehen, ob Claudes Bash-Befehle in einer Sandbox ausgeführt werden. Dort können Sie den Sandbox-Modus wechseln und ausgeschlossene Befehle hinzufügen. Erfordert Claude Code v2.1.280 oder höher.
    • Wählen Sie im Bereich Customize Claude in Chrome oder geben Sie /chrome ein, um die Verbindung zu Claude in Chrome zu prüfen und zu verwalten. Beides erfordert die Anmeldung mit einem claude.ai-Konto. Erfordert Claude Code v2.1.280 oder höher.
    • Wählen Sie im Bereich Context Export conversation oder geben Sie /export ein, um die Konversation als reinen Text zu kopieren oder in einer Datei zu speichern. Fügen Sie einen Dateinamen hinzu, z. B. /export notes.txt, um den Dialog zu überspringen und den Speicherort der Datei zu wählen. Erfordert Claude Code v2.1.280 oder höher.
    • Der Bereich Settings enthält Enable Remote Control for all sessions. Diese Option setzt remoteControlAtStartup und legt damit fest, ob sich neue interaktive Sitzungen automatisch mit Remote Control verbinden. Erfordert Claude Code v2.1.203 oder höher. Wenn Sie den Schalter in einem VS-Code-Fenster ein- oder ausschalten, ist die Änderung nicht auf Sitzungen beschränkt, die Sie danach starten. Sie gilt auch für die Sitzungen, die in diesem VS-Code-Fenster bereits geöffnet sind. Wenn Sie ihn ausschalten, werden die geöffneten Sitzungen getrennt. Ab Claude Code v2.1.261 wirkt sich die Änderung auch auf Sitzungen aus, die in Ihren anderen VS-Code-Fenstern geöffnet sind.
    • Der Bereich Settings enthält außerdem Focus view. Diese Ansicht blendet Tool-Aufrufe, Tool-Ergebnisse und Thinking hinter aufklappbaren Zeilen aus, sodass Ihre Prompts und Claudes Antworten übrig bleiben. Schalten Sie sie dort, mit Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux) oder über die Befehlspalette mit Claude Code: Toggle Focus view um. Die Änderung gilt für alle geöffneten Sitzungen und bleibt sitzungsübergreifend erhalten. Erfordert Claude Code v2.1.221 oder höher. Claudes neueste To-do-Liste bleibt sichtbar, ebenso der Text, auf den sich eine ausstehende Frage von Claude bezieht; dies erfordert Claude Code v2.1.225 oder höher. Während Claude Subagenten ausführt, erscheinen Live-Fortschrittszeilen mit deren neuester Aktivität unter der Gruppe von Tool-Aufrufen, die sie gestartet hat. Dies erfordert Claude Code v2.1.269 oder höher.
    • Um sich von Ihrem Anthropic-Konto abzumelden, wählen Sie im Bereich Settings Sign out oder geben Sie /logout ein. Bei einem Drittanbieter bietet das Menü keine der beiden Möglichkeiten an. Erfordert Claude Code v2.1.277 oder höher.
    • Um einen Fehler zu melden, klicken Sie unten im Menü auf Report a problem oder geben Sie /bug oder /feedback mit einer optionalen Beschreibung ein, die den Bericht vorausfüllt. Wenn Sie den Bericht absenden und über eine Erstanbieter-Verbindung bei Anthropic angemeldet sind, sendet Claude Code ihn an Anthropic. Erfordert Claude Code v2.1.229 oder höher. Bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten wird nichts gesendet. Der Dialog weist Sie darauf hin, bevor Sie schreiben. Beim Absenden wird der Bericht als lokales Archiv unter ~/.claude/feedback-bundles/ gespeichert, wobei bekannte Muster von API-Schlüsseln und Token unkenntlich gemacht werden. Das Speichern des Berichts auf Ihrem Computer erfordert Claude Code v2.1.284 oder höher. Nachdem der Bericht gespeichert wurde, nennt die Bestätigung die Datei und enthält eine Schaltfläche Show folder. Senden Sie diese Datei an Ihre Ansprechperson bei Anthropic oder hängen Sie sie an eine Supportanfrage an. Wenn die Richtlinie Ihrer Organisation Produktfeedback deaktiviert, erscheint Report a problem nicht im Menü, und /bug und /feedback zeigen anstelle des Berichts den Hinweis Feedback is turned off by your organization's policy or this environment's settings. an. Ab Claude Code v2.1.284 ist Feedback auch dann deaktiviert, wenn Sie die Umgebungsvariable DISABLE_FEEDBACK_COMMAND oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC setzen, und beim Öffnen des Berichts wird stattdessen dieser Hinweis angezeigt.
  • Nebenfragen: Geben Sie /btw gefolgt von einer Frage ein, um etwas zu Ihrer Sitzung zu fragen, ohne es der Konversation hinzuzufügen. Die Antwort öffnet sich in einem Panel neben dem Chat, in dem Sie Folgefragen stellen können. Erfordert Claude Code v2.1.227 oder höher. Der Thread bleibt beim Neuladen des Fensters erhalten. Claude Code behält die neuesten 20 Wortwechsel und lässt gespeicherte Threads gemäß dem Zeitplan von cleanupPeriodDays ablaufen, sofern Claude Code den Aufbewahrungszeitraum sicher bestimmen kann. Um einen Thread zu löschen, klicken Sie im Panel auf das Papierkorbsymbol.
  • Eine Antwort kopieren: Fahren Sie mit der Maus über eine Antwort und klicken Sie auf Copy response, um sie in Ihre Zwischenablage zu kopieren, oder geben Sie /copy ein, um die neueste Antwort zu kopieren. /copy 2 kopiert die vorletzte. Erfordert Claude Code v2.1.277 oder höher.
  • Lesezeichen: Fahren Sie mit der Maus über eine Antwort und klicken Sie auf Bookmark response, um sie zu speichern, oder klicken Sie bei einer gespeicherten Antwort auf Remove bookmark, um sie zu entfernen. Um gespeicherte Antworten anzusehen, öffnen Sie das Panel Bookmarks. Sie können oben im Claude-Code-Panel auf das Lesezeichensymbol klicken, im Bereich Context des Befehlsmenüs Bookmarks wählen oder /bookmarks eingeben. Erfordert Claude Code v2.1.286 oder höher.
  • Dateien, die Claude Ihnen sendet: Wenn die Sitzung mit Remote Control verbunden ist und Claude Ihnen mit dem Tool SendUserFile Dateien sendet, zeigt die Konversation eine Zeile wie Sent report.md, chart.png an. Klicken Sie auf den Namen einer Datei, um sie im Editor zu öffnen.
  • Kontextanzeige: Das Eingabefeld zeigt an, wie viel von Claudes Kontextfenster Sie nutzen. Claude komprimiert bei Bedarf automatisch, oder Sie können /compact manuell ausführen.
  • Prompt-Cache-Uhr: Ein Uhrsymbol neben der Kontextanzeige schätzt, wie viel Zeit dem Prompt-Cache der Konversation bis zum Ablauf noch bleibt. Es zählt von der fünfminütigen oder einstündigen Lebensdauer des Caches herunter, und jede Antwort, die den Cache nutzt, startet den Countdown neu. Abgesehen von der Komprimierung setzen die Aktionen, die den Cache ungültig machen, die Uhr nicht zurück, sodass sie nach einem Modellwechsel noch verbleibende Minuten anzeigen kann.
    • Bis der Countdown abgelaufen ist, zeigt das Symbol die verbleibenden Minuten an, z. B. 12m.
    • Wenn der Countdown abgelaufen ist, verschwinden die Minuten, und das Symbol wird bis zur nächsten Antwort rot bzw. in der Fehlerfarbe Ihres Designs angezeigt. Der Cache ist wahrscheinlich abgelaufen, daher ist bei Ihrer nächsten Nachricht mit einer langsameren, teureren Antwort zu rechnen, während der Cache neu aufgebaut wird. Wenn die fünfminütige Lebensdauer zwischen Ihren Nachrichten wiederholt abläuft, lesen Sie Die TTL selbst wählen.
    • Direkt nachdem die Konversation komprimiert wurde, wird das Symbol bis zur nächsten Antwort ebenfalls rot und ohne Minuten angezeigt, da der Cache die komprimierte Konversation noch nicht abdeckt.
  • Agentenübersicht: Wenn die Konversation Subagenten enthält, erscheint unten im Eingabefeld eine Agentenanzahl wie 2 agents. Ihr Punkt zeigt an, ob ein Subagent arbeitet oder auf Ihre Berechtigung wartet. Klicken Sie auf die Agentenanzahl, um die Agentenübersicht zu öffnen. Sie stellt die Subagenten der Konversation als Baum unter dem Hauptagenten dar, jeweils mit Status, verstrichener Zeit und Token-Anzahl. Klicken Sie auf einen Subagenten, um seinen Prompt und seine Tool-Aufrufe zu sehen, sein schreibgeschütztes Transkript zu öffnen oder ihn während der Ausführung zu stoppen. Erfordert Claude Code v2.1.269 oder höher. Die Übersicht listet unterhalb der Agenten auch die anderen Hintergrundaufgaben der Sitzung auf, etwa Shell-Befehle im Hintergrund und Monitore. Klicken Sie auf eine Zeile, um die Karte der Aufgabe zu öffnen und sie dort zu stoppen. Um die Übersicht zu öffnen, wenn keine Agentenanzahl angezeigt wird, etwa wenn Claude eine Hintergrund-Shell, aber keine Subagenten gestartet hat, geben Sie /tasks in das Eingabefeld ein. Hintergrundaufgaben in der Übersicht und die Eingabe von /tasks erfordern Claude Code v2.1.277 oder höher. Ab Claude Code v2.1.286 endet der aktuelle Turn, wenn Sie auf Stop klicken oder Esc drücken. Hintergrundagenten laufen weiter, bis sie fertig sind oder Sie sie in der Übersicht stoppen.
  • Extended Thinking: ermöglicht es Claude, sich mehr Zeit für das Durchdenken komplexer Probleme zu nehmen. Schalten Sie es über das Befehlsmenü (/) ein. Claudes Überlegungen erscheinen in der Konversation als eingeklappte Blöcke: Klicken Sie auf einen Block, um ihn zu lesen, oder drücken Sie Ctrl+O, um alle Thinking-Blöcke der Sitzung auf- oder zuzuklappen. Details finden Sie unter Extended Thinking.
  • Mehrzeilige Eingabe: Drücken Sie Shift+Enter, um eine neue Zeile hinzuzufügen, ohne zu senden. Dies funktioniert auch in der Freitexteingabe „Other“ von Fragedialogen.

Auf Dateien und Ordner verweisen

Verwenden Sie @-Erwähnungen, um Claude Kontext zu bestimmten Dateien oder Ordnern zu geben. Wenn Sie @ gefolgt von einem Datei- oder Ordnernamen eingeben, liest Claude diesen Inhalt und kann Fragen dazu beantworten oder Änderungen daran vornehmen. Claude Code unterstützt unscharfe Suche (Fuzzy Matching), sodass Sie Teilnamen eingeben können, um das Gesuchte zu finden:
Bei großen PDFs können Sie Claude bitten, bestimmte Seiten statt der ganzen Datei zu lesen. Fragen Sie nach einer einzelnen Seite, einem Bereich wie Seite 1–10 oder einem offenen Bereich wie ab Seite 3. Das Lesen bestimmter Seiten erfordert poppler-utils auf dem Rechner, auf dem Claude Code läuft. Wenn Sie im Editor Text auswählen, kann Claude Ihren markierten Code automatisch sehen. Die Fußzeile des Eingabefelds zeigt an, wie viele Zeilen ausgewählt sind. Drücken Sie Option+K (Mac) / Alt+K (Windows/Linux), um eine @-Erwähnung mit Dateipfad und Zeilennummern einzufügen, zum Beispiel @app.ts#5-10. Klicken Sie auf das X an der Auswahlanzeige, um sie zu entfernen, damit Claude die Auswahl nicht erhält. Die Anzeige erscheint wieder, wenn Sie anderen Text auswählen. Die Erweiterung hält ausgewählten Text aus manchen Dateien zurück:
  • Wenn sich die Datei in Ihrem Arbeitsbereich befindet und Ihren Einstellungen files.exclude oder search.exclude entspricht, erhält Claude höchstens den Pfad der Datei, nicht aber den von Ihnen ausgewählten Text.
  • Dasselbe gilt für eine Datei, die Git ignoriert, sofern sowohl die VS-Code-Einstellung search.useIgnoreFiles als auch die Einstellung respectGitIgnore der Erweiterung aktiviert sind, was standardmäßig der Fall ist.
Dieser Filter gilt nur für das Chat-Panel. Wenn Claude Code im integrierten Terminal läuft, sendet die CLI Ihren ausgewählten Text unabhängig von der Datei. Um den Inhalt einer Datei dort vor Claude zu verbergen, fügen Sie eine deny-Regel für Read hinzu. Claude sieht außerdem, welche Datei Sie im Editor geöffnet haben, auch wenn nichts ausgewählt ist, und das Eingabefeld zeigt ihren Namen an. Um nur Ihren ausgewählten Text hinzuzufügen, deaktivieren Sie die Einstellung Attach Open File. Die Einstellung erfordert Claude Code v2.1.271 oder höher. Sie können Ihrer Nachricht auch Bilder und Dateien anhängen:
  • Um ein Bild anzuhängen, fügen Sie es aus Ihrer Zwischenablage in das Eingabefeld ein.
  • Um Dateien anzuhängen, halten Sie Shift gedrückt, während Sie sie in das Eingabefeld ziehen.
  • Um einen Anhang aus dem Kontext zu entfernen, klicken Sie auf das X daran.

Terminal-Ausgabe in Prompts einbeziehen

Verweisen Sie in Ihren Prompts mit @terminal:name auf Terminal-Ausgaben, wobei name der Titel des Terminals ist. So kann Claude Befehlsausgaben, Fehlermeldungen oder Logs sehen, ohne dass Sie sie kopieren und einfügen müssen.

Text einfügen

Text, den Sie einfügen, bleibt im Eingabefeld sichtbar, anstatt wie im Terminal zu einem Platzhalter zusammengeklappt zu werden. In Sitzungen, in denen Claude Code eingefügten Text kennzeichnet, sieht Claude einen großen eingefügten Text weiterhin als eingefügten und nicht als getippten Text. Claude Code entfernt außerdem unsichtbare Unicode-Zeichen aus Text, den Sie in das Eingabefeld einfügen, und aus allem anderen, was Sie senden:
  • Wenn beim Einfügen ein Hinweis wie Removed 3 invisible characters from the pasted text erscheint, wurde der Text ohne diese Zeichen übernommen.
  • Wenn beim Senden ein Hinweis zu entfernten Zeichen erscheint, wurde nichts gesendet. Der bereinigte Text steht wieder im Eingabefeld. Senden Sie erneut, um den Text wie angezeigt zu senden.

LaTeX-Mathematik in Antworten

Das Chat-Panel zeigt LaTeX-Mathematik in Claudes Antworten als gesetzte Formeln an. Die Darstellung mathematischer Formeln erfordert Claude Code v2.1.301 oder höher. Im Terminal-Modus werden Formeln nicht gesetzt. Das Panel setzt sowohl abgesetzte als auch Inline-Formeln:
  • Abgesetzte Formeln: ein Block $$ … $$ oder \[ … \] auf einer oder mehreren eigenen Zeilen sowie ein umzäunter Codeblock mit math als Sprache
  • Inline-Formeln: $…$ oder \(…\), das auf derselben Zeile geöffnet und geschlossen wird, z. B. $E = mc^2$ oder \(a^2 + b^2 = c^2\)
Das Panel versucht, Mathematik von anderen Verwendungen derselben Zeichen zu unterscheiden, sodass Text wie $HOME, ein Preis wie $5 oder sed 's/\(foo\)/\1/' nicht gesetzt wird. Ebenso wenig Text innerhalb eines Code-Spans oder innerhalb eines Codeblocks, der kein umzäunter math-Block ist. Wenn eine Formel unverändert angezeigt wird, obwohl Sie sie gesetzt erwartet haben, lesen Sie Eine Formel wird als unformatiertes LaTeX angezeigt. Wenn Sie Text auswählen und kopieren, der eine gesetzte Formel enthält, erhalten Sie den TeX-Quelltext der Formel in den Begrenzern $…$ oder $$…$$ statt der gezeichneten Symbole. Copy response und /copy liefern Ihnen die Antwort so, wie Claude sie geschrieben hat, einschließlich des TeX-Quelltexts.

Frühere Konversationen fortsetzen

Klicken Sie oben im Claude-Code-Panel auf die Schaltfläche Session history, um auf Ihren Konversationsverlauf zuzugreifen. Sie können nach Stichwörtern suchen oder nach Zeit durchblättern. Klicken Sie auf eine beliebige Konversation, um sie mit dem vollständigen Nachrichtenverlauf fortzusetzen. Wenn die Konversation bereits in einem anderen Tab des aktuellen Fensters geöffnet ist, wechselt ein Klick zu diesem Tab. Wenn die Nachrichten zunächst leer bleiben, lesen Sie, warum sie leer sind und wann sie erscheinen. Weitere Informationen zum Fortsetzen von Sitzungen finden Sie unter Sitzungen verwalten.
  • Sitzungstitel: Neue Sitzungen erhalten KI-generierte Titel auf Basis Ihrer ersten Nachricht.
  • Umbenennen und archivieren: Fahren Sie mit der Maus über eine Sitzung, um diese Aktionen anzuzeigen. Benennen Sie sie um, um ihr einen aussagekräftigen Titel zu geben, oder archivieren Sie sie, um sie in die Gruppe Archived sessions am Ende der Liste zu verschieben.
Wenn die Konversation in einem anderen Claude-Code-Prozess geöffnet ist, etwa claude in einem Terminal oder in einem anderen VS-Code-Fenster, erscheint anstelle des Eingabefelds dieser Hinweis:
Um hier fortzufahren, schließen Sie die Konversation an der anderen Stelle und klicken Sie dann auf Open here anyway. Wenn Sie klicken, ohne sie zu schließen, ist die Konversation an beiden Stellen geöffnet. Wenn claudeProcessWrapper gesetzt ist, überspringt die Erweiterung diese Prüfung und öffnet die Konversation direkt. Standardmäßig wird eine Sitzung ohne Aktivität seit 14 Tagen automatisch nach Archived sessions verschoben, sofern sie nicht geöffnet, ungelesen oder in einer Gruppe ist. Die automatische Archivierung erfordert Claude Code v2.1.265 oder höher. Um den Zeitraum zu ändern oder die Funktion zu deaktivieren, öffnen Sie die Einstellung Archive Inactive Sessions und wählen Sie eine Anzahl von Tagen oder Never. So stellen Sie archivierte Sitzungen wieder her:
  • Eine Sitzung: Klappen Sie Archived sessions auf und klicken Sie auf Unarchive session.
  • Alle archivierten Sitzungen auf einmal: Fahren Sie in der Sitzungsliste in der Aktivitätsleiste mit der Maus über die Überschrift Archived sessions und klicken Sie auf deren Symbol zum Wiederherstellen. Erfordert Claude Code v2.1.277 oder höher.
Vor v2.1.257 lautete die Aktion Delete session. Sie blendete eine Sitzung aus, ohne dass sie wiederhergestellt werden konnte. Sitzungen, die Sie damals gelöscht haben, erscheinen nach dem Upgrade unter Archived sessions. Wenn die Konversation, die Sie fortsetzen, im Plan-Modus endete, stellt Claude Code den Plan-Modus wieder her. Erfordert Claude Code v2.1.246 oder höher. In diesen Fällen stellt Claude Code ihn nicht wieder her:

Cloud-Sitzungen von claude.ai fortsetzen

Wenn Sie Cloud-Sitzungen ausführen, können Sie diese direkt in VS Code fortsetzen. Dazu müssen Sie sich mit Claude.ai Subscription anmelden, nicht mit der Anthropic Console.
1

Sitzungsverlauf öffnen

Klicken Sie oben im Claude-Code-Panel auf die Schaltfläche Session history.
2

Den Tab Web auswählen

Der Dialog zeigt zwei Tabs: Local und Web. Klicken Sie auf Web, um Sitzungen von claude.ai zu sehen.
3

Eine Sitzung zum Fortsetzen auswählen

Durchblättern oder durchsuchen Sie die Sitzungen. Klicken Sie auf eine, um die Konversation lokal fortzusetzen.
Wenn der geöffnete Ordner ein GitHub-Repository ist, zeigt der Tab Web nur Sitzungen aus diesem Repository an.Wenn Sie eine Cloud-Sitzung fortsetzen, lädt die Erweiterung eine Kopie des Konversationsverlaufs herunter; Änderungen werden nicht zurück zu claude.ai synchronisiert.
Der Tab Web listet auch Ihre Remote-Control-Sitzungen auf. Wenn Sie auf eine klicken, die im geöffneten Ordner lief, öffnet die Erweiterung diese lokale Konversation, anstatt eine Kopie herunterzuladen. Die Erweiterung fokussiert den Tab, der sie bereits anzeigt, sofern es einen gibt. Wenn die Erweiterung nicht ausschließen kann, dass ein anderer Claude-Prozess die Konversation geöffnet hat, erhalten Sie stattdessen eine heruntergeladene Kopie. Wenn ein Teil einer Konversation nicht heruntergeladen werden kann, erscheint ein Fehler, und es wird keine Kopie gespeichert. Wählen Sie die Sitzung erneut aus, um es erneut zu versuchen. Wenn Sie eine Sitzung auswählen, für die noch keine Konversation zum Herunterladen vorhanden ist, teilt Ihnen ein Fehler mit, wo Sie sie stattdessen fortsetzen können.

Konto und Nutzung prüfen

Führen Sie /usage aus, um den Dialog Account & usage zu öffnen, der Ihr angemeldetes Konto und Ihre Nutzung anzeigt. Die Nutzungsangaben hängen davon ab, wie Sie sich angemeldet haben:
  • claude.ai-Plan: Nutzungsbalken für die Limits Ihres Plans, etwa für die aktuelle Sitzung und die Woche. Jeder Balken zeigt an, wie lange es dauert, bis sein Limit zurückgesetzt wird. Der Dialog schlüsselt außerdem auf, was zu Ihren Plan-Limits beiträgt. Er kennzeichnet Verhaltensweisen, die 10 % oder mehr der jüngsten Nutzung ausmachen, etwa Cache-Misses, langen Kontext sowie Sitzungen mit vielen Subagenten oder hoher Parallelität. Zu jeder gekennzeichneten Verhaltensweise gibt es einen Tipp, wie Sie sie reduzieren können. Zuordnungstabellen zeigen, wie viel Nutzung auf jeden Skill, Subagenten, jedes Plugin und jeden MCP-Server entfiel. Verwenden Sie den Umschalter Day/Week, um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Angaben sind Näherungswerte und werden aus lokalen Sitzungen auf diesem Rechner berechnet, sodass Nutzung auf anderen Geräten oder auf claude.ai nicht enthalten ist.
  • Andere Anmeldungen: Wenn für Ihre Anmeldung keine Plan-Limits gelten, etwa bei einem Drittanbieter oder mit einem API-Schlüssel, zeigt der Abschnitt Usage stattdessen die Kosten und die Token-Nutzung der Sitzung selbst an. Der /usage-Befehl der CLI zeigt dieselben Summen in seinem Session-Block an. Die Sitzungsliste in der Aktivitätsleiste zeigt die Summen der aktiven Sitzung ebenfalls unter ihrer Überschrift Account & usage an. Erfordert Claude Code v2.1.277 oder höher.
Weitere Informationen zum Verfolgen und Reduzieren der Nutzung finden Sie unter Kosten verfolgen.

Mit Checkpoints zurückspulen

Die VS-Code-Erweiterung unterstützt Checkpoints, die Claudes Dateibearbeitungen nachverfolgen und es Ihnen ermöglichen, zu einem früheren Zustand zurückzuspulen. Fahren Sie mit der Maus über eine beliebige Nachricht, um die Schaltfläche zum Zurückspulen anzuzeigen, und wählen Sie dann eine von drei Optionen:
  • Fork conversation from here: einen neuen Konversationszweig ab dieser Nachricht starten und dabei alle Codeänderungen beibehalten
  • Rewind code to here: Dateiänderungen auf diesen Punkt in der Konversation zurücksetzen und dabei den vollständigen Konversationsverlauf beibehalten
  • Fork conversation and rewind code: einen neuen Konversationszweig starten und Dateiänderungen auf diesen Punkt zurücksetzen
Ausführliche Informationen zur Funktionsweise von Checkpoints und ihren Einschränkungen finden Sie unter Checkpointing.

Ihren Workflow anpassen

Sie können das Claude-Panel neu positionieren, mehrere Konversationen ausführen, die Sitzungsliste gruppieren oder filtern oder in den Terminalmodus wechseln.

Festlegen, wo Claude angezeigt wird

Sie können das Claude-Panel per Drag-and-drop an eine beliebige Stelle in VS Code verschieben. Greifen Sie den Tab oder die Titelleiste des Panels und ziehen Sie es an eine dieser Stellen:
  • Sekundäre Seitenleiste: die rechte Seite des Fensters. Claude bleibt sichtbar, während Sie programmieren.
  • Primäre Seitenleiste: die linke Seitenleiste mit Symbolen für Explorer, Suche usw.
  • Editorbereich: öffnet Claude als Tab neben Ihren Dateien. Nützlich für Nebenaufgaben.
Wenn Claude einen Tab in einer neuen Editorgruppe öffnet, sperrt die Erweiterung diese Gruppe. Dateien, die Sie öffnen, während der Claude-Tab fokussiert ist, landen dann in einer anderen Gruppe statt daneben. Um zu verhindern, dass die Erweiterung Gruppen sperrt, deaktivieren Sie die Einstellung Lock Editor Groups. Bereits gesperrte Gruppen bleiben gesperrt, bis Sie sie entsperren. Die Einstellung erfordert Claude Code v2.1.274 oder höher.
Verwenden Sie die Seitenleiste für Ihre Haupt-Claude-Sitzung und öffnen Sie zusätzliche Tabs für Nebenaufgaben. Claude merkt sich Ihren bevorzugten Ort. Das Symbol der Sitzungsliste in der Aktivitätsleiste ist vom Claude-Panel getrennt. Die Sitzungsliste ist in der Aktivitätsleiste immer sichtbar, während das Symbol des Claude-Panels dort nur erscheint, wenn das Panel in der linken Seitenleiste angedockt ist.

Konversationen nach einem Neuladen fortsetzen

Nachdem Sie Developer: Reload Window ausgeführt oder VS Code neu gestartet haben, prüfen Sie, wo die Konversation geöffnet war:
  • Editor-Tab: Die Konversation kehrt mit ihrem Tab zurück.
  • Seitenleiste: Die Konversation kehrt zurück, wenn Sie darin innerhalb der letzten 10 Minuten eine Nachricht gesendet haben oder Claude geantwortet hat. Falls sie nicht zurückkehrt, setzen Sie die Konversation über den Sitzungsverlauf fort.
Wenn ein anderer Claude Code-Prozess die Konversation noch geöffnet hat, werden Sie gefragt, bevor sie hier geöffnet wird, mit demselben Hinweis Open here anyway wie beim Fortsetzen aus dem Sitzungsverlauf. Wenn die Nachrichten zunächst leer bleiben, lesen Sie, warum sie leer sind und wann sie erscheinen.

Unterbrochene Schritte nach einem Neuladen

Wenn das Neuladen Claude mitten in einem Schritt unterbrochen hat, setzt Claude diesen Schritt fort, sobald die Konversation zurückkehrt, und ein Hinweis im Chat kennzeichnet die Fortsetzung. Erfordert Claude Code v2.1.274 oder höher. Wenn der Schritt vor mehr als einer Stunde unterbrochen wurde oder die Sitzung an anderer Stelle geöffnet ist, kehrt die Konversation stattdessen im Leerlauf zurück.

Fortsetzung nach einem Neuladen ausschalten

Um zu verhindern, dass Claude einen unterbrochenen Schritt nach einem Neuladen fortsetzt, öffnen Sie die Einstellung Continue After Reload und deaktivieren Sie das Kontrollkästchen. Wenn Sie CLAUDE_CODE_RESUME_INTERRUPTED_TURN oder eine andere CLAUDE_CODE_RESUME_-Variable in der Umgebung von VS Code oder in der Einstellung environmentVariables setzen, hat dies im Panel keine Wirkung. Das liegt daran, dass die Erweiterung diese Variablen entfernt, bevor sie die Sitzungen des Panels startet.

Eine Konversation wurde nicht erneut geöffnet

Wenn nach einem Neuladen ein neuer Chat mit einem Hinweis wie diesem über dem Eingabefeld erscheint, hat das Panel Ihre Konversation geschlossen gelassen, weil die letzten beiden Öffnungsvorgänge der Konversation nicht abgeschlossen wurden:
Ein Öffnungsvorgang wird nicht abgeschlossen, wenn das Panel beim Laden der Konversation abstürzt oder nicht mehr reagiert oder wenn Sie das Fenster innerhalb von etwa drei Sekunden nach dem Öffnen neu laden oder schließen. Die Konversation bleibt unverändert und ist weiterhin im Sitzungsverlauf verfügbar.
  • Um sie trotzdem zu öffnen: Klicken Sie auf Open it anyway oder wählen Sie die Konversation im Sitzungsverlauf aus. Wenn sie sich öffnet und das Panel weiter funktioniert, kehrt sie bei späteren Neuladevorgängen wie gewohnt zurück. Wenn das Panel erneut nicht mehr reagiert, laden Sie das Fenster neu, um zu einem neuen Chat mit dem Hinweis zurückzukehren.
  • Um sie geschlossen zu lassen: Arbeiten Sie im neuen Chat weiter. Der Hinweis verschwindet, sobald Sie einen Prompt senden.

Mehrere Konversationen ausführen

Verwenden Sie Open in New Tab oder Open in New Window aus der Befehlspalette, um zusätzliche Konversationen zu starten. Jede Konversation behält ihren eigenen Verlauf und Kontext, sodass Sie parallel an verschiedenen Aufgaben arbeiten können. Bei der Verwendung von Tabs zeigt ein kleiner farbiger Punkt auf dem Funkensymbol den Status an: Blau bedeutet, dass eine Berechtigungsanfrage aussteht, Orange bedeutet, dass Claude fertig ist, während der Tab ausgeblendet war.

Sitzungen in Gruppen organisieren

In der Sitzungsliste in der Aktivitätsleiste können Sie zusammengehörige Sitzungen in benannten, einklappbaren Gruppen sammeln. Erfordert Claude Code v2.1.229 oder höher.
  • Sitzung gruppieren oder aus der Gruppe entfernen: Klicken Sie mit der rechten Maustaste auf eine Sitzung, um daraus eine Gruppe zu erstellen, sie in eine bestehende Gruppe zu verschieben oder sie aus ihrer Gruppe zu entfernen. Jede Sitzung gehört jeweils nur zu einer Gruppe; wenn Sie sie also in eine andere Gruppe verschieben, wird sie aus der ersten entfernt.
  • Mehrere Sitzungen gleichzeitig verschieben: Klicken Sie mit Cmd (Mac) / Ctrl (Windows/Linux) auf jede Sitzung oder mit Shift, um einen Bereich auszuwählen, und klicken Sie dann mit der rechten Maustaste auf die Auswahl.
  • Sitzung über ihren Tab gruppieren: Führen Sie Claude Code: Add Session Tab to Group aus der Befehlspalette aus und wählen oder erstellen Sie dann eine Gruppe. Erfordert Claude Code v2.1.257 oder höher.
  • Gruppe umbenennen oder löschen: Klicken Sie mit der rechten Maustaste auf eine Gruppenüberschrift. Beim Löschen einer Gruppe wird nur die Gruppe entfernt, und ihre Sitzungen kehren in die Liste der nicht gruppierten Sitzungen zurück.
Die Erweiterung speichert Gruppen pro Arbeitsbereichsordner, sodass sie das Neuladen des Fensters überstehen und in jedem Fenster erscheinen, in dem Sie denselben Ordner öffnen. Wenn Sie die Liste durchsuchen, zeigt die Erweiterung Treffer aus allen Gruppen in einer einzigen flachen Liste an.

Die Sitzungsliste filtern

Um eine lange Sitzungsliste in der Aktivitätsleiste einzugrenzen, verwenden Sie die beiden Filtersteuerelemente oben in der Liste. Erfordert Claude Code v2.1.271 oder höher. Archivierte Sitzungen werden nicht angezeigt, solange einer der Filter aktiv ist.
  • Active: Schalten Sie diesen Umschalter ein, um nur Sitzungen anzuzeigen, die Ihre Eingabe benötigen, gerade arbeiten oder ungelesen sind, sowie die Sitzung in dem Claude-Tab, den Sie zuletzt fokussiert haben.
  • Nach Status filtern: Klicken Sie auf das Trichtersymbol und aktivieren Sie dann Needs input, Working oder Completed, um Sitzungen in einem dieser Zustände anzuzeigen. Aktivieren Sie Open oder Closed, um danach einzugrenzen, ob eine Sitzung geöffnet ist. Eine Sitzung gilt als geöffnet, wenn sie in diesem Fenster einen Tab hat oder in einem anderen Claude Code-Prozess auf diesem Rechner läuft, etwa in einem Terminal.
Wenn Active eingeschaltet ist und Sie einen Status, Open oder Closed aktivieren, zeigt die Liste zusätzlich jede Sitzung an, die Ihrer Auswahl entspricht. Die von Ihnen gesetzten Filter bleiben über das Neuladen des Fensters hinweg erhalten.

In den Terminalmodus wechseln

Standardmäßig öffnet die Erweiterung ein grafisches Chat-Panel. Wenn Sie die CLI-ähnliche Oberfläche bevorzugen, öffnen Sie die Einstellung Use Terminal und aktivieren Sie das Kontrollkästchen. Sie können auch Cmd+, auf dem Mac oder Ctrl+, unter Windows/Linux drücken, um die VS Code-Einstellungen zu öffnen, zu Extensions > Claude Code navigieren und Use Terminal aktivieren.

Plugins verwalten

Die VS Code-Erweiterung enthält eine grafische Oberfläche zum Installieren und Verwalten von Plugins. Geben Sie /plugins in das Eingabefeld ein, um die Oberfläche Manage plugins zu öffnen.

Plugins installieren

Der Plugin-Dialog zeigt zwei Tabs: Plugins und Marketplaces. Im Tab „Plugins“:
  • Installierte Plugins erscheinen oben mit Schaltern, um sie zu aktivieren oder zu deaktivieren.
    • Wenn Sie ein Plugin ausschalten, das die gemeinsam genutzte .claude/settings.json Ihres Projekts einschaltet, fragt die Erweiterung zuerst nach: Disable for me schaltet es nur für Sie aus, während Disable for everyone die gemeinsam genutzte Datei ändert.
    • Ein Plugin, das nicht geladen werden konnte, zeigt in seiner Zeile einen kurzen Grund an. Klicken Sie auf den Grund, um zu sehen, was Sie dagegen tun können, einschließlich des Kopierens der vollständigen Fehlermeldung, um sie unter Fehlerbehebung bei Plugins nachzuschlagen.
  • Verfügbare Plugins aus Ihren konfigurierten Marketplaces erscheinen darunter
  • Suchen Sie, um Plugins nach Name oder Beschreibung zu filtern
  • Klicken Sie bei einem verfügbaren Plugin auf Install
Wenn Sie ein Plugin installieren, wählen Sie den Installationsgeltungsbereich:
  • Install for you: in allen Ihren Projekten verfügbar (Benutzer-Geltungsbereich)
  • Install for this project: mit Projektmitwirkenden geteilt (Projekt-Geltungsbereich)
  • Install locally: nur für Sie, nur in diesem Repository (lokaler Geltungsbereich)
Sobald die Installation abgeschlossen ist, fragt ein Formular nach allen Konfigurationsoptionen des Plugins, die noch nicht gesetzt sind. Um die Optionen später zu überprüfen oder zu ändern, klicken Sie auf das Zahnradsymbol in der Zeile des Plugins. Sensible Textfelder werden maskiert, und ein zuvor gespeichertes Secret zeigt (unchanged) an. Lassen Sie das Feld leer, um den gespeicherten Wert beizubehalten. Nachdem Sie Änderungen gespeichert haben, laden die geöffneten Sitzungen ihre Plugins neu, und der Dialog zeigt Restart Claude to apply plugin changes an.

Plugins deinstallieren

Jede installierte Zeile nennt den Geltungsbereich, in dem das Plugin installiert ist. Um diese Installation zu deinstallieren, klicken Sie auf das Papierkorbsymbol der Zeile. Ein abgeblendetes Papierkorbsymbol kennzeichnet eine Zeile, die Sie in diesem Arbeitsbereich nicht deinstallieren können, etwa ein Plugin, das Ihre Organisation verwaltet, oder eines, das für ein anderes Projekt installiert wurde. Die Erweiterung fragt in zwei Fällen zuerst nach:
  • Ein Plugin, das die gemeinsam genutzte .claude/settings.json Ihres Projekts einschaltet: Wählen Sie Disable for me, wodurch das Plugin für Ihre Mitwirkenden installiert bleibt, oder Uninstall for everyone, wodurch die Installation des Projekts mit --keep-data entfernt wird, sodass das Verzeichnis mit den gespeicherten Daten des Plugins erhalten bleibt. Wenn Sie das Plugin bereits für sich selbst ausgeschaltet haben, entfernt das Papierkorbsymbol Ihre eigene Installation ohne Nachfrage.
  • Andernfalls die letzte Installation eines Plugins mit gespeicherten Daten: Wählen Sie, ob die Daten behalten oder gelöscht werden sollen; Keep ist die Standardeinstellung
Um jemanden direkt zur Installation eines bestimmten Plugins zu führen, geben Sie ihm die install-plugin-URL der Erweiterung. Das Öffnen der URL startet VS Code oder holt es in den Vordergrund, öffnet das Claude Code-Panel und öffnet den Dialog Manage plugins bei der Auswahl des Geltungsbereichs für dieses Plugin. Es wird nichts installiert, bis die Person einen Geltungsbereich auswählt. Wenn der Marketplace des Plugins in ihrem Claude Code noch nicht konfiguriert ist, fordert der Dialog sie zuerst auf, ihn hinzuzufügen.
Die URL akzeptiert zwei Abfrageparameter: Die Erweiterung prüft beide Werte, bevor sie etwas öffnet:
  • Plugin-Name: höchstens 100 Zeichen, beginnend mit einem ASCII-Buchstaben oder einer Ziffer und ansonsten nur aus ASCII-Buchstaben, Ziffern, ., _ und - bestehend.
  • Marketplace-Quelle: nur die Formen, die der Parameter marketplace aufführt, also kein lokaler Pfad, keine http://-Adresse und nicht der Name des Marketplace, wie etwa claude-plugins-official. Eine https://-URL darf keinen Benutzernamen, kein Passwort und keinen Query-String enthalten.
  • Git-Ref: Um den Marketplace auf einen Branch oder Tag festzulegen, hängen Sie die Ref nach %23, der codierten Form von #, an die Quelle an, wie in marketplace=owner/repo%23v1.0. Ein Link mit einem nicht codierten # schlägt fehl. Marketplaces in der GitHub-Organisation anthropics können in einem Link nicht festgelegt werden.
Wer einen Link öffnet, der gegen diese Regeln verstößt, sieht einen Fehler, der mit Invalid plugin installation URL beginnt. Das Claude Code-Panel und der Dialog öffnen sich nicht, und es wird nichts installiert. Wenn der Name oder der Marketplace Ihres Plugins nicht in einen Link passt, weisen Sie die Leute an, den Marketplace im Tab Marketplaces hinzuzufügen und das Plugin dann im Tab Plugins zu installieren. In diesen Fällen endet der Vorgang mit einer Meldung im Dialog statt bei der Auswahl des Geltungsbereichs:
  • Der Marketplace führt kein Plugin mit diesem Namen auf: Der Dialog meldet, dass das Plugin nicht gefunden wurde. Gleichen Sie den Wert von plugin mit der Liste des Marketplace ab.
  • Das Plugin ist bereits installiert: Der Dialog weist darauf hin, und es ändert sich nichts.
  • Ein anderer Marketplace mit demselben Namen ist bereits hinzugefügt: Der Dialog meldet, dass der Marketplace des Links nicht hinzugefügt wurde, und es wird nichts installiert.
GitHub-READMEs, Issues und einige andere Markdown-Hosts entfernen Links, deren Schema nicht http oder https ist, sodass ein vscode://-Link dort als reiner Text dargestellt wird. Setzen Sie die URL auf diesen Hosts in einen Codeblock, wie es Der Link wird als reiner Text statt als anklickbarer Link dargestellt für claude-cli://-Links beschreibt.

Marketplaces verwalten

Wechseln Sie zum Tab Marketplaces, um Plugin-Quellen hinzuzufügen oder zu entfernen:
  • Geben Sie ein GitHub-Repository, eine URL oder einen lokalen Pfad ein, um einen neuen Marketplace hinzuzufügen
  • Klicken Sie auf das Aktualisierungssymbol, um die Plugin-Liste eines Marketplace zu aktualisieren
  • Klicken Sie auf das Papierkorbsymbol, um einen Marketplace zu entfernen. Das Entfernen deinstalliert jedes Plugin, das Sie daraus installiert haben, daher nennt eine Bestätigung zuerst diese Plugins
Plugin-Änderungen, die Sie im Dialog vornehmen, gelten sofort für die Claude Code-Sitzungen, die in diesem VS Code-Fenster geöffnet sind. Wenn die Sitzung, aus der Sie den Dialog geöffnet haben, ihre Plugins nicht neu laden kann, bietet der Dialog an, es erneut zu versuchen oder Claude in dieser Sitzung neu zu starten.
Die Erweiterung verwaltet Plugins, indem sie dieselben Befehle wie die CLI ausführt. Plugins und Marketplaces, die Sie in der Erweiterung konfigurieren, sind auch in der CLI verfügbar und umgekehrt.
Weitere Informationen zum Plugin-System finden Sie unter Plugins und Plugin-Marketplaces.

Plugins, die im Panel zeichnen

Ein Plugin, das einen Mod enthält, kann im Chat-Panel zeichnen. Das Zeichnen erfordert die Erweiterungsversion 2.1.299 oder höher und eine Sitzung, die Feature-Flags abruft. Von einem solchen Plugin können Sie Folgendes sehen:
  • Einen Bereich neben der Konversation oder über dem Eingabefeld
  • Eine Toast-Benachrichtigung oder eine Statuszeile über dem Eingabefeld
  • Eine Nachricht oder einen Tool-Aufruf, die auf die eigene Weise des Plugins gezeichnet werden
Wenn ein von Ihnen installiertes Plugin etwas im Panel hinzufügt oder ändert, nennt eine Beschriftung es, mit Formulierungen wie diesen:
  • From the token-chart plugin: Das Plugin hat dies gezeichnet oder ausgegeben, oder diese Karte ist das Plugin, das Sie etwas fragt
  • Edited by the token-chart plugin: Das Plugin hat etwas geändert, das Claude Code zeichnet, etwa einen Tool-Aufruf
  • Prompt from the token-chart plugin: Das Plugin hat diese Nachricht in Ihrem Namen gesendet
Um zu verhindern, dass ein Plugin zeichnet, schalten Sie das Plugin im Plugin-Dialog aus.

Browser-Aufgaben mit Chrome automatisieren

Verbinden Sie Claude mit Ihrem Chrome-Browser, um Web-Apps zu testen, mithilfe von Konsolen-Logs zu debuggen und Browser-Workflows zu automatisieren, ohne VS Code zu verlassen. Dazu ist die Claude in Chrome-Erweiterung in Version 1.0.36 oder höher erforderlich. Geben Sie @browser in das Prompt-Feld ein, gefolgt von dem, was Claude tun soll:
Sie können auch das Anhangsmenü öffnen, um bestimmte Browser-Tools auszuwählen, etwa zum Öffnen eines neuen Tabs oder zum Lesen von Seiteninhalten. Claude öffnet für Browser-Aufgaben neue Tabs und teilt den Anmeldestatus Ihres Browsers, sodass Claude auf jede Website zugreifen kann, bei der Sie bereits angemeldet sind. Weitere Informationen zur Arbeit mit dem Browser finden Sie hier:

Mit git arbeiten

Claude Code ist in git integriert, um Versionskontroll-Workflows direkt in VS Code zu unterstützen. Bitten Sie Claude, Änderungen zu committen, Pull Requests zu erstellen oder über Branches hinweg zu arbeiten. Um Claude in einem isolierten Worktree mit eigenen Dateien und Branch zu starten, siehe Parallele Sitzungen mit Worktrees ausführen.

Commits und Pull Requests erstellen

Claude kann Änderungen bereitstellen, Commit-Nachrichten schreiben und Pull Requests basierend auf Ihrer Arbeit erstellen:
Beim Erstellen von Pull Requests generiert Claude Beschreibungen basierend auf den tatsächlichen Code-Änderungen und kann Kontext zu Tests oder Implementierungsentscheidungen hinzufügen.

Arbeit im Hintergrund ausführen

Schicken Sie einen lang laufenden Befehl oder Subagenten in den Hintergrund und überprüfen Sie ihn dann über das Eingabefeld.

Einen laufenden Befehl oder Subagenten in den Hintergrund verschieben

Wenn ein Befehl oder ein Subagent Claude länger warten lässt, als Sie möchten, klicken Sie in der Konversation unter dessen Tool-Aufruf auf Run in background. Erfordert Claude Code v2.1.287 oder höher.
  • Zeitpunkt: Die Aktion erscheint, sobald ein Befehl etwa zwei Sekunden lang läuft, oder sobald ein Subagent startet.
  • Nach dem Klicken: Claude wartet nicht mehr und setzt den Turn fort. Der Befehl oder Subagent läuft als Hintergrundaufgabe weiter, die Claude benachrichtigt, wenn sie abgeschlossen ist.
Um die Aufgabe in der Zwischenzeit zu überprüfen oder zu stoppen, geben Sie /tasks in das Eingabefeld ein, um die Agentenübersicht zu öffnen. Ein Subagent behält dort seinen Platz im Baum der Agenten, und ein Befehl wird unterhalb der Agenten mit seiner neuesten Ausgabe auf seiner Karte aufgeführt.

Hintergrundprozesse überwachen

Geben Sie /tasks in das Eingabefeld ein, um die Agentenübersicht zu öffnen. Diese listet die Hintergrundaufgaben der Sitzung auf, etwa einen Entwicklungsserver, den Claude als Shell-Befehl im Hintergrund laufen gelassen hat. Klicken Sie auf eine Aufgabe, um ihre Karte zu öffnen, auf der Sie sie stoppen können. Erfordert Claude Code v2.1.277 oder höher. Bei einem Shell-Befehl im Hintergrund oder einem Monitor, der einen Befehl ausführt, zeigt die Karte außerdem die neueste Ausgabe des Befehls an und aktualisiert sie, während der Befehl läuft.

VS Code-Befehle und Tastenkombinationen

Um die Befehlspalette zu öffnen, drücken Sie Cmd+Shift+P auf dem Mac oder Ctrl+Shift+P unter Windows/Linux. Geben Sie dort „Claude Code“ ein, um alle verfügbaren VS Code-Befehle für die Claude Code-Erweiterung anzuzeigen. Einige Tastenkombinationen hängen davon ab, welcher Bereich „fokussiert“ ist (also die Tastatureingaben empfängt). Wenn sich Ihr Cursor in einer Codedatei befindet, ist der Editor fokussiert. Wenn sich Ihr Cursor im Prompt-Feld von Claude befindet, ist Claude fokussiert. Verwenden Sie Cmd+Esc / Ctrl+Esc, um zwischen beiden zu wechseln.
Dies sind VS Code-Befehle zur Steuerung der Erweiterung. Nicht alle integrierten Claude Code-Befehle sind in der Erweiterung verfügbar. Weitere Informationen finden Sie unter VS Code-Erweiterung vs. Claude Code CLI.

Einen VS Code-Tab aus anderen Tools starten

Die Erweiterung registriert einen URI-Handler unter vscode://anthropic.claude-code/open. Damit können Sie einen neuen Claude Code-Tab aus Ihren eigenen Tools heraus öffnen: einem Shell-Alias, einem Browser-Bookmarklet oder einem beliebigen Skript, das eine URL öffnen kann. Wenn VS Code noch nicht läuft, wird es beim Öffnen der URL zuerst gestartet. Wenn VS Code bereits läuft, wird die URL in dem Fenster geöffnet, das gerade fokussiert ist. Rufen Sie den Handler mit dem URL-Öffner Ihres Betriebssystems auf.
Der Handler akzeptiert zwei optionale Abfrageparameter: Um beispielsweise einen Tab zu öffnen, der mit „review my changes“ vorausgefüllt ist:
Die Erweiterung verarbeitet außerdem vscode://anthropic.claude-code/install-plugin, was den Plugin-Dialog für ein einzelnes Plugin öffnet. Um statt eines VS Code-Tabs eine Terminalsitzung zu starten, verwenden Sie den claude-cli://-Handler der CLI. Siehe Sitzungen über Links starten.

Einstellungen konfigurieren

Sie konfigurieren die Erweiterung an zwei Stellen, in den Erweiterungseinstellungen von VS Code und in der Einstellungsdatei von Claude Code:
  • Erweiterungseinstellungen in VS Code: steuern das Verhalten der Erweiterung innerhalb von VS Code. Öffnen Sie sie mit Cmd+, (Mac) oder Ctrl+, (Windows/Linux) und gehen Sie dann zu Extensions > Claude Code. Sie können auch / eingeben und General config… auswählen, um die Einstellungen zu öffnen.
  • Claude Code-Einstellungen in ~/.claude/settings.json: werden von der Erweiterung und der CLI gemeinsam genutzt. Verwenden Sie sie für erlaubte Befehle, Umgebungsvariablen, Hooks und MCP-Server. Ab Claude Code v2.1.283 sind sie außerdem einer der Faktoren für den Berechtigungsmodus, in dem Konversationen starten; in früheren Versionen gilt dies nur für die Pläne Pro, Max und Team. Berechtigungsmodi wechseln listet die Reihenfolge auf. Details finden Sie unter Einstellungen.
Fügen Sie "$schema": "https://json.schemastore.org/claude-code-settings.json" zu Ihrer settings.json hinzu, um Autovervollständigung und Inline-Validierung für alle verfügbaren Einstellungen direkt in VS Code zu erhalten.

Erweiterungseinstellungen

VS Code liest initialPermissionMode aus Ihren Benutzereinstellungen und ignoriert Werte aus dem Arbeitsbereich. Vor v2.1.225 setzte VS Code die Einstellung standardmäßig auf default und wendete Werte aus dem Arbeitsbereich an.

Drittanbieter verwenden

Standardmäßig verbindet sich Claude Code direkt mit der API von Anthropic. Wenn Ihre Organisation Amazon Bedrock, die Agent Platform von Google Cloud oder Microsoft Foundry für den Zugriff auf Claude verwendet, konfigurieren Sie die Erweiterung stattdessen für Ihren Anbieter:
1

Anmeldeaufforderung deaktivieren

Öffnen Sie die Einstellung „Disable Login Prompt“ und aktivieren Sie das Kontrollkästchen.Sie können auch Cmd+, auf dem Mac oder Ctrl+, unter Windows/Linux drücken, um die VS Code-Einstellungen zu öffnen, nach „Claude Code login“ suchen und Disable Login Prompt aktivieren.
2

Anbieter konfigurieren

Folgen Sie der Einrichtungsanleitung für Ihren Anbieter:Diese Anleitungen beschreiben die Konfiguration Ihres Anbieters in ~/.claude/settings.json, wodurch Ihre Einstellungen zwischen der VS Code-Erweiterung und der CLI geteilt werden.
Bei einem Drittanbieter bietet die Erweiterung keine Funktionen, die ein claude.ai-Konto erfordern, wie etwa Balken zur Plannutzung, Sprachdiktat und den Web-Tab für Cloud-Sitzungen. Was der Dialog „Account & usage“ bei diesen Anmeldungen anzeigt, erfahren Sie unter Konto und Nutzung prüfen. Eine claude.ai-Anmeldung, die von einem früheren /login übrig geblieben ist, bleibt ungenutzt: Die Erweiterung sendet sie bei keiner Anfrage mit.

Einen Screenreader verwenden

Das Chat-Panel der Erweiterung funktioniert mit Screenreadern. Sie müssen nichts einschalten: Die Erweiterung kündigt Aktivitäten in der Konversation für alle Benutzer an, ohne sichtbare Änderung. Dies ist unabhängig vom optional aktivierbaren Screenreader-Modus der CLI, der die Terminal-Oberfläche anpasst. Die Screenreader-Unterstützung im Chat-Panel erfordert Claude Code v2.1.236 oder neuer. Während einer Konversation kündigt die Erweiterung Folgendes an:
  • Antworten von Claude: Die Erweiterung kündigt jede Antwort einmal an, sobald sie vollständig ist, und bleibt still, während der Text gestreamt wird. Ihr Screenreader liest Codeblöcke als Zusammenfassung der Zeilenanzahl vor, liest Links anhand ihrer Beschriftung und liest Tabellen Zelle für Zelle vor; die vollständige Antwort bleibt im Transkript lesbar.
  • Berechtigungsanfragen und Fragen: Die Erweiterung kündigt eine Anfrage an, wenn ihre Berechtigungsabfrage erscheint, und nennt dabei das Tool, das Claude verwenden möchte. Auf dieselbe Weise erfolgt eine Ankündigung, wenn Claude Ihnen eine Frage stellt und wenn Claude einen Plan fertigstellt und auf Ihre Prüfung wartet.
  • Statusänderungen: Die Erweiterung kündigt an, wenn Claude mit der Arbeit beginnt, wenn Claude für Ihre Eingabe bereit ist und wenn Claude Code mit dem Komprimieren der Konversation beginnt.
  • Nachrichten in der Warteschlange: Wenn Sie eine Nachricht senden, während Claude arbeitet, kündigt die Erweiterung für diese Nachricht „Message queued.“ an.
  • Fehler und Modellabfragen: Die Erweiterung kündigt Fehler in der Konversation an und kündigt an, wenn die Zustimmungsabfrage für Nutzungsguthaben oder die Abfrage für markierte Anfragen erscheint.
Während Claude arbeitet, liest Ihr Screenreader anstelle der Animation des Fortschrittsindikators eine Textbeschriftung vor. Wenn Sie eine Sitzung erneut öffnen oder zu einer anderen wechseln, kündigt die Erweiterung nichts an: Wiederhergestellter Verlauf, ausstehende Berechtigungsabfragen und laufender Status bleiben still, bis etwas Neues passiert.

Das Chat-Panel per Tastatur verwenden

Jeder Turn im Transkript beginnt mit einer visuell ausgeblendeten Überschrift, die mit dem Prompt beschriftet ist, der den Turn gestartet hat. Verwenden Sie die Überschriftennavigation Ihres Screenreaders, um zwischen Turns zu springen. Innerhalb eines Turns kündigt Ihr Screenreader beim Durchgehen an, wessen Nachricht Sie gerade lesen:
  • Ihre Nachrichten: „You“
  • Nachrichten von Claude: „Claude“
  • Tool-Schritte: „Claude“ plus der Tool-Name, zum Beispiel „Claude, Bash“
  • Thinking-Blöcke: „Claude, thinking“
Da die Erweiterung das Transkript als beschrifteten Bereich bereitstellt, können Sie den Fokus auch mit Tab auf das Transkript selbst verschieben und es in Ihrem eigenen Tempo lesen. Um den Fokus stattdessen auf die neueste Nachricht oder eine wartende Berechtigungsabfrage zu verschieben, führen Sie Claude Code: Focus last message über die Befehlspalette aus. Wenn eine Option einer Berechtigungsabfrage eine Berechtigungsregel oder einen Verzeichniszugriff speichert, endet ihre Beschriftung mit der Angabe, wo die Genehmigung gespeichert wird, zum Beispiel „all projects“ oder „this session“. So ändern Sie das Ziel:
  • Drücken Sie bei fokussierter Option die Pfeiltaste Left oder Right. Die Erweiterung kündigt jedes Ziel an, während Sie dorthin wechseln. Die Pfeiltasten erfordern Claude Code v2.1.268 oder neuer.
  • Klicken Sie in der Beschriftung auf das Ziel.

VS Code-Erweiterung vs. Claude Code CLI

Claude Code ist sowohl als VS Code-Erweiterung (grafisches Panel) als auch als CLI (Befehlszeilenschnittstelle im Terminal) verfügbar. Einige Funktionen sind nur in der CLI verfügbar. Wenn Sie eine Funktion benötigen, die nur in der CLI verfügbar ist, führen Sie claude im integrierten Terminal von VS Code aus. Dies erfordert die eigenständige CLI-Installation: Die Erweiterung fügt claude nicht zu Ihrem PATH hinzu. Siehe CLI in VS Code ausführen.

CLI in VS Code ausführen

Um die CLI zu verwenden, ohne VS Code zu verlassen, drücken Sie Ctrl+` unter Windows/Linux oder Cmd+` auf dem Mac, um das integrierte Terminal zu öffnen, und führen Sie dann claude aus. Die CLI integriert sich automatisch in Ihre IDE, um Funktionen wie die Diff-Ansicht und das Teilen von Diagnosen bereitzustellen. Wenn Sie ein externes Terminal verwenden, führen Sie /ide innerhalb von Claude Code aus, um es mit VS Code zu verbinden. Durch die Installation der Erweiterung wird claude nicht in den PATH Ihrer Shell aufgenommen. Die Erweiterung enthält eine private Kopie der CLI für ihr Chat-Panel, aber um claude in einem Terminal einzugeben, ist die eigenständige CLI-Installation erforderlich. Führen Sie die Installation einmal durch, und die Befehle auf dieser Seite, einschließlich claude mcp add und claude --resume, funktionieren in jedem Terminal. Wenn claude nach der Installation weiterhin nicht gefunden wird, überprüfen Sie Ihren PATH.

Zwischen Erweiterung und CLI wechseln

Die Erweiterung und die CLI teilen sich denselben Konversationsverlauf. Um eine Konversation aus der Erweiterung in der CLI fortzusetzen, führen Sie claude --resume im Terminal aus. Dadurch wird eine interaktive Auswahl geöffnet, in der Sie nach Ihrer Konversation suchen und diese auswählen können.

Mit MCP eine Verbindung zu externen Tools herstellen

MCP-Server (Model Context Protocol) geben Claude Zugriff auf externe Tools, Datenbanken und APIs. Um MCP-Server zu verwalten, ohne VS Code zu verlassen, geben Sie /mcp im Chat-Panel ein. In dem sich öffnenden Dialog können Sie:
  • Server hinzufügen
  • Server entfernen, die im lokalen, Benutzer- oder Projekt-Geltungsbereich gespeichert sind
  • Server aktivieren oder deaktivieren
  • Erneut eine Verbindung zu einem Server herstellen
  • Die OAuth-Authentifizierung verwalten
Das Hinzufügen und Entfernen von Servern im Dialog erfordert Claude Code v2.1.261 oder höher. Sie können auch claude mcp add im integrierten Terminal von VS Code ausführen (Ctrl+` oder Cmd+`). Der Dialog und der Terminal-Befehl speichern in dieselbe MCP-Konfiguration, und Änderungen aus beiden wirken sich auf Konversationen aus, die Sie danach starten. Das folgende Beispiel fügt den Remote-MCP-Server von GitHub hinzu, der sich mit einem als Header übergebenen Personal Access Token authentifiziert:
Ersetzen Sie YOUR_GITHUB_PAT durch Ihr Personal Access Token. Der Befehl claude mcp add speichert die Konfiguration, ohne die Anmeldedaten zu validieren. Ein Platzhalterwert wird hier also akzeptiert, doch der Server kann später keine Verbindung herstellen. Um die Verbindung zu überprüfen, starten Sie eine neue Konversation, geben Sie /mcp ein und prüfen Sie, ob der Server Connected anzeigt. Ein Server mit fehlerhaften Anmeldedaten zeigt Failed an. Nach der Konfiguration können Sie Claude bitten, die Tools zu verwenden (zum Beispiel „Review PR #456“).
Informationen zum Finden von Servern, mit denen Sie sich verbinden können, finden Sie unter MCP-Server finden und erstellen.

Der integrierte IDE-MCP-Server

Wenn die Erweiterung aktiv ist, betreibt sie einen lokalen MCP-Server, mit dem sich die CLI automatisch verbindet. Über diesen Server führt die CLI Folgendes aus:
  • Sie öffnet Diffs im nativen Diff-Viewer von VS Code
  • Sie liest Ihre aktuelle Auswahl für @-Erwähnungen
  • Sie fordert VS Code auf, Zellen auszuführen, wenn Sie in einem Jupyter-Notebook arbeiten
Der Server heißt ide und ist in /mcp ausgeblendet, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen PreToolUse-Hook verwendet, um MCP-Tools per Allowlist freizugeben, müssen Sie wissen, dass er existiert. Auswahl- und Kontext der geöffneten Datei. Solange eine Verbindung besteht, fügt die CLI jedem Prompt, den Sie senden, Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext hinzu. Das Transkript zeigt in diesem Fall eine Zeile ⧉ Selected N lines from <file> an. Die folgenden Fälle ändern diesen Kontext:
  • Nachrichten in der Warteschlange: Wenn Sie eine Nachricht in die Warteschlange stellen, während Claude arbeitet, behält sie die Auswahl bei, die Sie beim Drücken von Enter hatten, unabhängig davon, was Sie danach auswählen.
  • Sensible Dateien: Um eine sensible Datei wie .env auszuschließen, fügen Sie eine Read-deny-Regel für ihren Pfad hinzu. Eine passende deny-Regel verhindert, dass sowohl der ausgewählte Text als auch der Hinweis auf die geöffnete Datei für diese Datei Claude erreichen.
  • Attach Open File ausgeschaltet: Wenn Sie die Einstellung Attach Open File ausschalten, erhält die CLI den Pfad der aktiven Datei nur, während Sie darin Text ausgewählt haben.
Transport und Authentifizierung. Der Server bindet sich an 127.0.0.1 auf einem zufälligen Port im Bereich 10000–65535, und der Port ist nicht konfigurierbar. Transport und Auth-Token funktionieren wie folgt:
  • Transport: unverschlüsseltes ws://. Da der Socket nur über Loopback erreichbar ist, kann jeder Prozess, der den Datenverkehr mitschneiden könnte, das Token auch aus der Lock-Datei lesen, sodass TLS keinen zusätzlichen Schutz bieten würde.
  • Auth-Token: Jede Aktivierung der Erweiterung erzeugt ein neues zufälliges Auth-Token und schreibt es in eine Lock-Datei unter ~/.claude/ide/<port>.lock. Die CLI muss das Token als Header X-Claude-Code-Ide-Authorization vorlegen, um eine Verbindung herzustellen.
  • Berechtigungen der Lock-Datei: Die Lock-Datei hat die Berechtigungen 0600 in einem Verzeichnis mit 0700, sodass nur der Benutzer, der VS Code ausführt, sie lesen kann. Wenn CLAUDE_CONFIG_DIR gesetzt ist, wird die Lock-Datei stattdessen nach $CLAUDE_CONFIG_DIR/ide/ geschrieben.
Für das Modell verfügbare Tools. Der Server stellt ein Dutzend Tools bereit, aber nur zwei sind für das Modell sichtbar. Der Rest sind interne RPCs, die die CLI für ihre eigene Benutzeroberfläche verwendet, etwa zum Öffnen von Diffs, Lesen von Auswahlen und Speichern von Dateien. Sie werden herausgefiltert, bevor die Tool-Liste Claude erreicht. Diagnosen im Chat-Panel. Im Chat-Panel liest Claude ab Claude Code v2.1.285 das Problems-Panel von VS Code über einen separaten integrierten Server namens claude-vscode. Claude kann ihn nach den aktuellen Fehlern und Warnungen in einer Datei oder in allen Dateien abfragen, für die VS Code Diagnosen hat. Hooks und Berechtigungsregeln sehen das Diagnose-Tool des Chat-Panels als mcp__claude-vscode__getDiagnostics. Um Diagnosen sowohl in der CLI als auch im Chat-Panel abzudecken, nennen Sie in Ihrem Hook oder Ihrer Regel sowohl mcp__ide__getDiagnostics als auch mcp__claude-vscode__getDiagnostics. Dieses settings.json-Beispiel verweigert beide Tools:
Eine Read-deny-Regel deckt keines der beiden Tools ab. Blockieren Sie sie daher wie im Beispiel namentlich mit einer deny-Regel. Jupyter-Ausführung fragt immer zuerst nach. mcp__ide__executeCode kann nichts unbemerkt ausführen. Jeder Aufruf durchläuft diese Schritte:
  1. Der Code wird als neue Zelle am Ende des aktiven Notebooks eingefügt.
  2. VS Code scrollt die Zelle in den sichtbaren Bereich.
  3. Ein natives Quick Pick fragt Sie, ob Sie Execute oder Cancel wählen.
Ein Abbruch oder das Schließen der Auswahl mit Esc gibt einen Fehler an Claude zurück, und nichts wird ausgeführt. Das Tool verweigert die Ausführung außerdem von vornherein, wenn kein Notebook aktiv ist, wenn die Jupyter-Erweiterung (ms-toolsai.jupyter) nicht installiert ist oder wenn der Kernel nicht Python ist.
Die Quick-Pick-Bestätigung ist unabhängig von PreToolUse-Hooks. Ein Allowlist-Eintrag für mcp__ide__executeCode erlaubt Claude, das Ausführen einer Zelle vorzuschlagen; erst das Quick Pick in VS Code lässt sie tatsächlich ausführen.

Häufige Probleme beheben

Fehler bei Anmeldung, Netzwerk und Start haben eigene Einträge auf den Seiten zur Fehlerbehebung bei der Installation und zur Fehlerreferenz. Suchen Sie in der Tabelle, was Sie sehen, und folgen Sie dann dem Link.

Erweiterung lässt sich nicht installieren

  • Stellen Sie sicher, dass Sie eine kompatible Version von VS Code (1.94.0 oder höher) verwenden
  • Prüfen Sie, ob VS Code die Berechtigung zum Installieren von Erweiterungen hat
  • Versuchen Sie, die Erweiterung direkt über den VS Code Marketplace zu installieren

Spark-Symbol nicht sichtbar

Das Spark-Symbol erscheint in der Editor-Symbolleiste (oben rechts im Editor), wenn eine Datei geöffnet ist. Falls Sie es nicht sehen:
  1. Öffnen Sie eine Datei: Für das Symbol muss eine Datei geöffnet sein. Nur einen Ordner geöffnet zu haben, reicht nicht aus.
  2. Prüfen Sie die VS Code-Version: Erforderlich ist 1.94.0 oder höher. Prüfen Sie dies unter Hilfe > Info
  3. Starten Sie VS Code neu: Führen Sie „Developer: Reload Window“ über die Befehlspalette aus
  4. Deaktivieren Sie in Konflikt stehende Erweiterungen: Deaktivieren Sie vorübergehend andere KI-Erweiterungen (Cline, Continue usw.)
  5. Prüfen Sie die Arbeitsbereichsvertrauensstellung: Die Erweiterung funktioniert nicht im eingeschränkten Modus
Alternativ können Sie auf ✻ Claude Code in der Statusleiste unten rechts im Fenster klicken. Dies funktioniert auch ohne geöffnete Datei. Sie können auch die Befehlspalette (Cmd+Shift+P / Ctrl+Shift+P) verwenden und „Claude Code“ eingeben.

Cmd+Esc bewirkt unter macOS nichts

Unter macOS Tahoe und neuer ist die System-Tastenkombination für das Game Overlay standardmäßig auf Cmd+Esc gelegt und fängt den Tastendruck ab, bevor er VS Code erreicht. So geben Sie die Tastenkombination frei:
  1. Öffnen Sie die Systemeinstellungen
  2. Gehen Sie zu Tastatur, dann Tastaturkurzbefehle, dann Gamecontroller
  3. Deaktivieren Sie das Kontrollkästchen für das Game Overlay
Alternativ können Sie der Erweiterung eine andere Taste zuweisen: Öffnen Sie den Editor für Tastenkombinationen von VS Code (Cmd+K Cmd+S), suchen Sie nach Claude Code: Focus input und weisen Sie eine neue Tastenkombination zu.

Eine fortgesetzte Konversation ist zunächst leer

Wenn Sie eine frühere Konversation fortsetzen oder eine Konversation nach einem Neuladen wiederhergestellt wird, können ihre Nachrichten leer bleiben, während der Claude Code-Prozess der Konversation startet. Nach etwa einer Sekunde erscheint Waiting for your plugins… im leeren Bereich. Sie müssen nichts tun. Die Nachrichten erscheinen, sobald der Prozess gestartet ist und bestätigt hat, dass kein Plugin sie zuerst prüfen muss, oder nach 20 Sekunden, falls der Start länger dauert.

Das Panel reagiert nicht mehr, jedes Mal wenn ein Neuladen eine Konversation wieder öffnet

Wenn das gesamte Panel abstürzt, einfriert oder nur Something went wrong anzeigt, jedes Mal wenn Sie neu laden und Ihre Konversation wiederhergestellt wird, aktualisieren Sie die Erweiterung auf v2.1.301 oder höher. Laden Sie dann das Fenster erneut neu oder starten Sie VS Code erneut. Nachdem das Öffnen der Konversation zweimal hintereinander nicht abgeschlossen werden konnte, erhalten Sie stattdessen einen neuen Chat mit einem Hinweis, dass sie nicht wieder geöffnet wurde.

Eine Formel wird als roher LaTeX-Code angezeigt

Wenn keine der mathematischen Formeln in Claudes Antworten gesetzt wird, prüfen Sie die Version der Erweiterung in der Erweiterungsansicht, da die Darstellung mathematischer Formeln Version 2.1.301 oder höher erfordert. Wenn Sie den Terminalmodus verwenden, der unabhängig von der Version keine Formeln setzt, deaktivieren Sie die Einstellung „Use Terminal“, damit Claude Code stattdessen im Chat-Panel geöffnet wird. Wenn eine Formel so angezeigt wird, wie sie geschrieben ist, während andere in ihrer Nähe gesetzt werden, prüfen Sie sie auf folgende Ursachen:
  • Sie wird als etwas anderes als Mathematik gelesen: $…$-Text, der wie ein Wort gelesen wird, bleibt so, wie er geschrieben ist, etwa $O(n log n)$. $…$-Text, der mit einer Ziffer beginnt, etwa $30$ oder $1/N$, bleibt ebenfalls so, wie er geschrieben ist, es sei denn, ein Zeichen wie =, + oder ^ kennzeichnet ihn als Mathematik. Bitten Sie Claude stattdessen um einen $$-Block in eigenen Zeilen, den das Panel ohne diese Prüfung setzt.
  • Sie enthält Leerzeichen, ist lang oder über mehrere Zeilen verteilt: $ x^2 $ mit Leerzeichen innerhalb der Dollarzeichen, $…$-Inhalte mit mehr als 60 Zeichen sowie $…$ oder \(…\), die über zwei Zeilen verteilt sind, werden nicht gesetzt. Bitten Sie Claude stattdessen um einen $$-Block in eigenen Zeilen, für den keine dieser Einschränkungen gilt.
  • Der TeX-Code kann nicht gesetzt werden: Eine Formel mit einem Syntaxfehler, einer Makrodefinition wie \newcommand oder \def oder einem nicht maskierten % wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, sie mit korrigiertem Fehler, ohne das Makro oder mit \% für ein Prozentzeichen neu zu schreiben.
  • Sie ist zu groß: Eine Formel mit mehr als 8.192 Zeichen oder eine, die weit größer dargestellt würde als ihr Quelltext, wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, sie in kleinere Formeln aufzuteilen oder kompakter zu schreiben.
  • Sie folgt auf eine große Menge Mathematik: Innerhalb eines Textblocks in einer Antwort setzt das Panel Formeln der Reihe nach bis zu einer Obergrenze. Eine spätere Formel, die diese Grenze überschreiten würde, wird so angezeigt, wie sie geschrieben ist. Bitten Sie Claude, die benötigte Formel noch einmal einzeln zu senden.

Claude Code antwortet nie

Wenn Claude Code nicht auf Ihre Prompts reagiert:
  1. Prüfen Sie Ihre Internetverbindung: Stellen Sie sicher, dass Sie eine stabile Internetverbindung haben
  2. Starten Sie eine neue Konversation: Versuchen Sie, eine neue Konversation zu beginnen, um zu sehen, ob das Problem weiterhin besteht
  3. Probieren Sie die CLI aus: Führen Sie claude im Terminal aus, um zu sehen, ob Sie detailliertere Fehlermeldungen erhalten
Wenn die Probleme weiterhin bestehen, erstellen Sie ein Issue auf GitHub mit Details zum Fehler.

Erweiterung deinstallieren

So deinstallieren Sie die Claude Code-Erweiterung:
  1. Drücken Sie Cmd+Shift+X auf dem Mac oder Ctrl+Shift+X unter Windows/Linux, um die Erweiterungsansicht zu öffnen
  2. Suchen Sie nach „Claude Code“
  3. Klicken Sie auf Uninstall
Wenn Sie claude in einem integrierten Terminal von VS Code ausführen, installiert Claude Code die Erweiterung automatisch neu. Damit sie deinstalliert bleibt, schalten Sie Auto-install IDE extension in /config aus oder setzen Sie autoInstallIdeExtension auf false. Sie können auch die Umgebungsvariable CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL auf 1 setzen. Um zusätzlich die Daten der Erweiterung zu entfernen und alle Einstellungen zurückzusetzen, löschen Sie das Speicherverzeichnis der Erweiterung für Ihre Plattform. Unter macOS:
Unter Linux:
Unter Windows in PowerShell:
Weitere Hilfe finden Sie im Leitfaden zur Fehlerbehebung.

Nächste Schritte

Nachdem Sie Claude Code in VS Code eingerichtet haben: