Windows (WSL)

Führen Sie OpenCode unter Windows mit WSL für die beste Erfahrung aus.

Obwohl OpenCode direkt unter Windows ausgeführt werden kann, empfehlen wir die Verwendung von Windows Subsystem für Linux (WSL) (opens in a new tab) für die beste Erfahrung. WSL stellt eine Linux-Umgebung bereit, die nahtlos mit den Funktionen von OpenCode zusammenarbeitet.

Tipp: WSL bietet eine bessere Dateisystemleistung, vollständige Terminal-Unterstützung und Kompatibilität mit Entwicklungstools, auf die OpenCode angewiesen ist.

Einrichtung

WSL installieren Falls noch nicht geschehen, installieren Sie WSL (opens in a new tab) mithilfe der offiziellen Microsoft-Anleitung.
OpenCode in WSL installieren Sobald WSL eingerichtet ist, öffnen Sie Ihr WSL-Terminal und installieren Sie OpenCode mit einer der Installationsmethoden.
```
curl -fsSL https://opencode.ai/install | bash
```
OpenCode von WSL aus verwenden Navigieren Sie zu Ihrem Projektverzeichnis (greifen Sie auf Windows-Dateien über /mnt/c/, /mnt/d/ usw. zu) und führen Sie OpenCode aus.
```
cd /mnt/c/Users/YourName/project
opencode
```

Desktop-App + WSL-Server

Wenn Sie die OpenCode Desktop-App verwenden, den Server aber in WSL ausführen möchten:

Starten Sie den Server in WSL mit --hostname 0.0.0.0, um externe Verbindungen zuzulassen:
```
opencode serve --hostname 0.0.0.0 --port 4096
```
Verbinden Sie die Desktop-App mit http://localhost:4096

Hinweis: Falls localhost in Ihrer Konfiguration nicht funktioniert, verbinden Sie sich stattdessen mit der WSL-IP-Adresse (aus WSL: hostname -I) und verwenden Sie http://<wsl-ip>:4096.

Achtung: Wenn Sie --hostname 0.0.0.0 verwenden, setzen Sie OPENCODE_SERVER_PASSWORD, um den Server abzusichern.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

Web-Client + WSL

Für die beste Web-Erfahrung unter Windows:

Führen Sie opencode web im WSL-Terminal aus statt in PowerShell:
```
opencode web --hostname 0.0.0.0
```
Zugriff über Ihren Windows-Browser unter http://localhost:<port> (OpenCode gibt die URL aus)

Das Ausführen von opencode web aus WSL stellt einen ordnungsgemäßen Dateisystemzugriff und eine Terminal-Integration sicher, während es weiterhin von Ihrem Windows-Browser aus zugänglich ist.

Zugriff auf Windows-Dateien

WSL kann über das Verzeichnis /mnt/ auf all Ihre Windows-Dateien zugreifen:

Laufwerk C: → /mnt/c/
Laufwerk D: → /mnt/d/
Und so weiter...

Beispiel:

cd /mnt/c/Users/YourName/Documents/project
opencode

Tipp: Für die reibungsloseste Erfahrung sollten Sie in Erwägung ziehen, Ihr Repo in das WSL-Dateisystem zu klonen/kopieren (zum Beispiel unter ~/code/) und OpenCode dort auszuführen.

Tipps

Lassen Sie OpenCode in WSL für Projekte laufen, die auf Windows-Laufwerken gespeichert sind – der Dateizugriff ist nahtlos
Verwenden Sie die WSL-Erweiterung (opens in a new tab) von VS Code zusammen mit OpenCode für einen integrierten Entwicklungs-Workflow
Ihre OpenCode-Konfiguration und -Sitzungen werden innerhalb der WSL-Umgebung unter ~/.local/share/opencode/ gespeichert

Fehlerbehebung TUI