OpenCode 2.1.4: QCode einrichten 2026

OpenCode 2.1.4 (23.10.2026): QCode.cc in opencode.json über baseURL für anthropic und openai, Key per /connect speichern.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-10-26 · 📄 Gemäß offizieller Dokumentation (OpenCode 2 v2.1.4, veröffentlicht am 2026-10-23; neueste Version von OpenCode 1: v1.19.4, veröffentlicht am 2026-10-22 (Repository jetzt anomalyco/opencode); bei der Prüfung am 2026-10-20 waren es v2.1.0 und v1.19.3)

Auf einen Blick¶

OpenCode ist ein 100 % quelloffener KI-Coding-Assistent im Terminal, ähnlich wie Claude Code, aber mit mehr Flexibilität und Anpassungsoptionen. Er unterstützt Multimodell-Wechsel, LSP-Integration und eine TUI-Oberfläche und ist an keinen bestimmten KI-Anbieter gebunden.

Projektvorstellung¶

OpenCode¶

OpenCode ist ein vom SST-Team entwickelter quelloffener KI-Coding-Agent. Die wichtigsten Funktionen sind:

• 100 % quelloffen - MIT-Lizenz, vollständig transparent

• Multimodell-Unterstützung - gleichzeitige Nutzung von Claude, OpenAI und weiteren

• Native LSP-Unterstützung - integrierter Language Server Protocol für intelligente Code-Analyse

• TUI First - für Terminal-Nutzer entwickelt, von Neovim-Enthusiasten gebaut

• Client/Server-Architektur - Server lokal ausführen und remote von Mobilgeräten steuern

• Zwei integrierte Agenten - build (Standard, voller Zugriff) und plan (schreibgeschützt, für Analyse und Planung)

OpenCode 2 (2026-10-20): OpenCode 2 akzeptiert und bewahrt die lsp-Konfiguration, führt aber keine Language-Server aus, stellt keine LSP-Tools bereit und erzeugt keine LSP-Diagnosen (offizielle Dokumentation).

Projektstatistik (Stand 2026-10-20):

• GitHub Stars: 218,397 (Stand 2026-10-20; 213k+ am 2026-10-15)

• Repository: anomalyco/opencode (ehemals sst/opencode; alte URL leitet weiter)

• Version: OpenCode 2 v2.1.4 (2026-10-23); neueste Version von OpenCode 1: v1.19.4 (2026-10-22). Die zuvor genannten v2.1.0 (2026-10-20), v1.19.3 (2026-10-16) und v1.19.0 (2026-10-11) sind jetzt historische Releases.

oh-my-opencode¶

oh-my-opencode ist ein von Dritten entwickeltes Erweiterungs-Plugin für OpenCode, in der Community oft „OpenCode auf Steroiden“ genannt. Wichtig: Stand 2026-10-15 wurde das Repository in code-yeongyu/oh-my-openagent umbenannt, die README nennt das Projekt jetzt OmO, und der Haupteinstieg ist ein eigenständiger Befehl omo. Die frühere OpenCode-Variante heißt in der README „OpenCode edition“; mit omo setup lässt sich von ihr migrieren (siehe die Anleitung Migrating from OpenCode). Das Schlüsselwort ultrawork wird in der README weiterhin beschrieben.

Weil sich die Form geändert hat, führt diese Seite die alte Tabelle der eingebauten Agentenrollen und den alten Installationsbefehl bunx oh-my-opencode install nicht mehr auf. Richten Sie sich bei Bedarf nach der offiziellen README: code-yeongyu/oh-my-openagent. Die OpenCode-Konfiguration unten hängt nicht davon ab.

Stand 2026-10-20 bezeichnet die README das Projekt als OmO 5.0 und nennt als Installationsbefehl curl -fsSL https://get.omo.dev/install.sh | bash; außerdem heißt es dort, dass OmO auf senpi läuft, dem Fork von pi aus diesem Projekt.

Installation & Konfiguration¶

Schritt 1: OpenCode installieren¶

OpenCode durchläuft schnell aufeinanderfolgende Iterationen, bitte beachten Sie die offizielle Installationsanleitung:

Offizielle Dokumentation: https://opencode.ai/docs

