Claude Code in VS Code einrichten und mehr damit machen als Autovervollständigung

Installiert heißt noch nicht integriert

Claude Code neben VS Code zum Laufen zu bringen, dauert etwa zehn Minuten. Bis es die eigene Arbeitsweise verändert, dauert es länger. Ein typisches Muster: anbinden und dann wie Copilot behandeln, für Tab-Vervollständigung, schnelle Vorschläge und gelegentliches Refactoring. Das ist in Ordnung und nützlich, aber nicht bahnbrechend, ungefähr so, als würde man einen Sportwagen im ersten Gang fahren. Claude im Editor zu haben und Claude in den Workflow einzubauen, sind zwei verschiedene Dinge. Die Einrichtung geht schnell, der Nutzen kommt, wenn man weiß, was man danach von ihm verlangt.

Vier Wege, Claude mit VS Code zu nutzen

"Claude in VS Code" kann Verschiedenes bedeuten:

• Claude Code im Terminal: die CLI von Anthropic selbst. Sie hat Zugriff auf die gesamte Codebasis, liest und schreibt Dateien, führt Befehle aus und arbeitet über viele Dateien gleichzeitig. Die mächtigste der vier Varianten.
• GitHub Copilot mit einem Claude-Modell: Wer Copilot abonniert hat, kann das Modell auf Claude Sonnet umstellen und in der vertrauten Oberfläche bleiben.
• Claude.ai in einem Browser-Tab neben dem Editor: simpel und unterschätzt. Code einfügen, Vorschläge holen, zurückkopieren. Langsamer, funktioniert aber überall und kostet nichts extra.
• Erweiterungen von Drittanbietern mit Claude-Chat in der Seitenleiste: Die Qualität schwankt, manche wurden seit Monaten nicht aktualisiert.

Im Folgenden geht es um Claude Code, weil genau das verändert, wie viel die KI leisten kann. Browser-Chat und Copilot sind praktisch, aber begrenzt. Claude Code sieht das ganze Projekt, versteht die Beziehungen zwischen Dateien, führt Tests aus und iteriert, und das ist eine andere Werkzeugklasse.

Einrichtung in drei Schritten

Rechnen Sie mit etwa 10 Minuten, wenn Sie es schon einmal gemacht haben, beim ersten Mal vielleicht mit 20.

Installieren

Claude Code ist ein Kommandozeilen-Tool und wird über npm installiert:

npm install -g @anthropic-ai/claude-code

Es braucht Node.js 18 oder neuer, also vorher aktualisieren, falls Ihre Version älter ist. Nach der Installation starten Sie es:

claude

Es fordert Sie auf, sich mit Ihrem Anthropic-Konto anzumelden. Für den Anfang reicht ein kostenloses Konto, bei einem echten Projekt stoßen Sie aber schnell an Limits. Nach der Anmeldung sind Sie fertig.

Aus dem VS-Code-Terminal nutzen

Der hier beschriebene Weg kommt ohne VS-Code-Erweiterung aus. Claude Code läuft im integrierten Terminal, der Ablauf ist also:

1. Das Projekt in VS Code öffnen.
2. Das integrierte Terminal mit Ctrl+ (Cmd+ auf dem Mac) öffnen.
3. Per cd ins Projektverzeichnis wechseln.
4. claude eingeben.

Ab dann kennt es den Kontext des Projekts. Es kann Dateien lesen, die Struktur erfassen, Ihre Tests ausführen und mehrere Dateien in einem Durchgang ändern. Neben dem Editor macht es sich ebenfalls gut: Claude im Terminalbereich bearbeiten lassen und zusehen, wie die Änderungen live im Editor auftauchen. Die geteilte Ansicht ist anfangs etwas ungewohnt und fühlt sich dann flüssig an.

Eine CLAUDE.md schreiben

Die meisten Tutorials lassen diesen Schritt aus, dabei bringt er am meisten. CLAUDE.md ist eine Datei im Projektstamm, die Claude Ihre Konventionen, Vorlieben und Regeln erklärt. Ohne sie trifft Claude vernünftige Annahmen aus dem, was es sieht. Mit ihr verhält es sich, als wäre es schon seit Monaten im Team. Eine Minimalversion:

# Project conventions

