Bevor du startest: der leere Rechner

▸MODUL 1 / EINSTIEG

Bevor wir loslegen

Du hast noch nichts installiert, noch kein Terminal angerührt, und vielleicht auch noch nie eines gesehen. Genau richtig so. Diese Lektion ist der Schritt vor dem ersten Schritt: bevor du BuilderBob einrichtest, klären wir gemeinsam den leeren Rechner vor dir. Was ist eigentlich dieses schwarze Fenster, das in jedem Tutorial auftaucht? Was heißt "Repository"? Und musst du dich jetzt schon zwischen einem Abo und einem API-Zugang entscheiden? Fünf kurze Blöcke, danach bist du bereit für die eigentliche Einrichtung in der nächsten Lektion.

Ich nehme dir hier bewusst Tempo raus. Niemand erwartet, dass du das Terminal, Ordner-Denken und die Abo-Frage in einer Minute verstehst. Aber ein einmal geklärtes Grundbild trägt dich durch den ganzen Kurs, und danach fühlt sich nichts mehr fremd an, nur noch neu.

Das Terminal ist nur ein Texteingabefeld

Das Terminal sieht aus wie aus einem Film über Hacker: schwarzer oder dunkler Hintergrund, weiße Schrift, blinkender Cursor. Genau dieses Bild macht vielen Angst, bevor sie es überhaupt geöffnet haben. Dabei ist es das Harmloseste am ganzen Rechner. Ein Terminal ist nichts anderes als ein Texteingabefeld, so wie ein Suchfeld oder eine Notiz-App, nur dass der Computer die Zeilen, die du eintippst, als Befehle versteht statt als Text zum Speichern. Du tippst, drückst Enter, und der Rechner antwortet mit ein paar Zeilen Text. Mehr passiert nicht, und durch reines Öffnen und Anschauen kann nichts kaputtgehen.

Wie du es öffnest, hängt vom Betriebssystem ab, und das ändert sich mit den Versionen, darum bewusst mit Stand versehen: (Stand Juli 2026, die genauen Menüpunkte prüfst du im Zweifel selbst oder fragst deine KI direkt nach deiner Version.)

• macOS: Drück Cmd und die Leertaste gleichzeitig, das öffnet die Spotlight-Suche. Tipp "Terminal" ein und drück Enter. Ein neues Fenster geht auf, meist mit weißem oder schwarzem Hintergrund und deinem Nutzernamen links.
• Windows: Öffne das Startmenü und tipp "PowerShell" oder "Terminal" ein. Beide Wege funktionieren für diesen Kurs, PowerShell ist die etwas ältere, "Terminal" die neuere, gebündelte App. Klick auf den obersten Treffer.
• Linux: Der Shortcut ist je nach Distribution unterschiedlich, aber Strg und Alt und T gleichzeitig ist der weitestverbreitete. Klappt das nicht, such in deinem Anwendungsmenü nach "Terminal" oder "Konsole".

Öffne es jetzt einmal, bei dir, während du das liest. Schau dir das Fenster zwanzig Sekunden an. Das ist schon der ganze erste Schritt.

Ordner, Repos und die drei Befehle, die du wirklich brauchst

Ein Projekt, an dem du mit einer KI baust, lebt immer in einem Ordner auf deinem Rechner. Stell dir diesen Ordner wie das Zuhause eines Vorhabens vor: alle Dateien, die zu deinem Rechnungs-Tool oder deiner Landingpage gehören, wohnen zusammen an einem Ort. Die KI, mit der du im Terminal arbeitest, "sieht" immer nur den Ordner, in dem sie gerade steht, so wie du auch nur den Raum siehst, in dem du gerade bist. Deshalb ist die erste Frage bei jedem Problem später oft: in welchem Ordner arbeite ich gerade?

Ein Repository, kurz "Repo", ist im Kern genau so ein Projekt-Ordner, nur mit einem zusätzlichen Gedächtnis: Er merkt sich, wie sich die Dateien über die Zeit verändert haben, wie ein Tagebuch für Code. Für den Anfang reicht dir das eine Bild: Repo ist gleich Projekt-Ordner mit Verlauf. Mehr musst du jetzt nicht wissen, BuilderBob erklärt dir den Rest, sobald du ihn tatsächlich brauchst.