Gängige Installationsmethoden:

# Install with curl (recommended)
curl -fsSL https://opencode.ai/install | bash

# Using package managers
npm install -g opencode-ai  # or bun/pnpm/yarn

# macOS Homebrew
brew install anomalyco/tap/opencode

Stand 2026-10-20 installiert dieses Skript nur OpenCode 1. OpenCode 2 verwendet eigene Installationsbefehle; siehe OpenCode 2 unten.

Schritt 2: oh-my-opencode (optional)¶

oh-my-opencode ist nicht erforderlich. Wenn Sie es nutzen möchten, installieren Sie es anhand der oben verlinkten offiziellen README; die OpenCode-Konfiguration unten hängt nicht davon ab.

Schritt 3: QCode API konfigurieren¶

Dies ist der entscheidende Schritt! Erstellen oder bearbeiten Sie die Konfigurationsdatei ~/.config/opencode/opencode.json:

Zur Modellauswahl: Die Konfiguration unten verwendet die Claude-5.5-Reihe und GPT-Modelle von QCode. Tägliche Standards sind claude-sonnet-5-5 / claude-opus-5-5, für leichte Aufgaben claude-haiku-5-5; bei GPT gpt-6.1-sol / gpt-6-sol / gpt-5.6-terra. Welche Modelle Sie aufrufen können, steht auf qcode.cc/models. QCode bietet derzeit weder Gemini noch Grok an, daher enthält die Konfiguration nur die Provider anthropic und openai. IDs der chinesischen Modelle: Chinesische Modelle.

Zur baseURL: Das Beispiel für die Anthropic-baseURL in der OpenCode-Dokumentation reicht bis /v1 (https://api.anthropic.com/v1), also gilt das auch hier: https://api.qcode.cc/claude/v1 für Anthropic und https://api.qcode.cc/openai/v1 für OpenAI – passend zu den Pfaden unter Endpunkte & API-Pfade.

Zu den chinesischen Modellen: Der eingebaute openai-Anbieter von OpenCode (@ai-sdk/openai) nutzt die Responses-Schnittstelle, und die Responses-Schnittstelle von QCode bedient keine chinesischen Modelle. Legen Sie dafür einen separaten Anbieter @ai-sdk/openai-compatible an (chat/completions, baseURL https://api.qcode.cc/openai/v1); die Modell-IDs stehen unter Chinesische Modelle. Die OpenCode-Dokumentation zu Anbietern sagt: @ai-sdk/openai für /v1/responses, @ai-sdk/openai-compatible für /v1/chat/completions.

{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.qcode.cc/claude/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.qcode.cc/openai/v1"
      }
    }
  },

  "model": "anthropic/claude-opus-5-5",
  "small_model": "anthropic/claude-haiku-5-5",
  "default_agent": "build",

  "permission": {
    "read": "allow",
    "list": "allow",
    "glob": "allow",
    "grep": "allow",
    "lsp": "allow",

    "edit": "ask",
    "bash": "ask",
    "webfetch": "ask",
    "websearch": "ask",

    "external_directory": "deny",
    "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Planning/decomposition/technical design (read-only, avoid accidental code changes)",
      "model": "anthropic/claude-opus-5-5",
      "prompt": "You are a senior technical lead. Goal: break down requirements into executable steps (with acceptance criteria/risks/rollback). Read-only by default, do not modify files or run commands; if execution is truly needed, explain the reason and suggest switching to build/codex.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "build": {
      "mode": "primary",
      "description": "Main development (end-to-end implementation/debugging/fixing tests) - Claude Opus 5.5",
      "model": "anthropic/claude-opus-5-5",
      "prompt": "You are the main software engineering agent. Priorities: minimal viable changes, readability, testability. Before making changes, briefly explain the approach; after changes, always provide: key diff points, how to verify locally (commands), potential edge cases.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "codex": {
      "mode": "primary",
      "description": "Refactoring/migration/major changes (Codex) - GPT-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "prompt": "You are a Codex-style engineering agent, skilled in large-scale refactoring, migration, code review, and complex toolchain collaboration. Priority: keep the project runnable: step-by-step commits, each step verifiable; when uncertain, add safeguards and tests first.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "review": {
      "mode": "subagent",
      "description": "Code review/second brain (read-only) - GPT-5.6 Terra",
      "model": "openai/gpt-5.6-terra",
      "prompt": "You are a strict code reviewer. Output: 1) Key risks (bugs/security/concurrency/edge cases) 2) Maintainability suggestions 3) Minimal modification suggestions (can use pseudo diff) 4) Necessary test points. Read-only by default, do not modify files/run commands.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "explore": {
      "mode": "subagent",
      "description": "Quick code scan/file location/context summary (read-only) - Claude Haiku 5.5",
      "model": "anthropic/claude-haiku-5-5",
      "prompt": "You are a quick exploration subagent: locate relevant files/functions/call chains with minimal steps, provide clear paths and summaries. Read-only by default, do not modify files/run commands.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "general": {
      "mode": "subagent",
      "description": "General research/documentation/comparing approaches (medium cost) - Claude Sonnet 5.5",
      "model": "anthropic/claude-sonnet-5-5",
      "prompt": "You are a general analysis subagent: focus on explanation, trade-offs, documentation, and approach comparison; read-only by default, try not to modify code.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "think": {
      "mode": "subagent",
      "description": "Assist thinking/edge case reasoning (read-only) - GPT-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "prompt": "You are a reasoning and edge case analysis subagent: provide structured analysis and suggestions for design, exception paths, concurrency/consistency, performance bottlenecks. Read-only by default.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    }
  }
}

