OpenCode

Stand: 27. August 2026

OpenCode ist ein offener Coding-Agent mit Terminal-, Desktop- und IDE-Oberflächen. Logicc kann darin als eigener Provider eingerichtet werden. Für GPT-Modelle empfehlen wir den Responses-Endpunkt. Claude- und Gemini-Routen über Chat Completions gelten als bedingt kompatibel.

Beta: OpenCode, Modellprovider und Gateway-Kompatibilität entwickeln sich unabhängig voneinander weiter. Testen Sie Tool Calling, Streaming und Reasoning mit der konkreten Modellroute, bevor Sie die Integration produktiv einsetzen.

Schnellstart

1. OpenCode installieren.
2. LOGICC_API_KEY als Umgebungsvariable setzen.
3. Die gemeinsame Konfiguration mit beiden Logicc Providern anlegen.
4. OpenCode starten und unter /models ein Modell auswählen.
5. Eine Testanfrage ausführen und anschließend die Quota prüfen.

Voraussetzungen

• Aktiver Logicc API-Key
• Mindestens ein freigeschaltetes Modell
• Aktuelle OpenCode-Version
• Terminal unter macOS, Linux, Windows oder WSL

1. OpenCode installieren

macOS, Linux oder WSL:

curl -fsSL https://opencode.ai/install | bash

Alternativ mit npm:

npm install -g opencode-ai

opencode --version

2. API-Key setzen

macOS, Linux oder WSL:

export LOGICC_API_KEY="DEIN_LOGICC_API_SCHLUESSEL"

Windows PowerShell:

$env:LOGICC_API_KEY = "DEIN_LOGICC_API_SCHLUESSEL"

Der Key wird in der Konfiguration ausschließlich über die Umgebungsvariable referenziert. Speichern Sie ihn nicht direkt in opencode.json oder Git.

3. Freigeschaltete Modelle prüfen

curl "https://api.logicc.cloud/v1/models" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

4. Logicc Provider konfigurieren

Erstellen Sie im Projektordner eine Datei opencode.json. Das folgende Beispiel enthält beide unterstützten Zugangswege in einer gemeinsamen Konfiguration. Es muss nicht mit einem zweiten Beispiel überschrieben werden.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "logicc-responses/gpt-5.6-terra",
  "provider": {
    "logicc-responses": {
      "npm": "@ai-sdk/openai",
      "name": "Logicc API, Responses",
      "options": {
        "baseURL": "https://api.logicc.cloud/v1",
        "apiKey": "{env:LOGICC_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra über Logicc"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna über Logicc"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol über Logicc"
        }
      }
    },
    "logicc-compatible": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Logicc API, Chat Completions",
      "options": {
        "baseURL": "https://api.logicc.cloud/v1",
        "apiKey": "{env:LOGICC_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5 über Logicc"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro über Logicc"
        }
      }
    }
  }
}

@ai-sdk/openai verwendet /v1/responses und ist für GPT-Modelle mit Tool-Aufrufen und Reasoning zu bevorzugen. @ai-sdk/openai-compatible verwendet /v1/chat/completions und dient für weitere kompatible Modellrouten.

Entfernen Sie Modelle, die für Ihren API-Key nicht freigeschaltet sind. Weitere freigeschaltete IDs können nach demselben Muster unter models ergänzt werden.

5. Konfiguration prüfen und starten

macOS, Linux oder WSL:

jq empty opencode.json
opencode

Unter Windows kann die JSON-Datei beispielsweise mit PowerShell geprüft werden:

Get-Content .\opencode.json -Raw | ConvertFrom-Json | Out-Null
opencode

Modellauswahl öffnen:

/models

Eine Übersicht gespeicherter Zugangsdaten zeigt:

opencode auth list

Dieser Befehl ist keine vollständige Verbindungskontrolle. Eine Verbindung ist erst nach einer erfolgreichen Modellanfrage bestätigt.

Modellkompatibilität

Responses, empfohlen

Chat Completions, bedingt kompatibel

Für Claude ist ein nativer Anthropic-Client wie Claude Code in der Regel kompatibler. Bei GPT-5.6 können Function Tools zusammen mit reasoning_effort über Chat Completions abgelehnt werden. Verwenden Sie dann den Responses-Provider oder setzen Sie den Reasoning-Aufwand auf none.

Nicht als Coding-Chatmodelle geeignet

• gpt-4o-transcribe und gpt-4o-mini-transcribe
• text-embedding-3-small, text-embedding-3-large und gemini-embedding-001
• gemini-3.1-flash-image und gemini-2.5-flash-image

Desktop und IDE

Die gleiche opencode.json kann von unterstützten OpenCode-Oberflächen verwendet werden. Eine im Terminal gesetzte Umgebungsvariable ist nicht automatisch für einen separat gestarteten Desktop- oder IDE-Prozess verfügbar. Stellen Sie sicher, dass LOGICC_API_KEY über die Secret-Verwaltung der jeweiligen Umgebung an den Prozess weitergegeben wird.

Für die erste Einrichtung und Fehleranalyse empfehlen wir die Terminal-Oberfläche.

Kosten und Quota

OpenCode kann automatisch viele Modellanfragen und Tool-Schritte ausführen. Verbrauch und Kosten hängen stark von Modell, Kontextlänge und Anzahl der Arbeitsschritte ab.

curl "https://api.logicc.cloud/api/governance/virtual-keys/quota" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Budget, Verbrauch und Restbudget werden in Euro geführt.

Datenschutz

OpenCode arbeitet lokal mit freigegebenen Dateien und Terminal-Werkzeugen. Die Modellverarbeitung findet nicht lokal statt. Prompts und relevante Datei- oder Codeausschnitte werden über die Logicc API an den eingerichteten Modellprovider übertragen. Plugins, MCP-Server und Webfunktionen können weitere Datenflüsse erzeugen.

Fehlerbehebung

Support

Bei Fragen schreiben Sie an [email protected] mit dem Betreff API. Teilen Sie OpenCode-Version, Betriebssystem, Provider, Modell-ID, HTTP-Status, Zeitpunkt und Fehlertext ohne API-Key mit.

Weiterführende Dokumentation:

• Logicc Help Center: https://help.logicc.com/docs
• OpenCode Installation: https://opencode.ai/docs
• OpenCode Provider: https://opencode.ai/docs/providers