
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.
Erweiterung installieren
Klicken Sie auf den Link für Ihre IDE, um direkt zu installieren: Oder drücken Sie in VS CodeCmd+Shift+X (Mac) oder Ctrl+Shift+X (Windows/Linux), um die Ansicht „Erweiterungen“ zu öffnen, suchen Sie nach „Claude Code“ und klicken Sie auf Installieren.
Die Versionsnummer der Erweiterung entspricht der darin enthaltenen Claude Code-Version. Beispielsweise benötigt eine Funktion, die Claude Code v2.1.286 oder höher voraussetzt, Version 2.1.286 oder höher der Erweiterung, die in der Ansicht „Erweiterungen“ angezeigt wird.
Die Erweiterung wird auch in anderen VS Code-Forks wie Devin Desktop oder Kiro installiert. Suchen Sie nach „Claude Code“ in der Ansicht „Erweiterungen“ des Editors, oder installieren Sie aus der Open VSX-Registrierung. Wenn Ihr Editor die Erweiterung nicht installieren kann, installieren Sie die CLI und führen Sie claude in dessen integriertem Terminal aus. Die CLI funktioniert in jedem Terminal.
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“ aus der Befehlspalette aus.
Erste Schritte
Nach der Installation können Sie Claude Code über die VS Code-Oberfläche verwenden:1
Öffnen Sie das Claude Code-Panel
In VS Code zeigt das Spark-Symbol Claude Code an: 
Der schnellste Weg, Claude zu öffnen, ist, auf das Spark-Symbol in der Editor-Symbolleiste (obere rechte Ecke des Editors) zu klicken. Das Symbol wird nur angezeigt, wenn Sie eine Datei geöffnet haben.
Weitere Möglichkeiten zum Öffnen von Claude Code:

- 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 immer in der Aktivitätsleiste sichtbar.
- Befehlspalette:
Cmd+Shift+P(Mac) oderCtrl+Shift+P(Windows/Linux), geben Sie „Claude Code“ ein und wählen Sie eine Option wie „In neuem Tab öffnen“ - Statusleiste: Klicken Sie auf ✻ Claude Code in der unteren rechten Ecke des Fensters. Dies funktioniert auch, wenn keine Datei geöffnet ist.
2
Melden Sie sich an
Wenn Sie das Panel zum ersten Mal öffnen, wird ein Anmeldungsbildschirm angezeigt. Klicken Sie auf Anmelden und schließen Sie die Autorisierung in Ihrem Browser ab.Wenn Sie später Nicht angemeldet · Bitte führen Sie /login aus sehen, öffnet die Erweiterung den Anmeldungsbildschirm automatisch erneut. Wenn dieser nicht angezeigt wird, laden Sie das Fenster aus der Befehlspalette mit Developer: Reload Window neu.Wenn Sie
ANTHROPIC_API_KEY in Ihrer Shell gesetzt haben, aber immer noch die Anmeldungsaufforderung sehen, hat VS Code möglicherweise Ihre Shell-Umgebung nicht geerbt. Starten Sie VS Code von einem Terminal aus mit code ., damit es Ihre Umgebungsvariablen erbt, oder melden Sie sich stattdessen mit Ihrem Claude-Konto an.Nach der Anmeldung wird eine Learn Claude Code-Checkliste angezeigt. Arbeiten Sie jedes Element durch, indem Sie auf Show me klicken, oder schließen Sie es mit dem X. Um es später erneut zu öffnen, deaktivieren Sie Hide Onboarding in den VS Code-Einstellungen unter Extensions → Claude Code.3
Senden Sie einen Prompt
Bitten Sie Claude, Ihnen bei Ihrem Code oder Ihren Dateien zu helfen, sei es zum Erklären, wie etwas funktioniert, zum Debuggen eines Problems oder zum Vornehmen von Änderungen.Hier ist ein Beispiel für eine Frage zu einer bestimmten Zeile in einer Datei:

4
Überprüfen Sie die Änderungen
Was Sie sehen, hängt vom Berechtigungsmodus ab, der unten im Prompt-Feld angezeigt wird:
- Im Modus „Auto“ oder „Automatisch bearbeiten“ bearbeitet Claude die meisten Dateien in Ihrem Arbeitsbereich ohne Nachfrage.
-
Im Modus „Manuell“ zeigt Claude, wenn es eine Datei bearbeiten möchte, einen Vergleich der ursprünglichen und vorgeschlagenen Änderungen nebeneinander an und fragt um Genehmigung. Sie können akzeptieren, ablehnen oder Claude sagen, was es stattdessen tun soll. Wenn Sie den vorgeschlagenen Inhalt direkt in der Diff-Ansicht bearbeiten, bevor Sie akzeptieren, wird Claude mitgeteilt, dass Sie ihn geändert haben, damit es nicht davon ausgeht, dass die Datei seinem ursprünglichen Vorschlag entspricht.

