OpenCode Desktop oder CLI: Welche Oberfläche passt zu Ihrer Arbeit?

OpenCode Desktop und CLI im Vergleich: Arbeitsabläufe, Provider-Einrichtung und Sitzungswechsel. Mit einer kleinen Python-Übung und versionsabhängiger Fehlerdiagnose.

OpenCode Desktop oder CLI: Welche Oberfläche passt zu Ihrer Arbeit?

Wählen Sie OpenCode Desktop, wenn Sie Sitzungen und Codeänderungen in einer grafischen Arbeitsumgebung prüfen möchten. Beginnt Ihre Arbeit im Terminal, in einer Remote-Shell oder in einem wiederholbaren Skript, ist die CLI der passende Ausgangspunkt. Sie können beide verwenden. Entscheidend sind dabei dasselbe Projektverzeichnis, derselbe Server und dasselbe Modell – eine zweimalige Anmeldung genügt nicht.

Hier geht es um zwei Oberflächen von OpenCode. Wenn Sie OpenCode mit OpenAIs Codex vergleichen möchten, lesen Sie den Vergleich von OpenCode und Codex CLI (Englisch).

Wir haben die aktuelle Dokumentation am 17. November 2026 geprüft und OpenCode CLI 2.3.0 in einem isolierten Verzeichnis installiert, um Versionsangabe und Hilfeausgabe zu kontrollieren. Außerdem haben wir die Python-Tests der herunterladbaren Übung lokal ausgeführt. Wir haben weder einen kostenpflichtigen Modellvergleich durchgeführt noch die Übung in Desktop erledigt. Die beschriebenen Oberflächenfunktionen beruhen auf Dokumentation, nicht auf einem Nachweis besserer Codequalität. Herausgeber dieses Artikels ist Ofox, ein Anbieter von API-Zugängen.

Nach der anstehenden Aufgabe entscheiden

Ihre nächste AufgabeEinstiegBegründungPrüfen
Ein lokales Repository untersuchen und mehrere Änderungen prüfenDesktopEine visuelle Ansicht von Sitzungen und Diffs passt zu einem Ablauf mit Schwerpunkt auf CodeprüfungRichtiges Verzeichnis öffnen und geänderte Dateien vor der Übernahme prüfen
Per SSH auf einem Entwicklungsrechner arbeitenCLIDer Einstieg ist direkt in der vorhandenen Remote-Shell möglichZugangsdaten, Dateien und Werkzeuge müssen auf diesem Rechner vorhanden sein
Einen Prompt in einem Skript oder CI-Job wiederholenCLIopencode run benötigt keine interaktive OberflächeModell, Berechtigungen, Ausgabeverarbeitung und Fehlerstatus
Mit der Tastatur arbeiten und trotzdem einen Dialog führenCLI TUIDie CLI ist auch eine interaktive Anwendung, nicht nur ein SkriptbefehlTerminaldarstellung und ausgewähltes Projekt
Während einer lokalen Aufgabe die Oberfläche wechselnBeide, mit bewusster ÜbergabeDas aktuelle V2 unterstützt einen gemeinsamen lokalen ServerBeide Clients müssen tatsächlich denselben Server und dasselbe Projekt nutzen
Einen Authentifizierungs- oder Providerfehler behebenZuerst die Verbindung untersuchenEine andere Oberfläche repariert weder einen ungültigen Schlüssel noch eine nicht unterstützte AnfrageExakter Provider, Modell, Endpunkt und Fehlermeldung

Die OpenCode-Produktseite (Englisch) beschreibt Desktop als Arbeitsumgebung mit Sitzungen, Tabs und Diffs und Terminal als Oberfläche für Shells und Remote-Server. Das sind nützliche Unterschiede im Arbeitsablauf. Sie belegen keine unterschiedliche Leistungsfähigkeit des zugrunde liegenden Modells.

Wer bereits über SSH fehlgeschlagene Tests untersucht, gewinnt wenig durch den Wechsel zu einer lokalen GUI mit anderem Dateisystem. Wer mehrere lokale Änderungen prüft, möchte Gespräch und Diffs möglicherweise gemeinsam in einer grafischen Umgebung sehen. In beiden Fällen bleiben die Tests des Projekts erforderlich.

Vor einer Einrichtungsanleitung die Version prüfen

„Desktop oder CLI“ und „OpenCode 1 oder OpenCode 2“ sind unterschiedliche Fragen. Ein Versionskonflikt kann wie eine Beschränkung der Oberfläche aussehen.

