Kurzantwort
Verwenden Sie den Installationsweg, der das Binary besitzt
Ein sicheres OpenCode-Update bleibt im gleichen Kanal: Homebrew mit Homebrew, npm mit npm und eine V2-Shell-Installation mit dem dokumentierten CLI-Upgrade. Gemischte Kanäle können zwei Dateien in PATH erzeugen, sodass die Shell weiterhin eine alte Kopie startet.
Führen Sie vor dem Update opencode --version aus und notieren Sie den Pfad. Sichern Sie Projektkonfiguration, globale Konfiguration und wichtige Plugins oder Skills. Das ist ein kleiner Wiederherstellungspunkt, keine vollständige Rechner-Sicherung.
Diese Seite behandelt normale Updates einer funktionierenden Installation. Der Wechsel von V1 zu V2 ist eine Hauptversionsmigration; verwenden Sie den OpenCode-V2-Migrationsleitfaden.
Installationsweg vor dem OpenCode-Update feststellen
Raten Sie nicht anhand des Befehlsnamens. OpenCode kann aus Shell-Installer, npm, Bun, Homebrew, Arch, einer Windows-Datei oder einem Container-Image stammen.
| Wahrscheinlicher Weg | Hinweis | Update-Grenze |
|---|---|---|
| V2-Shell-Installer | opencode.ai/v2/install wurde verwendet | V2-Upgrade ausführen und den Pfad erneut prüfen. |
| npm | npm list -g @opencode/cli zeigt das Paket | Globales Paket aktualisieren und postinstall prüfen. |
| Bun, pnpm oder Yarn | Paket steht in der globalen Liste | Globale Syntax und Script-Berechtigungen verwenden. |
| Homebrew | brew list --formula enthält OpenCode | Diese Formula aktualisieren, kein zweites Binary installieren. |
| Windows | where opencode zeigt eine exe | Offiziellen Downloadweg verwenden und richtige Datei ersetzen. |
Unter Unix zeigen command -v opencode und type -a opencode alle Kopien. PowerShell verwendet Get-Command opencode | Format-List Source,Version. Mehrere Pfade müssen vor dem Update geklärt werden.
OpenCode-Update-Befehle nach Installationsweg
Die Beispiele entsprechen den aktuell geprüften offiziellen Wegen. Paketnamen und Plattformen können sich ändern. Öffnen Sie die offizielle Dokumentation und wählen Sie genau eine passende Zeile.
Bereits installierte V2-CLI
Die V2-CLI dokumentiert opencode upgrade und den Alias opencode update. Version vor und nach dem Befehl vergleichen. Fehlt der Befehl, läuft eventuell V1 oder ein anderes Binary.
opencode --version
opencode upgrade
opencode --versionnpm, Bun, pnpm und Homebrew
Das V2-NPM-Paket heißt @opencode/cli. Bun und pnpm verlangen möglicherweise eine explizite Script-Freigabe; Homebrew sollte nur die bereits installierte Formula aktualisieren.
npm install -g @opencode/cli
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
brew upgrade anomalyco/tap/opencode-v2Führen Sie nicht alle Zeilen aus. Prüfen Sie Berechtigungsfehler, übersprungene Scripts und das Installationspräfix. Ein erfolgreicher Paketvorgang bedeutet nicht automatisch, dass die Shell das neue Binary nutzt.
Windows, Container und CI
Die offizielle V2-Seite bietet einen Windows-Binary-Weg. Öffnen Sie nach dem Ersetzen eine neue PowerShell. In Container und CI werden Image oder Lockfile geändert und neu gebaut; eine Änderung in einem laufenden Container ist nicht reproduzierbar.
OpenCode-Update vor einem echten Repository prüfen
Die Versionsnummer zeigt nur, welches Binary geantwortet hat. Die Prüfung muss die Aufgaben abdecken, die nach einem Paketwechsel ausfallen können.
- Binary bestätigen.
opencode --versionund den Pfadbefehl ausführen. - Risikoarmes Projekt verwenden.Test-Repository oder sauberen Branch wählen.
- Provider und Modell testen.Nur-Lese-Anfrage senden, ohne Geheimnisse zu protokollieren.
- Berechtigungen testen.Lesen, kleine Änderung und freigabepflichtigen Befehl prüfen.
- Erweiterungen testen.Wichtigen Agent, Command, Skill, MCP-Server oder Plugin ausführen.
- Diff prüfen.Unerwartete Dateien, Logs und Konfigurationsänderungen suchen.
Notieren Sie Betriebssystem, Shell, Kanal, Provider, Modell und Aufgabe. So bleibt das nächste OpenCode update vergleichbar und das Team erhält einen Rückkehrpunkt.
Bei einem defekten Update zurückkehren
Stoppen Sie die geänderte Installation und unterscheiden Sie Pfad-, Paket- und Kompatibilitätsfehler. Bewahren Sie alten Cache oder Installer nach Teamregel und trennen Sie Konfigurationsbackup vom Binary.
Befehl nicht gefunden
Neue Shell öffnen, where opencode oder command -v opencode ausführen und mit dem Manager-Präfix vergleichen. Erst PATH korrigieren, nicht mehrfach installieren.
Provider oder Modell fehlerhaft
Konfigurationspfad und Modell-ID mit der vorherigen Notiz vergleichen. Keine Schlüssel veröffentlichen. Nur-Lese-Anfrage senden und Provider-Dokumentation prüfen.
Plugin oder MCP fehlerhaft
Erweiterung in einem Testprojekt deaktivieren und die Kern-CLI prüfen. Nutzen Sie den Plugin-Leitfaden oder den MCP-Leitfaden. V1 zu V2 braucht den offiziellen Migrationsplan.
Hinweis zur aktuellen OpenCode-Version
Am 18. Oktober 2026 zeigte das offizielle Changelog v2.0.32 als ersten Eintrag vom 16. Oktober. Die offizielle Downloadseite listete V2-Installer, npm, Bun, Homebrew, Arch und Plattform-Binaries. Diese Prüfung ist datiert und keine dauerhafte Latest-Zusage.
Wir erfinden keine Direkt-URL, Dateigröße oder Scan-Aussage. Verwenden Sie den offiziellen Weg und notieren Sie die Ausgabe von opencode --version.
FAQ zum OpenCode-Update
Wie aktualisiere ich OpenCode?
Installationsweg feststellen, Version notieren und den passenden Befehl ausführen. Bei V2 ist es opencode upgrade, update ist der Alias. npm, Bun, pnpm, Homebrew und Binary bleiben bei ihrer Quelle.
Welcher Befehl aktualisiert die OpenCode-CLI?
Bei einer V2-Installation opencode upgrade. Fehlt er, prüfen Sie V1-Paket oder eine andere Datei in PATH.
Wie komme ich auf die neueste OpenCode-Version?
Latest hängt von Kanal und Plattform ab. Changelog und Downloadseite prüfen, über denselben Kanal aktualisieren und die ausgegebene Version kontrollieren.
Wie aktualisiere ich OpenCode unter Windows?
Offiziellen Weg für die passende Architektur verwenden, exe ersetzen, PowerShell neu öffnen und Get-Command opencode sowie opencode --version prüfen.
Überschreibt ein Update meine Konfiguration?
Ein Routineupdate ist keine Konfigurationsmigration. Backup behalten, Hinweise lesen und V1 zu V2 getrennt behandeln.
Soll ich zuerst CLI oder Plugins aktualisieren?
CLI zuerst in einem Testprojekt aktualisieren, danach jedes Plugin, MCP, jeden Agent und Editor-Client auf Kompatibilität prüfen.
Offizielle Quellen und verwandte Leitfäden
Befehle und Versionshinweis wurden am 18. Oktober 2026 geprüft. Vor einem späteren Update die Quellen erneut öffnen.