Zum Inhalt

Installation auf dem Mac

Auf dieser Seite richtest du alles einmalig ein. Geh Schritt für Schritt vor: Befehl tippen (oder einfügen), Return drücken und mit "Das solltest du sehen" vergleichen. Das dauert etwa 20-30 Minuten, die meiste Zeit wartest du auf Downloads.

Du brauchst macOS 13 (Ventura) oder neuer und das Anmeldepasswort deines Macs (ein Administrator-Konto).

1. Öffne das Terminal

Das Terminal ist ein Fenster, in das du Befehle tippst, statt zu klicken. Es sieht altmodisch aus, aber du brauchst nur eine Handvoll Befehle.

  1. Drück Cmd+Leertaste, um Spotlight zu öffnen.
  2. Tippe terminal.
  3. Drück Return.

Das solltest du sehen: ein Fenster mit einer Zeile, die auf % endet, zum Beispiel:

yourname@MacBook ~ %

Diese Zeile ist der Prompt. Er bedeutet "bereit, tippe einen Befehl".

Einfügen

Kopiere einen Befehl von dieser Seite mit dem Kopier-Knopf in der Ecke jedes Kastens. Im Terminal fügst du ihn mit Cmd+V ein und drückst dann Return.

2. Installiere Homebrew

Homebrew ist ein App-Installer fürs Terminal. Alles andere auf dieser Seite wird damit installiert.

Geh auf brew.sh, kopiere den Installationsbefehl oben auf der Seite (er beginnt mit /bin/bash -c) und füg ihn ins Terminal ein. Zum Zeitpunkt, als diese Seite geschrieben wurde, lautet er:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Was dann passiert:

  1. Es fragt nach deinem Mac-Passwort. Tippe es ein und drück Return. Beim Tippen siehst du keine Zeichen. Das ist normal.
  2. Es sagt dir, was es installieren wird, und bittet dich, Return zu drücken.
  3. Es installiert Apples Xcode Command Line Tools, falls sie fehlen. Das kann 5-15 Minuten dauern. Vielleicht erscheint ein Fenster, das fragt, ob du sie installieren willst: Klick auf Installieren.

Das solltest du sehen: Installation successful! gegen Ende.

Die "Next steps"-Zeilen (Macs mit Apple-Chip)

Auf Macs mit Apple-Chip (M1, M2, M3, M4 ...) endet Homebrew mit einem Abschnitt namens ==> Next steps, der zwei oder drei Befehle zeigt. Die sehen so aus:

echo >> /Users/yourname/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/yourname/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Kopiere die Zeilen aus deinem eigenen Terminal (sie enthalten deinen Benutzernamen), füg sie ein und drück Return. Sie sagen dem Terminal, wo Homebrew wohnt. Auf älteren Intel-Macs gibt es diese Zeilen nicht, dann kannst du das überspringen.

Prüf es:

brew --version

Das solltest du sehen: etwas wie Homebrew 4.4.10.

Falls es fehlschlägt mit "command not found: brew": Du hast die Next-steps-Zeilen übersprungen. Scroll im Terminal nach oben, such sie und führ sie aus. Oder schließ das Terminal, öffne es neu und versuch es noch einmal.

3. Installiere Git und die GitHub CLI

Git lädt das Modkit herunter und hält es aktuell. Die GitHub CLI (gh) verbindet dein Terminal mit GitHub, der Website, auf der das Modkit liegt.

brew install git gh

Prüf beide:

git --version
gh --version

Das solltest du sehen: etwas wie git version 2.47.1 und gh version 2.63.0.

4. Installiere Claude Code

Claude Code ist der KI-Agent, der deine Mods schreibt und prüft. Denk dran: Er braucht ein bezahltes Claude-Abo (Pro oder höher). Kein Abo? Spring zu Schritt 6 und nutze später Ohne KI-Agent.

Lieber Open Source? OpenCode statt Claude Code

OpenCode ist ein quelloffener Agent, der dieselben Regeln nutzt. Das Programm ist gratis; das KI-Modell dahinter zahlst du pro Nutzung, oder du nimmst eins der wenigen, schwächeren Gratis-Modelle, die es für begrenzte Zeit gibt. Installier ihn statt dieses Schritts mit brew install anomalyco/tap/opencode und lies dann die Seite OpenCode.

brew install --cask claude-code

Prüf es:

claude --version

Das solltest du sehen: eine Versionsnummer, gefolgt von (Claude Code).

Falls es fehlschlägt: Schließ das Terminal, öffne es neu und versuch es noch einmal. Klappt es immer noch nicht, führ claude doctor aus und füg die Ausgabe in den Modding-Kanal auf Discord ein.

Mit Python kann der Agent den Mod-Prüfer (den Validator) direkt ausführen. Ohne Python lädt der Agent stattdessen eine fertige Version des Prüfers herunter. Dieser Schritt ist also optional, aber empfohlen.

brew install python

Prüf es:

python3 --version

Das solltest du sehen: Python 3.x.x (3.9 oder neuer). Auf dem Mac heißt der Befehl python3, nicht python.

