Kurzantwort
Behandeln Sie OpenCode V2 als geplante Migration statt als blindes Update
Ein V2-Test ist sinnvoll, wenn die aktuellen CLI- und Desktop-Funktionen zu Ihrer Arbeit passen und Sie Zeit für eine Prüfung haben. Behalten Sie V1 zunächst bei und kontrollieren Sie Modelle, Zugangsdaten, Agents, Berechtigungen, MCP-Server, Plugins, Editor-Clients und echte Projektaufgaben. Eine einfache persönliche Installation kann in einem Testprojekt beginnen; Teams und Repositories mit eigenen Plugins sollten schrittweise umstellen.
Laut offizieller Migrationsanleitung sollen unterstützte V1-Konfigurationen und dateibasierte Definitionen weiter nutzbar sein; auch der bekannte Befehl opencode bleibt. Drei Änderungen brauchen trotzdem Aufmerksamkeit: V1-Plugins laufen nicht unter V2, der Vertrag der Server-API und ihrer Clients ändert sich, und Terminaleinstellungen wandern in eine globale Datei cli.json. Prüfen Sie die Kompatibilität auch dann, wenn Sie Ihre Hauptkonfiguration nicht konvertieren.
Diese Seite verbindet offizielle Installationswege, einen praktischen Vergleich und eine rückgängig machbare Checkliste. Die zentrale Migrationsanleitung verspricht keine vollständige Umwandlung historischer Sitzungsdatenbanken. Für Modelle, API-Schlüssel und Tarife lesen Sie die separaten Anleitungen zu Modellen, Providern und Tarifen.
OpenCode V1 vs. V2: Änderungen mit Folgen für den Arbeitsalltag
Die Versionsnummer allein verrät nichts über den Migrationsaufwand. Prüfen Sie die tatsächlich verwendeten Bereiche: Terminal-Client, Plugins, Server-API und Konfiguration. Unterstützte Projektdateien sind eine andere Kategorie als ausführbarer Plugin-Code oder API-Clients.
| Bereich | V1 | V2 und Migrationswirkung |
|---|---|---|
| CLI-Befehl | opencode | Der Name bleibt. Paketverwaltete V1- und V2-Installationen laufen standardmäßig nicht parallel. |
| Unterstützte Konfiguration und Dateien | V1-Konfiguration und Dateien unter .opencode/ | Unterstützte Felder und Definitionen sollen weiterlaufen; Provider und Berechtigungen müssen geprüft werden. |
| Plugins | V1-Plugin-API und Einstiegspunkte | Neue API; jedes V1-Plugin muss vor der Nutzung portiert werden. |
| Server-API und Clients | V1-Vertrag und generierte Clients | Neue Verträge; Integrationen benötigen V2-kompatible Clients und Tests. |
| Terminaleinstellungen | Mehrere tui.json- oder tui.jsonc-Dateien | Unterstützte Einstellungen wechseln in die globale cli.json; Ergebnis kontrollieren. |
| Installation | V1-Paket oder Installer | Einen offiziellen V2-Kanal verwenden; ein paketverwaltetes V1 muss eventuell zuerst entfernt werden. |
Die Tabelle grenzt die Prüfung ein und garantiert nicht, dass jedes alte Feld unterstützt wird. Die Migrationsanleitung unterscheidet zwischen unterstützten, akzeptierten aber nicht unterstützten und unzulässigen Werten. Prüfen Sie die aktuelle Dokumentation besonders vor Änderungen an Sicherheit, Providerzugriff oder Automatisierung und beachten Sie Startwarnungen.
Sollten Sie jetzt auf OpenCode V2 umsteigen?
Entscheiden Sie anhand von Kompatibilität und Rückkehrmöglichkeit, nicht allein anhand der Hauptversionsnummer. Eine private Installation mit integrierten Funktionen verursacht andere Kosten als ein Repository mit eigenen Plugins und Editorintegration.
Ein V2-Test bietet sich an, wenn
- Ihr Ablauf vor allem unterstützte Konfiguration, Provider, integrierte Befehle, Agents, Skills und MCP nutzt und Sie diese in einem Testprojekt prüfen können.
- Sie CLI oder Desktop von V2 nutzen möchten und eine funktionierende Kopie Ihrer aktuellen Umgebung behalten können.
- Ihre Plugins oder Server-Clients schon eine V2-Version haben oder eine zuständige Person sie portieren und testen kann.
Behalten Sie V1 vorerst, wenn
- Ein V1-Plugin, Serverendpunkt, IDE-Client oder Automatisierungsjob geschäftskritisch ist und noch nicht mit V2 getestet wurde.
- Sie Paket, Konfiguration oder Sitzungsdaten bei einem Fehler nicht wiederherstellen können.
- Das Werkzeug im Team genutzt wird, aber noch kein Plan für Umgebungen, Dokumentation und Support besteht.
Bei Unsicherheit starten Sie in einem entbehrlichen Testprojekt und notieren Befehl, Paketmanager, OpenCode-Version und erwartetes Ergebnis. Eine Person, die Agents und Provider verwendet, kann eine Kopie des Repositories prüfen, während eine zweite V1 für ein Server-Plugin behält. So beruht die Entscheidung auf konkreten Prüfpunkten statt auf einer pauschalen Behauptung, die neue Version sei besser.
OpenCode V2 über einen offiziellen Weg installieren
Die offizielle V2-Einführung nennt mehrere Installationswege im Terminal. Verwenden Sie nach Möglichkeit den Paketmanager, der Ihre Software bereits verwaltet, und prüfen Sie die aktuelle Systemunterstützung. Übernehmen Sie nicht ungeprüft einen alten V1-Paketbefehl für eine V2-Migration.
| Kanal | Befehl laut V2-Dokumentation | Prüfpunkt |
|---|---|---|
| Offizieller Installer | curl -fsSL https://opencode.ai/v2/install | bash | Installer und Betriebssystem müssen den aktuellen V2-Hinweisen entsprechen. |
| Homebrew | brew install anomalyco/tap/opencode-v2 | Tap und Paketname vor der Verwendung auf Aktualität prüfen. |
| npm | npm install -g @opencode/cli | Das npm-Tag @latest zeigte am 3. Oktober 2026 auf 2.0.22; aktuelle Version erneut prüfen. |
Die V2-Dokumentation beschreibt außerdem Bun, pnpm und weitere Wege. Die Plattformunterstützung ist unterschiedlich. Für Windows sollten Sie die dort genannten Binärdateien prüfen, statt anzunehmen, dass jeder Paketmanager geeignet ist. Folgen Sie bei Yarn, Vite+ oder AUR der aktuellen offiziellen V2-Syntax und nutzen Sie keine Downloadlinks von Drittanbietern.
Ermitteln Sie vor der Installation, wie V1 installiert wurde. Laut offizieller Anleitung muss paketverwaltetes V1 unter Umständen zuerst entfernt werden, weil beide Hauptversionen den Befehl opencode verwenden. Der V2-curl-Installer ersetzt die V1-Binärdatei. Das Entfernen eines Pakets sollte gemeinsame Konfiguration und Daten nicht löschen: Sichern Sie diese getrennt und prüfen Sie die Aktion des Paketmanagers.
So migrieren Sie kontrolliert von OpenCode V1 zu V2
Gestalten Sie den ersten Durchlauf rückgängig machbar. Zunächst soll V2 starten und das Projekt funktionieren; Sie müssen nicht am ersten Tag alle Konfigurationsdateien umschreiben. Orientieren Sie sich an der offiziellen Anleitung für Ihr Paket und Betriebssystem.
- V1-Installation dokumentieren. Notieren Sie Paketmanager oder Installer, Version, Umgebungsvariablen und Konfigurationspfade. Bewahren Sie das alte Paket oder eine verlässliche Neuinstallationsmethode auf.
- Ein datiertes Backup erstellen. Sichern Sie Konfiguration, Projektdefinitionen und benötigte Daten. Prüfen Sie, ob die Sicherung lesbar ist und nicht nur in einem temporären Ordner liegt.
- Ausführbare Abhängigkeiten erfassen. Listen Sie Plugins, API-Clients, CI-Befehle und Editorintegrationen auf. Kennzeichnen Sie jeden Punkt als unter V2 getestet, noch zu portieren oder nicht mehr benötigt.
- Über den passenden Kanal installieren. Entfernen Sie das V1-Paket nur, wenn die Anleitung es verlangt. Ein V1-Updatebefehl ist nicht die V2-Installation.
- Konfiguration prüfen. Starten Sie V2 in einem Testprojekt. Beachten Sie Warnungen zu alten Feldern, Modellen, Zugangsdaten, Berechtigungen und MCP-Verbindungen, bevor Sie wichtige Arbeit beginnen.
- Code und Clients anpassen. Portieren Sie Plugins zur neuen API und aktualisieren Sie Server-Clients. Testen Sie auch Fehlerfälle und Berechtigungen.
- Einstellungen später umwandeln. Unterstützte Terminalpräferenzen werden in eine globale
cli.jsonverschoben. Die Umwandlung in ein natives V2-Konfigurationsformat ist optional und kann bis nach den ersten Tests warten.
Lassen Sie unterstützte V1-Konfiguration während des ersten Prüflaufs unverändert. Laut Anleitung kann V2 unterstützte alte Einstellungen im Arbeitsspeicher normalisieren, ohne die Quelldatei umzuschreiben. Wenn Installation, Plugin-Portierung und Konvertierung getrennt bleiben, ist eine Regression leichter einzugrenzen und zurückzunehmen.
Was übernommen wird und was manuell geprüft werden muss
Betrachten Sie nur das Verhalten als kompatibel, das die aktuelle V2-Anleitung ausdrücklich unterstützt. So lassen sich Fragen zur OpenCode-V2-Kompatibilität beantworten, ohne für alle alten Felder oder Erweiterungen ein Weiterfunktionieren zu versprechen.
| Bestandteil | Vorsichtige Erwartung | Praktische Prüfung |
|---|---|---|
| Unterstützte Konfiguration und Projektdateien | Sollen weiterlaufen, können aber nicht unterstützte oder ignorierte Felder enthalten. | Startmeldungen lesen; Provider, Berechtigungen und echte Aufgaben testen. |
| Dateibasierte Agents, Befehle und Skills | Sind laut Anleitung weiter nutzbar, soweit ihr Verhalten unterstützt wird. | Jedes Element in einem Testprojekt aufrufen und das Ergebnis vergleichen. |
| Plugins | V1-Implementierungen laufen nicht als V2-Plugins. | Einstiegspunkt anpassen und Laden, Berechtigungen sowie Fehler prüfen. |
| Server-API und Clients | Der Vertrag ändert sich; V1-Clients gelten nicht automatisch als kompatibel. | Client portieren und Aufrufe, Ereignisse sowie Anmeldung validieren. |
| Alte Sitzungen | Die Kernanleitung verspricht keine Massenkonvertierung historischer Datenbanken. | Wichtige Sitzungen sichern und vor dem täglichen Wechsel prüfen. |
Die offizielle Dokumentation beschreibt einige alte Einstellungen als akzeptiert, aber nicht unterstützt; dadurch können Warnungen entstehen. Bei Optionen zu Dateirechten, Toolgrenzen oder Providerzugriff reicht es nicht, dass die Anwendung startet. Prüfen Sie das Protokoll und führen Sie einen Test aus, der die gewünschte Schutzwirkung nachweist.
OpenCode V2 testen, bevor Sie V1 als Rückfalloption entfernen
Führen Sie eine kurze Abnahme in einem Testprojekt durch und speichern Sie das Ergebnis bei Ihren Upgrade-Notizen. Teams können dieselbe Liste auf weiteren Rechnern verwenden; bei privater Nutzung hilft sie, die Entscheidung für V2 oder die Rückkehr zu V1 nachvollziehbar zu machen.
- Der aufgerufene Befehl gehört zur erwarteten Installation und zeigt eine V2-Version.
- Provider, Zugangsdaten und Modell funktionieren, ohne Schlüssel in Protokollen offenzulegen.
- Benötigte Agents, Befehle und Skills liefern das erwartete Verhalten.
- Lese- und Schreibrechte entsprechen den Projektregeln.
- MCP-Server verbinden sich; ein Verbindungsfehler löst keine unerwartete Aktion aus.
- Wichtige Plugins und Clients liegen in einer V2-kompatiblen Version vor.
- Benötigte Sitzungen sind vorhanden oder durch ein geprüftes Backup gesichert.
- Eine reale Aufgabe läuft erfolgreich durch und das Ergebnis lässt sich prüfen.
Schlägt eine zentrale Prüfung fehl, pausieren Sie V2 für diesen Arbeitsablauf und kehren Sie zur gesicherten V1-Installation oder zum Paket zurück. Lassen Sie V1 keine ausschließlich für V2 bestimmte Konfiguration lesen. Die Rückkehr hängt vom Paketmanager ab; halten Sie das Paket bereit und trennen Sie Nutzerdaten von der installierten Software. Löschen Sie die Sicherung erst nach einem vollständigen normalen Arbeitszyklus.
Für regelmäßige Updates nach einer V2-Installation dokumentiert die V2-CLI opencode upgrade und den Alias update. Dieser Befehl betrifft eine bereits installierte V2-Version; für den Wechsel von V1 gelten eigene Paket- und Installationsschritte.
Häufige Fragen zur OpenCode-V2-Migration
Ist OpenCode V2 ein normales Update von V1?
Nein. Es ist eine Migration auf eine neue Hauptversion. Beide verwenden den Befehl opencode, und paketverwaltete Installationen laufen standardmäßig nicht parallel. Klären Sie zuerst, wie V1 installiert wurde, und folgen Sie der offiziellen Anleitung.
Muss ich meine OpenCode-Konfiguration für V2 neu schreiben?
Nicht unbedingt. Laut offizieller Anleitung liest und normalisiert V2 unterstützte V1-Konfiguration, ohne die Quelldatei umzuschreiben. Prüfen Sie Warnungen und testen Sie Provider, Rechte und MCP.
Funktionieren OpenCode-V1-Plugins unter V2?
Nicht direkt. V1-Plugin-Implementierungen laufen nicht unter V2. Portieren Sie Einstiegspunkt und Verhalten mit der offiziellen Plugin-Anleitung und testen Sie das installierte Paket.
Wie installiere ich OpenCode V2 mit npm?
Die aktuelle V2-Dokumentation nennt npm install -g @opencode/cli. Prüfen Sie vor der Installation die V2-Einführung und Paketangaben auf Plattformunterstützung und notwendige Installationsskripte.
Welcher Befehl aktualisiert OpenCode V2?
Für eine bestehende V2-Installation dokumentiert die CLI opencode upgrade und den Alias update. Beim Wechsel von V1 müssen das alte Paket und der Installationskanal separat behandelt werden.
Wird beim Upgrade auf V2 die gesamte Sitzungshistorie übernommen?
Die zentrale Migrationsanleitung verspricht keine vollständige Umwandlung alter Datenbanken. Sichern Sie wichtige Daten und prüfen Sie benötigte Sitzungen, bevor Sie den täglichen Ablauf wechseln.
Offizielle OpenCode-Quellen
Installationsbefehle und Kompatibilitätsangaben wurden am 3. Oktober 2026 anhand offizieller Quellen geprüft. Pakete und Anleitungen können sich ändern; kontrollieren Sie sie vor einer Hauptversionsmigration erneut.