Zum Inhalt springen

Windows (WSL)

Nutze OpenCode unter Windows am besten mit WSL.

OpenCode 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 OpenCode-Features nahtlos funktioniert.


Setup

  1. Install WSL

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

  2. Install OpenCode in WSL

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

    Terminal-Fenster
    curl -fsSL https://opencode.ai/install | bash
  3. OpenCode über WSL verwenden

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

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

Desktop App + WSL Server

Wenn du die OpenCode-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
    opencode 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 opencode web im WSL-Terminal aus, nicht in PowerShell:

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

Wenn du opencode 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 OpenCode in WSL laufen, auch wenn das Projekt auf einem Windows-Laufwerk liegt
  • Nutze die WSL-Extension von VS Code fuer einen integrierten Workflow
  • OpenCode-Konfiguration und Sitzungen liegen in WSL unter ~/.local/share/opencode/