6. Leg ein GitHub-Konto an und melde dich an

  1. Geh auf github.com/signup und leg ein kostenloses Konto an. Bestätige deine E-Mail-Adresse.
  2. Tippe im Terminal:
gh auth login

Es stellt dir ein paar Fragen (auf Englisch). Nutze die Pfeiltasten und Return:

Frage Wähle
Where do you use GitHub? GitHub.com
What is your preferred protocol for Git operations? HTTPS
Authenticate Git with your GitHub credentials? Yes
How would you like to authenticate GitHub CLI? Login with a web browser

Dann kommt der Teil im Browser. Lass dir Zeit - das Terminal wartet auf dich:

  1. Das Terminal zeigt einen Einmal-Code, zum Beispiel ABCD-1234, und schreibt "Press Return to open github.com in your browser". Schreib dir den Code auf (oder lass das Terminal sichtbar) und drück dann Return.
  2. Dein Browser öffnet eine GitHub-Seite mit dem Titel Device Activation. Falls GitHub dich zuerst anmelden will, tu das.
  3. Tipp den Code aus dem Terminal in die Kästchen und klick auf Continue.
  4. GitHub zeigt jetzt Authorize GitHub CLI. Damit darf das Werkzeug gh auf deinem Rechner für dein GitHub-Konto handeln, um das Modkit herunterzuladen. Klick auf Authorize github (eventuell fragt GitHub noch einmal nach deinem Passwort).
  5. Der Browser meldet "Congratulations, you're all set!". Jetzt zurück ins Terminal und warten, bis dort ✓ Logged in as YourName steht. Erst dann weitermachen - wenn du vorher das Terminal schließt oder etwas anderes tippst, ist die Anmeldung nicht fertig.

Kontrollieren kannst du das jederzeit:

gh auth status

Das solltest du sehen: ✓ Logged in to github.com account YourName. Steht dort "You are not logged into any GitHub hosts", führ gh auth login noch einmal aus.

Nimm deine Einladung an. Während der Developer Preview ist das Modkit privat, du brauchst also auch die Einladung von Blindflug Studios (siehe Zuerst Zugang holen). GitHub schickt sie per Mail; du kannst auch angemeldet github.com/blindflugstudios/goa-modkit/invitations öffnen und auf Accept invitation klicken. Mach das einmal, vor dem nächsten Schritt.

Zwei-Faktor-Anmeldung ist Pflicht

Blindflug Studios verlangt auf GitHub für alle mit Zugang die Zwei-Faktor-Anmeldung (2FA). Wenn du die Einladung öffnest, fordert GitHub dich zuerst auf, sie einzurichten - das ist so gewollt und dauert etwa fünf Minuten. Am einfachsten geht es mit einer Authenticator-App auf dem Handy (GitHub Mobile, Microsoft Authenticator oder Google Authenticator): den QR-Code scannen, den 6-stelligen Code aus der App eintippen und die Wiederherstellungscodes sicher aufbewahren. Danach die Einladung annehmen. Die Anleitung von GitHub: Zwei-Faktor-Authentifizierung konfigurieren.

7. Hol dir das Modkit

Einladung nötig

Während der Developer Preview ist das Modkit privat. Dieser Schritt klappt erst, wenn du die Einladung von GitHub angenommen hast - siehe Zuerst Zugang holen.

Damit lädst du das Modkit in einen Ordner namens goa-modkit in deinem Benutzerordner. Das machst du einmal.

cd ~
gh repo clone blindflugstudios/goa-modkit
cd goa-modkit

Das solltest du sehen: ein paar Zeilen, die mit done enden, und dein Prompt zeigt jetzt goa-modkit.

Wenn du später Updates holen willst (neue Doku, Beispiele, Korrekturen am Prüfer), öffne das Terminal und tippe:

cd ~/goa-modkit
git pull

Deine eigenen Mods liegen in goa-modkit/mods/. Updates fassen diesen Ordner nie an.

8. Starte Claude Code und melde dich an

Tippe, immer noch im Ordner goa-modkit:

claude

Beim ersten Mal:

  1. Wähl mit den Pfeiltasten und Return ein Farbschema.
  2. Entscheide dich für die Anmeldung mit deinem Claude-Konto (deinem Abo). Dein Browser öffnet sich. Melde dich an und klick auf Authorize.
  3. Claude Code fragt, ob du den Dateien in diesem Ordner vertraust. Wähle Yes.

Das solltest du sehen: einen Kasten mit einem Cursor, in den du tippen kannst. Dort sprichst du mit dem Agenten. Tippe /exit (oder drück zweimal Ctrl+C), um ihn zu verlassen.

Fertig

Du bist bereit für Dein erster KI-Mod in 10 Minuten.

Werkzeuge aktuell halten

Homebrew aktualisiert Claude Code nicht von selbst. Führ alle paar Wochen aus:

brew update
brew upgrade claude-code git gh

Schließ Claude Code, bevor du es aktualisierst.