Claude Code - Tipps und Tricks
Eine kuratierte Sammlung von praktischen Tipps, Tricks und Lösungen für häufige Probleme bei der Arbeit mit Claude Code.
Inhaltsverzeichnis
Authentifizierung & Sessions
Tipp #1: OAuth Token abgelaufen - Was tun?
Problem: Beim Verwenden von claude --teleport <session_id> erscheint die Fehlermeldung:
Error: Failed to fetch session from Sessions API: Request failed with status code 401
Lösung: Diese kryptische Fehlermeldung bedeutet meist, dass Ihr OAuth-Token abgelaufen ist.
Workaround:
Führen Sie
/loginin Claude Code aus, um einen neuen Token zu erhaltenVersuchen Sie danach erneut, sich mit der Session zu verbinden
Hintergrund:
Der 401-Fehler ist ein generischer HTTP-Authentifizierungsfehler
Die aktuelle CLI-Version (2.0.25) zeigt keine spezifische Meldung über abgelaufene Tokens
Dies ist ein bekanntes Usability-Problem (siehe Issue #10120)
Prävention:
Beachten Sie die Gültigkeitsdauer Ihrer Tokens
Bei längerer Inaktivität führen Sie vorsorglich
/loginaus
Status: Bug-Fix ist in Arbeit - zukünftige Versionen werden klarere Fehlermeldungen anzeigen.
Model-Auswahl & Konfiguration
Tipp #2: OpusPlan-Modus verwendet jetzt Sonnet 4 (nicht 3.7)
Problem: Bei der Verwendung von opusplan auf AWS Bedrock wurde früher Sonnet 3.7 statt Sonnet 4 für Edits verwendet.
Lösung: Dieses Problem wurde in Version 1.0.88 behoben.
Was tun bei älteren Versionen:
Aktualisieren Sie Claude Code auf mindestens Version 1.0.88
Prüfen Sie mit
/model, welche Version aktiv ist
Hintergrund:
opusplansollte Opus 4.1 für Planung und Sonnet 4 für Edits verwendenIn Versionen vor 1.0.88 fiel der Modus auf Sonnet 3.7 zurück
Die Standardmodell-ID für Bedrock Sonnet wurde auf
anthropic.claude-sonnet-4-20250514-v1:0aktualisiert
Aktuelle Funktionalität (v1.0.88+):
Korrekte Verwendung von Sonnet 4 für Edits
Konfigurierbare Model-IDs für “opus” und “sonnet” in opusplan
Quelle: Issue #5990 - Status: ✅ Behoben
Model Context Protocol (MCP)
Tipp #3: MCP-Server funktionieren möglicherweise nicht mit Opus 4.1
Problem: MCP-Server werden von Claude Code nicht aufgerufen, wenn Opus 4.1 als Model verwendet wird.
Symptome:
MCP-Tools werden nicht invoziert, obwohl sie korrekt konfiguriert sind
In den Settings sind alle Permissions erteilt
Mit Sonnet 4 funktioniert die gleiche Konfiguration einwandfrei
Workaround:
Wechseln Sie temporär zu Sonnet 4 für MCP-intensive Aufgaben
Nutzen Sie
/modelzum Wechseln zwischen ModelsÜberprüfen Sie die MCP-Konfiguration in
.mcp.json
Verifizierung:
# Prüfen Sie die aktive Model-Konfiguration
/model
# Testen Sie mit Sonnet 4
# Wechseln Sie zu Sonnet 4 und beobachten Sie MCP-Tool-Aufrufe
Betroffene MCP-Server:
context7 (Upstash)
git-mcp
dart-mcp
und weitere…
Hintergrund:
Dies ist ein bekanntes Problem seit August 2025
Die Ursache liegt vermutlich in der Model-Integration
Opus 4.1 hat möglicherweise andere Tool-Calling-Mechanismen
Status: ⚠️ Offen - Untersuchung läuft (Issue #6329)
IDE-Integration
Tipp #4: Shift+Enter funktioniert nicht in JetBrains (Reworked 2025 Terminal)
Problem: Bei JetBrains IDEs (WebStorm, IntelliJ, etc.) mit dem “Reworked 2025” Terminal-Engine erstellt Shift+Enter keine neue Zeile, sondern sendet die Eingabe direkt ab.
Lösung: Verwenden Sie Alt+Enter für Zeilenumbrüche.
Alternative Workarounds:
Nutzen Sie Alt+Enter statt Shift+Enter
Deaktivieren Sie temporär die “Reworked 2025” Terminal-Engine:
Settings → Tools → Terminal → Terminal Engine
Wechseln Sie zurück zur klassischen Engine
Betroffene IDEs:
WebStorm
IntelliJ IDEA
PhpStorm
PyCharm
Weitere JetBrains-Produkte
Hintergrund:
Dies betrifft nur die neue “Reworked 2025” Terminal-Engine
Das klassische Terminal ist nicht betroffen
Das Problem wurde in neueren Versionen behoben
Status: ✅ Behoben in neueren Versionen (Issue #4796)
Empfehlung:
Aktualisieren Sie auf die neueste Claude Code-Version
Nutzen Sie Alt+Enter als universellen Workaround
Workflow & Produktivität
Tipp #5: Task-Listen im Blick behalten (VS Code Workaround)
Problem: Bei Multi-Step-Tasks scrollt der Plan aus dem Sichtfeld, wenn Claude die Schritte ausführt.
Aktuelle Situation:
Die VS Code Extension zeigt noch keine persistente Task-Liste an (Feature-Request offen: Issue #8723)
Workarounds bis zur offiziellen Implementierung:
Option 1: Separate Plan-Datei
# Lassen Sie Claude einen Plan in eine eigene Datei schreiben
“Please create a plan.md file with all tasks”
Vorteile:
Immer sichtbar im Editor
Manuell editierbar
Nachteile:
Keine automatischen Updates bei Task-Completion
Erfordert manuelle Pflege
Option 2: Chat-Pin-Workaround
Scrollen Sie regelmäßig nach oben zum Plan
Kopieren Sie den Plan in ein separates Notiz-Tool
Option 3: Claude nach Updates fragen
# Lassen Sie sich den Fortschritt periodisch ausgeben
“Show me the current task list with completion status”
Nachteile:
Verbraucht zusätzliche Tokens
Unterbricht den Workflow
Best Practice:
Für komplexe Projekte: Kombinieren Sie Option 1 mit periodischen Updates
Claude kann die
plan.mdautomatisch aktualisieren, wenn Sie dies explizit anfordern
Ausblick:
Ein persistentes Task-Panel ist als Feature geplant und würde:
Über dem Input-Feld fixiert bleiben
Real-time Updates bei Task-Completion zeigen
Collapsible sein für Platzersparnis
Fehlerbehandlung
Weitere Tipps folgen…
Best Practices
Weitere Tipps folgen…
Wie Sie beitragen können
Haben Sie einen nützlichen Tipp oder Trick für Claude Code? Beiträge sind willkommen!
Öffnen Sie ein Issue mit Ihrem Vorschlag
Beschreiben Sie das Problem und die Lösung klar
Fügen Sie wenn möglich Beispiele und Referenzen hinzu
Quellen und Referenzen
Letzte Aktualisierung: 11. November 2025