Drei Befehle reichen dir, um dich in diesem Zuhause zurechtzufinden, und alle drei sind kurz genug, um sie dir sofort zu merken:

• pwd zeigt dir, in welchem Ordner du gerade stehst (die Buchstaben stehen für "print working directory", auf Deutsch etwa "zeig mir den Arbeitsordner"). Tipp es ein, drück Enter, und du siehst einen Pfad wie eine Adresse.
• ls zeigt dir, was in diesem Ordner drinliegt, also die Liste der Dateien und Unterordner.
• cd gefolgt von einem Ordnernamen bringt dich in diesen Ordner hinein, so wie ein Klick auf einen Ordner im Finder oder Explorer, nur eben per Tastatur.

Ein Mini-Beispiel: Du tippst pwd und siehst, du stehst in deinem Nutzerordner. Du tippst ls und siehst dort einen Ordner namens "Projekte". Du tippst cd Projekte und bist jetzt drin, was du wieder mit pwd bestätigen kannst. Das ist die ganze Mechanik, alles andere baut nur darauf auf.

Warum das wichtig ist: Deine KI im Terminal arbeitet immer "in einem Ordner", genau wie du gerade eben. Wenn du weißt, wo du stehst, verstehst du auch, warum sie manchmal eine Datei nicht findet, die woanders liegt.

Installieren: dem offiziellen Weg folgen, nicht einer alten Anleitung

Für die Werkzeuge in diesem Kurs, allen voran die Agentic-CLI, die du in einer späteren Lektion einrichtest, gibt es meist zwei Installationswege: einen nativen Installer, also ein fertiges Paket zum Herunterladen und Doppelklicken, und eine Installation über einen Paketmanager wie npm oder Homebrew, also ein Werkzeug, das Programme direkt über das Terminal installiert und aktuell hält.

Welcher Weg gerade der empfohlene ist, ändert sich, weil sich Anbieter und Tools weiterentwickeln. Darum die einzige Regel, die über die Zeit stabil bleibt: Folge dem offiziellen Installationsweg aus der Anbieter-Dokumentation, nicht einem Video oder Forenpost, der vielleicht schon veraltet ist. Und wenn du unsicher bist, welcher Weg für dich der richtige ist, fragst du genau das deine KI im App-Builder oder in einem Chat, bevor du irgendetwas installierst. (Stand Juli 2026, die konkreten Installationswege ändern sich, die offizielle Doku des jeweiligen Anbieters ist die verlässliche Quelle, selbst prüfen.)

Abo oder API-Zugang: eine Entscheidung, die du einmal triffst

Bevor du ein KI-Werkzeug für dieses Werkbuch einrichtest, stellt sich eine Frage, die auf den ersten Blick technisch wirkt, aber eigentlich nur eine Alltagsentscheidung ist: zahlst du eine feste Monatsrate (Abo), oder zahlst du pro Nutzung (API, also Pay-per-Token)?

Ein Abo ist wie ein Fitnessstudio-Vertrag: eine feste Rate im Monat, egal wie oft du kommst, planbar, gut wenn du regelmäßig arbeitest. Ein API-Zugang, also die nutzungsbasierte Abrechnung "pro Token" (Token sind grob die kleinen Text-Bausteine, die ein KI-Modell verarbeitet und die auch die Abrechnungseinheit sind), ist eher wie ein Taxi: du zahlst nur, was du fährst. Das ist ideal zum Reinschnuppern und für unregelmäßige Nutzung, kann aber bei intensiver, täglicher Arbeit am Ende teurer werden als ein Abo.

Für den Weg durch diesen Kurs reicht dir eines von beidem: ein Einsteiger-Abo bei einem der großen Anbieter, oder ein moderates Guthaben auf einem API-Zugang. Es gibt hier keine einzig richtige Antwort, nur die, die zu deinem Nutzungsmuster passt. Baust du fast täglich, tendiert das Abo dazu, sich schneller zu lohnen. Probierst du erstmal ein, zwei Wochenenden aus, ist ein kleines API-Guthaben oft der günstigere Einstieg.

