Stufe 01
Den Rechner vorbereiten
Bevor etwas installiert wird, klären Sie drei Dinge: ob Ihr System neu genug ist, ob Sie Programme installieren dürfen, und ob Ihre wichtigen Dateien gesichert sind. Das kostet zehn Minuten und erspart Ihnen den Abend, an dem plötzlich die Rechte fehlen.
Auf beiden Systemen
- Mindestens 4 GB Arbeitsspeicher und eine Internetverbindung; das verlangt Claude Code.
- Administratorrechte (Administratorrechte erlauben es, auf einem Gerät Programme zu installieren und Einstellungen für alle Benutzer zu ändern.) auf dem Rechner. Betreut eine IT-Firma Ihren Rechner, fragen Sie zuerst dort; manche Firmen sperren die Installation von Programmen bewusst.
- Eine aktuelle Sicherungskopie Ihrer wichtigen Dateien, bevor ein Programm in Ihren Ordnern schreiben darf.
- Ein Passwortmanager und die Zwei-Faktor-Authentifizierung (Bei der Zwei-Faktor-Authentifizierung melden Sie sich mit zwei Nachweisen an, etwa mit Ihrem Passwort und einem Code auf dem Telefon.) für die neuen Konten, die Sie in den nächsten Stufen anlegen.
Windows
- Sie brauchen Windows 10 ab Version 1809 oder Windows 11. Die Version zeigt das Fenster, das der Befehl unten öffnet.
- Diese Anleitung installiert unter Windows mit winget, dem Paketmanager von Microsoft. Er ist in Windows 11 und in aktuellen Versionen von Windows 10 enthalten; fehlt er, installieren Sie im Microsoft Store das Programm «App-Installer».
macOS
- Sie brauchen macOS 13 (Ventura) oder neuer. Die Version steht im Apple-Menü unter «Über diesen Mac», oder Sie lassen sie sich mit dem Befehl unten anzeigen.
So prüfen Sie es
Sie kennen Ihre Systemversion, und unter Windows meldet winget eine Versionsnummer. Die Befehle geben Sie im Terminal ein; wie Sie es öffnen, steht in der nächsten Stufe.
Wenn es hakt
- Windows meldet, «winget» sei nicht erkannt.
Installieren oder aktualisieren Sie im Microsoft Store das Programm «App-Installer» und öffnen Sie danach ein neues Terminal-Fenster.
- Beim Installieren erscheint eine Sperre oder ein Fenster, das ein Administratorpasswort verlangt, das Sie nicht haben.
Hier endet die Selbsthilfe. Fragen Sie Ihre IT-Firma; umgehen Sie die Sperre nicht.
Im Setup Wir prüfen den Rechner vor der Installation und richten das Setup auf Windows und macOS ein, bei Bedarf mit der Freigabe (Freigabe bedeutet: Eine Person entscheidet, bevor eine von der KI vorbereitete Nachricht nach aussen geht oder Geld ausgegeben wird.) Ihres IT-Partners.
Stufe 02
Das Terminal öffnen
Das Terminal ist das Fenster, in dem Sie Befehle tippen statt klicken. Alle weiteren Stufen arbeiten darin, und Claude Code läuft darin. Ein Befehl ist eine Zeile Text; Sie bestätigen ihn mit der Eingabetaste. Nach jeder Installation öffnen Sie ein neues Fenster, denn ein schon offenes kennt die neuen Programme noch nicht.
Windows
- Öffnen Sie das Startmenü, tippen Sie «Terminal» und öffnen Sie das Programm. Unter Windows 10 heisst es «Windows PowerShell»; das neuere «Windows Terminal» gibt es kostenlos im Microsoft Store.
- Am Anfang der Zeile steht «PS C:\Users\…>». Das «PS» zeigt: Sie sind in PowerShell. Fehlt es, sind Sie in der alten Eingabeaufforderung (CMD); öffnen Sie dann PowerShell, denn die Befehle dieser Anleitung sind für PowerShell geschrieben.
- Einfügen: mit Ctrl + V oder einem Rechtsklick ins Fenster.
macOS
- Öffnen Sie «Terminal» unter Programme › Dienstprogramme, oder drücken Sie Cmd + Leertaste und tippen Sie «Terminal».
- Installieren Sie danach Homebrew, den Paketmanager, mit dem diese Anleitung auf dem Mac installiert. Das Installationsprogramm fragt nach Ihrem Mac-Passwort (beim Tippen erscheinen keine Zeichen, das ist normal) und installiert bei Bedarf die Befehlszeilenwerkzeuge von Apple mit.
- Am Ende zeigt Homebrew unter «Next steps» ein bis zwei Befehle, die Homebrew in den Suchpfad des Terminals eintragen. Kopieren Sie diese Zeilen aus Ihrem Terminal und führen Sie sie aus; sie hängen von Ihrem Mac ab.
So prüfen Sie es
Das Terminal antwortet auf einen Befehl, und auf dem Mac meldet Homebrew sich bereit.
macOS
brew --version
brew doctor
Wenn es hakt
- Mac: «command not found: brew» direkt nach der Installation.
Die Zeilen unter «Next steps» wurden nicht ausgeführt. Scrollen Sie im Terminal zurück, führen Sie sie aus und öffnen Sie ein neues Fenster.
- Windows: Eine Zeile mit «&&» meldet einen Fehler.
Sie sind in PowerShell und der Befehl ist für CMD gedacht, oder umgekehrt. Nehmen Sie die Befehle dieser Anleitung in PowerShell.
Im Setup Das Terminal brauchen Sie dann nicht zu kennen: Sie starten Ihre Workflows (Ein Workflow legt fest, welche Angaben eingehen, was damit geschieht und wer das Ergebnis prüft.) mit kurzen Befehlen, die wir einrichten, und prüfen die Ergebnisse dort, wo es Ihnen passt.
Git hält jeden Stand Ihrer Dateien fest, den Sie speichern. Sie sehen später, was sich geändert hat, und nehmen jede Änderung zurück, auch eine der KI. Unter Windows empfiehlt Anthropic Git für Windows ausserdem, damit Claude Code die Bash nutzen kann; ohne Git weicht Claude Code auf PowerShell aus.
Windows
- Installieren Sie «Git for Windows» mit winget. Es bringt die Git Bash und den Git Credential Manager mit, der später die Anmeldung bei GitHub übernimmt.
macOS
- Installieren Sie Git mit Homebrew. Eine ältere Version von Apple ist oft schon da; die von Homebrew ist aktueller.
Danach, auf beiden Systemen
- Öffnen Sie ein neues Terminal-Fenster und hinterlegen Sie einmal Ihren Namen und Ihre E-Mail-Adresse. Git schreibt beides in jeden gespeicherten Stand. Nehmen Sie die Adresse, mit der Sie in der nächsten Stufe Ihr GitHub-Konto anlegen.
- Die dritte Zeile nennt den ersten Zweig jedes neuen Projekts «main», wie GitHub es tut.
git config --global user.name "Vorname Nachname"
git config --global user.email "name@firma.ch"
git config --global init.defaultBranch main
So prüfen Sie es
Git meldet seine Version und zeigt Ihren Namen und Ihre Adresse.
Wenn es hakt
- «git» wird nicht erkannt, obwohl die Installation durchlief.
Schliessen Sie alle Terminal-Fenster und öffnen Sie ein neues. Ein offenes Fenster kennt neu installierte Programme nicht.
- Später meldet Git «Please tell me who you are».
Name und Adresse fehlen. Führen Sie die beiden «git config»-Zeilen oben aus.
Im Setup Im Pro Setup (Pro Setup ist unser empfohlenes Paket für CHF 1'490.–: Vault, Workflows mit KI-Agenten, erste Anbindungen, eine Einführungssitzung und drei Monate Business-Seat.) legen wir eine Struktur für Ihre Projektdateien an; Git gehört zu den Programmen, die wir dafür installieren.
Stufe 04
Ein GitHub-Konto anlegen
GitHub bewahrt Ihre Projekt-Repositories ausserhalb Ihres Rechners auf. Das ist Ihre Sicherung, wenn der Rechner ausfällt, und der gemeinsame Ort, wenn später ein Team am selben Projekt arbeitet. Ein privates Repository sieht nur, wen Sie einladen. Ein kostenloses Konto genügt für den Anfang.
Auf beiden Systemen
- Legen Sie unter github.com ein Konto an, mit einer Adresse, die Sie dauerhaft nutzen.
- Schalten Sie gleich die Zwei-Faktor-Authentifizierung ein (Settings › Password and authentication). GitHub verlangt sie für viele Konten ohnehin.
- Installieren Sie danach GitHub CLI, das Programm «gh». Es meldet Git bei GitHub an und legt in Stufe 9 Ihr erstes Repository an. Bei «gh auth login» wählen Sie GitHub.com, HTTPS und die Anmeldung im Browser, und bestätigen, dass Git Ihre GitHub-Anmeldung verwenden darf.
- Auf GitHub kommen einzelne Projekte, nicht Ihr ganzer Vault: Der Vault ist Ihr persönlicher Ordner.
macOS
brew install gh
gh auth login
So prüfen Sie es
GitHub CLI meldet, dass Sie angemeldet sind, mit Ihrem Benutzernamen.
Wenn es hakt
- Git fragt beim Hochladen nach einem Passwort und lehnt Ihr GitHub-Passwort ab.
GitHub nimmt für Git kein Kontopasswort an. Melden Sie sich mit «gh auth login» an und bestätigen Sie, dass Git diese Anmeldung verwenden darf.
- «gh» wird nicht erkannt.
Öffnen Sie nach der Installation ein neues Terminal-Fenster.
Im Setup Was Ihr Team teilt, legen wir im gemeinsamen Projekt-Repository ab, das Sie kontrollieren: auf GitHub, auf einem eigenen Git-Server oder dort, wo Sie es möchten.
Stufe 05
Node.js installieren
Viele Erweiterungen für KI-Werkzeuge laufen mit Node.js, zum Beispiel MCP-Server, über die Claude Code andere Programme wie Ihren Kalender oder eine Datenbank erreicht. Auch der Helfer aus dem Startpaket (Stufe 10) läuft damit. Claude Code selbst braucht Node.js nicht, wenn Sie es wie in Stufe 7 installieren. Wählen Sie die Version «LTS»: Sie wird am längsten gepflegt.
Windows
- Öffnen Sie nodejs.org, wählen Sie die LTS-Version und laden Sie den «Windows Installer (.msi)». Führen Sie ihn mit den vorgeschlagenen Einstellungen aus.
macOS
- Öffnen Sie nodejs.org, wählen Sie die LTS-Version und laden Sie den «macOS Installer (.pkg)». Führen Sie ihn mit den vorgeschlagenen Einstellungen aus.
So prüfen Sie es
Node.js und sein Paketprogramm npm melden je eine Versionsnummer (in einem neuen Terminal-Fenster).
Wenn es hakt
- Windows: «npm» meldet, die Ausführung von Skripts sei auf diesem System deaktiviert.
Das ist die Ausführungsrichtlinie von PowerShell. Die übliche Einstellung für Ihr eigenes Benutzerkonto erlaubt lokale Skripts und verlangt für heruntergeladene eine Signatur. Betreut eine IT-Firma Ihren Rechner, fragen Sie vorher dort.
Im Setup Wir installieren die Programme, die Ihr Setup braucht; welche das sind, hängt von Ihren Workflows ab.
Stufe 06
Python installieren
Python ist die Sprache vieler kleiner Hilfsprogramme für Tabellen, Dokumente und Daten. Schreibt die KI ein Skript, das zum Beispiel Angaben aus PDF-Dateien in eine Tabelle überträgt, ist es oft Python, und es läuft nur, wenn Python installiert ist.
Windows
- Unter Windows installieren Sie den «Python install manager», den die Python-Dokumentation empfiehlt. Er verwaltet die Python-Versionen für Sie.
- Öffnen Sie danach ein neues Terminal-Fenster. Beim ersten Aufruf von «python» installiert der Manager die aktuelle Python-Version.
macOS
- Laden Sie auf python.org unter Downloads › macOS das Installationsprogramm der aktuellen Version und führen Sie es aus. Auf dem Mac heisst der Befehl danach «python3».
So prüfen Sie es
Python meldet seine Version.
Wenn es hakt
- Mac: «command not found: python».
Auf dem Mac heisst der Befehl «python3».
- Windows: Es startet eine andere Python-Version als erwartet.
Der Manager bevorzugt die Versionen, die er selbst verwaltet. «py list» zeigt sie; «py install» installiert die gewünschte.
- Windows: «python» wird nicht gefunden oder verhält sich seltsam.
Klicken Sie auf Start, öffnen Sie «App-Ausführungsaliase verwalten» und prüfen Sie, ob die Aliase für «Python (default)» eingeschaltet sind. Sind sie es schon, schalten Sie sie aus und wieder ein; so empfiehlt es die Python-Dokumentation.
Im Setup Wir installieren die Programme, die Ihre Workflows brauchen; Python gehört oft dazu.
Stufe 07
Den KI-Harness einrichten: Claude Code
Claude Code ist die Arbeitsumgebung, in der die KI mit Ihren Dateien arbeitet. Sie starten es in einem Ordner; es liest die Dateien darin, schlägt Schritte vor und führt aus, was Sie erlauben. Es läuft im Terminal und verbindet sich mit Ihrem Konto bei Anthropic.
Auf beiden Systemen
- Sie brauchen ein Konto bei Anthropic: ein Claude-Abo (Pro, Max, Team oder Enterprise; Anthropic empfiehlt diese) oder ein Konto in der Claude (Ein KI-Assistent ist ein Chatprogramm wie ChatGPT, Claude, Gemini oder Perplexity: Sie schreiben in normaler Sprache, und ein Sprachmodell antwortet.) Console mit vorausbezahltem Guthaben. Die Nutzung kostet je nach Plan; die aktuellen Preise stehen bei Anthropic. Das Konto eröffnen Sie selbst, in Ihrem Namen.
- Installieren Sie Claude Code mit dem offiziellen Installationsprogramm. Es zeigt keinen Fortschritt an, bis es fertig ist; warten Sie, bis die Eingabezeile zurückkommt. Danach aktualisiert sich Claude Code selbst im Hintergrund.
Windows
- Den Befehl geben Sie in PowerShell ein. Mit Git for Windows aus Stufe 3 nutzt Claude Code die Bash.
macOS
- Den Befehl geben Sie im Terminal ein.
Danach, auf beiden Systemen
- Öffnen Sie ein neues Terminal-Fenster und starten Sie Claude Code. Beim ersten Start meldet es sich im Browser bei Ihrem Konto an; danach bleibt die Anmeldung gespeichert. Mit «/exit» beenden Sie die Sitzung wieder.
- Starten Sie Claude Code für die eigentliche Arbeit immer im Ordner eines Projekts, nicht im Benutzerordner. Das kommt in Stufe 9.
So prüfen Sie es
Claude Code meldet seine Version, und die Diagnose findet keine Probleme. In einer laufenden Sitzung prüft «/doctor» dasselbe und behebt, was es beheben kann.
claude --version
claude doctor
Wenn es hakt
- Windows: «claude» wird nicht erkannt.
Der Installationsordner fehlt im Suchpfad. Diese zwei Zeilen tragen ihn für Ihr Benutzerkonto ein (aus der Anleitung von Anthropic); schliessen Sie danach PowerShell und öffnen Sie ein neues Fenster.
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
- Mac: «command not found: claude».
Der Installationsordner fehlt im Suchpfad. Diese zwei Zeilen tragen ihn ein (aus der Anleitung von Anthropic).
- Windows: «'irm' is not recognized».
Sie sind in der Eingabeaufforderung (CMD), nicht in PowerShell. Öffnen Sie PowerShell und versuchen Sie es dort.
- Die Installation bricht mit «403» oder einer anderen Meldung ab.
Die Seite «Troubleshoot installation» von Anthropic ordnet jede Meldung einer Lösung zu; Claude Code ist ausserdem nur in den von Anthropic unterstützten Ländern verfügbar.
Im Setup Wir installieren den gewählten KI-Harness; Claude Code ist eine mögliche Wahl. Zugangsdaten legen wir ausserhalb von Chats ab, zum Beispiel in 1Password.
Stufe 08
Den Vault anlegen
Der Vault ist Ihr Arbeitsordner für alles, was mit der KI zu tun hat: Projekte, Notizen, Unterlagen und die Anleitungen für wiederkehrende Aufgaben. Ordnen Sie ihn von Anfang an nach PARA: Projekte haben ein Ziel und ein Ende, Bereiche laufen dauernd, Ressourcen sind Nachschlagematerial, und ins Archiv kommt, was erledigt ist. So finden Sie und die KI später, was wohin gehört.
Auf beiden Systemen
- Legen Sie in Ihrem Benutzerordner einen Ordner «Vault» mit vier Unterordnern an; die Befehle unten tun das in einem Schritt. Den Ort dürfen Sie frei wählen; die Anleitung geht von Ihrem Benutzerordner aus.
- Freiwillig: Installieren Sie Obsidian und öffnen Sie den Ordner dort mit «Open folder as vault». Obsidian zeigt Ihre Notizen verknüpft an; die Dateien bleiben gewöhnliche Textdateien, die auch Claude Code liest.
- Liegt der Vault in einem Ordner, der mit einer Cloud (Mit «Cloud» sind Rechner in den Rechenzentren eines Anbieters gemeint, auf denen Programme laufen und Daten liegen, statt auf Ihrem eigenen Gerät.) abgeglichen wird (OneDrive, iCloud), achten Sie darauf, dass Projekte mit Git nicht gleichzeitig von zwei Seiten verändert werden.
Windows
mkdir $HOME\Vault\1-Projekte, $HOME\Vault\2-Bereiche, $HOME\Vault\3-Ressourcen, $HOME\Vault\4-Archiv
So prüfen Sie es
Im Vault liegen die vier Ordner.
Wenn es hakt
- Sie finden den Vault im Explorer oder im Finder nicht.
Er liegt direkt in Ihrem Benutzerordner, nicht unter «Dokumente». Windows: Tippen Sie %USERPROFILE% in die Adresszeile des Explorers. Mac: Im Finder öffnet Shift + Cmd + H den Benutzerordner.
Im Setup In der Grundinstallation (Die Grundinstallation ist unser kleinstes Paket für CHF 490.–: ein eingerichteter KI-Harness, eine Vault-Vorlage und ein bis zwei Basis-Workflows auf Ihrem Rechner.) erhalten Sie eine Vorlage (Eine Vorlage ist ein vorbereiteter Aufbau, etwa für ein Dokument, eine E-Mail oder eine Ablage, den man für jeden Fall nur noch ergänzt.) für den Vault; im Pro Setup richten wir Ihren Vault als Arbeitsablage ein, dazu unsere Plattform (Auf unserer Plattform laufen die KI-Agenten und Lösungen, die wir für Ihre Firma bauen; wir hosten sie in der Schweiz.). Local, unsere lokale App (Eine lokale App ist ein Programm, das auf Ihrem eigenen Gerät installiert ist, im Unterschied zu einer Web-App, die im Browser läuft.), verbindet ihn mit der Plattform.
Die Namen der vier Ordner gleichen wir noch mit unserer Vault-Vorlage ab.
Stufe 09
Das erste Projekt anlegen
Jetzt kommt alles zusammen: ein Projektordner im Vault mit den Vorlagen aus dem Startpaket, ein eigenes Git-Repository dafür, eine private Kopie auf GitHub und Claude Code, das in diesem Ordner startet. Claude Code arbeitet dann in genau diesem Projekt und liest beim Start die Anweisungen in der Datei «CLAUDE.md».
Auf beiden Systemen
- Fordern Sie das Startpaket unten auf dieser Seite an und laden Sie es über den Link in der E-Mail herunter.
- Entpacken Sie es in den Ordner «1-Projekte» Ihres Vaults und benennen Sie den Ordner «jules-startpaket» nach Ihrem ersten Ablauf um, zum Beispiel «erster-ablauf».
- Kopieren Sie die Anweisungsdatei aus «vorlagen» als «CLAUDE.md» in den Projektordner. Claude Code liest diese Datei bei jedem Start in diesem Ordner.
- Machen Sie den Ordner zu einem Git-Repository, speichern Sie den ersten Stand und legen Sie mit GitHub CLI eine private Kopie auf GitHub an.
- Starten Sie Claude Code im Projektordner und geben Sie den ersten Prompt (Ein Prompt ist die Eingabe an ein Sprachmodell: die Frage, die Anweisung oder die Vorlage, auf die die KI antwortet.) ein: «Lies die Datei 02-schnelleinrichtung.md. Stelle mir danach höchstens fünf Rückfragen, bevor du irgendetwas vorschlägst.»
Windows
cd $HOME\Vault\1-Projekte\erster-ablauf
Copy-Item vorlagen\anweisungen.md CLAUDE.md
git init
git add .
git commit -m "Erster Stand"
gh repo create erster-ablauf --private --source . --push
claude
macOS
cd ~/Vault/1-Projekte/erster-ablauf
cp vorlagen/anweisungen.md CLAUDE.md
git init
git add .
git commit -m "Erster Stand"
gh repo create erster-ablauf --private --source . --push
claude
So prüfen Sie es
Git zeigt den ersten Stand, GitHub zeigt das private Repository, und Claude Code kennt Ihre Anweisungen: Fragen Sie es «Was steht in CLAUDE.md?».
git log --oneline
gh repo view --web
Wenn es hakt
- Claude Code kennt Ihre Anweisungen nicht.
Die Datei muss «CLAUDE.md» heissen und in dem Ordner liegen, in dem Sie «claude» starten. Beenden Sie Claude Code, wechseln Sie mit «cd» in den Projektordner und starten Sie es neu.
- «gh repo create» meldet, das Repository gebe es schon.
Wählen Sie einen anderen Namen, oder laden Sie in das bestehende Repository hoch.
- Claude Code möchte einen Befehl ausführen, den Sie nicht verstehen.
Lehnen Sie ab und fragen Sie, was der Befehl tut. Sie entscheiden, was ausgeführt wird.
Im Setup Im Pro Setup richten wir drei bis fünf Befehle ein, mit denen Sie Workflows starten, und üben in einer Einführungssitzung (In der Einführungssitzung üben Sie mit Ihren eigenen Dokumenten, wie Sie die eingerichteten Workflows starten und die Ergebnisse prüfen.) mit Ihren eigenen Dokumenten, wie Sie sie starten und die Ergebnisse prüfen.
Stufe 10
Den Helfer einrichten, und weiterarbeiten
Im Startpaket liegt ein kleiner, freiwilliger Helfer für Claude Code: Läuft Claude in einen Fehler oder bitten Sie um Fehlersuche, schlägt Claude einmal pro Sitzung höflich vor, Jules anzurufen, damit es jemand sauber baut. Der Helfer sendet nichts und speichert nichts von Ihnen. Danach arbeiten Sie mit den Vorlagen und Prompts weiter, Schritt für Schritt.
Auf beiden Systemen
- Die Anleitung zum Helfer steht im Paket unter «claude-code-helfer/LIESMICH.md»: eine Datei in den Ordner «.claude/hooks» in Ihrem Benutzerordner kopieren, zwei Einträge in der Datei «.claude/settings.json» daneben ergänzen und Claude Code neu starten. Entfernen heisst: beides wieder löschen.
- Gehen Sie dann die Vorlagen durch: zuerst die Schnelleinrichtung, dann die Vertiefung, ein Interview, das Claude Code mit Ihnen führt. Die Prompts dazu stehen weiter unten.
- Speichern Sie nach jedem Arbeitsschritt einen Stand mit «git add .» und «git commit», und laden Sie ihn mit «git push» auf GitHub.
So prüfen Sie es
In Claude Code zeigt der Befehl «/hooks» die beiden Einträge des Helfers.
Wenn es hakt
- Der Helfer meldet sich nie.
Er meldet sich nur bei einem Fehler oder einer Bitte um Fehlersuche, und nur einmal pro Sitzung. Prüfen Sie mit «/hooks», ob die Einträge da sind.
Im Setup Kommen Sie an eine Stelle, die Sie lieber abgeben: Die Grundinstallation kostet CHF 490.– als Fixpreis, das Pro Setup CHF 1'490.–.