Claude Code Build-Fehler-Triage: Ursache in 15 Minuten eingrenzen

Build-Fehler zuerst aufteilen

Wenn ein Node- oder Astro-Build fehlschlägt, liegt es nahe, das ganze Log an Claude Code zu geben. Dann vermischen sich erste Fehlerzeile, Ursache und unnötiges Aufräumen.

Diese Schleife überträgt das Bug-Report-Template und die Review-Checkliste auf Builds. Ziel ist eingegrenzte Ursache, kleine Diagnose und Beweis nach dem Fix.

Belege immer gleich erfassen

Nutzen Sie immer Status, Build und bei Bedarf Test.

git status --short
npm.cmd run build
npm.cmd run test -- --runInBand

Der erste Lauf muss nicht erfolgreich sein. Er soll die erste Fehlerzeile sichern, die meist näher an der Ursache liegt als der letzte Stacktrace.

Log in vier Gruppen teilen

Perfekt muss es nicht sein. Dependency/import, Runtime-Shape, Test-Erwartung und Permission decken viele Fehler ab.

const patterns = [
  [/Cannot find module|ERR_MODULE_NOT_FOUND/i, "dependency or import path"],
  [/TypeError:.*undefined|undefined is not/i, "runtime null or shape mismatch"],
  [/Expected.*received|AssertionError/i, "test expectation drift"],
  [/EACCES|permission denied/i, "permission or sandbox boundary"],
];

export function classifyBuildLine(line) {
  const hit = patterns.find(([regex]) => regex.test(line));
  return hit ? hit[1] : "needs manual reading";
}

Mit dieser Trennung fragen Sie Claude Code nach der kleinsten Diagnose statt nach einer breiten Reparatur.

Kopierbarer Triage-Prompt

Lies dieses fehlgeschlagene Build-Log.
Schlage keine großen Refactors vor.
Gib zurück:
1. erste fehlgeschlagene Zeile
2. wahrscheinlichste Ursache
3. kleinstes Diagnosekommando
4. kleinster Code- oder Config-Fix
5. Prüfkommando nach dem Fix

Wichtig ist das Verbot großer Refactors. Ein Build-Fix braucht eine Hypothese und einen Beweis.

Fehlerfall: Abhängigkeiten zu früh ändern

Bei “Cannot find module” sofort ein Paket zu installieren kann falsch sein, wenn nur der Pfad defekt ist. Bei “undefined” breite null checks einzubauen kann Frontmatter-Probleme verdecken.

Für öffentliche Sites reicht lokaler Build nicht. Umsatzpfade brauchen öffentliche URL, korrektes h1, canonical, CTA und Gumroad-Links.

Nächster Schritt

Nutzen Sie das kostenlose Cheatsheet für Befehle. Kaufen Sie 50 Prompt Templates für Debugging und Review. Für CI/CD und Produktion helfen Setup Guide und Beratung.