OpenCode auf dem Cloud-Server: Installation und Dauerbetrieb
Stand 2026-10-20 lässt sich OpenCode auf einem QCode-Cloud-Server installieren, mit opencode serve dauerhaft betreiben und mit dem QCode-Schlüssel Modelle aufrufen. Cloud-Server und AI-Services werden getrennt verkauft; sie teilen nur Konto und Guthaben.
Aktualisiert 2026-10-20
Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT und chinesische Modelle.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Vier Punkte für die Einrichtung
Headless-HTTP-Server
Laut offizieller Server-Dokumentation startet opencode serve einen Headless-HTTP-Server mit OpenAPI-Endpunkt; der Standardport ist 4096, die Standardadresse 127.0.0.1.
Voller root-Zugriff
Ein QCode-Cloud-Server ist ein KVM-Host mit eigener öffentlicher IPv4 und vollem root-Zugriff; System und Daten verwalten Sie selbst.
Testdauer
Der Test dauert 1 Tag (24 Stunden) und wird nach der gewählten Konfiguration abgerechnet; währenddessen können Sie den Server im Panel auf 1, 3, 6 oder 12 Monate umstellen und behalten. Sonst wird er am Ende gelöscht, die Daten bleiben nicht erhalten.
Bei der Bestellung wählbar
Bei der Bestellung können Sie einen öffentlichen SSH-Schlüssel hinterlegen und „nur Schlüssel-Login“ (Root-Passwort-Login ausschalten) wählen. Eine Web-Konsole gibt es derzeit nicht: Wer den privaten Schlüssel verliert, kommt nur durch eine Neuinstallation des Systems wieder hinein, dabei werden die Daten gelöscht.
Was auf dem Server läuft
So läuft OpenCode auf einem QCode-Cloud-Server: Bestellen Sie einen KVM-Host mit root-Zugriff, installieren Sie OpenCode mit dem offiziellen Skript, tragen Sie die QCode-Endpunkte in opencode.json ein und starten Sie opencode serve in tmux. Ein QCode-Cloud-Server ist eine Maschine im Ausland, die separat verkauft wird und eine eigene öffentliche IPv4 hat; er ist ein eigenständiges Produkt neben dem AI-Service, und beide teilen nur Konto und Guthaben. Die QCode-Dokumentation nennt Hongkong, Japan, Korea, die USA und Deutschland, mit einer oder mehreren Linien pro Region.
Was die offiziellen Seiten sagen
Laut offizieller OpenCode-Server-Dokumentation (opencode.ai/docs/server, Teil der Dokumentation von OpenCode 1) ist opencode serve ein Headless-HTTP-Server; der Standardport ist 4096, die Standardadresse 127.0.0.1, änderbar mit --hostname und --port. Mit OPENCODE_SERVER_PASSWORD wird HTTP basic auth aktiviert; der Benutzername ist standardmäßig opencode. Die OpenCode-Seite der QCode-Dokumentation zeigt die QCode-Endpunkte in ~/.config/opencode/opencode.json.
Zeitleiste
Die OpenCode-Seite der QCode-Dokumentation wurde am 2026-10-20 geprüft und enthält jetzt einen Abschnitt zu OpenCode 2.
Das npm-Paket @opencode/cli von OpenCode 2 hat Version 2.1.0 veröffentlicht. opencode.ai/docs bleibt die Dokumentation von OpenCode 1; die Dokumentation von OpenCode 2 liegt unter opencode.ai/v2/docs.
Die QCode-Dokumentation zu Cloud-Servern und die Cloud-Seite wurden am 2026-10-20 geprüft: Die Größe lässt sich online upgraden, pro Server sind bis zu 3 Snapshots möglich, und auf der Bestellseite können Sie optional einen SSH-Public-Key angeben.
Bestätigt vs. nicht verifiziert
Bestätigt (wörtlich auf den offiziellen Seiten)
QCode-Cloud-Server: eine Maschine im Ausland, separat verkauft, KVM, voller root, 1 eigene öffentliche IPv4 pro Server (bei Bereitstellung zugewiesen, nicht änderbar), Hongkong, Japan, Korea, die USA und Deutschland, ein bezahlter Test von 1 Tag (24 Stunden), Umstellung auf 1, 3, 6 oder 12 Monate während des Tests, Online-Upgrade der Größe, bis zu 3 Snapshots pro Server. OpenCode: opencode serve ist ein Headless-HTTP-Server, standardmäßig 127.0.0.1:4096, OPENCODE_SERVER_PASSWORD aktiviert basic auth; das offizielle Installationsskript für OpenCode 1 ist curl -fsSL https://opencode.ai/install.
Nicht verifiziert und vom Hersteller nicht veröffentlicht
Auf GitHub berichtet ein Nutzer (#56668, am 2026-10-18 angelegt, gemeldete Version Desktop 2.0.32, am 2026-10-20 weiterhin open): In der Desktop-App kann die erste SSH-Verbindung zu einem neuen Remote-Server mehrere Minuten für das Herunter- oder Hochladen des entfernten OpenCode-Servers brauchen, während der Dialog nur Connecting over SSH… zeigt und die App eingefroren wirkt. Das ist ein Nutzerbericht, kein offizielles Ergebnis.
Zwei Betriebsarten
opencode serve
Ein Headless-HTTP-Dienst für andere Clients oder Skripte. Standardmäßig lauscht er nur auf 127.0.0.1; für den Fernzugriff ändern Sie die Adresse mit --hostname und schützen ihn mit OPENCODE_SERVER_PASSWORD.
Lokale TUI
Laut offizieller Server-Dokumentation startet opencode sowohl eine TUI als auch einen Server; die TUI ist der Client, der mit dem Server spricht. opencode serve startet einen eigenständigen Server.
Einrichtung in Schritten
① Bestellen Sie einen QCode-Cloud-Server: Region, Linie, Größe, System und Laufzeit wählen; für einen Test 1 Tag. Der Netzwerkschritt enthält immer 1 eigene öffentliche IPv4; im Schritt mit dem root-Passwort können Sie optional einen öffentlichen SSH-Schlüssel eintragen. ② Nach der Bereitstellung melden Sie sich mit ssh root@SERVER_IP an; das root-Passwort haben Sie bei der Bestellung gesetzt. ③ Installieren Sie OpenCode über die offizielle Installationsseite: curl -fsSL https://opencode.ai/install | bash. Die offizielle Seite stellt dieses Skript als Weg zur Installation von OpenCode 1 vor; laut QCode-Dokumentation funktioniert die provider-/options.baseURL-Konfiguration der OpenCode-Seite in OpenCode 1 und in OpenCode 2. OpenCode 2 hat einen anderen Installationsbefehl, und mit dem Standardbefehl lassen sich beide Versionen nicht nebeneinander installieren (siehe letzte FAQ-Frage). ④ Schreiben Sie die QCode-Endpunkte in ~/.config/opencode/opencode.json und speichern Sie den Schlüssel mit opencode auth login. ⑤ Lassen Sie den Prozess in tmux laufen: Legen Sie mit tmux new -s opencode eine Sitzung an, starten Sie darin OPENCODE_SERVER_PASSWORD=your-password opencode serve (lauscht standardmäßig nur auf 127.0.0.1:4096) und lösen Sie die Sitzung mit Ctrl+B, dann D; mit tmux attach -t opencode kehren Sie zurück.
OpenCode mit QCode verbinden
Die dokumentierte OpenCode-Einrichtung bei QCode: Die Konfigurationsdatei ist ~/.config/opencode/opencode.json; baseURL des Anthropic-Providers https://api.qcode.cc/claude/v1, des OpenAI-Providers https://api.qcode.cc/openai/v1. Der Schlüssel wird mit opencode auth login oder /connect geschrieben; OpenCode 1 speichert ihn in ~/.local/share/opencode/auth.json, OpenCode 2 in SQLite und importiert die alte auth.json. Aktivieren Sie zuerst die Berechtigung API direct access: Sie ist standardmäßig deaktiviert und wird über den Online-Support oder per E-Mail an hi@qcode.cc für Ihren gekauften API-Key freigeschaltet. Die Abrechnung erfolgt pro Token, die Preise je Modell stehen auf /models. Kein Monatsplan? «Nutzungspakete» gibt es ab $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 bis 90 Tagen aufbrauchen. Wenn Sie bereits einen Privatplan haben und mehr Kontingent brauchen, buchen Sie ein Booster-Paket dazu.
Häufig gestellte Fragen
Wie installiere ich OpenCode auf dem Cloud-Server?
Verwenden Sie das Skript der offiziellen OpenCode-Installationsseite: curl -fsSL https://opencode.ai/install | bash. Die offizielle Seite stellt es als Weg zur Installation von OpenCode 1 vor. OpenCode 2 hat einen anderen Installationsbefehl – siehe die letzte Frage.
Stoppt opencode serve beim Trennen der SSH-Verbindung?
Im Vordergrund endet der Prozess mit der Verbindung. Die QCode-Dokumentation beschreibt tmux (im Beispiel heißt die Sitzung agent, der Name ist frei wählbar; hier wird opencode verwendet): Mit tmux new -s opencode legen Sie eine Sitzung an, starten dort opencode serve und lösen die Sitzung mit Ctrl+B, dann D; mit tmux attach -t opencode kehren Sie zurück. tmux-Sitzungen überstehen einen unbeabsichtigten Abbruch oder das Abkoppeln.
Wie ruft OpenCode Modelle mit dem QCode-Schlüssel auf?
Folgen Sie der QCode-Dokumentation: Schreiben Sie in ~/.config/opencode/opencode.json https://api.qcode.cc/claude/v1 als baseURL des Anthropic-Providers und https://api.qcode.cc/openai/v1 als baseURL des OpenAI-Providers. Den Schlüssel schreiben Sie mit opencode auth login oder /connect; OpenCode 1 speichert ihn in ~/.local/share/opencode/auth.json, OpenCode 2 in SQLite und importiert die alte auth.json. Aktivieren Sie zuerst API direct access.
Muss ich zum Cloud-Server auch einen AI-Plan kaufen?
Nein. Laut QCode-Dokumentation werden Cloud-Server und AI-Services getrennt verkauft und teilen nur Konto und Guthaben; Claude Code oder Codex auf der Maschine zu betreiben bedeutet nicht, dass Sie einen AI-Plan kaufen müssen. Damit OpenCode QCode-Modelle aufruft, verwenden Sie Ihren QCode-Schlüssel; die Modelle werden pro Token abgerechnet, die Preise je Modell stehen auf /models.
Kann ich die Größe ändern oder die Linie wechseln?
Die Größe lässt sich online upgraden: Im Actions-Tab wählen Sie einen größeren Tarif und zahlen die Differenz bis zum Ablaufdatum; die Änderung wirkt sofort, der Server startet einmal neu, das Ablaufdatum bleibt gleich. Downgrades und ein Wechsel der Region oder Linie sind nicht möglich; für eine andere Linie bestellen Sie einen weiteren Server. Ein Testserver muss zuerst in einen Monatstarif umgewandelt werden.
Soll ich auf dem Server OpenCode 1 oder OpenCode 2 installieren?
Das hängt von der Dokumentation ab, der Sie folgen. opencode.ai/docs (einschließlich der Server-Seite) ist die Dokumentation von OpenCode 1, und das Skript curl -fsSL https://opencode.ai/install installiert OpenCode 1. Die Dokumentation von OpenCode 2 liegt unter opencode.ai/v2/docs, das Installationsskript lautet curl -fsSL https://opencode.ai/v2/install | bash. Beide verwenden den Befehl opencode und lassen sich mit dem Standardbefehl nicht nebeneinander installieren; das curl-Installationsskript von OpenCode 2 ersetzt die V1-Binärdatei. Das opencode.json-Beispiel für QCode steht auf der OpenCode-Seite der QCode-Dokumentation (geprüft am 2026-10-20); laut QCode-Dokumentation funktioniert die provider-/options.baseURL-Konfiguration dort in OpenCode 1 und in OpenCode 2.
Quellen
QCode-Dokumentation zu Cloud-Servern (abgerufen am 2026-10-20; Regionen, Test, Upgrades, Snapshots, SSH-Schlüssel); QCode-Cloud-Seite (abgerufen am 2026-10-20); QCode-Dokumentation zur Cloud-Abrechnung (abgerufen am 2026-10-20); QCode-Dokumentation zu Agenten auf dem Cloud-Server (abgerufen am 2026-10-20; tmux und Oberflächensprachen); offizielle OpenCode-Dokumentation zu Server und Installation (abgerufen am 2026-10-20); OpenCode-Seite und Seite «Nutzungspakete» von QCode (abgerufen am 2026-10-20).
OpenCode auf einer dauerhaft laufenden Maschine
Startpreise und Linien der Cloud-Server stehen auf qcode.cc/en/cloud; die Oberfläche der Cloud-Server ist derzeit nur auf Chinesisch und Englisch verfügbar.
Weiterführende Lektüre
Nutzungspakete für Claude Code: ohne Abo, 7–90 Tage gültig
Kontingent einmal kaufen und binnen 7–90 Tagen nutzen, ohne Abo; weitere Pakete landen auf demselben Key.
OpenCode: Session-Sharing entfällt (1.19.1), Upgrade auf 2
Was sich beim Session-Sharing und beim Wechsel auf OpenCode 2 geändert hat.
OpenCode 2026: über 200.000 Sterne, KI-Coding-Agent
Was OpenCode ist, Installation, Multi-Agent, BYOK und die Anbindung an QCode.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Die Cloud-Server-Angaben auf dieser Seite wurden am 2026-10-20 gegen qcode.cc/cloud und docs.qcode.cc geprüft; die OpenCode-Angaben am 2026-10-20 gegen die offizielle Installationsseite und die Server-Dokumentation; Modellverfügbarkeit und Preise folgen /models. Offizielle Änderungen werden nicht gesondert angekündigt.