Auswahl der API-Endpunkte¶

Je nach Ihrer Netzwerksituation können Sie den baseURL in der provider-Konfiguration ändern:

Für Nutzer in Festland-China: Verwenden Sie asia.qcode.cc (den Zugangspunkt für Asien) und ändern Sie baseURL auf die beiden Adressen der Zeile „Asien“ in der Tabelle oben.

Verfügbare Modelle¶

QCode unterstützt derzeit diese beliebten Modelle (vollständige Liste und Preise auf qcode.cc/models):

Claude-Serie (Pfad: /claude/v1):

• claude-opus-5-5 – aktuelles Haupt-Flaggschiff (claude-opus-5 und claude-opus-4-8 sind weiterhin aufrufbar)

• claude-sonnet-5-5 – täglicher Standard (claude-sonnet-5 und claude-sonnet-4-6 sind weiterhin aufrufbar)

• claude-haiku-5-5 – Haiku 5.5, ultraschnelle Antwort

OpenAI-/Codex-Serie (Pfad: /openai/v1):

• gpt-6.1-sol – Haupt-Flaggschiff, 1,05 Mio. Kontext (empfohlen)

• gpt-6-sol – GPT-6 Sol, 1,05 Mio. Kontext

• gpt-5.6-terra – Programmierung / Codex CLI

• gpt-5.6-sol – Geschwistermodell der 5.6-Reihe

QCode bietet derzeit weder die Gemini-Serie noch gpt-6-luna / gpt-5.6-luna an.

Konfigurationsübersicht¶

Die obige Konfiguration umfasst einen vollständigen Multi-Agent-Workflow:

Sie können die Einstellungen model, prompt und permission jedes Agents nach Ihren Vorlieben anpassen.

Schritt 4: API-Key konfigurieren¶

Nach dem Öffnen von OpenCode verwenden Sie den Befehl /connect, um Ihren API-Key zu konfigurieren:

Anthropic (Claude) konfigurieren¶

1. Geben Sie /connect in OpenCode ein

2. Wählen Sie Anthropic

3. Wählen Sie Manually enter API Key

4. Geben Sie den API-Key ein, den Sie bei QCode erworben haben

5. Drücken Sie Enter, um zu speichern

OpenAI (Codex) konfigurieren¶

1. Geben Sie /connect ein

2. Wählen Sie OpenAI

3. Wählen Sie Manually enter API Key

4. Geben Sie den API-Key ein, den Sie bei QCode erworben haben

5. Drücken Sie Enter, um zu speichern

Speichern und Neustart¶

Nach der Konfiguration:

1. Geben Sie /exit ein, um OpenCode zu beenden

2. Öffnen Sie OpenCode erneut

