OpenCode unter Windows mit WSL installieren: Anleitung 2026
So installieren Sie OpenCode unter Windows mit WSL 2 und Ubuntu. Mit exakten Befehlen, Modell-Setup, Projektstruktur und Lösungen für häufige Probleme.
Die empfohlene Einrichtung ist WSL 2 mit Ubuntu. Öffnen Sie PowerShell als Administrator, führen Sie `wsl --install` aus, starten Sie Windows neu, öffnen Sie Ubuntu und installieren Sie OpenCode mit `curl -fsSL https://opencode.ai/install | bash` oder `npm install -g opencode-ai`.
Warum WSL für OpenCode unter Windows?
OpenCode kann über npm, Chocolatey, Scoop, Docker oder fertige Releases installiert werden. Die offizielle Dokumentation empfiehlt WSL für bessere Kompatibilität und Performance der terminalbasierten Funktionen. [1]
WSL bietet einen Linux-Userspace innerhalb von Windows, ohne klassische virtuelle Maschine oder Dual-Boot. Das ist praktisch für Node.js, Git Hooks, Package Manager und Shell-Befehle.
Windows bleibt Ihr Desktop, Ubuntu die Linux-Entwicklungsumgebung und WSL 2 die Verbindung dazwischen.
Screenshot des Abschnitts why-wslWSL 2 und Ubuntu installieren
Führen Sie die Befehle in PowerShell als Administrator aus und schließen Sie anschließend die Ubuntu-Ersteinrichtung ab.
PowerShell als Administrator öffnen
PowerShell im Startmenü suchen, rechtsklicken und Run as administrator auswählen.
WSL installieren
wsl --install ausführen. Microsoft zufolge werden damit die nötigen Komponenten aktiviert und Ubuntu installiert. [2]
Windows neu starten
Nach dem Neustart Ubuntu starten. Falls wsl --install nur Hilfe anzeigt, wsl --list --online und danach wsl --install -d Ubuntu verwenden. [2]
Ubuntu einrichten
Linux-Benutzernamen und Passwort anlegen. Diese Zugangsdaten sind getrennt vom Windows-Konto.
WSL 2 prüfen
wsl --list --verbose ausführen. Ubuntu sollte Version 2 zeigen; sonst wsl --set-version Ubuntu 2 ausführen. [2]
WSL-Check
Vor der OpenCode-Installation prüfen, ob Ubuntu wirklich unter WSL 2 läuft.
OpenCode in Ubuntu installieren
Ubuntu öffnen
Ubuntu über Startmenü oder Windows Terminal starten. Es sollte eine Linux-Shell und nicht PowerShell geöffnet sein.
Pakete aktualisieren
sudo apt update ausführen.
OpenCode installieren
Offizielles Script: curl -fsSL https://opencode.ai/install | bash. Mit vorhandenem Node.js geht auch npm install -g opencode-ai. [1]
Befehl prüfen
opencode --version ausführen. Bei command not found die Linux-PATH-Variable und eine neue Shell prüfen.
Wichtig
OpenCode in derselben Linux-Umgebung installieren, in der Projekt und Dependencies laufen.
Projekt öffnen und Modell verbinden
Linux-Dateisystem verwenden
Aktive Repositories unter ~/projects beziehungsweise /home/<user>/projects speichern. /mnt/c funktioniert, kann aber langsamer sein.
Repository öffnen
Zum Beispiel cd ~/projects && git clone <repository-url>. Keine API-Keys oder .env-Dateien in Prompts einfügen.
OpenCode starten
opencode und anschließend /connect für OpenCode Zen oder einen anderen Provider ausführen.
Projekt initialisieren
/init ausführen. OpenCode erstellt AGENTS.md mit Projektregeln. [1]
Kleine Aufgabe stellen
Mit einer Dateierklärung, einem Test oder einem reproduzierbaren Bug beginnen. Für riskante Änderungen zuerst einen Plan anfordern.
Häufige OpenCode- und WSL-Probleme
opencode: command not found — OpenCode innerhalb von Ubuntu installieren und which node sowie which npm prüfen.
Projekt ist langsam — Repository aus /mnt/c/Users/... nach ~/projects/my-app verschieben.
Ubuntu nutzt WSL 1 — wsl --list --verbose prüfen und wsl --set-version Ubuntu 2 ausführen.
Installation bleibt bei 0% stehen — wsl --install --web-download -d Ubuntu versuchen. [2]
Modell antwortet nicht — /connect, API-Key, Kontingent, Billing und Modell prüfen.
Linux-PATH, Projektort und WSL-Version prüfen — damit lassen sich die meisten Setup-Probleme lösen.
Screenshot des Abschnitts troubleshootingSicherer AI-Coding-Workflow unter Windows
Git-Branch verwenden
So bleiben Änderungen isoliert und prüfbar.
Mit Plan-Modus beginnen
Besonders für Auth, Zahlungen, Migrationen und große Refactorings.
Secrets schützen
.env und Produktionszugänge nicht in Prompts einfügen.
Ergebnis verifizieren
Tests, Typecheck, Linter oder Build ausführen.
FAQ
Ja. Dokumentiert sind auch Chocolatey, Scoop, npm, Docker, Mise und fertige Releases. WSL wird wegen Kompatibilität und Performance empfohlen.
Windows 10 ab Version 2004 und Windows 11.
Für den WSL-Workflow innerhalb von Ubuntu, zusammen mit Node.js, Package Manager und dem Projekt.
`wsl --list --verbose` in PowerShell ausführen. Ubuntu sollte Version 2 zeigen.
Offizielle Installationsquellen
Die zuverlässigste Kombination
Beschreiben Sie die Aufgabe — die ersten 15 Minuten der Beratung sind kostenlos.
Verwandte Artikel
AI Assistant Entwicklung Kosten 2026: RAG, Knowledge Base, Integrationen und Support
Praktischer Leitfaden zu Kosten fuer AI Assistants: RAG, Knowledge Base, Channels, Tool Use, Guardrails, Evaluations, Monitoring und Support.
KI fur Landingpage-Entwicklung: wo sie Launches beschleunigt und wo sie Conversion schadet
Eine praxisnahe Analyse zur Nutzung von KI fur Landingpages: v0, Webflow AI, Builder.io, Framer-ahnliche Builder, UX-Generierung, Copy, SEO, Personalisierung, A/B-Tests, Template-Risiken, Accessibility, Security und technischer Schuldenaufbau.
AI SEO / GEO im Jahr 2026: Ihre nächsten Kunden sind nicht Menschen — sondern Agents
Suche verschiebt sich von Klicks zu Antworten. Bots und AI-Agents crawlen, zitieren, empfehlen — und kaufen zunehmend. Erfahren Sie, was AI SEO / GEO bedeutet, warum klassisches SEO nicht mehr reicht und wie PAS7 Studio Marken im agentischen Web sichtbar macht.
Der leistungsstärkste Chip von Apple? M5 Pro und M5 Max brechen Rekorde
Eine Analyse zu Apple M5 Pro und M5 Max im März 2026. Wir zeigen, warum diese Chips als die stärksten professionellen Laptop-SoCs von Apple gelten können, wie sie sich gegen M4 Pro, M4 Max, M1 Pro, M1 Max schlagen und was der Vergleich mit aktuellen Intel- und AMD-Chips zeigt.
Professionelle Entwicklung für Ihr Geschäft
Wir erstellen moderne Web-Lösungen und Bots für Unternehmen. Erfahren Sie, wie wir Ihnen helfen können, Ihre Ziele zu erreichen.