Zum Inhalt springen

Windows (WSL)

CodeTutor laeuft zwar direkt unter Windows, die beste Erfahrung bekommst du aber mit Windows Subsystem for Linux (WSL). WSL bietet eine Linux-Umgebung, die mit den CodeTutor-Features nahtlos funktioniert.


Einrichtung

  1. Install WSL

    Falls noch nicht geschehen, installiere WSL mit der offiziellen Microsoft-Anleitung.

  2. Install CodeTutor in WSL

    Wenn WSL eingerichtet ist, oeffne dein WSL-Terminal und installiere CodeTutor mit einer der Installationsmethoden.

    Terminal-Fenster
    curl -fsSL https://codetutor-docs.vercel.app/install | bash
  3. CodeTutor über WSL verwenden

    Wechsle in dein Projektverzeichnis (Windows-Dateien erreichst du ueber /mnt/c/, /mnt/d/ usw.) und starte CodeTutor.

    Terminal-Fenster
    cd /mnt/c/Users/YourName/project
    opencode

Desktop-App + WSL-Server

Wenn du die CodeTutor-Desktop-App nutzen willst, den Server aber in WSL betreiben moechtest:

  1. Starte den Server in WSL mit --hostname 0.0.0.0, damit externe Verbindungen moeglich sind:

    Terminal-Fenster
    codetutor serve --hostname 0.0.0.0 --port 4096
  2. Verbinde die Desktop-App mit http://localhost:4096


Web-Client + WSL

Fuer die beste Web-Erfahrung unter Windows:

  1. Fuehre codetutor web im WSL-Terminal aus, nicht in PowerShell:

    Terminal-Fenster
    codetutor web --hostname 0.0.0.0
  2. Rufe die URL im Windows-Browser auf unter http://localhost:<port> (CodeTutor zeigt die URL an)

Wenn du codetutor web aus WSL startest, bleiben Dateizugriff und Terminal-Integration sauber. Gleichzeitig ist die Weboberflaeche weiterhin im Windows-Browser erreichbar.


Zugriff auf Windows-Dateien

WSL kann ueber das Verzeichnis /mnt/ auf alle Windows-Dateien zugreifen:

  • Laufwerk C: -> /mnt/c/
  • Laufwerk D: -> /mnt/d/
  • usw.

Beispiel:

Terminal-Fenster
cd /mnt/c/Users/YourName/Documents/project
opencode

Tipps

  • Lass CodeTutor in WSL laufen, auch wenn das Projekt auf einem Windows-Laufwerk liegt
  • Nutze die WSL-Extension von VS Code fuer einen integrierten Workflow
  • CodeTutor-Konfiguration und Sitzungen liegen in WSL unter ~/.local/share/opencode/