---
title: "opencode eigener OpenAI-kompatibler Provider | BroadRouter"
description: "BroadNet Inference im Coding-Agent opencode als eigenen OpenAI-kompatiblen Provider in opencode.jsonc einrichten, mit Modell-Aliasen, Capabilities und Limits."
url: https://broadrouter.com/de/guides/opencode-custom-provider/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/opencode-custom-provider/) (aktualisiert am 2026-11-16).

# BroadNet Inference als eigenen Provider in opencode einrichten

Aktualisiert 2026-11-16

Legen Sie in opencode.jsonc unter providers einen Eintrag broadnet an, mit package @opencode/ai/providers/openai-compatible, settings.baseURL = https://inference.broadnet.ai/v1 und env = BROADNET\_API\_KEY. Ordnen Sie kurze Modell-Keys per modelID BroadNet-IDs wie broadnet/glm-5.3 zu und wählen Sie das Modell mit /models. Ältere V1-Konfigurationen mit npm @ai-sdk/openai-compatible und options.baseURL funktionieren weiterhin.

opencode ist ein Open-Source-Coding-Agent für das Terminal. Provider, die nicht in seinem eingebauten Katalog stehen, werden als **eigene Provider** (custom providers) in `opencode.jsonc` hinzugefügt. BroadNet Inference spricht das Chat-Completions-Format von OpenAI und nutzt daher das OpenAI-kompatible Runtime-Paket von opencode. Diese Anleitung folgt der aktuellen Dokumentation von opencode (V2).

## Einrichtung

1.  **Exportieren Sie Ihren Schlüssel** in der Shell, aus der Sie opencode starten:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Konfiguration anlegen.** Legen Sie sie als `opencode.jsonc` in Ihr Projekt oder nach `~/.config/opencode/opencode.jsonc`, um sie überall zu nutzen.

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
```

3.  **opencode starten und das Modell wählen** mit `/models`. Die Referenz lautet `broadnet/<map key>`, zum Beispiel `broadnet/glm-5.3`. opencode sendet den Wert von `modelID` an BroadNet.

Konfigurationsdateien werden zusammengeführt. opencode wendet zuerst die globale Datei an, dann Projektdateien, die es vom aktuellen Verzeichnis aufwärts findet (die entfernteste zuerst), dann eine eventuelle `.opencode/`\-Konfiguration. Eine Projektdatei kann also den globalen Provider überschreiben. Eine verwaltete Systemkonfiguration, falls Ihr Unternehmen eine nutzt, hat Vorrang vor beiden. Halten Sie den Schlüssel in der Umgebung, nicht in der Datei, damit die Konfiguration in die Versionsverwaltung darf.

## Warum Aliase

BroadNet-IDs enthalten bereits einen Schrägstrich (`broadnet/glm-5.3`). Der Key in der Map `models` ist das, was opencode anzeigt und auswählt, und `modelID` ist das, was es sendet. Kurze Keys halten die Referenzen lesbar.

Setzen Sie `capabilities` und `limit` selbst. Für ein Modell außerhalb seines Katalogs nimmt opencode JSON-Tool-Unterstützung, Text- und Bildeingabe, 200.000 Token Kontext und 32.000 Ausgabe-Token an. Seine Dokumentation nennt das Fallback-Annahmen, keine erkannten Werte. Der `output`\-Wert 16000 oben ist unser Vorschlag, kein Limit von BroadNet; er lässt Raum für Reasoning.

### Ältere V1-Konfigurationen

opencode V2 liest das V1-Format weiterhin, ein bestehender Block wie dieser funktioniert also weiter:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}
```

