01 — Arbeitsplatz einrichten

📋

Vorbereitung

Voraussetzungen

Was du brauchst, bevor du beginnst.

Computer mit Internetverbindung — Zum Herunterladen von Python und Git
Admin-Rechte — Für die Installation von Software
~500 MB freier Speicherplatz — Für Python, Git und das Repository
Grundlegendes Terminal-Wissen — Befehle eingeben und ausführen können

💡

Keine Vorkenntnisse nötig

Diese Anleitung führt dich durch jeden Schritt. Selbst wenn du noch nie mit dem Terminal gearbeitet hast, schaffst du das!

🐍

Schritt 1

Python Installation

Claw Code benötigt Python 3.8 oder höher. Wähle dein Betriebssystem für detaillierte Anweisungen.

Anfänger Essentiell

Version prüfen

Öffne ein Terminal und führe folgenden Befehl aus, um zu prüfen, ob Python bereits installiert ist:

bash

$ python3 --version
Python 3.10.12

# Alternativ auf Windows:
$ python --version
Python 3.11.4

✅

Bereits installiert?

Wenn du Python 3.8 oder höher siehst, kannst du direkt zu Schritt 2 springen. Andernfalls folge den Anweisungen unten.

Installation nach Betriebssystem

Python unter Windows installieren

Installer herunterladen

Besuche python.org/downloads und lade die neueste Python-Version herunter (mindestens 3.8).

Installer ausführen

Wichtig: Aktiviere das Häkchen "Add Python to PATH" am Anfang der Installation!

Installation verifizieren

Öffne PowerShell oder CMD und führe aus:
python --version

Python unter macOS installieren

Mit Homebrew (empfohlen)

Wenn du Homebrew installiert hast:
brew install python3

Ohne Homebrew

Lade den Installer von python.org/downloads herunter und führe ihn aus.

Installation verifizieren

Öffne das Terminal und führe aus:
python3 --version

Python unter Linux installieren

Ubuntu/Debian

sudo apt update && sudo apt install python3 python3-pip

Fedora/RHEL

sudo dnf install python3 python3-pip

Arch Linux

sudo pacman -S python python-pip

Installation verifizieren

python3 --version

💡

Gute Nachricht

Claw Code benötigt keine externen Abhängigkeiten — alles läuft mit der Python-Standardbibliothek.

🌿

Schritt 2

Git Installation

Git ist ein Versionskontrollsystem, das wir verwenden, um das Claw-Code-Repository herunterzuladen.

Anfänger Essentiell

Prüfe, ob Git bereits installiert ist

bash

$ git --version
git version 2.34.1

Wenn du eine Versionsnummer siehst, ist Git bereits installiert und du kannst zu Schritt 3 springen.

Git installieren

Git unter Windows

1. Lade den Installer herunter: git-scm.com/download/win

2. Führe den Installer aus und behalte die Standard-Einstellungen bei

3. Wähle bei "Adjusting your PATH environment" die Option "Git from the command line and also from 3rd-party software"

# Nach der Installation, öffne PowerShell oder CMD:
$ git --version

Git unter macOS

Mit Homebrew (empfohlen):

$ brew install git

Ohne Homebrew:

Installiere Xcode Command Line Tools:

$ xcode-select --install

Git unter Linux

Ubuntu/Debian:

$ sudo apt install git

Fedora/RHEL:

$ sudo dnf install git

Arch Linux:

$ sudo pacman -S git

📦

Schritt 3

Repository klonen

Lade das Claw-Code-Repository auf deinen Computer herunter.

Anfänger Essentiell

Schritt-für-Schritt Anleitung

Zu einem Zielordner navigieren

Wähle einen Ordner, in dem du das Projekt speichern möchtest (z.B. Dokumente oder Home-Verzeichnis):

# Windows (PowerShell):
$ cd ~\Documents

# macOS/Linux:
$ cd ~/Documents

# Oder einen anderen beliebigen Ordner:
$ cd ~/Projekte

Repository klonen

Führe den folgenden Git-Befehl aus:

$ git clone https://github.com/instructkr/claw-code.git

Cloning into 'claw-code'...
remote: Enumerating objects: 1250, done.
remote: Total 1250 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (1250/1250), 2.5 MiB | 5.2 MiB/s, done.
Resolving deltas: 100% (850/850), done.