Ihre API-Keys werden in ~/.local/share/opencode/auth.json gespeichert und können für zukünftige Anpassungen direkt bearbeitet werden.

In OpenCode 2 werden gespeicherte API-Keys und OAuth-Token in der SQLite-Datenbank des Servers gespeichert. Bei der Datenbankmigration importiert V2 unterstützte Anmeldedaten aus der alten auth.json (offizielle Dokumentation, 2026-10-20).

Konfiguration überprüfen¶

Nach dem erneuten Öffnen von OpenCode können Sie Ihre Konfiguration testen, indem Sie Folgendes ausführen:

# Start OpenCode
opencode

# Test in OpenCode
> Hello, please introduce yourself

Wenn die Konversation normal funktioniert, war Ihre Konfiguration erfolgreich!

Tipps zur Nutzung¶

ultrawork-Modus¶

In der älteren Version oh-my-opencode (OpenCode edition) aktivieren Sie mit ultrawork oder ulw im Prompt die parallele Multi-Modell-Orchestrierung; das neuere OmO ist ein eigenständiger Befehl omo, folgen Sie dessen README. Beispiel für die ältere Version:

ultrawork Help me refactor the authentication module of this project

Mit Tab zwischen Agenten wechseln¶

Drücken Sie Tab, um zwischen den Agenten build und plan zu wechseln:

• build – Vollzugriff, für Entwicklungsarbeit

• plan – Nur-Lese-Modus, für Analyse und Planung

In OpenCode 2 ist die Standardtaste zum Wechseln der Agenten Shift+Tab (offizielle Dokumentation, 2026-10-20).

OpenCode 2¶

OpenCode 2 ist eine eigene Hauptversion desselben Projekts. Der Standard-Installer installiert weiterhin nur OpenCode 1; beide Versionen verwenden den Befehl opencode und können daher unter diesem Standardbefehl nicht nebeneinander installiert werden (offizieller Installer und Migrationsleitfaden, 2026-10-20).

OpenCode 2 installieren¶

Die V2-Dokumentation nennt diese Installationsbefehle:

# OpenCode 2
curl -fsSL https://opencode.ai/v2/install | bash
npm install -g @opencode/cli
brew install anomalyco/tap/opencode-v2
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn global add @opencode/cli

Entfernen Sie vor der Installation von V2 die über den Paketmanager installierte V1-Version; der curl-Installer von V2 ersetzt die V1-Binärdatei. Um eine vorhandene OpenCode-1-Installation zu aktualisieren, führen Sie opencode upgrade --major aus (offizielle Dokumentation, 2026-10-20).

Die Konfiguration funktioniert in beiden Versionen¶

OpenCode 2 liest System-, globale und Projektkonfiguration von denselben Orten wie V1, darunter ~/.config/opencode/opencode.json(c). Die vorhandene unterstützte V1-Konfiguration soll weiterhin funktionieren; das V1-Konfigurationsformat bleibt unterstützt, das native V2-Format ist optional. OpenCode 2 normalisiert unterstützte V1- und native V2-Felder im Arbeitsspeicher, ohne die Quelldatei umzuschreiben. Der Migrationsleitfaden rät davon ab, V1 auf Dateien zeigen zu lassen, nachdem sie in eine nur für natives V2 bestimmte Form umgewandelt wurden.

Die obige Konfiguration mit provider / options.baseURL funktioniert daher sowohl in OpenCode 1 als auch in OpenCode 2. Wenn Sie nur OpenCode 2 verwenden und das native V2-Format bevorzugen, sehen dieselben Endpunkte so aus:

{
  "providers": {
    "anthropic": { "settings": { "baseURL": "https://api.qcode.cc/claude/v1" } },
    "openai": { "settings": { "baseURL": "https://api.qcode.cc/openai/v1" } }
  }
}

Diese native Form ist nur für OpenCode 2 bestimmt.

Verhaltensunterschiede, die die obige Konfiguration betreffen¶

