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 for Linux (WSL) (opens in a new tab) für die beste Erfahrung. WSL bietet eine Linux-Umgebung, die nahtlos mit den Funktionen von OpenCode zusammenarbeitet.

💡

Warum WSL?

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

Einrichtung

WSL installieren

Falls noch nicht geschehen, installieren Sie WSL (opens in a new tab) mit 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 aus WSL verwenden

Navigieren Sie zu Ihrem Projektverzeichnis (greifen Sie auf Windows-Dateien über /mnt/c/, /mnt/d/ usw. zu) und starten Sie OpenCode.
```
cd /mnt/c/Users/YourName/project
opencode
```

Desktop-App + WSL-Server

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

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

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.

⚠️

Bei Verwendung von --hostname 0.0.0.0 setzen Sie OPENCODE_SERVER_PASSWORD, um den Server zu sichern.

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 anstatt in PowerShell:
```
opencode web --hostname 0.0.0.0
```
Greifen Sie von Ihrem Windows-Browser aus zu unter http://localhost:<port> (OpenCode gibt die URL aus)

Das Ausführen von opencode web aus WSL gewährleistet den ordnungsgemäßen Dateisystemzugriff und die Terminal-Integration, während es weiterhin von Ihrem Windows-Browser aus zugänglich ist.

Zugriff auf Windows-Dateien

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

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

Beispiel:

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

💡

Für die reibungsloseste Erfahrung sollten Sie in Betracht ziehen, Ihr Repository 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 Entwicklungsworkflow
Ihre OpenCode-Konfiguration und Sitzungen werden innerhalb der WSL-Umgebung unter ~/.local/share/opencode/ gespeichert

Fehlerbehebung Migration zu 1.0