OpenCode-Integration

Nutzung des quelloffenen KI-Coding-Assistenten OpenCode im Terminal mit der QCode-API

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

Zuletzt überprüft: 2026-10-15 · 📄 Gemäß offizieller Dokumentation (OpenCode v1.19.0, veröffentlicht am 2026-10-11 (Repository jetzt anomalyco/opencode))

Auf einen Blick¶

⚠️ Wichtig: Berechtigung für direkten API-Zugriff erforderlich

Für die Nutzung von OpenCode muss die Berechtigung für den direkten API-Zugriff aktiviert werden. Da direkte API-Aufrufe nicht über den Session-Mechanismus von Claude Code verfügen, ist der Token-Verbrauch höher, weshalb diese Berechtigung standardmäßig deaktiviert ist.

Um sie zu aktivieren, wenden Sie sich bitte an unseren Online-Support oder schreiben Sie an hi@qcode.cc, und wir schalten diese Berechtigung für Ihren gekauften API-Key frei.

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)

Projektstatistik (Stand 2026-10-15):

• GitHub Stars: 213k+ (Stand 2026-10-15)

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

• Version: v1.19.0 (veröffentlicht am 2026-10-11)

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.

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

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.

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

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 →