Führen Sie im Terminal Folgendes aus:

opencode --version
opencode --help
opencode run --help

Unsere isolierte Installation meldete opencode v2.3.0. Die Hilfe nennt run, session, service, models, auth und debug. Insbesondere akzeptiert opencode models in dieser Version keinen Providernamen als Positionsargument. Ein Befehl aus einer älteren Anleitung muss mit der aktuellen Binärdatei nicht funktionieren.

Für eine neue V2-Installation mit npm unter macOS oder Linux nennt die aktuelle Installationsdokumentation (Englisch):

npm install -g @opencode/cli
opencode --version

Wer V1 bereits verwendet, sollte zuerst den offiziellen Migrationsleitfaden (Englisch) lesen. Beide Generationen verwenden den Befehl opencode. Ein zusätzlich installiertes Paket kann den bisherigen Befehl ersetzen oder einen Konflikt verursachen. Unter Windows verwenden Sie den von OpenCode aufgeführten eigenständigen CLI-Download, statt die Paketmanager-Anleitung als allgemein gültig anzusehen. Desktop steht ebenfalls für macOS, Windows und Linux zum Download bereit.

V2 verarbeitet weiterhin unterstützte V1-Konfigurationen; ein Umstieg verlangt daher keine Neufassung aller Dateien. Für Plugins und Serverintegrationen gibt es jedoch inkompatible Änderungen. Native V2-Providereinträge verwenden providers, package und settings, ältere Einträge provider, npm und options. Halten Sie jeden verschachtelten Providereintrag vollständig in einem Format, statt Bruchstücke aus Suchergebnissen zu mischen. Sichern Sie eine funktionierende Konfiguration vor der Umwandlung.

Provider verbinden und anschließend das Modell auswählen

Es gibt drei getrennte Prüfpunkte: Der Provider ist verbunden, das Modell ist sichtbar und eine Anfrage gelingt tatsächlich. Der erste Punkt beweist die beiden anderen nicht.

Für Ofox beginnen Sie mit der OpenCode-Integrationsanleitung, die beide Oberflächen abdeckt. Erstellen Sie einen Schlüssel anhand der Anleitung zur API-Authentifizierung. Er gehört weder in eingecheckte Projektdateien noch in Screenshots oder kopierte Diagnoseprotokolle.

Vorgehen in Desktop

Der dokumentierte Ofox-Ablauf lautet:

  1. Settings → Providers öffnen und Show more providers auswählen.
  2. Nach Ofox suchen, die Verbindung herstellen und den Schlüssel eingeben.
  3. Settings → Models öffnen, nach Ofox suchen und das gewünschte Modell aktivieren.
  4. Im richtigen Projekt eine Sitzung erstellen und dieses Modell in der Modellauswahl der Sitzung auswählen.

Weicht die Oberfläche ab, prüfen Sie zunächst die installierte Version und die aktuellen Provider-Einstellungen, bevor Sie einen Kontofehler vermuten. Der folgende Screenshot zeigt die englische Ofox-Dokumentation, keinen neuen Inferenzlauf in Desktop.

Englische Ofox-Dokumentation mit dem Pfad zu den Provider-Einstellungen in Desktop

Dokumentationsaufnahme vom 17. November 2026. Die eingebettete Oberfläche ist ein Dokumentationsbeispiel und belegt nicht die auf Ihrem Rechner installierte Version.

Vorgehen in der CLI

Öffnen Sie das Projektverzeichnis, starten Sie opencode, wählen Sie mit /connect den Provider und mit /models das Modell. Diese Slash-Befehle gehören in die interaktive Oberfläche, nicht an den normalen Shell-Prompt.

Für Skripte prüfen Sie die Modellliste mit opencode models und verwenden anschließend die exakt ausgegebene Kennung:

opencode run --model 'PROVIDER/MODEL' "Explain the files in this project. Do not edit them."

Ersetzen Sie PROVIDER/MODEL; es ist ein Platzhalter, kein echtes Modell. Der englische Prompt verlangt eine Erklärung der Projektdateien ohne Änderungen. Dieser Befehl sendet eine Modellanfrage und kann Providerkosten verursachen. Wir haben die Optionen über die lokale Hilfe geprüft, die Anfrage jedoch nicht ausgeführt.

