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
- Exportieren Sie Ihren Schlüssel in der Shell, aus der Sie opencode starten:
export BROADNET_API_KEY='your-broadnet-key'
- Konfiguration anlegen. Legen Sie sie als
opencode.jsoncin Ihr Projekt oder nach~/.config/opencode/opencode.jsonc, um sie überall zu nutzen.
{
"$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 }
}
}
}
}
}
- opencode starten und das Modell wählen mit
/models. Die Referenz lautetbroadnet/<map key>, zum Beispielbroadnet/glm-5.3. opencode sendet den Wert vonmodelIDan 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:
{
"$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 ordnet jedes Feld zu.
Welches Modell passt
| Aufgabe | Modell | Hinweise |
|---|---|---|
| Agentisches Coding mit Tools | GLM 5.3 | Tools und strukturierte Ausgabe gelistet; 1M Kontext |
| Screenshots, Arabisch | Qwen3.8 27B | Tools und Bilder; 262K Kontext |
| Ganztägige Sessions, Festpreis | 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_KEYist 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, obmodelIDexakt der ID von BroadNet entspricht. Referenzen unterscheiden Groß- und Kleinschreibung. Kostenpflichtige Modelle erfordern eine Aufladung; das Guthaben von $5 deckt nurbroadnet/gemma-4-26b-a4bund die beiden Transcribe-Modelle ab. - Leere Antworten. Erhöhen Sie
limit.output. Warum Antworten leer zurückkommen. - 429. Pay-as-you-go-Schlüssel erlauben 30 Anfragen pro Minute und 4 gleichzeitig laufende. Retries zählen mit. Siehe Fehler und Retries.
- Subagents in einem Plan. Jede Plan-Session verarbeitet jeweils eine Anfrage, parallele Subagents stehen also in der Warteschlange, sofern nicht jeder eine eigene Session hat.
