Die Claude Code VS Code Extension ist die offizielle Extension von Anthropic (ID anthropic.claude-code), die Claude Code in einem grafischen Panel in VS Code anzeigt. Du installierst sie über die Extensions-Ansicht und meldest dich an, danach sieht Claude deine geöffnete Datei und deine Auswahl, zeigt vorgeschlagene Änderungen als Side-by-Side-Diffs, die du annimmst oder ablehnst, und teilt den Verlauf mit der CLI. Sie braucht VS Code 1.94.0 oder neuer und einen kostenpflichtigen Claude-Tarif oder einen Console-Account. Wenn du das Terminal bevorzugst, kannst du die claude-CLI auch im integrierten Terminal von VS Code ausführen und die IDE-Diffs behalten.
Dieser Leitfaden behandelt die Installation, Extension versus CLI, die Diff-Ansicht, den Auswahlkontext, die Einstellungen, die sich zu ändern lohnen, häufige Probleme und einen kurzen Abschnitt zu JetBrains. Alles hier stammt aus der offiziellen VS-Code-Doku und der JetBrains-Doku.
Die Extension installieren
- Öffne VS Code und drücke
Cmd+Shift+X(Mac) oderCtrl+Shift+X(Windows/Linux). - Suche nach Claude Code und installiere die Extension von Anthropic.
- Erscheint sie nicht sofort, starte VS Code neu oder führe Developer: Reload Window über die Command Palette aus.
- Öffne das Panel und melde dich an, sobald danach gefragt wird.
Voraussetzungen:
| Voraussetzung | Detail |
|---|---|
| VS Code | 1.94.0 oder neuer |
| Account | Pro-, Max-, Team- oder Enterprise-Tarif oder ein Console-Account |
| Workspace | Vertrauenswürdig (die Extension läuft nicht im Restricted Mode) |
Cursor und andere VS-Code-Forks
Die Doku bietet einen direkten Link Install for Cursor, Cursor wird also unterstützt. Andere VS-Code-Forks können die Extension aus der Open-VSX-Registry installieren. Kann dein Editor sie gar nicht installieren, öffne sein integriertes Terminal und führe claude aus.
Claude Code öffnen
Es gibt vier Wege:
- Spark-Symbol in der Editor-Symbolleiste oben rechts. Es erscheint nur, wenn eine Datei geöffnet ist.
- Activity Bar: die Sessions-Liste links.
- Command Palette (
Cmd+Shift+P/Ctrl+Shift+P): „Claude Code“ eintippen und Open in New Tab wählen. - Statusleiste: klicke unten rechts auf ✻ Claude Code. Funktioniert ohne geöffnete Datei.
Du kannst das Panel in die sekundäre Seitenleiste (rechts), die primäre Seitenleiste (links) oder als Tab in den Editorbereich ziehen. Die Doku empfiehlt die Seitenleiste für deine Hauptsession und Tabs für Nebenaufgaben.
Extension oder CLI im integrierten Terminal?
Beides ist dasselbe Claude Code. Der Unterschied liegt in der Oberfläche und einer Handvoll Funktionen.
| Funktion | CLI | VS Code Extension |
|---|---|---|
| Befehle und Skills | Alle | Eine Teilmenge (tippe /, um sie zu sehen) |
| MCP-Server-Konfiguration | Ja | Ja, mit /mcp im Panel |
| Checkpoints | Ja | Ja |
!-Shell-Kürzel | Ja | Nein |
| Tab-Vervollständigung | Ja | Nein |
Die Falle, über die viele stolpern: Die Installation der Extension legt claude nicht in deinen PATH. Die Extension bringt für ihr Panel eine private Kopie der CLI mit. Um claude in einem Terminal einzutippen, brauchst du die eigenständige CLI-Installation.
Sind beide installiert, teilen sie sich den Gesprächsverlauf. Führe claude --resume im Terminal aus, um ein Gespräch fortzusetzen, das du im Panel begonnen hast.
Um die CLI in VS Code auszuführen, drücke Ctrl+` (auf dem Mac Cmd+`) und starte claude. Sie verbindet sich automatisch mit der IDE für Diffs und Diagnosen. Aus einem externen Terminal führst du in Claude Code /ide aus, um die Verbindung zu VS Code herzustellen.
Wenn du die Terminal-Oberfläche magst, sie aber anstelle des Panels haben willst, aktiviere die Einstellung Use Terminal (claudeCode.useTerminal).
Faustregel: Nutze das Panel, wenn du dich durch Diffs klicken und Pläne als Dokumente sehen willst. Nutze die CLI, wenn du alle Slash-Befehle, den !-Shell-Modus und die Tastenkürzel aus unserem Cheat Sheet brauchst.
Auswahlkontext und @-Erwähnungen
Die Extension fügt deiner Nachricht die im Editor geöffnete Datei hinzu, und Claude sieht den Text, den du markiert hast. Du musst keinen Code in den Prompt einfügen.
Option+K(Mac) /Alt+K(Windows/Linux) fügt einen Verweis auf die aktuelle Datei und Auswahl ein, etwa@auth.ts#5-10. Der Editor muss den Fokus haben.@im Prompt-Feld erwähnt eine beliebige Datei oder einen Ordner.@terminal:nameverweist auf die Ausgabe eines Terminals.Cmd+Esc/Ctrl+Escwechselt den Fokus zwischen Editor und Claude.
Hinweis zum Datenschutz: Markierter Text wird nicht aus Dateien gesendet, die durch files.exclude oder search.exclude erfasst sind, und auch nicht aus per Gitignore ausgeschlossenen Dateien, solange respectGitIgnore aktiv ist. Das gilt für das Chat-Panel. Wenn nur deine Auswahl gesendet werden soll und nicht die ganze geöffnete Datei, schalte attachOpenFile aus.
Die Diff-Ansicht
Will Claude im Manual-Modus eine Datei ändern, zeigt VS Code einen Side-by-Side-Diff der vorgeschlagenen Änderung. Du kannst sie annehmen, ablehnen oder den vorgeschlagenen Text vor dem Annehmen bearbeiten. Neuere Versionen erlauben es außerdem, einzelne Änderungen innerhalb einer Bearbeitung anzunehmen oder abzulehnen, mit Accept Change at Cursor und Reject Change at Cursor in der Command Palette. Sehr große Bearbeitungen (über 100 Änderungen) bekommen keine Schaltflächen pro Änderung.
Wie oft du Diffs siehst, hängt vom Berechtigungsmodus im Prompt-Feld ab:
| Modus | Was passiert |
|---|---|
| Manual | Claude fragt vor jeder Bearbeitung und zeigt den Diff |
| Edit automatically | Bearbeitungen werden ohne Nachfrage angewendet |
| Plan | Claude schreibt einen Plan als Markdown-Dokument, den du kommentieren kannst, und wartet |
| Auto | Claude entscheidet mit einer Sicherheitsprüfung; in neueren Versionen ist das der Standard |
Checkpoints setzen darauf auf. Fahre mit der Maus über eine Nachricht, um die Rückspul-Schaltfläche zu sehen: Rewind code to here, Fork conversation from here oder beides zugleich.
Einstellungen, die sich zu ändern lohnen
Öffne die VS-Code-Einstellungen (Cmd+, / Ctrl+,) und gehe zu Extensions > Claude Code. Gemeinsame Einstellungen wie erlaubte Befehle, Hooks und MCP-Server gehören in ~/.claude/settings.json, die auch die CLI liest.
| Einstellung | Standard | Warum ändern |
|---|---|---|
useTerminal | false | Die Oberfläche im CLI-Stil statt des Chat-Panels öffnen |
initialPermissionMode | nicht gesetzt | Neue Chats in default, plan, acceptEdits oder bypassPermissions starten |
preferredLocation | panel | sidebar hält Claude rechts angedockt |
attachOpenFile | true | Ausschalten, um nur deine Auswahl zu senden |
autosave | true | Speichert Dateien, bevor Claude sie liest oder schreibt |
useCtrlEnterToSend | false | Mit Ctrl/Cmd+Enter senden, Enter für Zeilenumbrüche |
respectGitIgnore | true | Per Gitignore ausgeschlossene Dateien aus Suche und Auswahlkontext heraushalten |
environmentVariables | [] | Umgebungsvariablen nur für den Claude-Prozess |
allowDangerouslySkipPermissions | false | Fügt Bypass permissions zum Modusmenü hinzu. Nur für Sandboxes |
initialPermissionMode wird nur aus deinen Benutzereinstellungen gelesen, nicht aus den Workspace-Einstellungen. Füge "$schema": "https://json.schemastore.org/claude-code-settings.json" zu settings.json hinzu, um Autovervollständigung zu bekommen.
Mehrere Gespräche parallel führen
Open in New Tab (Cmd+Shift+Esc / Ctrl+Shift+Esc) und Open in New Window starten zusätzliche Gespräche mit eigenem Verlauf. Ein farbiger Punkt am Spark-Symbol des Tabs zeigt den Status: blau bei einer offenen Berechtigungsanfrage, orange, wenn Claude fertig wurde, während der Tab verborgen war. Die Sessions-Liste kann Sessions gruppieren und nach Needs input, Working oder Completed filtern.
Häufige Probleme beheben
| Problem | Lösung |
|---|---|
| Die Extension lässt sich nicht installieren | Prüfe, ob VS Code 1.94.0+ ist und Extensions installieren darf, oder installiere von der Marketplace-Seite |
| Kein Spark-Symbol | Öffne eine Datei (ein Ordner allein reicht nicht), vertraue dem Workspace, deaktiviere störende KI-Extensions, lade das Fenster neu |
Cmd+Esc tut auf macOS nichts | macOS Tahoe belegt es mit dem Game Overlay. Schalte das unter Keyboard Shortcuts → Game Controllers aus oder belege Claude Code: Focus input neu |
| „Not logged in · Please run /login“ | Lade das Fenster neu und melde dich erneut an |
ANTHROPIC_API_KEY wird nicht erkannt | Starte VS Code mit code . aus einem Terminal, damit es die Umgebung erbt |
claude im Terminal nicht gefunden | Installiere die eigenständige CLI; die Extension fügt sie nicht zum PATH hinzu |
| Claude antwortet nie | Prüfe die Verbindung, starte ein neues Gespräch und probiere dann claude in einem Terminal für eine klarere Fehlermeldung |
| Du brauchst Logs | Führe Claude Code: Show Logs über die Command Palette aus |
Claude Code in JetBrains-IDEs
Das Plugin Claude Code [Beta] aus dem JetBrains Marketplace unterstützt IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm und GoLand. Anders als die VS Code Extension führt es die claude-CLI im Terminal der IDE aus, installiere die CLI also zuerst. Erscheint „Cannot launch Claude Code“, liegt claude nicht in deinem PATH.
Das bekommst du:
Cmd+Esc/Ctrl+Escöffnet Claude Code aus dem Editor.Cmd+Option+K/Alt+Ctrl+Kfügt einen Dateiverweis wie@src/auth.ts#L1-99ein.- Vorgeschlagene Änderungen öffnen sich im Diff-Viewer der IDE. Setze Diff tool in
/configaufautooderterminal. - Deine Auswahl und die IDE-Diagnosen (Lint- und Typfehler) werden mit Claude geteilt.
- Aus einem externen Terminal verbindest du dich mit
/ide.
Zwei Lösungen aus der Doku: Unterbricht Esc Claude nicht, gehe zu Settings → Tools → Terminal und deaktiviere „Move focus to the editor with Escape“. Setze unter WSL den Claude-Befehl des Plugins auf wsl -d Ubuntu -- bash -lic "claude", und falls „No available IDEs detected“ erscheint, füge eine Firewall-Regel hinzu oder stelle WSL auf Mirrored Networking um.
Wann eine eigene App für viele Agenten sinnvoll ist
Die Extension ist auf ein Editorfenster und ein paar Gespräche ausgelegt. Das deckt die meisten Tage ab. Schwieriger wird es, wenn du vier oder fünf Agenten gleichzeitig auf verschiedenen Branches laufen lässt oder Claude Code mit Codex oder anderen CLI-Agenten mischst und den Überblick verlierst, welcher eine Antwort braucht.
Dafür ist AgentVera gebaut. Es ist eine Desktop-App für macOS, Windows und Linux, die jeden CLI-Agenten in einem eigenen Pane ausführt, in einem Raster pro Projekt. Es ist kein Editor und ersetzt VS Code nicht. Viele lassen beide geöffnet.
- Viele Agenten, eine Ansicht. Der Workspace ordnet Agenten in Rastern bis 5×4 an. Die Gruppenansicht zählt die Agenten, die arbeiten, auf eine Antwort warten oder auf eine Freigabe warten, mit Approve und Reject auf jeder Karte.
- Diffs ohne Fensterwechsel. Die Werkzeuge Editor und Terminal enthalten einen Dateieditor und einen Tab Changes, der den Diff zwischen HEAD und Arbeitsverzeichnis zeigt, unified oder Side-by-Side. Git und GitHub ergänzt Worktrees und PRs.
- Ein zweiter Blick. Das automatische Code-Review lässt ein von dir gewähltes Claude-Modell den Code eines Agenten prüfen, sobald dessen Turn endet, mit file:line-Links.
Wenn du parallele Arbeit einrichtest, ist Git Worktrees für parallele Agenten der nächste Schritt.
Um AgentVera auszuprobieren, beginne auf der Startseite.