• Verzeichnisse außerhalb des Projekts: V1 fragt vor dem Zugriff auf Pfade außerhalb des Projekts nach; V2 erlaubt external_directory standardmäßig. Der Migrationsleitfaden sagt nicht, wie V2 die obigen external_directory-Regeln im V1-Format behandelt (hier stehen sie auf deny); prüfen Sie die Wirkung in V2 daher selbst. Um in nativem V2 das V1-Verhalten beizubehalten, ergänzt der Leitfaden eine external_directory-Regel mit der Wirkung ask.
• Berechtigungsaktionen: lsp und doom_loop sind keine aktuellen Berechtigungsaktionen von V2 Core.
• Language-Server: OpenCode 2 akzeptiert und bewahrt die lsp-Konfiguration, führt aber keine Language-Server aus, stellt keine LSP-Tools bereit und erzeugt keine LSP-Diagnosen.
• Anmeldedaten: Gespeicherte API-Keys und OAuth-Token liegen in der SQLite-Datenbank des Servers. Bei der Datenbankmigration importiert V2 unterstützte Anmeldedaten aus der alten auth.json; neue und aktualisierte Anmeldedaten werden in SQLite gespeichert und nicht in diese Datei zurückgeschrieben.
• Agentenwechsel: Die Standardtaste für agent.cycle ist Shift+Tab.
• Plugins: V1-Plugin-Implementierungen laufen nicht in V2; Plugins verwenden eine neue Plugin-API.

Die Hinweise auf qcode.cc zum Upgrade auf OpenCode 2, einschließlich der Abschaffung des Session-Sharings in 1.19.1, finden Sie unter Upgrade auf OpenCode 2 und Abschaffung des Session-Sharings.

Änderungen in 2.1.3–2.1.4 und 1.19.4 (2026-10-26)¶

OpenCode 2.1.4 wurde am 2026-10-23 veröffentlicht, 2.1.3 am 2026-10-22 und die neueste Version der 1.x-Linie, 1.19.4, am 2026-10-22. Die Punkte, die die obige Konfiguration betreffen:

• 2.1.3 — baseURL-Einstellungen benutzerdefinierter Anbieter überschreiben jetzt die Modell-Endpunkte aus dem Katalog wie erwartet.
• 2.1.3 — die mitgelieferte Bun-Runtime wurde auf 1.4.4 aktualisiert: Sicherheitskorrekturen für Brotli, TLS, HTTP/1.1, HTTP/2, HTTP/3, WebSocket und fetch sowie aktualisierte Stammzertifikate auf NSS 3.131.1.
• 2.1.4 — wenn ein MCP-Server während eines Tool-Aufrufs eine Eingabe anfordert, erscheint jetzt das Formular, statt dass der Aufruf bis zum Timeout wartet; die experimentelle Hintergrundkomprimierung wird über experimental.background_compaction aktiviert.
• 1.19.4 — die 1.x-Linie erhielt dieselben Sicherheitskorrekturen aus Bun 1.4.4.

Die obigen V2-Installationsbefehle sind in der am 2026-10-26 geprüften Dokumentation unverändert.

Fehlerbehebung¶

API-Verbindung fehlgeschlagen¶

1. Prüfen Sie, ob die API-Endpunkt-Konfiguration korrekt ist

2. Stellen Sie sicher, dass der API-Key korrekt gespeichert wurde

3. Versuchen Sie, einen anderen API-Endpunkt zu verwenden (z. B. asia.qcode.cc oder us.qcode.cc)

4. Prüfen Sie, ob Ihr Netzwerk einen Proxy erfordert

Modell nicht verfügbar¶

Stellen Sie sicher, dass die Modelldefinition korrekt in opencode.json konfiguriert ist und die Modell-ID mit den von QCode unterstützten Modellnamen übereinstimmt.

Konfigurationsprobleme mit oh-my-opencode¶

Siehe offizielle Dokumentation: https://github.com/code-yeongyu/oh-my-openagent#configuration

Weiterführende Links¶

• OpenCode offizielle Website

• OpenCode GitHub

• oh-my-opencode GitHub

• OpenCode offizielle Dokumentation

Nächste Schritte¶

• Sehen Sie sich die VS Code Integration für die IDE-Nutzung an

• Erkunden Sie die Codex Integration, um OpenAI Codex Modelle zu nutzen

• Lernen Sie CLI Tipps kennen, um die Terminal-Effizienz zu verbessern

Enterprise →