Was ich dir bewusst nicht nenne, sind konkrete Preise. Die ändern sich zu häufig, um sie in ein Werkbuch zu schreiben, das dich länger begleiten soll. (Stand Juli 2026, aktuelle Preise findest du immer auf der Preisseite des jeweiligen Anbieters, dort selbst prüfen, bevor du dich entscheidest.) Wichtig ist nur, dass du die Entscheidung triffst, bevor du in der nächsten Lektion loslegst, nicht danach mitten im Bauen.

Die drei häufigsten Setup-Fehler

Fast jeder, der neu einsteigt, stolpert über eine dieser drei Kleinigkeiten. Kennst du sie vorher, kosten sie dich eine Minute statt eine frustrierte Stunde.

Erstens, im falschen Ordner arbeiten. Du glaubst, du bist in deinem Projekt-Ordner, bist aber eigentlich woanders, und plötzlich fehlen Dateien oder tauchen an der falschen Stelle auf. Die Lösung ist der Befehl, den du gerade gelernt hast: tipp pwd und schau, wo du wirklich stehst. Das ist fast immer der erste Handgriff, wenn etwas komisch aussieht.

Zweitens, "command not found" nach einer frischen Installation. Du hast ein Werkzeug gerade installiert, tippst seinen Namen ein, und das Terminal sagt, es kenne den Befehl nicht. Das liegt fast immer daran, dass dein aktuelles Terminal-Fenster den frisch installierten Befehl noch nicht "gesehen" hat. Der einfachste Fix: schließ das Terminal-Fenster komplett und öffne ein neues. Dahinter steckt der sogenannte PATH, eine Liste von Orten, an denen dein Rechner nach Befehlen sucht, kindgerecht gesagt eine Art Inhaltsverzeichnis, das erst beim Neustart des Fensters neu gelesen wird. Hilft das nicht, gib die genaue Meldung an deine KI weiter und lass sie dich führen, statt selbst zu rätseln.

Drittens, eine fehlende Grundlage wie Node oder fehlende Rechte. Manche Werkzeuge brauchen ein anderes Programm im Hintergrund (zum Beispiel Node.js, eine Laufzeitumgebung, die viele CLI-Werkzeuge zum Funktionieren brauchen), oder du hast auf deinem Rechner nicht die nötigen Rechte, um etwas zu installieren. Auch hier gilt dieselbe Regel wie überall in diesem Kurs: Kopier die Fehlermeldung vollständig, wortwörtlich, und gib sie deiner KI. In der Meldung steht fast immer schon, was fehlt, du musst sie nur weiterreichen.

Bevor ich weitermache, hier mein aktueller Stand:

Terminal: (offen, ja oder nein, und auf welchem Betriebssystem, Mac,
Windows oder Linux)
Ergebnis von pwd: (was mir der Befehl gerade anzeigt)
Abo oder API-Zugang: (wofür ich mich entschieden habe, und warum)

Sag mir ehrlich, ob mit diesem Stand einer Installation etwas im Weg
steht, oder ob ich startklar bin, um jetzt weiterzumachen.

Die ehrliche Einordnung

Nichts von dem hier musst du dir merken. Du wirst pwd, ls und cd in den nächsten Lektionen so oft tippen, dass sie dir in die Finger übergehen, ohne dass du bewusst darüber nachdenkst. Und die Abo-oder-API-Frage ist keine, die du für immer festlegst: Merkst du nach ein paar Wochen, dass die andere Variante besser zu dir passt, wechselst du einfach. Nichts davon ist in Stein gemeißelt.

Was diese Lektion dir wirklich gibt, ist ein ruhiger Kopf für den nächsten Schritt. Das Terminal ist kein Prüfungsraum, in dem du etwas falsch machen kannst, nur weil du hinschaust. Und wenn eine Meldung erscheint, die du nicht verstehst, ist das kein Rückschlag, sondern genau die nächste Frage an deine KI. Mit diesem Stand gehst du jetzt in die nächste Lektion und richtest BuilderBob ein, deinen KI-Bau-Begleiter für den Rest dieses Kurses.