## Tech stack
- Node.js 20, TypeScript, Express
- PostgreSQL via Prisma
- Jest for testing

## Code style
- Use async/await, never callbacks
- Prefer explicit error handling over try/catch everywhere
- All new functions need JSDoc comments

## Testing
- Every new endpoint needs at least 3 tests: happy path,
  validation error, and auth failure
- Use factories, not fixtures

## What NOT to do
- Don't use any (TypeScript). Use unknown and narrow it.
- Don't add console.log for debugging. Use the logger.
- Don't install new dependencies without asking first.

Fünfzehn Minuten für diese Datei sparen Stunden, in denen Sie Claudes Standardverhalten korrigieren. Ergänzen Sie sie jedes Mal, wenn Claude denselben Fehler zweimal macht.

Gewohnheiten, mit denen es sich lohnt

Ist die Einrichtung erledigt, kommt der schwierigere Teil: es so zu nutzen, dass es einem normalen Chatfenster überlegen ist.

Größere Aufgaben übergeben

Am Anfang nutzen viele Claude Code als bessere Autovervollständigung und bitten um eine Funktion, eine Syntaxkorrektur oder einen zusätzlichen Parameter nach dem anderen. Das funktioniert, macht das Tool aber nicht besonders. Bei größeren Aufgaben ist es stärker. Etwa so: Füge allen List-Endpunkten dieser API Paginierung hinzu, so macht es der Users-Endpunkt bisher, wende dasselbe Muster überall an. Von Hand ist das eine Stunde Arbeit, Claude schafft es in rund fünf Minuten.

Das Kontextfenster ist groß genug für einen ordentlichen Teil einer echten Codebasis, also nutzen Sie das. Geben Sie ihm mehrere Dateien, beschreiben Sie das Gesamtbild und lassen Sie es über alles hinweg arbeiten.

Es ermitteln lassen

Wenn in Produktion etwas Merkwürdiges auftaucht, etwa eine langsame Abfrage, eine leicht falsche Antwort oder ein Fehler, der nur ab und zu kommt, beschreiben Sie es, zeigen Sie Claude die relevanten Dateien und fragen Sie, wo es schiefgehen könnte. Es liest sich durch die Codebasis und liefert eine nach Wahrscheinlichkeit sortierte Liste von Verdächtigen. Es liegt nicht immer richtig, findet aber Dinge, die Sie übersehen hätten, und verfolgt Ausführungspfade viel schneller als von Hand.

In einem direkten Vergleich mit Cursor und Copilot an einem echten Bug war Claude Code das einzige Tool, das vor dem Start innehielt und eine Rückfrage stellte, und genau diese Frage war der ganze Bug.

Zuerst den Test schreiben

Klingt verkehrt herum, funktioniert aber gut bei allem mit klaren Anforderungen. Schreiben Sie einen Test, der das gewünschte Verhalten beschreibt, übergeben Sie ihn und sagen Sie: Bring den zum Laufen, ohne etwas anderes kaputtzumachen. Daraus folgen drei Dinge. Die Implementierung entspricht Ihren tatsächlichen Anforderungen, weil Sie sie in Code festgelegt haben. Unklarheiten zeigen sich früh, weil das Schreiben des Tests Sie durch die Randfälle zwingt. Und am Ende haben Sie einen Test, den Sie nicht unbedingt bekämen, wenn Sie zuerst das Feature und danach Tests verlangen. Besonders lohnt sich das bei Zahlungsabläufen, Authentifizierung und externen APIs, wo Fehler so teuer sind, dass das richtige Verhalten feststehen sollte, bevor es Code gibt.

Für Refactoring einsetzen

Refactorings sind leicht beschrieben und mühsam sorgfältig umzusetzen. Vielleicht ist eine Funktion ausgeufert, ein Modul hat zu viel übernommen, oder dasselbe Snippet wurde fünfmal kopiert statt abstrahiert. Sagen Sie Claude, wofür das Modul zuständig sein soll, lassen Sie den Rest in ein neues auslagern und alle Importstellen anpassen. Es zieht das durch die ganze Codebasis, korrigiert jede Referenz und lässt die Testsuite laufen, um zu prüfen, dass nichts kaputtgegangen ist. Was einen konzentrierten Vormittag kosten würde, ist womöglich in zwanzig Minuten erledigt.