Verwenden Sie den integrierten Ofox-Provider, wenn er Ihre Anforderungen erfüllt. Ein eigener Provider ist ein separater Weg für ein bestimmtes Protokoll oder einen Endpunkt, keine Voraussetzung für Desktop. Der Abschnitt zu integrierten und eigenen Providern erläutert den Unterschied. Falls Sie einen eigenen Zugang benötigen, gleichen Sie die aktuelle OpenCode-Providerreferenz (Englisch) mit dem exakten Endpunkt und unterstützten Protokoll aus der Ofox-Dokumentation ab. Unsere Anleitung zur eigenen Providerkonfiguration (Englisch) erklärt den Zusammenhang zwischen Provider- und Modellregistrierung; datierte Versionsbeispiele müssen Sie mit Ihrer installierten Version abgleichen.

Was wird beim Wechsel der Oberfläche geteilt?

Die aktuelle CLI-Dokumentation (Englisch) beschreibt einen gemeinsamen Hintergrundserver für den lokalen Benutzer. Er verwaltet Sitzungen, Konfiguration, Berechtigungen, Integrationen und Werkzeugausführung. Alternativ kann die CLI mit --standalone einen privaten Server verwenden oder über --server einen bestimmten Server ansprechen.

„Ich bin am selben Laptop“ reicht deshalb als Übergabeprüfung nicht aus. Ein privater Server, ein anderes Konto, ein Remote-Rechner oder ein anderer Projektpfad kann einen anderen Arbeitskontext bedeuten.

GegenstandBei der Übergabe prüfenWarum das wichtig ist
DateienDasselbe absolute Projektverzeichnis und den aktuellen Dateiinhalt bestätigenGleichnamige Ordner können unterschiedliche Arbeit enthalten
ServerZielservice beider Clients kontrollierenEin privater oder entfernter Dienst ist nicht automatisch der lokale gemeinsame Dienst
SitzungDie gewünschte Sitzung auswählen, nicht einfach die neuesteDie jüngste Historie kann zu einer anderen Aufgabe gehören
ModellDie genaue Provider-/Modellauswahl vergleichenEin vertrauter Anzeigename beweist keine identische Weiterleitung
BerechtigungenErlaubte Lese-, Schreib- und Ausführungsaktionen prüfenEin Oberflächenwechsel erteilt keine zusätzlichen Zugriffsrechte
Werkzeuge und UmgebungWerkzeuge auf dem Rechner prüfen, auf dem die Ausführung stattfindetEine lokale Python-Installation ist nicht automatisch auf dem Remote-Rechner verfügbar

Um den Dienstzustand ohne Neustart laufender Arbeit zu untersuchen:

opencode service status
opencode session list

Führen Sie den Sitzungsbefehl im Projekt aus, an dem Sie weiterarbeiten möchten. Die lokale Hilfe von CLI 2.3.0 beschreibt ihn als Auflistung der Sitzungen auf oberster Ebene im aktuellen Projekt. Wir haben die Befehlsdefinitionen kontrolliert, keinen Sitzungswechsel zwischen den Oberflächen getestet.

Bei abweichenden Einstellungen prüfen Sie anhand der Konfigurationsreferenz (Englisch) die betreffenden Projekt- und Benutzerdateien. Administrativ verwaltete Einstellungen können Vorrang haben. Deaktivieren Sie keine Verwaltungsrichtlinien, nur um beide Oberflächen gleich erscheinen zu lassen.

Dieselbe kleine Aufgabe in getrennten Arbeitskopien ausprobieren

Laden Sie die Vergleichsübung herunter. Sie enthält eine absichtlich unvollständige Python-Funktion, vier Tests, einen Prompt und eine redaktionell geschriebene Referenzlösung. Anleitung und Prompt sind Englisch. Für die Tests selbst sind weder API-Schlüssel noch zusätzliche Abhängigkeiten erforderlich.

Die Aufgabe besteht darin, Dateinamen mit der Endung .csv unabhängig von Groß- und Kleinschreibung anzunehmen und Endungen wie .csv.tmp abzulehnen. Das ist eine eng begrenzte Programmierübung, kein Maßstab für allgemeine Softwareentwicklungsfähigkeit.

  1. Entpacken Sie das Archiv zweimal in getrennte Ordner, beispielsweise desktop-check und cli-check.
  2. Führen Sie in beiden Ordnern python3 -m unittest -v aus. Wird Python 3 auf Ihrem System mit python gestartet, verwenden Sie diesen Befehl.
  3. Die Ausgangsversion sollte zwei fehlgeschlagene Tests von vier ergeben. Notieren Sie diesen Ausgangspunkt vor dem Agent-Einsatz.
  4. Öffnen Sie desktop-check in Desktop und starten Sie die CLI aus cli-check. Verwenden Sie denselben Provider, dasselbe Modell und gleichwertige Berechtigungen.
  5. Geben Sie beiden denselben Prompt. Die englische Originalfassung verlangt ausschließlich die Funktionskorrektur, unveränderte Tests und einen ehrlichen Ergebnisbericht:
