Workflow-Tipps
Effiziente Claude Code Entwicklungsworkflows zur Steigerung der Teamproduktivität
Brauchen Sie einen API-Key? Registrieren →Endpunkte & Base-URLs →
Auf dieser Seite
- Plan-Ausführung-Workflow
- Feature-Branch-Workflow
- Code-Review-Workflow
- Testgetriebener Workflow
- Debugging-Workflow
- Workflow für die Zusammenarbeit mit Subagents
- Workflow für die IDE-Integration
- Workflow für die Teamarbeit
- Workflow-Checkliste
- Die wichtigsten Schalter für Workflows
- Hinweise zum Betrieb auf QCode
- Häufige Fehler und Fehlersuche
- FAQ
- Nächste Schritte
Dieser Leitfaden zeigt, wie Sie Claude Code in Ihren täglichen Entwicklungsworkflow integrieren – von der persönlichen Effizienz bis zur Teamzusammenarbeit – und wie Sie effiziente KI-gestützte Entwicklungsprozesse etablieren.
Plan-Ausführung-Workflow¶
Das effektivste Claude Code-Muster ist erst planen, dann ausführen – vermeiden Sie, dass die KI direkt Code schreibt.
Grundablauf¶
1. Analyze Requirements → 2. Create Plan → 3. Confirm Plan → 4. Execute Step by Step → 5. Verify Results
Praktische Schritte¶
Schritt 1: Claude die Anforderungen verstehen lassen
> Read the code in @src/services/ directory and understand the existing architecture.
> Don't write any code, just analyze.
Schritt 2: Implementierungsplan erstellen
> Based on your understanding of the existing code, create a detailed implementation plan for "user permission management".
> Include: file changes, new files, dependencies, risk points.
Schritt 3: Plan bestätigen und anpassen
Prüfen Sie Claudes Plan und schlagen Sie Änderungen vor:
> In step 3 of the plan, I want to use Redis cache instead of memory cache. Please adjust the plan.
Schritt 4: Schrittweise ausführen
> Now execute step 1 of the plan: create the permission model.
Nach Abschluss jedes Schritts Ergebnisse verifizieren, bevor Sie fortfahren.
Feature-Branch-Workflow¶
Best Practices für Git-Branches¶
# 1. Create feature branch
git checkout -b feature/user-permissions
# 2. Navigate to project and start Claude Code
cd your-project && claude
# 3. Commit frequently during development
> Committe diese Änderung # Erster Commit
# Continue developing...
> Committe diese Änderung # Zweiter Commit
# 4. Feature complete, create PR
> Create a PR description for the current branch, summarizing all commit changes
Tipps zur Commit-Häufigkeit¶
-
Kleine Commits: Nach jedem unabhängigen Funktionspunkt committen
-
Commit-Messages: Claude eine passende Message aus dem Diff erzeugen lassen (Projekte mit eigenem
/commit-Befehl können diesen nutzen) -
Große Commits vermeiden: Nicht zu viele Änderungen ansammeln, bevor committet wird
Code-Review-Workflow¶
Selbstüberprüfung¶
Vor dem Einreichen eines PRs von Claude prüfen lassen:
> /review
> Focus on: security, performance, code style
Code anderer prüfen¶
# Get PR changes
gh pr diff 123 | claude "Review this PR, focus on:
1. Logic correctness
2. Edge case handling
3. Error handling
4. Code maintainability"
Mehrstufiger Review-Prozess¶
Für komplexe PRs strukturiertes Review verwenden:
> Phase 1: Check if architecture design is reasonable
> Phase 2: Check if implementation matches design
> Phase 3: Check if test coverage is sufficient
> Phase 4: Check if documentation is complete
Testgetriebener Workflow¶
TDD mit Claude Code¶
1. Write Tests → 2. Run Tests (Fail) → 3. Write Code → 4. Run Tests (Pass) → 5. Refactor
Praktische Schritte¶
Schritt 1: Tests definieren
> Write test cases for user registration, covering:
> - Normal registration
> - Invalid email format
> - Weak password
> - User already exists
> Write tests first, don't implement the feature.
Schritt 2: Prüfen, dass Tests fehlschlagen
npm test # Expected: tests fail
Schritt 3: Funktion implementieren
> Now implement the code to make all tests pass.
Schritt 4: Verifizieren und refactoring
npm test # Expected: tests pass
> Tests pass. Now refactor the code for better readability without breaking tests.
Debugging-Workflow¶
Strukturiertes Debugging¶
1. Reproduce Issue → 2. Gather Information → 3. Analyze Cause → 4. Verify Hypothesis → 5. Fix Issue
Praktische Schritte¶
Schritt 1: Problem beschreiben
> Issue: After login, clicking "My Orders" shows blank page
> Expected: Display user's order list
> Steps to reproduce: Login → Click "My Orders"
Schritt 2: Informationen sammeln
> Analyze these files to find possible issues:
> @src/pages/MyOrders.tsx
> @src/services/OrderService.ts
> @src/api/orders.ts
Schritt 3: Logs analysieren
# Collect error logs
cat app.log | claude "Analyze these logs, find errors related to the orders page"
Schritt 4: Beheben und verifizieren
> Based on the analysis, fix the issue in OrderService
> After fixing, I'll test to verify
Workflow für die Zusammenarbeit mit Subagents¶
Parallele Verarbeitung¶
Nutzen Sie Subagents, um Aufgaben parallel zu bearbeiten:
> Execute these tasks simultaneously:
> 1. Use Explore agent to analyze project structure
> 2. Use Plan agent to design new feature approach
Spezialisierte Rollen¶
Verschiedene Subagents haben unterschiedliche Stärken:
| Agent | Spezialgebiet | Anwendungsfall |
|---|---|---|
| Explore | Schnelle Suche | Code finden, Struktur verstehen |
| Plan | Architekturentwurf | Planung komplexer Features |
| Background | Parallele Verarbeitung | Stapelaufgaben, lang laufende Aufgaben |
Workflow für die IDE-Integration¶
VS Code-Integration¶
-
Installieren Sie die Claude Code VS Code-Erweiterung
-
Wechseln Sie mit
Cmd+Esc/Ctrl+Escschnell zwischen den Fenstern -
Markieren Sie Code im Editor und rufen Sie dann Claude auf
Zusammenarbeit von Terminal und IDE¶
Terminal (Claude Code) IDE (VS Code)
↓ ↓
Analyze, Plan Manual adjustments, reading
↓ ↓
Generate Code ←─────────→ View diff, test
↓ ↓
Commit Code Continue development
Workflow für die Teamarbeit¶
Standardisierte CLAUDE.md¶
Teilen Sie die CLAUDE.md-Konfiguration im gesamten Team:
# Team Development Standards
## Code Style
- ESLint config: .eslintrc.js
- Prettier config: .prettierrc
## Git Standards
- Branch naming: feature/xxx, fix/xxx, hotfix/xxx
- Commit format: type(scope): description
## Testing Requirements
- Unit test coverage > 80%
- E2E tests cover core flows
PR-Vorlagen¶
Lassen Sie Claude einheitliche PR-Vorlagen verwenden:
> Create PR description using this template:
> ## Changes
> ## Test Plan
> ## Screenshots (if UI changes)
> ## Checklist
Workflow-Checkliste¶
Vor dem Start einer neuen Aufgabe¶
-
[ ] Feature-Branch erstellen
-
[ ] Kontext mit
/clearleeren -
[ ] Claude zuerst den bestehenden Code verstehen lassen
-
[ ] Umsetzungsplan erstellen
Während der Entwicklung¶
-
[ ] Schritt für Schritt vorgehen und jeden Schritt überprüfen
-
[ ] Kleine Commits, Claude häufig committen lassen
-
[ ] Kontext mit
/contextim Blick behalten -
[ ] Bei Bedarf
/compactverwenden
Vor dem Einreichen¶
-
[ ] Mit
/revieweine Selbstprüfung durchführen -
[ ] Alle Tests ausführen
-
[ ] Auf Lint-Fehler prüfen
-
[ ] PR-Beschreibung generieren
Die wichtigsten Schalter für Workflows¶
Stand 2026-10-15 laut Claude-Code-Dokumentation:
| Situation | Vorgehen | Aussage der Dokumentation |
|---|---|---|
| Erst planen, keine Dateien ändern | Mit Shift+Tab in den Planmodus wechseln; die Statusleiste zeigt ⏸ plan mode on |
Claude liest Dateien und schlägt einen Plan vor, ohne vor Ihrer Freigabe zu bearbeiten |
| Eine frühere Sitzung fortsetzen | claude --continue (letzte im aktuellen Verzeichnis), claude --resume (Auswahl aus Liste) oder /resume in einer Sitzung |
Gibt es im Verzeichnis keine frühere Sitzung, gibt --continue No conversation found to continue aus und endet |
| Eine misslungene Änderung zurücknehmen | /rewind oder bei leerem Eingabefeld zweimal Esc |
Wählbar sind Code und Unterhaltung wiederherstellen, nur Unterhaltung, nur Code oder ab einer Nachricht zusammenfassen |
| Sitzungsverbrauch ansehen | /usage (Alias /cost) |
Zeigt Kosten und Verbrauch der aktuellen Sitzung |
Zwei Grenzen beim Zurücksetzen: Laut Dokumentation werden Datei-Snapshots für die 100 letzten Checkpoints einer Sitzung vorgehalten und standardmäßig etwa 30 Tage nach dem letzten Speichern der Sitzung bereinigt; danach kann das Zurücksetzen mit No files were restored scheitern. Zum längeren Aufbewahren passen Sie cleanupPeriodDays an.
Hinweise zum Betrieb auf QCode¶
- Parallelität: Ein Privatplan oder ein Nutzungspaket erlaubt 5 gleichzeitige Anfragen pro API-Key (Ultimate: 10; siehe FAQ). Mehrere Claude-Code-Instanzen oder viele parallele Subagenten stoßen womöglich zuerst an diese Grenze, was sich häufig als 429 zeigt.
- Lange Sitzungen: Plan-dann-ausführen-Sitzungen werden oft lang; nahe am Kontextlimit erscheinen
E015/ 429. Zuerst/compact, sonst die Sitzung neu starten; siehe Kontextverwaltung. - Arbeitsteilung zwischen Modellen: Für Planung und Review ein stärkeres Modell, für Massenänderungen
claude-sonnet-5, Wechsel mit/model. QCode rechnet pro Token ab; die Preise je Modell stehen unter qcode.cc/models.
Häufige Fehler und Fehlersuche¶
| Symptom | Mögliche Ursache | Abhilfe |
|---|---|---|
429 mit E015 im Inhalt |
Die Unterhaltung ist zu lang, der Kontext fast voll | /compact, sonst beenden und neu starten |
| Vermutlich Ratenbegrenzung (häufig 429) bei kurzer Unterhaltung | Gleichzeitige Anfragen überschreiten womöglich das Parallelitätslimit des Keys | Zahl der laufenden Instanzen oder Subagenten verringern und später erneut versuchen |
| Im Planmodus will es trotzdem Dateien ändern | Es ist gar nicht im Planmodus | In der Statusleiste auf ⏸ plan mode on achten; fehlt es, erneut Shift+Tab drücken |
Nach /rewind kehren Dateien nicht zurück, No files were restored |
Die Snapshots dieses Checkpoints wurden bereinigt | Aus git wiederherstellen und an wichtigen Punkten committen |
/commit bewirkt nichts |
Stand 2026-10-15 steht /commit nicht in der offiziellen Liste der eingebauten Befehle, er stammt meist aus einem eigenen Befehl oder Skill; außerdem muss ein git-Repository vorliegen |
Mit /help die verfügbaren Befehle ansehen; fehlt er, bitten Sie einfach: „Committe diese Änderungen mit einer guten Commit-Nachricht“ |
401 / 404 / model_not_available_on_endpoint |
Ein Verbindungsproblem, das mit Workflows nichts zu tun hat | Den Selbsttest in Endpunkte und API-Formate durchführen |
FAQ¶
Muss ich immer erst planen und dann ausführen?¶
Kleine Änderungen können Sie direkt vornehmen. Bei Aufgaben über mehrere Dateien oder mit teuren Fehlern lassen Sie zuerst im Planmodus einen Plan erstellen und führen nach Ihrer Bestätigung aus; das bedeutet meist weniger Nacharbeit.
Wie oft sollte ich /compact ausführen?¶
Es gibt keinen festen Rhythmus. Komprimieren Sie nach einer abgeschlossenen Phase oder wenn /context 70 bis 80 % Auslastung zeigt, statt auf einen Überlauf zu warten.
Wie setze ich nach einem Fehler zurück?¶
Beim Code helfen git und /rewind gemeinsam: in kleinen Schritten committen und /rewind für das Rückgängigmachen innerhalb der Sitzung nutzen. An wichtigen Punkten committen, bevor Claude weitermacht.
Beeinflussen sich mehrere parallele Sitzungen mit unterschiedlichen Aufgaben?¶
Die Unterhaltungen sind unabhängig, teilen sich aber das Parallelitätskontingent desselben Keys. Bei vielen parallelen Aufgaben kann es zu Ratenbegrenzung kommen; verringern Sie die Parallelität wie oben beschrieben.
Nächste Schritte¶
-
Lernen Sie die CLI-Tipps für weitere Befehle kennen
-
Entdecken Sie Benutzerdefinierte Befehle, um teamspezifische Befehle zu erstellen
-
Lesen Sie die Best Practices, um Ihre Workflows weiter zu optimieren
Mit QCode starten
Ein API-Key für Claude Code, Codex und mehr – Abrechnung pro Token, Preise je Modell auf qcode.cc/models