NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Grünes Terminal Fenster mit OPENCODE Schriftzug, Windows Logo links, Rakete rechts

OpenCode unter Windows installieren: Warum bash nicht funktioniert

OpenCode ist ein KI Helfer, der in einem schwarzen Fenster auf deinem Rechner läuft. Dieses Fenster heißt Terminal. Diese Anleitung bringt dich in vier Schritten dahin. Du brauchst kein Vorwissen und keine Adminrechte.

Auf der OpenCode Seite steht ein Befehl mit dem Wort bash. Der ist für Mac und Linux. Unter Windows kommt sofort das hier:

Code: 
          
Der Name "bash" wurde nicht als Name eines Cmdlet, einer Funktion,
einer Skriptdatei oder eines ausführbaren Programms erkannt.

Das ist kein Fehler von dir. Windows kennt bash einfach nicht. Wir nehmen deshalb den Windows Weg. Wir nutzen diese Anleitung auch in unseren Vibe Coding Schulungen, damit im Training keine Zeit fürs Setup draufgeht.

Inhalt

OpenCode Setup mit NCA: Schnelle Hilfe vom Experten

Wir arbeiten jeden Tag mit Terminal Agents. OpenCode und Claude Code gehören zu unserem Stack, dazu lokale Modelle über Ollama. Wir wissen also genau, wo Windows Nutzer hängen bleiben.

Wir holen Teams beim Onboarding ab, begleiten im 1:1 Mentoring und in der Vibe Coding Beratung. Danach geht es um Best Practices, CI/CD Pipelines und Security bei KI Code. Läuft ein Projekt aus dem Ruder, helfen wir beim Retten von Vibe Coding Projekten.

Lass uns sprechen

Finde das passende Angebot für dein Projekt

🤖

Hey! Ich bin CodeBot. Lass uns herausfinden, wie wir dein Projekt zum Fliegen bringen.

Was soll entstehen?

Terminal öffnen: So findest du das schwarze Fenster

Drücke die Windows Taste, tippe powershell und drücke Enter. Fertig, das ist dein Terminal.

Dort tippst du Befehle ein und drückst Enter. Nach jedem Befehl wartest du, bis wieder eine neue Zeile erscheint. Die Zeile sieht so aus:

Code: 
          
PS C:\Users\DeinName>

Wichtig ist nur das PS am Anfang. Dann bist du richtig. Fehlt das PS, tippe einmal das Wort powershell und drücke Enter.

Geschafft, wenn: deine Zeile mit PS beginnt.

Schritt 1: Node.js installieren

OpenCode braucht ein Programm namens Node.js. Das holst du dir mit einem Befehl. Kopiere ihn und drücke Enter.

Code: 
          
winget install OpenJS.NodeJS.LTS

Kommt eine Frage zur Lizenz, tippe J und drücke Enter. Dann läuft die Installation.

Jetzt das Wichtigste: Schließe das Terminal Fenster komplett und öffne es neu. Ohne diesen Neustart kennt Windows den neuen Befehl nicht. Das ist die häufigste Stolperfalle.

Im neuen Fenster prüfst du, ob alles da ist:

Code: 
          
node --version

Geschafft, wenn: eine Zahl erscheint, zum Beispiel v22.14.0. Kommt eine Fehlermeldung, hast du das Fenster nicht neu geöffnet.

Schritt 2: Wenn Windows den Befehl blockiert

Viele bekommen jetzt diese Meldung:

Code: 
          
npm : Die Datei "C:\Program Files\nodejs\npm.ps1" kann nicht geladen werden,
da die Ausführung von Skripts auf diesem System deaktiviert ist.

Kein Grund zur Sorge. Windows sperrt aus Sicherheitsgründen bestimmte Dateien. Es gibt einen einfachen Trick.

Der Trick: Hänge .cmd an den Befehl an. Jeder Befehl existiert doppelt. Die eine Version wird gesperrt, die andere nie. Mit .cmd nimmst du automatisch die, die immer funktioniert.

Code: 
          
npm.cmd --version

Das gilt für alle weiteren Befehle: statt npm einfach npm.cmd. Wer die Sperre dauerhaft lösen will, tippt einmal diesen Befehl. Adminrechte braucht es dafür nicht.

Code: 
          
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Geschafft, wenn: npm.cmd --version eine Zahl zeigt, zum Beispiel 10.9.2.

Schritt 3: OpenCode installieren

Jetzt kommt OpenCode selbst. Ein Befehl, einmal Enter.

Code: 
          
npm.cmd install -g opencode-ai

Das Paket heißt opencode-ai, nicht opencode. Vertipp dich hier nicht.

Danach wieder: Fenster schließen, neu öffnen. Dann prüfen:

Code: 
          
opencode --version

Geschafft, wenn: eine Zahl erscheint. Kommt eine Sperrmeldung, nimm opencode.cmd --version.

Schritt 4: OpenCode starten

OpenCode arbeitet immer in dem Ordner, in dem du es startest. Mit cd wechselst du in deinen Projektordner, danach startest du das Programm.

Code: 
          
cd C:\Users\DeinName\Documents\mein-projekt
opencode

Beim ersten Start fehlt noch die KI. Du tippst im Programm /connect und wählst einen Anbieter aus. Der Zugang wird gespeichert, beim nächsten Mal geht es sofort los.

Du kannst Anthropic, OpenAI oder Google verbinden. Genauso laufen lokale Modelle über Ollama, ganz ohne Daten an US Anbieter. Welches Modell zu dir passt, zeigt unser Guide zur Modellauswahl.