Wo es an Grenzen stößt

• Es macht selbstbewusste Fehler. Claude Code implementiert manchmal etwas falsch, ohne Zweifel anzumelden, also lesen Sie das Ergebnis, statt es nur auszuführen, besonders wenn Daten oder Geld im Spiel sind.
• Die Architektur nimmt es Ihnen nicht ab. Ein Design umzusetzen ist seine Stärke, zu entscheiden, was gebaut wird, wie das System aufgebaut ist und welche Kompromisse man eingeht, nicht. Diese Entscheidungen bleiben bei Ihnen.
• Kontextgrenzen sind real. In einer sehr großen Codebasis sieht es nicht alles, also zeigen Sie ihm die relevanten Dateien, statt davon auszugehen, dass es weiß, wo es suchen soll.
• Es kann nicht ausführen, was Ihre Umgebung nicht ausführen kann. Brauchen Tests eine bestimmte Datenbankverbindung, einen laufenden Server oder Umgebungsvariablen, muss das eingerichtet sein. Es arbeitet in Ihrer echten Umgebung und zaubert nicht.

Bevor Sie ihm etwas Produktionskritisches anvertrauen, sollten Sie genau wissen, wo es bei einem realistischen Feature gescheitert ist.

Drei Prompts, die man behalten sollte

Sie sind aus viel Ausprobieren entstanden.

Kontext zuerst. Beschreiben Sie das aktuelle und das gewünschte Verhalten ausdrücklich, damit Claude das Bestehende nicht falsch versteht:

I'm working in [filename]. Here's the current behavior:
[describe it]

Here's what I want it to do instead:
[describe it]

Constraints: [any important limits]

Make the change and update any affected tests.

Annahmen offenlegen. Nutzen Sie das immer, wenn Anforderungen auch nur leicht mehrdeutig sind. Es kostet eine halbe Minute und bewahrt Sie vor einer subtil falschen Implementierung:

Before you start coding, list the assumptions you're making
about how this should work. I'll confirm or correct them.

Review mit Checkliste. Ein Code-Review ist am nützlichsten, wenn Sie sagen, worauf geachtet werden soll. Sonst bemängelt das Modell gern Stilfragen und übersieht das Wesentliche. Lassen Sie das laufen, bevor Sie etwas Größeres mergen:

Review this code for: performance issues, security concerns,
missing error handling, and anything that would cause problems
at scale. Be specific. If something is fine, say it's fine
and move on.

Claude Code oder Copilot?

Die beiden glänzen bei unterschiedlichen Aufgaben, weshalb Leute, die beide ausprobieren, meist beide behalten. Copilot gewinnt bei der Inline-Vervollständigung: Vorschläge erscheinen beim Tippen, ohne gedanklichen Kontextwechsel, die Tab-Vervollständigung ist noch immer flüssiger und es ist etwas besser in die VS-Code-Oberfläche eingebunden. Claude Code ist stärker bei Aufgaben über mehrere Dateien, bei Ermittlungen, Refactoring und allem, was sich in natürlicher Sprache beschreiben und der KI zur Bearbeitung über die Codebasis überlassen lässt. Bei agentischen Fähigkeiten liegt es klar vorn.

Wenn Sie sich für eines entscheiden müssen, nehmen Sie Claude Code, denn die Arbeit, die nur es gut erledigt, ist mehr wert als schnellere Autovervollständigung. Viele Entwickler, die es täglich nutzen, lassen Copilot trotzdem im Hintergrund laufen und wechseln je nach Aufgabe.

Was den Unterschied gemacht hat

Nach Monaten täglicher Nutzung kam die größte Verbesserung nicht von der Einrichtung. Sie kam davon, anders zu fragen. Wer am meisten aus Claude Code herausholt, schreibt damit nicht schneller Funktionen. Diese Leute geben ihm größere, unordentlichere, realistischere Probleme: das ewig aufgeschobene Refactoring, das Feature über sechs Dateien, die Fehlersuche, die einen Nachmittag Logs lesen kosten würde.

Die Einrichtung kostet zehn Minuten. In solchen größeren Aufgaben denken zu lernen ist die eigentliche Investition, und sie lohnt sich.