In der nativen V2-Form wird `provider` zu `providers`, `npm` zu `package` (`aisdk:@ai-sdk/openai-compatible`, wenn Sie das AI-SDK-Paket behalten wollen), und `options.baseURL` und `options.apiKey` wandern unter `settings`. Die [Migrationsanleitung von opencode für V1](https://opencode.ai/docs/migrate-v1/) ordnet jedes Feld zu.

## Welches Modell passt

| Aufgabe | Modell | Hinweise |
| --- | --- | --- |
| Agentisches Coding mit Tools | [GLM 5.3](https://broadrouter.com/de/models/glm-5.3/) | Tools und strukturierte Ausgabe gelistet; 1M Kontext |
| Screenshots, Arabisch | [Qwen3.8 27B](https://broadrouter.com/de/models/qwen3.8-27b/) | Tools und Bilder; 262K Kontext |
| Ganztägige Sessions, Festpreis | [DeepSeek V4.1 Flash](https://broadrouter.com/de/models/deepseek-v4.1-flash/) | Unbegrenzte Pläne; Tools von BroadNet nicht gelistet |

opencode ist auf Tool Calls angewiesen. Die Dokumentation von BroadNet listet Tool Calling für DeepSeek V4.1 Flash nicht, daher markiert die Konfiguration es als zu testende Annahme. Testen Sie eine echte Aufgabe mit einer Meteor-Stunde ($1), bevor Sie einen Full-Moon-Monat ($60) kaufen.

## Fehlerbehebung

-   **401.** Der Schlüssel in `BROADNET_API_KEY` ist falsch, abgelaufen oder das Pay-as-you-go-Kontingent ist aufgebraucht. Stellen Sie sicher, dass die Variable in dem Prozess gesetzt ist, der opencode ausführt.
-   **Modell nicht gefunden oder abgelehnt.** Wählen Sie den Map-Key (`broadnet/glm-5.3`) und prüfen Sie, ob `modelID` exakt der ID von BroadNet entspricht. Referenzen unterscheiden Groß- und Kleinschreibung. Kostenpflichtige Modelle erfordern eine Aufladung; das Guthaben von $5 deckt nur `broadnet/gemma-4-26b-a4b` und die beiden Transcribe-Modelle ab.
-   **Leere Antworten.** Erhöhen Sie `limit.output`. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **429.** Pay-as-you-go-Schlüssel erlauben 30 Anfragen pro Minute und 4 gleichzeitig laufende. Retries zählen mit. Siehe [Fehler und Retries](https://broadrouter.com/de/guides/errors-and-retries/).
-   **Subagents in einem Plan.** Jede [Plan-Session](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) verarbeitet jeweils eine Anfrage, parallele Subagents stehen also in der Warteschlange, sofern nicht jeder eine eigene Session hat.

## Begriffe in dieser Anleitung

[Tool Calling (Function Calling)](https://broadrouter.com/de/glossary/tool-calling/)

Tool Calling, auch Function Calling genannt, ist eine Funktion von LLM-APIs, bei der das Modell eine strukturierte Anfrage zurückgibt, eine vom Entwickler definierte Funktion mit JSON-Argumenten auszuführen. Die Anwendung führt die Funktion aus und sendet das Ergebnis zurück; das Modell selbst führt nie Code aus.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[Subagent](https://broadrouter.com/de/glossary/subagent/)

Ein Subagent ist ein separater Agent, den ein Hauptagent für eine klar umrissene Aufgabe startet. Er läuft mit eigenem Kontextfenster, System-Prompt und Tool-Zugriff, erledigt die Arbeit und gibt nur ein Ergebnis oder eine Zusammenfassung an den Hauptagenten zurück, sodass die Hauptkonversation klein bleibt.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

[KI-Coding-Agent (AI coding agent)](https://broadrouter.com/de/glossary/coding-agent/)

Ein KI-Coding-Agent ist ein Software-Tool, in dem ein Sprachmodell in einer Schleife an einer Codebasis arbeitet: Es liest Dateien, bearbeitet sie, führt Befehle wie Tests aus, liest die Ausgabe und entscheidet über den nächsten Schritt, bis die Aufgabe erledigt oder ein Limit erreicht ist.

[Prepaid-Guthaben (Prepaid Credit)](https://broadrouter.com/de/glossary/prepaid-credit/)

Prepaid-Guthaben ist Geld, das vor der Nutzung auf ein API-Konto eingezahlt wird. Jede Anfrage zieht ihre Kosten vom Guthaben ab, und wenn es aufgebraucht ist, stoppen abgerechnete Anfragen, bis Sie aufladen. So sind die Ausgaben auf das eingezahlte Geld begrenzt.

[Strukturierte Ausgabe (Structured Output)](https://broadrouter.com/de/glossary/structured-output/)

Strukturierte Ausgabe (Structured Output) ist eine Funktion von LLM-APIs, die die Antwort eines Modells auf ein vom Entwickler vorgegebenes Format beschränkt, meist ein JSON Schema, damit Code sie zuverlässig parsen kann. Sie ist strenger als der JSON-Modus, der gültiges JSON garantiert, aber keine bestimmte Struktur.

## Häufige Fragen

### Warum findet opencode mein BroadNet-Modell nicht?

opencode löst die Referenz als Provider/Map-Key auf, und IDs unterscheiden Groß- und Kleinschreibung. Mit der Konfiguration unten wählen Sie broadnet/glm-5.3, wobei glm-5.3 der Map-Key ist. Der Wert von modelID ist nur das, was an BroadNet gesendet wird.

### Meine Konfiguration nutzt provider und npm mit @ai-sdk/openai-compatible. Ist das falsch?

Nein. Das ist das V1-Format, und laut Migrationsanleitung von opencode wird es weiter unterstützt. Die native V2-Form benennt provider in providers um, npm in package (aisdk:@ai-sdk/openai-compatible) und options.baseURL in settings.baseURL.

### Warum sind die Antworten in opencode leer?

Das Modell hat sein Ausgabebudget für Reasoning verbraucht. Erhöhen Sie limit.output für das Modell. Bei BroadNet zählt Reasoning zu max\_tokens.

## Verwandte Anleitungen

-   [Cline mit BroadNet Inference nutzen (Provider OpenAI Compatible)](https://broadrouter.com/de/guides/cline-openai-compatible/)
-   [So funktionieren die unbegrenzten LLM-API-Pläne für Agenten](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/)
-   [Warum ein Reasoning-Modell eine leere Antwort liefert](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/)
-   [Das Vercel AI SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/vercel-ai-sdk-openai-compatible/)
-   [Alle Tools, die mit BroadNet Inference funktionieren (auf Englisch)](https://broadrouter.com/integrations/): SDKs, Coding-Agenten, Chat-Oberflächen und Automatisierungstools, jeweils mit den genauen Einstellungen

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-opencode-custom-provider&utm_content=page-cta) ·

**Quellen**

-   [Dokumentation von opencode, Providers (eigener Provider) (geprüft am 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Dokumentation von opencode, Models (Aliase, Capabilities, Limits) (geprüft am 2026-11-14)](https://opencode.ai/docs/models/)
-   [Dokumentation von opencode, Speicherorte der Konfiguration (geprüft am 2026-11-14)](https://opencode.ai/docs/config/)
-   [Dokumentation von opencode, Migration von V1 (geprüft am 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [API-Referenz von BroadNet Inference (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-opencode-custom-provider&utm_content=sources)