Ein Tipp für den Anfang: Mit der Tab Taste schaltest du um. Plan Mode schaut sich dein Projekt nur an. Build Mode schreibt Code. Starte mit Plan Mode.

Geschafft, wenn: OpenCode läuft und auf deine erste Frage antwortet.

Fehlermeldungen und was sie bedeuten

Was auf dem Bildschirm steht Was los ist Was du tust
Der Name bash wurde nicht erkannt Du hast den Befehl für Mac oder Linux erwischt Nimm den Weg aus dieser Anleitung
Die Datei npm.ps1 kann nicht geladen werden Windows sperrt diese Datei Hänge .cmd an, also npm.cmd statt npm
Der Name node wurde nicht erkannt Das Fenster kennt den neuen Befehl noch nicht Terminal schließen und neu öffnen
Der Name opencode wurde nicht erkannt Gleiche Ursache wie oben Terminal schließen und neu öffnen, sonst opencode.cmd nutzen
winget wurde nicht gefunden Sehr altes Windows 10 Node.js von nodejs.org laden, LTS Version wählen
Etwas mit bin sh exe beim Start Ein Fehler älterer OpenCode Versionen npm.cmd install -g opencode-ai@latest ausführen
OpenCode startet, kennt aber kein Modell Es ist noch keine KI verbunden Im Programm /connect tippen

Aktualisieren und entfernen

OpenCode wird oft verbessert. Ein Befehl holt die neueste Version:

Code: 
          
npm.cmd install -g opencode-ai@latest

Und wenn du es wieder loswerden willst:

Code: 
          
npm.cmd uninstall -g opencode-ai

Damit läuft dein Setup. Der nächste Schritt ist der Umgang damit: gute Prompts schreiben und Code Qualität mit KI Agenten sichern.

Aus unseren Schulungen: Setup ist kein Nebenschauplatz

In unseren Schulungen sehen wir es immer wieder: Die erste Stunde geht für Installationsprobleme drauf. Fast jede Anleitung im Netz geht von Mac oder Linux aus. Windows Rechner ohne Entwickler Setup bleiben hängen. Deshalb schicken wir dieses Dokument vorher raus.

Ein laufender Agent ist der Anfang, nicht das Ziel. Ohne Regeln entsteht Code, den später niemand prüfen will. Genau da setzen wir an: mit automatisierten Code Reviews, klaren Best Practices und einer ehrlichen Tool Übersicht.

CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

E-Mail Kontakt

Häufige Fragen zur OpenCode Installation unter Windows

Die Fragen, die uns in Schulungen und im Support am häufigsten begegnen, wenn Windows Nutzer OpenCode zum ersten Mal lokal installieren.

Wie installiere ich OpenCode unter Windows 2026?

In vier Schritten. Node.js mit winget installieren, Terminal neu öffnen, dann npm.cmd install -g opencode-ai eingeben, Terminal wieder neu öffnen. Danach startest du OpenCode in deinem Projektordner mit dem Wort opencode. Adminrechte brauchst du nicht.

Warum funktioniert der offizielle Befehl unter Windows nicht 2026?

Er endet auf bash. Das ist eine Shell von Mac und Linux, die es unter Windows nicht gibt. Deshalb bricht Windows sofort ab. Der Weg über winget und npm ist der Windows Weg.

Was bedeutet npm.ps1 kann nicht geladen werden 2026?

Windows sperrt aus Sicherheitsgründen bestimmte Dateien. Node.js ist trotzdem korrekt installiert. Hänge einfach .cmd an den Befehl an, also npm.cmd statt npm. Damit umgehst du die Sperre komplett.

Brauche ich WSL oder Linux für OpenCode 2026?

Nein. OpenCode läuft direkt unter Windows. WSL wird von der offiziellen Doku empfohlen, nötig ist es für den Einstieg aber nicht. Fang ohne an.

Wie heißt das Paket von OpenCode 2026?

Es heißt opencode-ai, nicht opencode. Das ist die häufigste Verwechslung. Der komplette Befehl lautet npm.cmd install -g opencode-ai.

Wie öffne ich überhaupt ein Terminal?

Windows Taste drücken, das Wort powershell tippen, Enter drücken. Das schwarze Fenster ist dein Terminal. Dort tippst du Befehle ein und bestätigst jeden mit Enter.

Warum wird node nach der Installation nicht gefunden?

Weil das Fenster noch offen war, als du installiert hast. Es kennt den neuen Befehl nicht. Schließe es komplett und öffne es neu. Danach funktioniert node --version.

Brauche ich Adminrechte?

Nein. Kein Schritt dieser Anleitung braucht Adminrechte. Das ist besonders auf Firmenrechnern wichtig, wo du selbst nichts installieren darfst.

Was kostet OpenCode?

OpenCode selbst ist Open Source und kostenlos. Kosten entstehen nur beim KI Anbieter, den du verbindest. Wer lokale Modelle über Ollama nutzt, zahlt gar nichts, braucht dafür aber einen passenden Rechner.

Welche KI verbinde ich mit OpenCode?

Das entscheidest du. Anthropic, OpenAI und Google gehen genauso wie lokale Modelle über Ollama. Du tippst im Programm /connect und wählst aus. Der Zugang wird gespeichert.

Was ist der Unterschied zwischen Plan Mode und Build Mode?

Plan Mode schaut sich dein Projekt nur an und ändert nichts. Build Mode schreibt Code. Mit der Tab Taste wechselst du. Für den Anfang ist Plan Mode die sichere Wahl.

Wie aktualisiere ich OpenCode?

Mit npm.cmd install -g opencode-ai@latest. Danach zeigt opencode --version die neue Nummer. Bei Problemen lohnt sich ein Update fast immer als erster Versuch.