opencode è un agente di coding open source per il terminale. I provider che non fanno parte del suo catalogo integrato si aggiungono come provider personalizzati in opencode.jsonc. BroadNet Inference parla il formato chat completions di OpenAI, quindi usa il pacchetto runtime compatibile con OpenAI di opencode. Questa guida segue la documentazione attuale (V2) di opencode.
Configurazione
- Esporta la chiave nella shell da cui avvii opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Crea la configurazione. Mettila nel progetto come
opencode.jsonc, oppure in~/.config/opencode/opencode.jsoncper usarla ovunque.
{
"$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 }
}
}
}
}
}
- Avvia opencode e scegli il modello con
/models. Il riferimento èbroadnet/<map key>, per esempiobroadnet/glm-5.3. opencode invia a BroadNet il valore dimodelID.
I file di configurazione si uniscono. opencode applica prima il file globale, poi i file di progetto trovati risalendo dalla directory corrente (prima i più lontani), poi l’eventuale configurazione in .opencode/; così un file di progetto può sovrascrivere il provider globale. La configurazione di sistema gestita, se la tua azienda la usa, ha la precedenza su entrambi. Tieni la chiave nell’ambiente, non nel file, così puoi mettere la configurazione sotto controllo di versione.
Perché gli alias
Gli ID di BroadNet contengono già una barra (broadnet/glm-5.3). La chiave della mappa models è ciò che opencode mostra e seleziona, mentre modelID è ciò che invia. Le chiavi brevi rendono i riferimenti leggibili.
Imposta tu capabilities e limit. Per un modello fuori dal suo catalogo, opencode presume il supporto agli strumenti JSON, input di testo e immagini, un contesto di 200.000 token e 32.000 token di output. La sua documentazione li chiama presupposti di ripiego, non valori rilevati. Il valore output di 16000 qui sopra è un nostro suggerimento, non un limite di BroadNet; lascia spazio al ragionamento.
Vecchie configurazioni V1
opencode V2 legge ancora il formato V1, quindi un blocco esistente come questo continua a funzionare:
{
"$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" }
}
}
}
}
Nella forma nativa V2, provider diventa providers, npm diventa package (aisdk:@ai-sdk/openai-compatible se vuoi mantenere il pacchetto dell’AI SDK), e options.baseURL e options.apiKey passano sotto settings. La guida alla migrazione dalla V1 di opencode indica la corrispondenza di ogni campo.
Quale modello scegliere
| Attività | Modello | Note |
|---|---|---|
| Coding agentico con strumenti | GLM 5.3 | Strumenti e output strutturato indicati; contesto da 1M |
| Screenshot, arabo | Qwen3.8 27B | Strumenti e immagini; contesto da 262K |
| Sessioni di un’intera giornata, prezzo fisso | DeepSeek V4.1 Flash | Piani illimitati; strumenti non indicati da BroadNet |
opencode si basa sulle chiamate agli strumenti. La documentazione di BroadNet non indica il tool calling per DeepSeek V4.1 Flash, quindi la configurazione lo segna come un’ipotesi da verificare. Prova un task reale con un’ora di Meteor ($1) prima di comprare un mese di Full Moon ($60).
Risoluzione dei problemi
- 401. La chiave in
BROADNET_API_KEYè sbagliata, scaduta o ha esaurito la quota a consumo. Verifica che la variabile sia impostata nel processo che esegue opencode. - Modello non trovato o rifiutato. Seleziona la chiave della mappa (
broadnet/glm-5.3) e controlla chemodelIDcorrisponda esattamente all’ID di BroadNet. I riferimenti distinguono maiuscole e minuscole. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solobroadnet/gemma-4-26b-a4be i due modelli Transcribe. - Risposte vuote. Alza
limit.output. Perché le risposte arrivano vuote. - 429. Le chiavi a consumo consentono 30 richieste al minuto e 4 in corso. Contano anche i nuovi tentativi. Vedi errori e nuovi tentativi.
- Subagenti su un piano. Ogni sessione del piano gestisce una richiesta alla volta, quindi i subagenti in parallelo finiscono in coda, a meno che ognuno non abbia la propria sessione.