In das Projektverzeichnis wechseln

cd claw-code

Ordnerstruktur anzeigen

Überprüfe, ob alle Dateien korrekt heruntergeladen wurden:

# Windows (PowerShell):
$ dir

# macOS/Linux:
$ ls -la

drwxr-xr-x 8 user user 4096 Apr 3 10:00 .
drwxr-xr-x 5 user user 4096 Apr 3 09:59 ..
drwxr-xr-x 2 user user 4096 Apr 3 10:00 assets
drwxr-xr-x 2 user user 4096 Apr 3 10:00 src
drwxr-xr-x 2 user user 4096 Apr 3 10:00 tests
-rw-r--r-- 1 user user 220 Apr 3 10:00 README.md
-rw-r--r-- 1 user user 4500 Apr 3 10:00 ANLEITUNG.md

✅

Repository erfolgreich geklont!

Du solltest nun die Ordner src/, tests/, assets/ und die Dateien README.md sowie ANLEITUNG.md sehen.

✓

Schritt 4

Erste Verifizierung

Stelle sicher, dass alles korrekt funktioniert, indem du die ersten Befehle ausführst.

Wichtig Anfänger

Teste die Installation

bash

# Stelle sicher, dass du im Projekt-Ordner bist:
$ pwd
/home/user/Documents/claw-code

# Führe den ersten Befehl aus:
$ python3 -m src.main summary

# Claw Code — Portierungsübersicht

## Python-Arbeitsbereich
- Dateien: 25 Python-Dateien
- Subsysteme: 30+ Module
- Befehle: ~150 gespiegelt
- Tools: ~100 gespiegelt

🎉

Alles funktioniert!

Wenn du die Zusammenfassung siehst, ist deine Entwicklungsumgebung vollständig eingerichtet. Du bist bereit für Tutorial 02!

Weitere nützliche Befehle zum Testen

# Liste alle verfügbaren Befehle auf:
$ python3 -m src.main commands --limit 5

# Zeige die Projektstruktur:
$ python3 -m src.main manifest

# Liste die Subsysteme auf:
$ python3 -m src.main subsystems --limit 5

⚠️

Problemlösung

Häufige Fehler

Typische Probleme bei der Einrichtung und ihre Lösungen.

Hilfreich

"python3: command not found"

Lösung:
Auf Windows verwende python statt python3.

Oder füge Python zum PATH hinzu: set PATH=%PATH%;C:\Python311

"git: command not found"

Lösung:
Git ist nicht im PATH. Starte das Terminal neu oder füge es manuell hinzu.

Unter Windows: C:\Program Files\Git\bin zum PATH hinzufügen.

"Permission denied"

Lösung:
Führe das Terminal als Administrator aus (Windows) oder verwende sudo (macOS/Linux).

Bei Git-Clone-Fehlern: Überprüfe deine Internetverbindung.

"ModuleNotFoundError: No module named 'src'"

Lösung:
Du bist nicht im Projekt-Root-Verzeichnis. Wechsle mit cd in den claw-code Ordner.

Prüfe mit pwd oder dir, wo du bist.

Python Version zu alt

Lösung:
Claw Code benötigt Python 3.8+. Aktualisiere deine Python-Installation.

Prüfe mit: python3 --version

SSL-Zertifikat-Fehler

Lösung:
Bei Git-Klon-Fehlern: git config --global http.sslVerify false

Oder aktualisiere deine SSL-Zertifikate.

⚠️

Nach der Installation

Wenn du Python oder Git frisch installiert hast, starte dein Terminal neu, damit die Änderungen wirksam werden.

📝

Checkliste

Zusammenfassung

Hast du alles erledigt?

Python 3.8+ installiert — Getestet mit python3 --version
Git installiert — Getestet mit git --version
Repository geklont — git clone https://github.com/instructkr/claw-code.git
Erster Befehl funktioniert — python3 -m src.main summary zeigt Ergebnisse

🎉

Sektion 1 abgeschlossen!

Dein Arbeitsplatz ist eingerichtet. Du hast Python, Git und das Claw-Code-Repository erfolgreich installiert. Weiter geht's mit Tutorial 02: Repository klonen & erste Befehle!

Bereit für das nächste Tutorial?

Lerne die Projektstruktur kennen und führe die ersten drei essenziellen Befehle aus.

Zu Tutorial 02 →