Verwenden Sie das Eingabefeld
Das Eingabefeld unterstützt mehrere Funktionen:-
Berechtigungsmodi: Klicken Sie auf den Modusindikator am unteren Rand des Eingabefelds, um zwischen Berechtigungsmodi zu wechseln. Mit Claude Code v2.1.283 oder später ist Auto der integrierte Startberechtigungsmodus, und in früheren Versionen nur in Pro-, Max- und Team-Plänen. Siehe wie die Erweiterung den Startberechtigungsmodus wählt, um zu erfahren, was das ändert, und jeden Berechtigungsmodus, den der Indikator anbietet.
- Auto: Ein Klassifizierer überprüft die meisten Aktionen, anstatt Sie zu fragen. Siehe Auto-Modus, um zu erfahren, was er überprüft und blockiert.
- Manuell: Claude fragt vor Dateibearbeitungen und den meisten Shell-Befehlen um Genehmigung.
-
Plan: Claude beschreibt, was es tun wird, und wartet auf Genehmigung, bevor Änderungen vorgenommen werden. 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
/planim Eingabefeld eingeben. Erfordert Claude Code v2.1.280 oder später./plan: wechselt zum Plan-Modus. Wenn Sie bereits im Plan-Modus sind, zeigt es den aktuellen Plan statt./planmit einer Aufgabe, wie/plan fix the auth bug: wechselt zum Plan-Modus und beginnt, diese Aufgabe zu planen./plan open: wenn Sie bereits im Plan-Modus sind, öffnet die Plan-Datei im Editor.
- Automatisch bearbeiten: Claude nimmt Bearbeitungen vor, ohne zu fragen.
-
Modell: Wählen Sie Modell wechseln… aus dem Befehlsmenü, um das Modell während einer Sitzung zu ändern. Sie können auch auf den Modellnamen am unteren Rand des Eingabefelds klicken, um dieselbe Auswahl zu öffnen. Mit Claude Code v2.1.284 oder später öffnet auch die Eingabe von
/modelallein im Eingabefeld die Auswahl. Wenn das aktuelle Modell Anstrengungsstufen unterstützt, zeigt die Auswahl auch eine Zeile Anstrengung und die Schaltfläche für den Modellnamen zeigt die ausgewählte Stufe. Wenn Sie eine andere Stufe alsmaxwählen, speichert Claude Code sie für das aktuelle Modell als Standard untermodelSettingsin Ihren Benutzereinstellungen;maxgilt nur für die aktuelle Sitzung. Die Schaltfläche für den Modellnamen und die Zeile Anstrengung erfordern Claude Code v2.1.257 oder später. Wenn dynamische Workflows aktiviert sind und das aktuelle Modell dies unterstützt, wird ein Ultracode-Schalter unter der Zeile Anstrengung angezeigt. Schalten Sie ihn ein, damit Claude für jede wesentliche Aufgabe in dieser Sitzung einen Workflow auf der ausgewählten Anstrengungsstufe plant. Während er aktiviert ist, zeigt die Schaltfläche für den Modellnamen· Ultracodenach der Stufe. Der Schalter erfordert Claude Code v2.1.284 oder später. -
Befehlsmenü: Klicken Sie auf
/oder geben Sie/ein, um das Befehlsmenü zu öffnen. Die Optionen umfassen das Anhängen von Dateien, das Wechseln von Modellen und das Umschalten des erweiterten Denkens. Der Abschnitt „Anpassen“ bietet Zugriff auf MCP-Server, Befehle, Ausgabestile, Hooks, Speicher, Anweisungen, Berechtigungen und Plugins. Elemente mit einem Terminal-Symbol öffnen sich im integrierten Terminal.-
Um Befehle wie
/usageoder/remote-controlzu durchsuchen, wählen Sie Slash commands im Abschnitt „Anpassen“. Ein Dialog listet sie mit einem Filterfeld auf. Wählen Sie einen aus, um ihn auszuführen. Das Eingeben von/im Eingabefeld schlägt Befehle weiterhin inline vor. Erfordert Claude Code v2.1.257 oder später. Das Eingeben von/skillsöffnet auch diesen Dialog. Jede Skill-Zeile zeigt ihre Sichtbarkeit, wie On oder Name only. Klicken Sie auf die Sichtbarkeit, um sie zu ändern, außer bei Zeilen, die als locked gekennzeichnet sind, wie Plugin-Skills. Die/skills-Verknüpfung und die Sichtbarkeitssteuerelemente erfordern Claude Code v2.1.280 oder später. - Wählen Sie Output styles im Abschnitt „Anpassen“, um einen Ausgabestil auszuwählen, einschließlich Ihrer benutzerdefinierten Stile. Erfordert Claude Code v2.1.257 oder später. Um stattdessen einen benutzerdefinierten Stil zu erstellen, wählen Sie Build a custom style aus dem Menü Output styles. Claude Code schreibt die Stildatei für Sie auf Projekt- oder Benutzerebene. Erfordert Claude Code v2.1.261 oder später.
- Wählen Sie Hooks im Abschnitt „Anpassen“, um die Hooks anzuzeigen, die in der Sitzung geladen sind, gruppiert nach Ereignis. Sie können Hooks hinzufügen, bearbeiten oder entfernen, die in Ihren Benutzer-, Projekt- und lokalen Einstellungsdateien gespeichert sind. Hooks aus anderen Quellen, wie verwaltete Einstellungen oder Plugins, sind schreibgeschützt. Erfordert Claude Code v2.1.269 oder später.
- Wählen Sie Permissions im Abschnitt „Anpassen“, 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, wie verwaltete Einstellungen oder Genehmigungen, die nur für diese Sitzung gelten, sind schreibgeschützt. Erfordert Claude Code v2.1.269 oder später.
- Wählen Sie Memory im Abschnitt „Anpassen“, um automatisches Speichern ein- oder auszuschalten. Während es aktiviert ist, können Sie auch die Speicher durchsuchen, die Claude gespeichert hat, und die Ordner, die sie speichern, in Ihrem Datei-Manager anzeigen. Erfordert Claude Code v2.1.274 oder später. Klicken Sie auf einen gespeicherten Speicher, um ihn im Dialog zu lesen, wo Sie den Text bearbeiten, den Speicher löschen oder seine Datei im Editor öffnen können. Das Anzeigen, Bearbeiten und Löschen eines Speichers im Dialog erfordern Claude Code v2.1.275 oder später.
- Wählen Sie Instructions im Abschnitt „Anpassen“, 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 vorhanden ist, erstellt Claude Code sie zuerst. Erfordert Claude Code v2.1.274 oder später.
-
Wählen Sie Status im Abschnitt „Anpassen“, oder geben Sie
/statusein, um die Claude Code-Version, das Konto, das Modell und die MCP-Server-Details der Sitzung zu überprüfen. Erfordert Claude Code v2.1.280 oder später. -
Wählen Sie Sandbox im Abschnitt „Anpassen“, oder geben Sie
/sandboxein, um zu sehen, ob Claudes Bash-Befehle sandboxed ausgeführt werden. Sie können den Sandbox-Modus dort wechseln und ausgeschlossene Befehle hinzufügen. Erfordert Claude Code v2.1.280 oder später. -
Wählen Sie Claude in Chrome im Abschnitt „Anpassen“, oder geben Sie
/chromeein, um die Claude in Chrome-Verbindung zu überprüfen und zu verwalten. Beide erfordern die Anmeldung mit einem claude.ai-Konto. Erfordert Claude Code v2.1.280 oder später. -
Wählen Sie Export conversation im Abschnitt „Context“, oder geben Sie
/exportein, um das Gespräch als Klartext zu kopieren oder in einer Datei zu speichern. Fügen Sie einen Dateinamen hinzu, wie/export notes.txt, um den Dialog zu überspringen und auszuwählen, wo die Datei gespeichert werden soll. Erfordert Claude Code v2.1.280 oder später. -
Der Abschnitt „Einstellungen“ enthält Enable Remote Control for all sessions, das
remoteControlAtStartupsetzt, um zu steuern, ob neue interaktive Sitzungen automatisch eine Verbindung zur Remote-Steuerung herstellen. Erfordert Claude Code v2.1.203 oder später. Wenn Sie den Schalter in einem VS Code-Fenster ein- oder ausschalten, gilt die Änderung für die bereits in diesem VS Code-Fenster geöffneten Sitzungen, nicht nur für Sitzungen, die Sie danach starten. Wenn Sie ihn ausschalten, werden die offenen Sitzungen getrennt. Mit Claude Code v2.1.261 oder später erreicht die Änderung auch Sitzungen, die in Ihren anderen VS Code-Fenstern geöffnet sind. -
Der Abschnitt „Einstellungen“ enthält auch Focus view, das Werkzeugaufrufe, Werkzeugergebnisse und Denken hinter erweiterbaren Zeilen verbirgt und nur Ihre Eingaben und Claudes Antworten hinterlässt. Schalten Sie es dort um, mit
Ctrl+Option+F(Mac) /Ctrl+Alt+F(Windows/Linux), oder aus der Befehlspalette mit Claude Code: Toggle Focus view. Die Änderung gilt für jede offene Sitzung und bleibt über Sitzungen hinweg erhalten. Erfordert Claude Code v2.1.221 oder später. Claudes neueste To-Do-Liste bleibt sichtbar, ebenso wie der Text einer ausstehenden Frage von Claude; dies erfordert Claude Code v2.1.225 oder später. Während Claude Subagenten ausführt, erscheinen Live-Fortschrittszeilen mit ihrer neuesten Aktivität unter der Werkzeugaufrufsgruppe, die sie gestartet hat. Dies erfordert Claude Code v2.1.269 oder später. -
Um sich von Ihrem Anthropic-Konto abzumelden, wählen Sie Sign out im Abschnitt „Einstellungen“, oder geben Sie
/logoutein. Bei einem Drittanbieter bietet das Menü keines von beiden. Erfordert Claude Code v2.1.277 oder später. -
Um einen Fehler zu melden, klicken Sie auf Report a problem am unteren Rand des Menüs, oder geben Sie
/bugoder/feedbackmit einer optionalen Beschreibung ein, die den Bericht ausfüllt. Wenn Sie den Bericht einreichen und Sie bei Anthropic auf einer First-Party-Verbindung angemeldet sind, sendet Claude Code ihn an Anthropic. Erfordert Claude Code v2.1.229 oder später. Bei einem Drittanbieter oder ohne Anthropic-Anmeldedaten wird nichts gesendet. Der Dialog sagt dies, bevor Sie schreiben. Das Einreichen speichert den Bericht als lokales Archiv unter~/.claude/feedback-bundles/mit bekannten API-Schlüssel- und Token-Mustern redigiert. Senden Sie diese Datei an Ihren Anthropic-Kontorepräsentanten oder fügen Sie sie an eine Support-Anfrage an. Die Bestätigung nennt die Datei und enthält eine Schaltfläche Show folder. Das Speichern des Berichts auf Ihrem Computer erfordert Claude Code v2.1.284 oder später. Wenn die Richtlinie Ihrer Organisation Produktfeedback deaktiviert, wird Report a problem nicht im Menü angezeigt, und/bugund/feedbackzeigen stattdessen eineFeedback is turned off by your organization's policy or this environment's settings.Benachrichtigung an. Mit Claude Code v2.1.284 oder später wird Feedback auch ausgeschaltet, wenn Sie die UmgebungsvariableDISABLE_FEEDBACK_COMMANDoderCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICsetzen, und das Öffnen des Berichts zeigt diese Benachrichtigung statt.
-
Um Befehle wie
-
Nebenfragen: Geben Sie
/btwgefolgt von einer Frage ein, um eine Frage zu Ihrer Sitzung zu stellen, ohne sie zum Gespräch hinzuzufügen. Die Antwort öffnet sich in einem Panel neben dem Chat, in dem Sie Anschlussfragen stellen können. Der Thread bleibt bei Fenster-Neuladen erhalten. Claude Code behält die neuesten 20 Austausche und läuft gespeicherte Threads nach demcleanupPeriodDays-Plan ab, solange Claude Code sicher die Aufbewahrungsfrist bestimmen kann. Um einen Thread zu löschen, klicken Sie auf das Papierkorbsymbol im Panel. Erfordert Claude Code v2.1.227 oder später. -
Antwort kopieren: Bewegen Sie den Mauszeiger über eine Antwort und klicken Sie auf Copy response, um sie in die Zwischenablage zu kopieren, oder geben Sie
/copyein, um die neueste Antwort zu kopieren./copy 2kopiert die vorletzte. Erfordert Claude Code v2.1.277 oder später. -
Lesezeichen: Bewegen Sie den Mauszeiger ü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 Bookmarks-Panel: Klicken Sie auf das Lesezeichensymbol oben im Claude Code-Panel, wählen Sie Bookmarks im Abschnitt „Context“ des Befehlsmenüs oder geben Sie
/bookmarksein. Erfordert Claude Code v2.1.286 oder später. -
Von Claude gesendete Dateien: Wenn die Sitzung mit Remote Control verbunden ist und Claude Ihnen Dateien mit dem
SendUserFile-Tool sendet, zeigt die Konversation eine Zeile wie Sent report.md, chart.png. Klicken Sie auf den Namen einer Datei, um sie im Editor zu öffnen. -
Kontextindikator: Das Eingabefeld zeigt, wie viel von Claudes Kontextfenster Sie verwenden. Claude komprimiert automatisch bei Bedarf, oder Sie können
/compactmanuell ausführen. -
Prompt-Cache-Uhr: Ein Uhr-Symbol neben dem Kontextindikator schätzt, wie viel Zeit das Prompt-Cache des Gesprächs noch hat, bevor es abläuft. Es zählt von der Lebensdauer des Caches von fünf Minuten oder einer Stunde herunter, und jede Antwort, die den Cache verwendet, startet den Countdown neu. Abgesehen von der Komprimierung setzen die Aktionen, die den Cache ungültig machen, die Uhr nicht zurück, daher kann sie immer noch Minuten anzeigen, nachdem Sie Modelle wechseln.
- Bis der Countdown abläuft, zeigt das Symbol die verbleibenden Minuten an, z. B. 12m.
- Wenn der Countdown abläuft, verschwinden die Minuten und das Symbol wird rot oder die Fehlerfarbe Ihres Designs, bis zur nächsten Antwort. Der Cache ist wahrscheinlich abgelaufen, daher erwarten Sie eine langsamere, teurere Antwort auf Ihre nächste Nachricht, während der Cache neu aufgebaut wird. Wenn die fünfminütige Lebensdauer zwischen Ihren Nachrichten immer wieder abläuft, siehe Wählen Sie die TTL selbst.
- Unmittelbar nach dem Komprimieren des Gesprächs wird das Symbol auch rot ohne Minuten bis zur nächsten Antwort, da der Cache das komprimierte Gespräch noch nicht abdeckt.
-
Agent-Karte: Wenn das Gespräch Subagenten enthält, erscheint eine Agent-Anzahl wie 2 agents am unteren Rand des Eingabefelds. Sein Punkt zeigt, ob ein Subagent arbeitet oder auf Ihre Genehmigung wartet.
Klicken Sie auf die Agent-Anzahl, um die Agent-Karte zu öffnen, die die Subagenten des Gesprächs als Baum unter dem Hauptagenten zeichnet, jeweils mit seinem Status, verstrichener Zeit und Token-Anzahl. Klicken Sie auf einen Subagenten, um sein Eingabefeld und seine Werkzeugaufrufe anzuzeigen, sein schreibgeschütztes Transkript zu öffnen oder ihn während der Ausführung zu stoppen. Erfordert Claude Code v2.1.269 oder später.
Die Karte listet auch die anderen Hintergrundaufgaben der Sitzung auf, wie Hintergrund-Shell-Befehle und Monitore, unter den Agenten. Klicken Sie auf eine Zeile, um die Karte der Aufgabe zu öffnen und sie dort zu stoppen.
Um die Karte zu öffnen, wenn keine Agent-Anzahl angezeigt wird, z. B. wenn Claude einen Hintergrund-Shell-Befehl gestartet hat, aber keine Subagenten, geben Sie
/tasksim Eingabefeld ein. Hintergrundaufgaben in der Karte und das eingegebene/taskserfordern Claude Code v2.1.277 oder später. Mit Claude Code v2.1.286 oder später endet der aktuelle Turn, wenn Sie auf Stop klicken oderEscdrücken. Hintergrundagenten laufen weiter, bis sie fertig sind oder Sie sie über die Karte stoppen. -
Erweitertes Denken: Ermöglicht Claude, mehr Zeit für die Überlegung komplexer Probleme aufzuwenden. Schalten Sie es über das Befehlsmenü (
/) ein. Claudes Überlegungen erscheinen im Gespräch als zusammengeklappte Blöcke: Klicken Sie auf einen Block, um ihn zu lesen, oder drücken SieCtrl+O, um jeden Denkblock in der Sitzung zu erweitern oder zu reduzieren. Siehe Erweitertes Denken für Details. -
Mehrzeilige Eingabe: Drücken Sie
Shift+Enter, um eine neue Zeile hinzuzufügen, ohne zu senden. Dies funktioniert auch in der Freitexteingabe „Other“ von Frage-Dialogen.
Referenzdateien und -ordner
Verwenden Sie @-Erwähnungen, um Claude Kontext über bestimmte Dateien oder Ordner 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 Fuzzy Matching, sodass Sie Teilnamen eingeben können, um zu finden, was Sie benötigen:
Option+K (Mac) / Alt+K (Windows/Linux), um eine @-Erwähnung mit dem Dateipfad und den Zeilennummern einzufügen (z. B. @app.ts#5-10). Klicken Sie auf das X auf dem Auswahlindikator, um ihn zu entfernen, damit Claude die Auswahl nicht erhält. Der Indikator erscheint wieder, wenn Sie anderen Text auswählen.
Die Erweiterung behält ausgewählten Text aus einigen Dateien zurück. Wenn sich die Datei in Ihrem Arbeitsbereich befindet und Ihren files.exclude- oder search.exclude-Einstellungen entspricht, erhält Claude höchstens den Dateipfad und nicht den Text, den Sie ausgewählt haben. Das Gleiche gilt für eine Datei, die Git ignoriert, solange die search.useIgnoreFiles-Einstellung von VS Code und die respectGitIgnore-Einstellung der Erweiterung beide aktiviert sind, was die Standardeinstellung ist. Dieser Filter gilt nur für das Chat-Panel: Wenn Claude Code im integrierten Terminal ausgeführt wird, sendet die CLI Ihren ausgewählten Text unabhängig von der Datei, daher fügen Sie eine Read-Ablehnungsregel hinzu, um zu verhindern, dass Claude dort auf die Inhalte einer Datei zugreift.
Claude sieht auch, welche Datei Sie im Editor geöffnet haben, auch wenn nichts ausgewählt ist, und das Eingabefeld zeigt seinen Namen. Um nur Ihren ausgewählten Text hinzuzufügen, schalten Sie die Attach Open File-Einstellung aus. Die Einstellung erfordert Claude Code v2.1.271 oder später.
Sie können auch Bilder und Dateien an Ihre Nachricht anhängen:
- Um ein Bild anzuhängen, fügen Sie es aus Ihrer Zwischenablage in das Eingabefeld ein.
- Um Dateien anzuhängen, halten Sie
Shiftgedrückt, während Sie sie in das Eingabefeld ziehen. - Um einen Anhang aus dem Kontext zu entfernen, klicken Sie auf das X darauf.
Text einfügen
Text, den Sie einfügen, bleibt im Eingabefeld sichtbar, anstatt zu einem Platzhalter zu kollabieren, wie es im Terminal der Fall ist. In Sitzungen, in denen Claude Code eingefügten Text markiert, sieht Claude ein großes Einfügen immer noch als Text, den Sie eingefügt haben, anstatt eingegeben zu haben. Claude Code entfernt auch unsichtbare Unicode-Zeichen aus Text, den Sie in das Eingabefeld einfügen, und aus allem anderen, das Sie senden:- Wenn eine Benachrichtigung wie
Removed 3 invisible characters from the pasted textangezeigt wird, wenn Sie einfügen, ging der Text ohne diese Zeichen ein. - Wenn eine Benachrichtigung über entfernte Zeichen angezeigt wird, wenn Sie senden, wurde nichts gesendet. Der bereinigte Text ist zurück im Eingabefeld. Senden Sie erneut, um den Text wie angezeigt zu senden.
Frühere Gespräche fortsetzen
Klicken Sie auf die Schaltfläche Session history oben im Claude Code-Panel, um auf Ihren Gesprächsverlauf zuzugreifen. Sie können nach Schlüsselwort suchen oder nach Zeit durchsuchen. Klicken Sie auf eine beliebige Konversation, um sie mit dem vollständigen Nachrichtenverlauf fortzusetzen. Wenn die Konversation bereits in einer anderen Registerkarte des aktuellen Fensters geöffnet ist, wird durch Klicken darauf zu dieser Registerkarte gewechselt. 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 basierend auf Ihrer ersten Nachricht.
- Umbenennen und archivieren: Bewegen Sie den Mauszeiger über eine Sitzung, um diese Aktionen anzuzeigen. Benennen Sie sie um, um ihr einen beschreibenden Titel zu geben, oder archivieren Sie sie, um sie in die Gruppe Archived sessions am unteren Rand der Liste zu verschieben.
claude in einem Terminal oder einem anderen VS Code-Fenster, erscheint anstelle des Eingabefelds ein Hinweis: This conversation is still open somewhere else. Using it in two places at once can mix up its messages. 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 für 14 Tage automatisch zu Archived sessions verschoben, es sei denn, sie ist offen, ungelesen oder in einer Gruppe. Automatisches Archivieren erfordert Claude Code v2.1.265 oder später. Um den Zeitraum zu ändern oder auszuschalten, öffnen Sie die Archive Inactive Sessions-Einstellung und wählen Sie eine Anzahl von Tagen oder Never.
Um eine archivierte Sitzung wiederherzustellen, erweitern Sie Archived sessions und klicken Sie auf Unarchive session. Um jede archivierte Sitzung auf einmal wiederherzustellen, bewegen Sie den Mauszeiger über die Kopfzeile Archived sessions in der Sitzungsliste in der Aktivitätsleiste und klicken Sie auf sein Unarchive-Symbol, das Claude Code v2.1.277 oder später erfordert. Vor v2.1.257 war die Aktion Delete session, die eine Sitzung ohne Möglichkeit zur Wiederherstellung ausblendete. Sitzungen, die Sie dann gelöscht haben, werden nach dem Upgrade unter Archived sessions angezeigt.
Wenn das Gespräch, das Sie fortsetzen, im Plan-Modus endete, stellt Claude Code den Plan-Modus wieder her. Erfordert Claude Code v2.1.246 oder später. Claude Code stellt ihn in diesen Fällen nicht wieder her:
- Die Erweiterung wählt den Startberechtigungsmodus aus
claudeCode.initialPermissionModeoder einer Auswahl, die aus einem früheren Gespräch übernommen wird - Sie haben
claudeCode.claudeProcessWrapperkonfiguriert - Eine deny-Regel entfernt das Tool
ExitPlanMode
Cloud-Sitzungen von Claude.ai fortsetzen
Wenn Sie Cloud-Sitzungen ausführen, können Sie sie direkt in VS Code fortsetzen. Dies erfordert die Anmeldung mit Claude.ai Subscription, nicht Anthropic Console.1
Sitzungsverlauf öffnen
Klicken Sie auf die Schaltfläche Session history oben im Claude Code-Panel.
2
Wählen Sie die Registerkarte „Web"
Der Dialog zeigt zwei Registerkarten: Local und Web. Klicken Sie auf Web, um Sitzungen von claude.ai anzuzeigen.
3
Wählen Sie eine Sitzung zum Fortsetzen
Durchsuchen oder suchen Sie die Sitzungen. Klicken Sie auf eine, um das Gespräch lokal fortzusetzen.
Wenn der Ordner, den Sie geöffnet haben, ein GitHub-Repository ist, zeigt die Registerkarte „Web“ nur Sitzungen aus diesem Repository.Wenn Sie eine Cloud-Sitzung fortsetzen, lädt die Erweiterung eine Kopie des Gesprächsverlaufs herunter; Änderungen werden nicht mit claude.ai synchronisiert.
Konto und Nutzung überprüfen
Führen Sie/usage aus, um das Dialogfeld „Account & usage“ zu öffnen. Es zeigt Ihr angemeldetes Konto, und die Nutzung, die es meldet, unterscheidet sich je nach Anmeldung:
- claude.ai-Plan: Nutzungsbalken für die Limits Ihres Plans, wie die aktuelle Sitzung und die Woche. Jeder Balken zeigt, wie lange es dauert, bis sein Limit zurückgesetzt wird. Das Dialogfeld schlüsselt auch auf, was zu Ihren Planlimits beiträgt. Es kennzeichnet Verhaltensweisen, die 10 % oder mehr der letzten Nutzung ausmachen, wie z. B. Cache-Misses, langer Kontext und Subagent-intensive oder hochgradig parallele Sitzungen, jeweils mit einem Tipp zur Reduzierung. Attributionstabellen zeigen, wie viel Nutzung von jedem Skill, Subagent, Plugin und MCP-Server kam. Verwenden Sie den Umschalter „Day“ und „Week“, um zwischen den letzten 24 Stunden und den letzten 7 Tagen zu wechseln. Die Zahlen sind ungefähr und werden aus lokalen Sitzungen auf diesem Computer berechnet, daher ist die Nutzung von anderen Geräten oder claude.ai nicht enthalten.
-
Andere Anmeldungen: Wenn Planlimits nicht auf Ihre Anmeldung zutreffen, z. B. bei einem Drittanbieter oder mit einem API-Schlüssel, zeigt der Abschnitt „Usage“ stattdessen die Kosten und Token-Nutzung der Sitzung selbst. Die CLI
/usagezeigt die gleichen Summen in ihrem Session-Block. Die Sitzungsliste in der Aktivitätsleiste zeigt auch die Summen der aktiven Sitzung unter ihrer Kopfzeile Account & usage. Erfordert Claude Code v2.1.277 oder später.
Passen Sie Ihren Arbeitsablauf an
Sie können das Claude-Panel neu positionieren, mehrere Gespräche führen, die Sitzungsliste in Gruppen organisieren oder filtern, oder in den Terminalmodus wechseln.Wählen Sie, wo Claude sich befindet
Sie können das Claude-Panel überall in VS Code neu positionieren. Greifen Sie die Registerkarte oder Titelleiste des Panels und ziehen Sie es zu:- Sekundäre Seitenleiste: die rechte Seite des Fensters. Hält Claude sichtbar, während Sie programmieren.
- Primäre Seitenleiste: die linke Seitenleiste mit Symbolen für Explorer, Suche usw.
- Editor-Bereich: öffnet Claude als Registerkarte neben Ihren Dateien. Nützlich für Nebenaufgaben.
Konversationen nach einem Neuladen fortsetzen
Nachdem Sie Developer: Reload Window ausgeführt oder VS Code neu gestartet haben, hängt es davon ab, wo das Gespräch offen war, ob es mit seiner Konversation zurückkommt:- Editor-Registerkarte: Das Gespräch kommt mit seiner Registerkarte zurück.
- Seitenleiste: Das Gespräch kommt zurück, wenn Sie eine Nachricht gesendet oder Claude darin geantwortet hat, innerhalb der letzten 10 Minuten. Wenn es nicht zurückkommt, setzen Sie das Gespräch aus Sitzungsverlauf fort.
CLAUDE_CODE_RESUME_INTERRUPTED_TURN oder einer anderen CLAUDE_CODE_RESUME_-Variable in der Umgebung von VS Code oder in der Einstellung environmentVariables hat im Panel keine Wirkung, da die Erweiterung diese Variablen entfernt, bevor sie die Sitzungen des Panels startet.
Führen Sie mehrere Gespräche
Verwenden Sie Open in New Tab oder Open in New Window aus der Befehlspalette, um zusätzliche Gespräche zu starten. Jedes Gespräch behält seine eigene Verlauf und seinen eigenen Kontext bei, sodass Sie parallel an verschiedenen Aufgaben arbeiten können. Bei Verwendung von Registerkarten zeigt ein kleiner farbiger Punkt auf dem Funken-Symbol den Status an: Blau bedeutet, dass eine Berechtigungsanfrage ausstehend ist, Orange bedeutet, dass Claude fertig ist, während die Registerkarte ausgeblendet war.Organisieren Sie Sitzungen in Gruppen
In der Sitzungsliste in der Aktivitätsleiste können Sie verwandte Sitzungen in benannte, einklappbare Gruppen sammeln. Erfordert Claude Code v2.1.229 oder später.- Gruppieren oder Gruppierung aufheben einer Sitzung: Klicken Sie mit der rechten Maustaste auf eine Sitzung, um eine Gruppe daraus zu erstellen, sie in eine vorhandene Gruppe zu verschieben oder sie aus ihrer Gruppe zu entfernen. Jede Sitzung gehört jeweils zu einer Gruppe, daher wird sie durch das Verschieben in eine andere Gruppe aus der ersten entfernt.
- Verschieben Sie mehrere Sitzungen gleichzeitig:
Cmd-Klick (Mac) /Ctrl-Klick (Windows/Linux) auf jede Sitzung, oderShift-Klick, um einen Bereich auszuwählen, dann Rechtsklick auf die Auswahl. - Gruppieren Sie eine Sitzung von ihrer Registerkarte: Führen Sie Claude Code: Add Session Tab to Group aus der Befehlspalette aus, und wählen Sie dann eine Gruppe aus oder erstellen Sie eine. Erfordert Claude Code v2.1.257 oder später.
- Benennen Sie eine Gruppe um oder löschen Sie sie: Klicken Sie mit der rechten Maustaste auf einen Gruppenkopf. Das Löschen einer Gruppe entfernt nur die Gruppe, und ihre Sitzungen kehren zur ungruppierten Liste zurück.
Filtern Sie die Sitzungsliste
Um eine lange Sitzungsliste in der Aktivitätsleiste zu verkürzen, verwenden Sie die zwei Filtersteuerelemente oben in der Liste. Erfordert Claude Code v2.1.271 oder später. Archivierte Sitzungen werden nicht angezeigt, während einer der Filter aktiviert ist.- Aktiv: Aktivieren Sie diesen Schalter, um nur Sitzungen anzuzeigen, die Ihre Eingabe benötigen, arbeiten oder ungelesen sind, sowie die Sitzung in der Claude-Registerkarte, auf die Sie zuletzt fokussiert haben.
- Nach Status filtern: Klicken Sie auf das Trichtersymbol, und aktivieren Sie dann Eingabe erforderlich, Arbeitet oder Abgeschlossen, um Sitzungen in einem dieser Zustände anzuzeigen. Aktivieren Sie Offen oder Geschlossen, um nach zu filtern, ob eine Sitzung offen ist. Eine Sitzung zählt als offen, wenn sie eine Registerkarte in diesem Fenster hat oder in einem anderen Claude Code-Prozess auf diesem Computer ausgeführt wird, z. B. in einem Terminal.
Wechseln Sie zum Terminalmodus
Standardmäßig öffnet die Erweiterung ein grafisches Chat-Panel. Wenn Sie die CLI-ähnliche Schnittstelle bevorzugen, öffnen Sie die Einstellung „Use Terminal“ und aktivieren Sie das Kontrollkästchen. Sie können auch VS Code-Einstellungen öffnen (Cmd+, auf Mac oder Ctrl+, unter Windows/Linux), zu Erweiterungen → Claude Code gehen und Use Terminal aktivieren.
Plugins verwalten
Die VS Code-Erweiterung enthält eine grafische Benutzeroberfläche zum Installieren und Verwalten von Plugins. Geben Sie/plugins in das Eingabefeld ein, um die Schnittstelle Plugins verwalten zu öffnen.
Plugins installieren
Der Plugin-Dialog zeigt zwei Registerkarten: Plugins und Marketplaces. Auf der Registerkarte Plugins:- Installierte Plugins werden oben mit Umschaltern angezeigt, um sie zu aktivieren oder zu deaktivieren.
- Wenn Sie ein Plugin deaktivieren, das die gemeinsame
.claude/settings.jsonIhres Projekts aktiviert, fragt die Erweiterung zuerst: Für mich deaktivieren deaktiviert es nur für Sie, während Für alle deaktivieren die gemeinsame 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.
- Wenn Sie ein Plugin deaktivieren, das die gemeinsame
- Verfügbare Plugins aus Ihren konfigurierten Marketplaces werden darunter angezeigt
- Suchen Sie, um Plugins nach Name oder Beschreibung zu filtern
- Klicken Sie auf Installieren für jedes verfügbare Plugin
- Für Sie installieren: verfügbar in allen Ihren Projekten (Benutzerbereich)
- Für dieses Projekt installieren: geteilt mit Projektmitarbeitern (Projektbereich)
- Lokal installieren: nur für Sie, nur in diesem Repository (lokaler Bereich)
Plugins deinstallieren
Jede installierte Zeile nennt den Bereich, in dem sie installiert ist. Um diese Installation zu deinstallieren, klicken Sie auf das Papierkorbsymbol der Zeile. Ein abgeblendetes Papierkorbsymbol markiert eine Zeile, die Sie nicht aus diesem Arbeitsbereich deinstallieren können, z. B. ein Plugin, das Ihre Organisation verwaltet, oder eines, das für ein anderes Projekt installiert ist. Die Erweiterung fragt zuerst in zwei Fällen:- Ein Plugin, das die gemeinsame
.claude/settings.jsonIhres Projekts aktiviert: Wählen Sie Für mich deaktivieren, was das Plugin für Ihre Mitarbeiter installiert hält, oder Für alle deinstallieren, was die Installation des Projekts mit--keep-dataentfernt, sodass das Datenverzeichnis des Plugins erhalten bleibt. Wenn Sie das Plugin bereits für sich selbst deaktiviert haben, entfernt das Papierkorbsymbol Ihre eigene Installation ohne die Frage. - Andernfalls die letzte Installation eines Plugins mit gespeicherten Daten: Wählen Sie, ob Sie die Daten behalten oder löschen möchten; Behalten ist die Standardeinstellung
Plugin-Installationslink teilen
Um jemanden direkt zur Installation eines bestimmten Plugins zu führen, geben Sie ihm dieinstall-plugin-URL der Erweiterung. Das Öffnen startet oder fokussiert VS Code, öffnet das Claude Code-Panel und öffnet den Dialog Plugins verwalten mit der Bereichswahl für dieses Plugin. Nichts wird installiert, bis die Person einen Bereich auswählt. Wenn der Marketplace des Plugins in Claude Code noch nicht konfiguriert ist, fragt der Dialog zuerst, ob er hinzugefügt werden soll.
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
marketplaceauflistet, also kein lokaler Pfad, keinehttp://-Adresse und nicht der Name des Marketplace, wie z. B.claude-plugins-official. Einehttps://-URL darf keinen Benutzernamen, kein Passwort und keinen Query-String enthalten. - Git-Ref: Um den Marketplace an einen Branch oder Tag zu binden, hängen Sie die Ref nach
%23, der kodierten Form von#, an die Quelle an, wie inmarketplace=owner/repo%23v1.0. Ein Link mit einem unkodierten#schlägt fehl. Marketplaces in der GitHub-Organisationanthropicskönnen in einem Link nicht fixiert werden.
Invalid plugin installation URL beginnt. Das Claude Code-Panel und der Dialog werden nicht geöffnet, und nichts wird installiert. Wenn der Name oder der Marketplace Ihres Plugins nicht in einen Link passt, weisen Sie die Personen an, den Marketplace auf der Registerkarte Marketplaces hinzuzufügen und das Plugin dann über die Registerkarte Plugins zu installieren.
Diese Fälle enden mit einer Nachricht im Dialog statt der Bereichswahl:
- Der Marketplace listet kein Plugin mit diesem Namen auf: Der Dialog meldet, dass das Plugin nicht gefunden wurde. Überprüfen Sie den
plugin-Wert anhand der Auflistung des Marketplace. - Das Plugin ist bereits installiert: Der Dialog teilt dies mit, 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 nichts wird installiert.
http oder https ist, sodass ein vscode://-Link dort als Klartext angezeigt wird. Platzieren Sie die URL in einem Codeblock auf diesen Hosts, wie Der Link wird als Klartext angezeigt, anstatt anklickbar zu sein für claude-cli://-Links beschreibt.
Marketplaces verwalten
Wechseln Sie zur Registerkarte 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 von ihm installiert haben, daher nennt eine Bestätigung diese Plugins zuerst
Die Plugin-Verwaltung in VS Code verwendet unter der Haube die gleichen CLI-Befehle. Plugins und Marketplaces, die Sie in der Erweiterung konfigurieren, sind auch in der CLI verfügbar, und umgekehrt.
Browser-Aufgaben mit Chrome automatisieren
Verbinden Sie Claude mit Ihrem Chrome-Browser, um Web-Apps zu testen, mit Konsolenprotokollen zu debuggen und Browser-Workflows zu automatisieren, ohne VS Code zu verlassen. Dies erfordert die Claude in Chrome-Erweiterung Version 1.0.36 oder höher. Geben Sie@browser in das Eingabefeld ein, gefolgt von dem, was Claude tun soll:
@browser eingeben müssen, erfahren Sie unter Chrome standardmäßig aktivieren. Wann Claude Code vor einer Browser-Aktion bei Ihnen nachfragt, erfahren Sie unter Berechtigungsabfragen in VS Code-Sitzungen.
Anweisungen zur Einrichtung, die vollständige Liste der Funktionen und Fehlerbehebung finden Sie unter Claude Code mit Chrome verwenden.
VS Code-Befehle und Tastenkombinationen
Öffnen Sie die Befehlspalette (Cmd+Shift+P auf Mac oder Ctrl+Shift+P unter Windows/Linux) und geben Sie „Claude Code“ ein, um alle verfügbaren VS Code-Befehle für die Claude Code-Erweiterung anzuzeigen.
Einige Tastenkombinationen hängen davon ab, welches Panel „fokussiert“ ist (Tastatureingaben empfängt). Wenn sich der Cursor in einer Codedatei befindet, ist der Editor fokussiert. Wenn sich der Cursor in Claudes Eingabefeld befindet, ist Claude fokussiert. Verwenden Sie Cmd+Esc / Ctrl+Esc, um zwischen ihnen 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.
Starten Sie eine VS Code-Registerkarte von anderen Tools aus
Die Erweiterung registriert einen URI-Handler untervscode://anthropic.claude-code/open. Verwenden Sie ihn, um eine neue Claude Code-Registerkarte von Ihren eigenen Tools aus zu öffnen: ein Shell-Alias, ein Browser-Bookmarklet oder ein beliebiges Skript, das eine URL öffnen kann. Wenn VS Code nicht bereits ausgeführt wird, wird es beim Öffnen der URL zuerst gestartet. Wenn VS Code bereits ausgeführt wird, wird die URL in dem Fenster geöffnet, das derzeit fokussiert ist.
Rufen Sie den Handler mit dem URL-Öffner Ihres Betriebssystems auf.
- macOS
- Linux
- Windows
Um beispielsweise eine Registerkarte mit „review my changes“ vorausgefüllt zu öffnen:
vscode://anthropic.claude-code/install-plugin, das den Plugin-Dialog für ein Plugin öffnet. Um stattdessen eine Terminalsitzung zu starten, verwenden Sie den CLI-Handler claude-cli://. Siehe Launch sessions from links.
Einstellungen konfigurieren
Die Erweiterung hat zwei Arten von Einstellungen:- Erweiterungseinstellungen in VS Code: steuern das Verhalten der Erweiterung in VS Code. Öffnen Sie sie mit
Cmd+,(Mac) oderStrg+,(Windows/Linux), gehen Sie dann zu Erweiterungen → 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 zwischen der Erweiterung und der CLI gemeinsam genutzt. Verwenden Sie diese für zulässige Befehle, Umgebungsvariablen, Hooks und MCP-Server. Mit Claude Code v2.1.283 oder später ist dies auch eine Eingabe für den Berechtigungsmodus, in dem Gespräche beginnen, und in früheren Versionen nur in Pro-, Max- und Team-Plänen. Berechtigungsmodi wechseln listet die Reihenfolge auf. Weitere Informationen finden Sie unter Einstellungen.
Erweiterungseinstellungen
VS Code liestinitialPermissionMode aus Ihren Benutzereinstellungen und ignoriert Workspace-Werte. Vor v2.1.225 setzte VS Code die Einstellung standardmäßig auf default und wendete Workspace-Werte an.
Verwenden Sie einen Bildschirmleser
Das Chat-Panel der Erweiterung funktioniert mit Bildschirmlesern. Sie müssen nichts aktivieren: Die Erweiterung kündigt Gesprächsaktivitäten für jeden Benutzer an, ohne visuelle Änderungen. Dies ist unabhängig vom Bildschirmlesermodus der CLI, der sich aktivieren lässt und die Terminaloberfläche anpasst. Die Unterstützung für Bildschirmleser im Chat-Panel erfordert Claude Code v2.1.236 oder später. Während eines Gesprächs kündigt die Erweiterung an:- Antworten von Claude: Die Erweiterung kündigt jede Antwort einmal an, wenn sie vollständig ist, und bleibt stumm, während Text einströmt. Ihr Bildschirmleser liest Code-Blöcke als Zeilenzahl-Zusammenfassung, liest Links nach ihrem Label und liest Tabellen Zelle für Zelle; die vollständige Antwort bleibt im Transkript lesbar.
- Berechtigungsanfragen und Fragen: Die Erweiterung kündigt eine Anfrage an, wenn die Berechtigungsaufforderung angezeigt wird, und nennt das Tool, das Claude verwenden möchte. Sie kündigt auf die gleiche Weise an, wenn Claude Ihnen eine Frage stellt und wenn Claude einen Plan abgeschlossen hat und auf Ihre Überprüfung wartet.
- Statusänderungen: Die Erweiterung kündigt an, wenn Claude mit der Arbeit beginnt, wenn Claude bereit für Ihre Eingabe ist, und wenn Claude Code das Gespräch komprimiert.
- 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 Modell-Aufforderungen: Die Erweiterung kündigt Fehler im Gespräch an und kündigt an, wenn die Aufforderung zur Zustimmung für Nutzungsguthaben oder die Aufforderung für gekennzeichnete Anfragen angezeigt wird.
Verwenden Sie das Chat-Panel von der Tastatur aus
Jede Runde im Transkript beginnt mit einer visuell verborgenen Überschrift, die mit der Eingabeaufforderung gekennzeichnet ist, die die Runde gestartet hat, sodass Sie mit der Überschriftsnavigation Ihres Bildschirmlesers zwischen Runden springen können. Innerhalb einer Runde kündigt Ihr Bildschirmleser an, wessen Nachricht Sie lesen, während Sie sich durch sie bewegen:- Ihre Nachrichten: „You“
- Nachrichten von Claude: „Claude“
- Tool-Schritte: „Claude“ plus der Tool-Name, z. B. „Claude, Bash“
- Thinking-Blöcke: „Claude, thinking“
Tab auf das Transkript selbst verschieben und es in Ihrem eigenen Tempo lesen. Um den Fokus stattdessen auf die neueste Nachricht oder eine ausstehende Berechtigungsaufforderung zu verschieben, führen Sie Claude Code: Focus last message aus der Befehlspalette aus.
Wenn eine Option in einer Berechtigungsaufforderung eine Berechtigungsregel oder einen Verzeichniszugriff speichert, endet ihr Label mit der Angabe, wo die Genehmigung gespeichert ist, z. B. „all projects“ oder „this session“. Wenn diese Option fokussiert ist, drücken Sie die Left- oder Right-Pfeiltaste, um das Ziel zu ändern, und die Erweiterung kündigt jedes Ziel an, wenn Sie es erreichen. Sie können das Ziel auch im Label anklicken. Die Pfeiltasten erfordern Claude Code v2.1.268 oder später.
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 nur in der CLI verfügbare Funktion benötigen, führen Sieclaude 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.
Mit Checkpoints zurückspulen
Die VS Code-Erweiterung unterstützt Checkpoints, die Claudes Dateibearbeitungen verfolgen und es Ihnen ermöglichen, zu einem vorherigen Zustand zurückzuspulen. Bewegen Sie den Mauszeiger über eine beliebige Nachricht, um die Schaltfläche zum Zurückspulen anzuzeigen, und wählen Sie dann aus drei Optionen:- Konversation von hier aus verzweigen: Starten Sie einen neuen Konversationszweig von dieser Nachricht aus, während alle Codeänderungen erhalten bleiben
- Code bis hier zurückspulen: Setzen Sie Dateiänderungen auf diesen Punkt in der Konversation zurück, während Sie die vollständige Konversationshistorie behalten
- Konversation verzweigen und Code zurückspulen: Starten Sie einen neuen Konversationszweig und setzen Sie Dateiänderungen auf diesen Punkt zurück
CLI in VS Code ausführen
Um die CLI zu verwenden und dabei in VS Code zu bleiben, öffnen Sie das integrierte Terminal (Ctrl+` unter Windows/Linux oder Cmd+` auf Mac) und führen Sie claude aus. Die CLI wird automatisch mit Ihrer IDE für Funktionen wie Diff-Anzeige und Diagnosefreigabe integriert.
Die Installation der Erweiterung fügt claude nicht zu Ihrem Shell-PATH hinzu. Die Erweiterung enthält eine private Kopie der CLI für ihr Chat-Panel, aber die Eingabe von claude in einem Terminal erfordert die eigenständige CLI-Installation. Führen Sie die Installation einmal aus und die Befehle auf dieser Seite, einschließlich claude mcp add und claude --resume, funktionieren in jedem Terminal. Wenn claude nach der Installation immer noch nicht gefunden wird, überprüfen Sie Ihren PATH.
Wenn Sie ein externes Terminal verwenden, führen Sie /ide in Claude Code aus, um es mit VS Code zu verbinden.
Zwischen Erweiterung und CLI wechseln
Die Erweiterung und die CLI teilen die gleiche Konversationshistorie. Um eine Erweiterungskonversation in der CLI fortzusetzen, führen Sieclaude --resume im Terminal aus. Dies öffnet eine interaktive Auswahl, in der Sie Ihre Konversation suchen und auswählen können.
Terminalausgabe in Eingabeaufforderungen einbeziehen
Referenzieren Sie Terminalausgabe in Ihren Eingabeaufforderungen mit@terminal:name, wobei name der Titel des Terminals ist. Dies ermöglicht Claude, Befehlsausgabe, Fehlermeldungen oder Protokolle zu sehen, ohne sie zu kopieren und einzufügen.
Laufenden Befehl oder Subagenten in den Hintergrund verschieben
Wenn Claude auf einen Befehl oder einen Subagenten wartet, der länger dauert als gewünscht, klicken Sie in der Konversation unterhalb seines Tool-Aufrufs auf Run in background. Die Aktion erscheint, sobald ein Befehl etwa zwei Sekunden lang läuft, bzw. sobald ein Subagent startet. Claude wartet nicht mehr und setzt den Turn fort, während der Befehl oder Subagent als Hintergrundaufgabe weiterläuft, die Claude benachrichtigt, wenn sie abgeschlossen ist. Erfordert Claude Code v2.1.287 oder später. Um die Aufgabe zwischenzeitlich zu überprüfen oder zu beenden, geben Sie/tasks im Eingabefeld ein, um die Agent-Karte 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 im Eingabefeld ein, um die Agent-Karte zu öffnen, die die Hintergrundaufgaben der Sitzung auflistet, z. B. einen Dev-Server, den Claude als Hintergrund-Shell-Befehl ausführt. Klicken Sie auf eine Aufgabe, um ihre Karte zu öffnen und sie dort zu beenden. Erfordert Claude Code v2.1.277 oder später.
Bei einem Hintergrund-Shell-Befehl 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.
Mit MCP eine Verbindung zu externen Tools herstellen
MCP (Model Context Protocol)-Server 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. Im angezeigten Dialog können Sie Server hinzufügen, auf lokaler, Benutzer- oder Projekt-Ebene gespeicherte Server entfernen, Server aktivieren oder deaktivieren, sich erneut mit einem Server verbinden und die OAuth-Authentifizierung verwalten. Das Hinzufügen und Entfernen von Servern im Dialog erfordert Claude Code v2.1.261 oder später.
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 der gleichen MCP-Konfiguration, und Änderungen von beiden werden in Konversationen wirksam, die Sie danach starten. Das folgende Beispiel fügt Githubs Remote-MCP-Server hinzu, der sich mit einem persönlichen Zugriffstoken authentifiziert, das als Header übergeben wird:
YOUR_GITHUB_PAT durch Ihr persönliches Zugriffstoken. Der Befehl claude mcp add speichert die Konfiguration, ohne Anmeldedaten zu validieren, daher wird hier ein Platzhalterwert akzeptiert, aber der Server kann sich später nicht verbinden. Um die Verbindung zu überprüfen, starten Sie eine neue Konversation, geben Sie /mcp ein und überprüfen Sie, dass der Server Connected anzeigt. Ein Server mit ungültigen Anmeldedaten zeigt Failed.
Nach der Konfiguration bitten Sie Claude, die Tools zu verwenden (z. B. „Review PR #456“).
Um Server zum Verbinden zu finden, siehe MCP-Server suchen und erstellen.
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:Verwenden Sie Drittanbieter
Standardmäßig verbindet sich Claude Code direkt mit der API von Anthropic. Wenn Ihre Organisation Amazon Bedrock, Google Cloud’s Agent Platform oder Microsoft Foundry nutzt, um auf Claude zuzugreifen, konfigurieren Sie die Erweiterung, um stattdessen Ihren Anbieter zu verwenden:1
Anmeldeeingabeaufforderung deaktivieren
Öffnen Sie die Einstellung „Anmeldeeingabeaufforderung deaktivieren“ und aktivieren Sie das Kontrollkästchen.Sie können auch die VS Code-Einstellungen öffnen (
Cmd+, auf Mac oder Ctrl+, unter Windows/Linux), nach „Claude Code login“ suchen und Anmeldeeingabeaufforderung deaktivieren aktivieren.2
Konfigurieren Sie Ihren Anbieter
Folgen Sie dem Einrichtungsleitfaden für Ihren Anbieter:
- Claude Code auf Amazon Bedrock
- Claude Code auf Google Cloud’s Agent Platform
- Claude Code auf Microsoft Foundry
~/.claude/settings.json, was sicherstellt, dass Ihre Einstellungen zwischen der VS Code-Erweiterung und der CLI gemeinsam genutzt werden./login übrig bleibt, wird nicht verwendet: Die Erweiterung sendet sie nicht mit einer Anfrage.
Sicherheit und Datenschutz
Ihr Code bleibt privat. Claude Code verarbeitet Ihren Code, um Ihnen Unterstützung zu bieten, verwendet ihn aber nicht zum Trainieren von Modellen. Weitere Informationen zur Datenverarbeitung und zum Deaktivieren der Protokollierung finden Sie unter Daten und Datenschutz. Wenn Auto-Edit-Berechtigungen aktiviert sind, kann Claude Code VS Code-Konfigurationsdateien (wiesettings.json oder tasks.json) ändern, die VS Code möglicherweise automatisch ausführt. Um das Risiko bei der Arbeit mit nicht vertrauenswürdigem Code zu verringern:
- Aktivieren Sie den VS Code Restricted Mode für nicht vertrauenswürdige Arbeitsbereiche
- Verwenden Sie den manuellen Modus anstelle von „Edit automatically“ oder „Auto“ für Bearbeitungen
- Überprüfen Sie Änderungen sorgfältig, bevor Sie sie akzeptieren
Der integrierte IDE-MCP-Server
Wenn die Erweiterung aktiv ist, wird ein lokaler MCP-Server ausgeführt, mit dem sich die CLI automatisch verbindet. Auf diese Weise öffnet die CLI Diffs im nativen Diff-Viewer von VS Code, liest Ihre aktuelle Auswahl für@-Erwähnungen und fordert VS Code auf – wenn Sie in einem Jupyter-Notebook arbeiten – Zellen auszuführen.
Der Server heißt ide und ist in /mcp verborgen, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen PreToolUse-Hook verwendet, um MCP-Tools auf eine Allowlist zu setzen, müssen Sie wissen, dass er existiert.
Auswahl und Kontext offener Dateien. Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine ⧉ Selected N lines from <file>-Zeile, wenn dies geschieht.
Wenn Sie eine Nachricht in die Warteschlange einreihen, während Claude arbeitet, behält es die Auswahl, die Sie beim Drücken von Enter hatten, unabhängig davon, was Sie danach auswählen.
Um eine vertrauliche Datei wie .env auszuschließen, fügen Sie eine Read-Ablehnungsregel für ihren Pfad hinzu. Eine entsprechende Ablehnungsregel verhindert, dass sowohl der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.
Wenn Sie die Einstellung „Attach Open File“ deaktivieren, erhält die CLI den Pfad der aktiven Datei nur, wenn 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. Der Transport ist unverschlüsseltes ws://; da der Socket nur loopback ist, kann jeder Prozess, der den Datenverkehr erfassen kann, auch das Token aus der Lock-Datei lesen, daher würde TLS keinen zusätzlichen Schutz bieten. Jede Erweiterungsaktivierung generiert ein neues zufälliges Auth-Token, schreibt es in eine Lock-Datei unter ~/.claude/ide/<port>.lock, und die CLI muss es als X-Claude-Code-Ide-Authorization-Header präsentieren, um sich zu verbinden. Die Lock-Datei hat 0600-Berechtigungen in einem 0700-Verzeichnis, daher kann nur der Benutzer, der VS Code ausführt, sie lesen. Wenn CLAUDE_CONFIG_DIR gesetzt ist, wird die Lock-Datei stattdessen in $CLAUDE_CONFIG_DIR/ide/ geschrieben.
Dem Modell verfügbar gemachte Tools. Der Server hostet ein Dutzend Tools, aber nur zwei sind für das Modell sichtbar. Der Rest ist internes RPC, das die CLI für ihre eigene Benutzeroberfläche verwendet, etwa zum Öffnen von Diffs, Lesen von Auswahlen und Speichern von Dateien. Diese Tools werden herausgefiltert, bevor die Toolliste Claude erreicht.
Diagnosen im Chat-Panel. Im Chat-Panel liest Claude mit Claude Code v2.1.285 oder höher 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:
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. mcp__ide__executeCode kann nichts stillschweigend ausführen. Bei jedem Aufruf wird der Code als neue Zelle am Ende des aktiven Notebooks eingefügt, VS Code scrollt ihn in die Ansicht, und ein natives Quick Pick fragt Sie, ob Sie Execute oder Cancel wählen. Abbrechen oder das Schließen des Pickers mit Esc gibt einen Fehler an Claude zurück, und nichts wird ausgeführt. Das Tool weigert sich auch kategorisch, wenn es kein aktives Notebook gibt, 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 lässt Claude die Ausführung einer Zelle vorschlagen; das Quick Pick in VS Code ist das, was es tatsächlich ausführen lässt.Häufige Probleme beheben
Anmelde-, Netzwerk- und Startfehler 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 wird nicht installiert
- Stellen Sie sicher, dass Sie eine kompatible Version von VS Code haben (1.94.0 oder später)
- Überprüfen Sie, dass VS Code die Berechtigung zum Installieren von Erweiterungen hat
- Versuchen Sie, die Erweiterung direkt vom VS Code Marketplace zu installieren
Spark-Symbol nicht sichtbar
Das Spark-Symbol wird in der Editor-Symbolleiste (oben rechts im Editor) angezeigt, wenn Sie eine Datei geöffnet haben. Wenn Sie es nicht sehen:- Öffnen Sie eine Datei: Das Symbol erfordert, dass eine Datei geöffnet ist. Es reicht nicht aus, nur einen Ordner geöffnet zu haben.
- Überprüfen Sie die VS Code-Version: Erfordert 1.94.0 oder höher (Hilfe → Über)
- Starten Sie VS Code neu: Führen Sie „Developer: Reload Window“ aus der Befehlspalette aus
- Deaktivieren Sie in Konflikt stehende Erweiterungen: Deaktivieren Sie vorübergehend andere KI-Erweiterungen (Cline, Continue, usw.)
- Überprüfen Sie die Workspace-Vertrauenswürdigkeit: Die Erweiterung funktioniert nicht im eingeschränkten Modus
Cmd+Shift+P / Ctrl+Shift+P) verwenden und „Claude Code“ eingeben.
Cmd+Esc funktioniert auf macOS nicht
Auf macOS Tahoe und später ist die System-Game-Overlay-Verknüpfung standardmäßig anCmd+Esc gebunden und fängt den Tastendruck ab, bevor er VS Code erreicht. So geben Sie die Verknüpfung frei:
- Öffnen Sie die Systemeinstellungen
- Gehen Sie zu Tastatur, dann Tastaturkürzel, dann Game Controllers
- Deaktivieren Sie das Kontrollkästchen für Game Overlay
Cmd+K Cmd+S), suchen Sie nach Claude Code: Focus input, und weisen Sie eine neue Bindung zu.
Eine fortgesetzte Konversation ist zunächst leer
Wenn Sie eine frühere Konversation fortsetzen oder eine Konversation nach einem Neuladen zurückkehrt, können ihre Nachrichten leer bleiben, während der Claude Code-Prozess der Konversation startet. Nach etwa einer Sekunde erscheintWaiting for your plugins… im leeren Bereich.
Sie müssen nichts tun. Die Nachrichten werden angezeigt, 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.
Claude Code antwortet nie
Wenn Claude Code nicht auf Ihre Eingaben antwortet:- Überprüfen Sie Ihre Internetverbindung: Stellen Sie sicher, dass Sie eine stabile Internetverbindung haben
- Starten Sie ein neues Gespräch: Versuchen Sie, ein neues Gespräch zu starten, um zu sehen, ob das Problem weiterhin besteht
- Versuchen Sie die CLI: Führen Sie
claudevom Terminal aus, um zu sehen, ob Sie detailliertere Fehlermeldungen erhalten
Erweiterung deinstallieren
So deinstallieren Sie die Claude Code-Erweiterung:- Öffnen Sie die Ansicht „Erweiterungen“ (
Cmd+Shift+Xauf Mac oderCtrl+Shift+Xauf Windows/Linux) - Suchen Sie nach „Claude Code“
- Klicken Sie auf Deinstallieren
claude in einem integrierten VS Code-Terminal ausführen, installiert Claude Code die Erweiterung automatisch neu. Um sie deinstalliert zu halten, deaktivieren Sie Auto-install IDE extension in /config, oder setzen Sie autoInstallIdeExtension auf false. Sie können auch die Umgebungsvariable CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL auf 1 setzen.
Um auch Erweiterungsdaten zu entfernen und alle Einstellungen zurückzusetzen, löschen Sie das Speicherverzeichnis der Erweiterung für Ihre Plattform.
Auf macOS:
Nächste Schritte
Jetzt, da Sie Claude Code in VS Code eingerichtet haben:- Erkunden Sie häufige Workflows, um das Beste aus Claude Code herauszuholen
- Richten Sie MCP servers ein, um Claudes Funktionen mit externen Tools zu erweitern. Fügen Sie sie mit
/mcpim Chat-Panel hinzu und verwalten Sie sie. - Konfigurieren Sie Claude Code-Einstellungen, um zulässige Befehle, hooks und mehr anzupassen. Diese Einstellungen werden zwischen der Erweiterung und der CLI geteilt.