O opencode é um agente de código open source para o terminal. Provedores que não estão no catálogo nativo dele são adicionados como provedores personalizados no opencode.jsonc. A BroadNet Inference fala o formato chat completions da OpenAI, então usa o pacote de runtime compatível com a OpenAI do opencode. Este guia segue a documentação atual (V2) do opencode.
Configuração
- Exporte a sua chave no shell que inicia o opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Crie a configuração. Coloque no seu projeto como
opencode.jsonc, ou em~/.config/opencode/opencode.jsoncpara usar em todo lugar.
{
"$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 }
}
}
}
}
}
- Inicie o opencode e escolha o modelo com
/models. A referência ébroadnet/<map key>, por exemplobroadnet/glm-5.3. O opencode envia à BroadNet o valor demodelID.
Os arquivos de configuração são mesclados. O opencode aplica primeiro o arquivo global, depois os arquivos de projeto encontrados subindo a partir do diretório atual (os mais distantes primeiro) e, por fim, qualquer configuração em .opencode/; assim, um arquivo de projeto pode sobrescrever o provedor global. A configuração de sistema gerenciada, se a sua empresa usar, tem prioridade sobre os dois. Mantenha a chave no ambiente, não no arquivo, para poder colocar a configuração no controle de versão.
Por que os aliases
Os IDs da BroadNet já têm uma barra (broadnet/glm-5.3). A chave do mapa models é o que o opencode mostra e seleciona, e modelID é o que ele envia. Chaves curtas deixam as referências legíveis.
Defina capabilities e limit você mesmo. Para um modelo fora do catálogo, o opencode supõe suporte a ferramentas em JSON, entrada de texto e imagem, contexto de 200.000 tokens e 32.000 tokens de saída. A documentação dele chama isso de suposições de fallback, não de valores detectados. O valor output de 16000 acima é sugestão nossa, não um limite da BroadNet; ele deixa espaço para o raciocínio.
Configurações V1 antigas
O opencode V2 ainda lê o formato V1, então um bloco existente como este continua funcionando:
{
"$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" }
}
}
}
}
Na forma nativa V2, provider vira providers, npm vira package (aisdk:@ai-sdk/openai-compatible se quiser manter o pacote do AI SDK), e options.baseURL e options.apiKey passam para dentro de settings. O guia de migração da V1 do opencode mostra a correspondência de cada campo.
Qual modelo escolher
| Tarefa | Modelo | Observações |
|---|---|---|
| Código com agente e ferramentas | GLM 5.3 | Ferramentas e saída estruturada listadas; contexto de 1M |
| Screenshots, árabe | Qwen3.8 27B | Ferramentas e imagens; contexto de 262K |
| Sessões o dia inteiro, preço fixo | DeepSeek V4.1 Flash | Planos ilimitados; ferramentas não listadas pela BroadNet |
O opencode depende de chamadas de ferramentas. A documentação da BroadNet não lista tool calling para o DeepSeek V4.1 Flash, então a configuração marca isso como uma suposição a testar. Rode uma tarefa real com uma hora de Meteor ($1) antes de comprar um mês de Full Moon ($60).
Solução de problemas
- 401. A chave em
BROADNET_API_KEYestá errada, expirou ou ficou sem cota de pagamento por uso. Confirme que a variável está definida no processo que roda o opencode. - Modelo não encontrado ou rejeitado. Selecione a chave do mapa (
broadnet/glm-5.3) e confira semodelIDé exatamente o ID da BroadNet. As referências diferenciam maiúsculas de minúsculas. Os modelos pagos exigem uma recarga; o crédito de $5 cobre sóbroadnet/gemma-4-26b-a4be os dois modelos Transcribe. - Respostas vazias. Aumente
limit.output. Por que as respostas voltam vazias. - 429. Chaves de pagamento por uso permitem 30 requisições por minuto e 4 em andamento. As novas tentativas também contam. Veja erros e novas tentativas.
- Subagentes num plano. Cada sessão do plano atende uma requisição por vez, então subagentes em paralelo entram na fila, a menos que cada um tenha a própria sessão.
