OpenCode-Integration

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

Zuletzt überprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (OpenCode v1.18.31, veröffentlicht am 2026-09-14 (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, Google Gemini 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 Januar 2026):

• GitHub Stars: 208k+ (Stand 2026-09)

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

• Version: v1.18.31 (veröffentlicht am 2026-09-14)

oh-my-opencode¶

oh-my-opencode ist ein Erweiterungs-Plugin für OpenCode, oft als „OpenCode auf Steroiden“ bezeichnet, das ein KI-Coding-Erlebnis in Profiqualität bietet:

Kernfunktionen:

• Asynchrone Subagenten - Fähigkeit zur parallelen Task-Verarbeitung ähnlich wie Claude Code

• Kuratierte Agenten-Konfigurationen - vorkonfigurierte professionelle Agentenrollen (Oracle, Librarian, Explore usw.)

• LSP/AST-Tools - intelligentes Refactoring, Code-Analyse, Symbol-Suche und mehr

• Claude Code-Kompatibilitätsschicht - unterstützt Hooks-, Befehls- und Skills-Konfigurationen von Claude Code

• Sisyphus-Hauptagent - leistungsstarker Orchestrierungs-Agent auf Basis von Claude Opus 4.8 mit Hintergrund-Parallel-Tasks

• ultrawork-Modus - fügen Sie einfach ultrawork zu Ihrem Prompt hinzu, um den leistungsstärksten parallelen Orchestrierungsmodus zu aktivieren

Integrierte Agentenrollen:

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 installieren (empfohlen)¶

oh-my-opencode bietet professionelle Out-of-the-box-Konfigurationen, dringend empfohlen:

bunx oh-my-opencode install

Offizielle Dokumentation: https://github.com/code-yeongyu/oh-my-opencode

Tipp: Während der Installation werden Sie gefragt, welche KI-Abos Sie besitzen (Claude, ChatGPT, Gemini). Wählen Sie anhand Ihrer tatsächlichen Abos.

Schritt 3: QCode API konfigurieren¶

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

Zur Modellauswahl: Die untenstehende Konfiguration verwendet QCodes Claude-5-Linie und GPT-Codex-Modelle. Tägliche Standardmodelle sind claude-sonnet-5 / claude-opus-5; 4.x ist weiterhin im Angebot. QCode verkauft Gemini (siehe qcode.cc/models) und verkauft kein grok. China-Familien-IDs: China-Familien-Modelle.

Zum Google-Provider-Block: Der google-Provider-Block in der Konfiguration dient der Verbindung mit Gemini (z. B. gemini-2.5-pro, gemini-3.5-flash). Hinweis: Die offiziellen Gemini CLI Pro-/Free-Tiers erreichten am 2026-06-18 ihr Ende der Lebensdauer (Google-Ankündigung); der Nachfolger ist Google Antigravity CLI. Kostenpflichtige Enterprise-Keys sind nicht betroffen. Falls Sie eine Google-Modell-Toolchain benötigen, empfehlen wir den Wechsel zur Antigravity CLI.

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

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

  "model": "anthropic/claude-opus-5",
  "small_model": "anthropic/claude-haiku-4-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",
      "temperature": 0.1,
      "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",
      "model": "anthropic/claude-opus-5",
      "temperature": 0.2,
      "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-Sol",
      "model": "openai/gpt-6-sol",
      "temperature": 0.2,
      "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",
      "temperature": 0.1,
      "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 4.5",
      "model": "anthropic/claude-haiku-4-5",
      "temperature": 0.1,
      "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",
      "model": "anthropic/claude-sonnet-5",
      "temperature": 0.2,
      "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-Luna",
      "model": "openai/gpt-6-luna",
      "temperature": 0.2,
      "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: Für die beste Leistung ändern Sie baseURL auf https://api.qcode.cc/claude/v1 und https://api.qcode.cc/openai.

Verfügbare Modelle¶

QCode unterstützt derzeit diese beliebten Modelle:

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

• claude-opus-5 – aktuelles Flaggschiff (claude-opus-4-8 weiterhin im Angebot)

• claude-sonnet-5 – täglicher Standard (claude-sonnet-4-6 weiterhin im Angebot)

• claude-haiku-4-5 – Haiku 4.5, ultraschnelle Antwort

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

• gpt-6-sol – Flaggschiff, 1.05M Kontext (empfohlen)

• gpt-6-luna – Schnell, kostengünstig

• gpt-5.6-terra – Programmierung / Codex CLI

• gpt-5.6-sol – 5.6-Geschwistermodell

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¶

Wenn Sie oh-my-opencode installiert haben, fügen Sie einfach ultrawork oder ulw zu Ihrer Eingabeaufforderung hinzu, um den leistungsstärksten parallelen Multi-Modell-Orchestrierungsmodus zu aktivieren:

ultrawork Help me refactor the authentication module of this project

Hintergrundtasks¶

Verwenden Sie die @-Syntax, um spezialisierte Agenten für bestimmte Aufgaben aufzurufen:

@oracle Review the architecture design of this code
@librarian Find similar open-source implementations
@explore Search for all API endpoints in the 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 / us als Fallback)

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-opencode#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