Startup-Validierung: Claude Code CLI Pfad beim Start prüfen #87

New issue

Open

opened 2026-03-30 20:21:40 +00:00 by David · 0 comments

David commented

2026-03-30 20:21:40 +00:00

Collaborator

Beschreibung

backend/config.py:30 definiert claude_code_path = "claude", aber beim Startup wird nicht geprüft ob die Claude CLI tatsächlich installiert und ausführbar ist. Der Fehler tritt erst beim ersten Ticket auf.

Hintergrund

Wenn Claude Code nicht installiert ist oder der Pfad falsch konfiguriert ist, startet das Backend erfolgreich. Erst wenn das erste Ticket die Pipeline durchläuft, schlägt der Claude Runner mit "command not found" fehl. Frühzeitige Erkennung spart Debugging-Zeit.

Akzeptanzkriterien

Beim Startup: shutil.which(claude_code_path) prüfen
Wenn nicht gefunden: CRITICAL Log + klare Fehlermeldung
Optional: Version prüfen (claude --version) und loggen
Health-Endpoint meldet Claude CLI Status
Test: Falscher Pfad wird beim Start erkannt

Technische Hinweise

Betroffene Dateien: backend/main.py (Startup), backend/config.py
Ansatz: Check in @app.on_event("startup") oder Lifespan-Handler
Verwandt mit #61 (System-Status Dashboard)
Migration nötig: nein

Aufwand: S

## Beschreibung `backend/config.py:30` definiert `claude_code_path = "claude"`, aber beim Startup wird nicht geprüft ob die Claude CLI tatsächlich installiert und ausführbar ist. Der Fehler tritt erst beim ersten Ticket auf. ## Hintergrund Wenn Claude Code nicht installiert ist oder der Pfad falsch konfiguriert ist, startet das Backend erfolgreich. Erst wenn das erste Ticket die Pipeline durchläuft, schlägt der Claude Runner mit "command not found" fehl. Frühzeitige Erkennung spart Debugging-Zeit. ## Akzeptanzkriterien - [ ] Beim Startup: `shutil.which(claude_code_path)` prüfen - [ ] Wenn nicht gefunden: CRITICAL Log + klare Fehlermeldung - [ ] Optional: Version prüfen (`claude --version`) und loggen - [ ] Health-Endpoint meldet Claude CLI Status - [ ] Test: Falscher Pfad wird beim Start erkannt ## Technische Hinweise - Betroffene Dateien: `backend/main.py` (Startup), `backend/config.py` - Ansatz: Check in `@app.on_event("startup")` oder Lifespan-Handler - Verwandt mit #61 (System-Status Dashboard) - Migration nötig: nein ## Aufwand: S