# OpenCode-Integration

> **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

| Element | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (anthropic-Anbieter) · GPT ✅ · Chinesische Modelle ✅ (openai-Anbieter) · Gemini ✅ (google-Anbieter) |
| Protokoll & Base URL | Anthropic: `https://api.qcode.cc/claude/v1` · OpenAI: `https://api.qcode.cc/openai/v1` · Gemini: `https://api.qcode.cc/gemini/v1beta` (anbieterbezogene `options.baseURL`) |
| Konfiguration | `~/.config/opencode/opencode.json`; Schlüssel über `opencode auth login` in `auth.json` |
| Offizielle Dokumentation | [opencode.ai/docs](https://opencode.ai/docs) |

> ⚠️ **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](https://github.com/anomalyco/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](https://github.com/anomalyco/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](https://github.com/code-yeongyu/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**:

| Agentenname | Modell | Zweck |
|------------|-------|---------|
| **Sisyphus** | Claude Opus 4.8 | Hauptorchestrierer, plant und delegiert Tasks |
| **Oracle** | GPT 5.4 | Architekturdesign, Code-Review, Strategieanalyse |
| **Librarian** | Claude Sonnet 4.6 | Multi-Repo-Analyse, Doku-Suche, Implementierungsbeispiele |
| **Explore** | Grok Code | Schnelle Codebase-Erkundung und Musterabgleich |
| **Frontend UI/UX** | Gemini 2.5 Pro | Frontend-Entwicklung, besonders stark beim Erstellen ansprechender Oberflächen |
## Installation & Konfiguration

### Schritt 1: OpenCode installieren

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

**Offizielle Dokumentation**: [https://opencode.ai/docs](https://opencode.ai/docs)

Gängige Installationsmethoden:

```bash
# 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:

```bash
bunx oh-my-opencode install
```

**Offizielle Dokumentation**: [https://github.com/code-yeongyu/oh-my-opencode](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](https://qcode.cc/models)) und **verkauft kein grok**. China-Familien-IDs: [China-Familien-Modelle](/docs/usage/cn-models).

> **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](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)); 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.

```json
{
  "$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:

| Endpunkt | Anthropic (Claude) | OpenAI (Codex) | Anwendungsfall |
|----------|-------------------|----------------|----------|
| **Domain** (empfohlen) | `https://api.qcode.cc/claude/v1` | `https://api.qcode.cc/openai` | Globale Nutzer, wählt automatisch den optimalen Knoten aus |

> **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:

| Agent | Modell | Modus | Zweck |
|-------|-------|------|---------|
| **plan** | Claude Opus 5 | primary | Planung/Dekomposition/technisches Design (schreibgeschützt) |
| **build** | Claude Opus 5 | primary | Hauptentwicklung, End-to-End-Implementierung |
| **codex** | GPT-6-Sol | primary | Refactoring/Migration/große Änderungen |
| **review** | GPT-5.6 Terra | subagent | Code-Review (schreibgeschützt) |
| **explore** | Claude Haiku 4.5 | subagent | Schneller Codescan/Dateiortung (schreibgeschützt) |
| **general** | Claude Sonnet 5 | subagent | Allgemeine Recherche/Dokumentation (schreibgeschützt) |
| **think** | GPT-6-Luna | subagent | Denkunterstützung/Edge-Case-Analyse (schreibgeschützt) |

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:

```bash
# 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:

```text
ultrawork Help me refactor the authentication module of this project
```

### Hintergrundtasks

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

```text
@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](https://github.com/code-yeongyu/oh-my-opencode#configuration)

## Weiterführende Links

- [OpenCode offizielle Website](https://opencode.ai)

- [OpenCode GitHub](https://github.com/anomalyco/opencode)

- [oh-my-opencode GitHub](https://github.com/code-yeongyu/oh-my-opencode)

- [OpenCode offizielle Dokumentation](https://opencode.ai/docs)

## Nächste Schritte

- Sehen Sie sich die [VS Code Integration](/docs/ide/vscode) für die IDE-Nutzung an

- Erkunden Sie die [Codex Integration](/docs/ide/codex), um OpenAI Codex Modelle zu nutzen

- Lernen Sie [CLI Tipps](/docs/usage/cli-tips) kennen, um die Terminal-Effizienz zu verbessern