Read app.py and test_app.py. Update only accepts_csv in app.py so filenames
ending in .csv are accepted case-insensitively. Reject .csv.tmp and names
with no .csv suffix. Do not modify the tests or install dependencies.
Run python3 -m unittest -v and report the result. If Python is unavailable,
say so rather than claiming the tests passed. Explain the exact code change.

Prüfen Sie danach app.py und stellen Sie sicher, dass test_app.py unverändert blieb. Wiederholen Sie die Tests selbst: Alle vier sollten bestehen. Eine Meldung „behoben“ ersetzt diese Abnahme nicht. Die Referenzlösung dient zur Kontrolle der gewünschten Regel; sie ist keine Ausgabe einer der beiden OpenCode-Oberflächen.

Wir haben die zwei Fehler der Ausgangsversion und die vier erfolgreichen Tests der Referenzlösung lokal bestätigt. Laufzeit, Kosten und Modellerfolgsraten von Desktop gegenüber CLI haben wir nicht erhoben. Wenn Sie die Übung ausführen, halten Sie solche Beobachtungen getrennt vom deterministischen Testergebnis fest. Eine kleine Aufgabe zeigt, ob Ihnen der Ablauf liegt; sie beweist keine grundsätzlich höhere Geschwindigkeit oder Genauigkeit einer Oberfläche.

Für einen Übergabetest stoppen Sie zunächst laufende Arbeit, wechseln die Oberfläche und prüfen vor dem Fortsetzen die sechs Punkte der vorherigen Tabelle. Lassen Sie nicht beide Agents gleichzeitig dieselbe Arbeitskopie bearbeiten: Ihre Änderungen würden das Vergleichsergebnis vermischen.

Fehler auf der richtigen Ebene untersuchen

SymptomZuerst prüfenNächster Schritt
opencode wird nicht gefundenInstallation und Shell-PATHInstallationsweg der gewählten Version prüfen; nach PATH-Änderungen die Shell neu öffnen
Ein kopierter Befehl lehnt ein Argument abopencode --version und die zugehörige --help-AusgabeSyntax der installierten Generation verwenden, statt Zugangsdaten auszutauschen
Provider verbunden, Modell fehltSichtbarkeit, Provider-ID und Modell-IDModellaktivierung in Desktop und CLI-Liste prüfen; gegebenenfalls eigene Registrierung kontrollieren
Desktop zeigt eine Sitzung, CLI nichtProjektpfad, Konto und ServerSitzungen im richtigen Projekt auflisten und Dienstzustand prüfen
Anfrage liefert 401Herkunft der Zugangsdaten und ZielendpunktOfox-Anleitung zu Authentifizierung und Anfragefehlern verwenden; keine Geheimnisse in Fehlerberichte kopieren
Anfrage liefert 429Ratenbegrenzung und zurückgegebene Wiederholungsinformationen429-Diagnose (Englisch) nutzen; ein Oberflächenwechsel beseitigt die Grenze nicht
Chat funktioniert, Agent-Werkzeuge scheiternModellfähigkeiten, Protokoll und Werkzeug-ErgebnisformatMit Prüfungen für OpenAI-kompatible APIs einfachen Chat von Tool-Calling-Kompatibilität unterscheiden

Bei einem Versionswechsel notieren Sie alte und neue Version sowie die erste fehlgeschlagene Aktion. Ändern Sie jeweils nur eine Variable. Gleichzeitiges Neuinstallieren, Austauschen des Schlüssels und Umschreiben der Providerkonfiguration erschwert die Ursachenbestimmung.

Beginnen Sie mit Desktop für visuelle lokale Codeprüfung oder mit der CLI für Terminal- und Skriptarbeit. Behalten Sie beide, wenn die Übergabe einen Nutzen hat. Entscheidend sind richtige Dateien, Modell und Berechtigungen sowie ein unabhängig überprüfbares Ergebnis – nicht eine mächtiger wirkende Oberfläche.