Claude Code für bestehende Codebases: In 45 Minuten lesen, ändern und prüfen

Warum dieser Ablauf wichtig ist

Claude Code ist in bestehenden Codebases oft wertvoller als in leeren Projekten. Gleichzeitig ist die erste Sitzung riskanter. Wer sofort einen großen Umbau fordert, bekommt einen Diff, den niemand sauber prüfen kann. Besser ist zuerst eine Karte: Einstiegspunkte, sichere Dateien, riskante Bereiche und ein kleiner Patch mit Beweis.

Für mehr Kontext lesen Sie auch den Claude-Code-Einstieg, harness engineering, den Berechtigungsleitfaden.

Der praktische Ablauf

Der 45-Minuten-Ablauf: Status sichern, Dateien kartieren, einen engen Patch wählen, einen Prüfbefehl ausführen und eine Handoff-Notiz schreiben. Bei Content-Sites gehören Gratis-PDF, Gumroad-Produkt und Beratungs-CTA zur Karte.

Minimales Kopier-Set

git status --short
rg --files | Select-Object -First 80
rg "TODO|FIXME|console\.log|throw new Error" -n site src scripts
cd site
npm.cmd run build

# CLAUDE.md

## Existing-codebase map
- entry points: site/src/pages, site/src/layouts, site/src/lib
- safe first task: update one CTA or one article
- risky areas: auth, billing, deploy scripts, secrets

## Definition of done
- small diff
- one proof command
- public URL or local preview checked
- next step written down

Read this repository as an existing codebase.
Return:
1. the three most important entry points
2. the safest first patch under 45 minutes
3. files that should not be touched today
4. the proof command
5. the handoff note format

Drei echte Anwendungsfälle

• Nur den unteren CTA eines Artikels verbessern und den Gratis-PDF-Pfad prüfen.
• Sichere Befehle, verbotene Bereiche und Done-Kriterien in CLAUDE.md ergänzen.
• Einen internen Link von einem beliebten Artikel zur Produktseite setzen und h1 plus CTA auf der öffentlichen URL prüfen.

Fehlerfälle und Gegenmittel

Der häufige Fehler lautet: ‘Refactore das ganze Projekt’. Claude Code kann plausible Änderungen liefern, aber der Patch wird zu groß. Starten Sie mit einer Datei, einem Pfad und einem Prüfbefehl.

Pfad zu Gratis-PDF, Gumroad und Beratung

Nutzen Sie zuerst das kostenlose Cheatsheet. Der Setup Guide passt, wenn CLAUDE.md, Hooks, Permissions und Teamregeln wiederholbar werden sollen. Beratung passt, wenn Einführung oder Umsatzpfad entschieden werden müssen.

• Kostenloses Claude-Code-Cheatsheet
• Claude-Code-Prompt-Vorlagen
• Claude-Code-Setup-Guide
• Produkte
• Beratung

Starten Sie mit dem kostenlosen Cheatsheet, kaufen Sie den Gumroad-Leitfaden bei wiederholbaren Workflows und buchen Sie Beratung, wenn Einführung oder Umsatzpfad nicht geraten werden sollten.

Was ich für diesen Artikel geprüft habe

Ich habe PowerShell-Befehle, CLAUDE.md-Fragment und CTA-Prüfung getrennt, damit der Ablauf direkt in einem echten Repository nutzbar bleibt.