---
title: "opencode: provider personalizzato compatibile con OpenAI"
description: "Aggiungi BroadNet Inference all’agente di coding opencode come provider personalizzato compatibile con OpenAI in opencode.jsonc, con alias, capacità e limiti."
url: https://broadrouter.com/it/guides/opencode-custom-provider/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/opencode-custom-provider/) (aggiornato il 2026-11-16).

# Aggiungere BroadNet Inference a opencode come provider personalizzato

Aggiornato 2026-11-16

In opencode.jsonc aggiungi una voce broadnet sotto providers con package @opencode/ai/providers/openai-compatible, settings.baseURL impostato su https://inference.broadnet.ai/v1 ed env impostato su BROADNET\_API\_KEY. Associa chiavi brevi agli ID di BroadNet con modelID, per esempio broadnet/glm-5.3, poi scegli il modello con /models. Le vecchie configurazioni V1 con npm @ai-sdk/openai-compatible e options.baseURL funzionano ancora.

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

1.  **Esporta la chiave** nella shell da cui avvii opencode:

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

2.  **Crea la configurazione.** Mettila nel progetto come `opencode.jsonc`, oppure in `~/.config/opencode/opencode.jsonc` per usarla ovunque.

```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.  **Avvia opencode e scegli il modello** con `/models`. Il riferimento è `broadnet/<map key>`, per esempio `broadnet/glm-5.3`. opencode invia a BroadNet il valore di `modelID`.

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:

```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" }
      }
    }
  }
}
```

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](https://opencode.ai/docs/migrate-v1/) indica la corrispondenza di ogni campo.

## Quale modello scegliere

| Attività | Modello | Note |
| --- | --- | --- |
| Coding agentico con strumenti | [GLM 5.3](https://broadrouter.com/it/models/glm-5.3/) | Strumenti e output strutturato indicati; contesto da 1M |
| Screenshot, arabo | [Qwen3.8 27B](https://broadrouter.com/it/models/qwen3.8-27b/) | Strumenti e immagini; contesto da 262K |
| Sessioni di un’intera giornata, prezzo fisso | [DeepSeek V4.1 Flash](https://broadrouter.com/it/models/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 che `modelID` corrisponda esattamente all’ID di BroadNet. I riferimenti distinguono maiuscole e minuscole. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **Risposte vuote.** Alza `limit.output`. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429.** Le chiavi a consumo consentono 30 richieste al minuto e 4 in corso. Contano anche i nuovi tentativi. Vedi [errori e nuovi tentativi](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Subagenti su un piano.** Ogni [sessione del piano](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) gestisce una richiesta alla volta, quindi i subagenti in parallelo finiscono in coda, a meno che ognuno non abbia la propria sessione.

## Termini in questa guida

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Agente di coding AI (AI coding agent)](https://broadrouter.com/it/glossary/coding-agent/)

Un agente di coding AI è uno strumento software in cui un modello linguistico lavora su una codebase in un ciclo: legge file, li modifica, esegue comandi come i test, legge l’output e decide il passo successivo finché il compito è finito o si raggiunge un limite.

[Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/)

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

## Domande frequenti

### Perché opencode non trova il mio modello BroadNet?

opencode risolve il riferimento come provider/chiave della mappa, e gli ID distinguono maiuscole e minuscole. Con la configurazione qui sotto, seleziona broadnet/glm-5.3, dove glm-5.3 è la chiave della mappa. Il valore di modelID è solo ciò che viene inviato a BroadNet.

### La mia configurazione usa provider e npm con @ai-sdk/openai-compatible. È sbagliata?

No. È il formato V1, e la guida alla migrazione di opencode dice che resta supportato. La forma nativa V2 rinomina provider in providers, npm in package (aisdk:@ai-sdk/openai-compatible) e options.baseURL in settings.baseURL.

### Perché opencode restituisce risposte vuote?

Il modello ha speso il budget di output nel ragionamento. Alza limit.output per quel modello. Su BroadNet il ragionamento conta in max\_tokens.

## Guide correlate

-   [Usare Cline con BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/it/guides/cline-openai-compatible/)
-   [Come funzionano i piani API LLM illimitati per gli agenti](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Usare il Vercel AI SDK con BroadNet Inference](https://broadrouter.com/it/guides/vercel-ai-sdk-openai-compatible/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

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

**Fonti**

-   [Documentazione di opencode, Providers (provider personalizzato) (verificata il 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Documentazione di opencode, Models (alias, capacità, limiti) (verificata il 2026-11-14)](https://opencode.ai/docs/models/)
-   [Documentazione di opencode, posizioni dei file di configurazione (verificata il 2026-11-14)](https://opencode.ai/docs/config/)
-   [Documentazione di opencode, migrazione dalla V1 (verificata il 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-opencode-custom-provider&utm_content=sources)
