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.
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-wslFü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.
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.
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.
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 troubleshootingGit-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.
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.
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.
AI-assisted Attacks und Prompt Injection 2026: neue Angriffsfläche für AI-Produkte
AI-assisted Attacks und Prompt Injection 2026: neue Angriffsfläche für AI-Produkte. Ein praktischer PAS7-Studio-Sicherheitsleitfaden mit Threat Model, Kontrollen, Rollout-Checklist, Fehlern und Quellen.
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.
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.