Mission 0: Werkzeug einrichten

Planzeit: 1 Stunde. Achievement: keines, aber ohne diese Mission geht nichts.

Ziel

Am Ende läuft die App in deinem Browser, die Tests starten, und dein KI-Agent kennt den Kurs.

Was du brauchst

Einen Laptop oder Desktop (Windows, macOS oder Linux). Kein Tablet.
Node.js, Version 20 oder neuer. Prüfen: node -v im Terminal.
Git. Prüfen: git --version.
Claude Code oder Codex mit einem eigenen Konto. Das ist dein Tutor in diesem Kurs.
Ein Konto bei der Akademie (du hast eine E-Mail mit dem Zugangslink erhalten).

Falls Node.js oder Git fehlen: Bitte deinen KI-Agenten, dich durch die Installation für dein Betriebssystem zu führen. Das ist Teil der Mission, kein Umweg.

Schritte

Entpacke das Kit in einen Ordner ohne Leerzeichen im Pfad, zum Beispiel C:\lernen\lead-cockpit oder ~/lernen/lead-cockpit.
Öffne den Ordner in deinem KI-Agenten (Claude Code: claude im Ordner starten; Codex: codex).
Sage: "Lies CLAUDE.md und begleite mich durch Mission 0."
Im Terminal, im Projektordner:

npm install
cp .env.example .env
git init
git add -A
git commit -m "Mission 0: Kit eingerichtet"
npm run dev

Unter Windows ohne cp: Datei .env.example kopieren und in .env umbenennen.

Öffne http://localhost:5173. Du siehst "Lead Cockpit" und einen Hinweis zu Mission 2. Das ist richtig so.
Beende den Server mit Ctrl+C und starte die Tests:

npm run bic -- check 0

Mission 0 ist grün, sobald das Projekt installiert ist.

Verbinde dich mit der Akademie:

npm run bic -- login

Du gibst deine E-Mail ein, bekommst einen Code per Mail und tippst ihn ein. Danach npm run bic -- whoami.

Dein Projekt in zwei Minuten

Ordner oder Datei	Was drin ist	Darfst du ändern?
`src/`	Deine App	Ja, hier arbeitest du
`src/api/followUpApi.ts`	Simulierte Schnittstelle	Nein
`src/data/leads.json`	50 Beispiel-Leads, 6 davon absichtlich fehlerhaft	Nein
`tests/`	Die Prüfungen jeder Mission	Nein
`missions/`	Deine Aufgaben und Hinweise	Lesen
`briefing.md`, `KI-PROTOKOLL.md`, `README.md`	Deine Dokumente	Ja
`tools/bic.mjs`, `bic.config.json`	Kurswerkzeug	Nein

Fehlermeldungen lesen

Fehlermeldungen sind auf Englisch. Die häufigsten:

Meldung	Bedeutung	Was tun
`command not found` oder `wird nicht erkannt`	Programm nicht installiert oder Terminal nicht neu gestartet	Installation prüfen, Terminal neu öffnen
`EADDRINUSE`	Port 5173 ist belegt	Anderen `npm run dev` beenden
`Cannot find module`	`npm install` fehlt oder Pfad falsch	`npm install` erneut
`TODO Mission 3: ... nicht implementiert`	Diese Funktion baust du erst in Mission 3	Nichts, das ist erwartet
`Unable to find an element by: [data-testid="..."]`	Die Oberfläche hat dieses Element noch nicht	Element mit genau diesem `data-testid` bauen
`expected X to be Y`	Ein Test erwartet Y, deine App liefert X	Beide Werte vergleichen, Ursache suchen

Bitte deinen Agenten: "Erkläre mir diese Meldung in einfachen Worten", bevor du etwas änderst.

Wenn etwas nicht geht

Terminal schliessen, neu öffnen, im Projektordner erneut versuchen.
rm -rf node_modules (Windows: Ordner löschen) und npm install erneut.
Node-Version prüfen (node -v muss 20 oder höher zeigen).
Immer noch blockiert: Support der Akademie mit der genauen Fehlermeldung und deinem Betriebssystem. Antwort in der Regel innerhalb von zwei Arbeitstagen. Die Zeit zählt nicht als Lernzeit.

Selbstcheck

Ich kann die App starten und stoppen.
Ich kann npm run bic -- check 0 ausführen und die Ausgabe lesen.
Ich weiss, welche Dateien ich nicht ändern darf.
Mein Agent hat CLAUDE.md gelesen und weiss, dass er Coach ist.

Weiter mit missions/01-auftrag.md.