---
title: "Kilo Code: provider personalizzato compatibile OpenAI"
description: "Collega Kilo Code a BroadNet Inference come provider OpenAI Compatible personalizzato, dalla finestra di VS Code o da kilo.json, con ID, limiti e flag dei tool."
url: https://broadrouter.com/it/guides/kilo-code-openai-compatible/
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/kilo-code-openai-compatible/) (aggiornato il 2026-11-16).

# Usare Kilo Code con BroadNet Inference (provider OpenAI Compatible)

Aggiornato 2026-11-16

In Kilo Code apri Settings, vai su Providers e clicca Custom provider. Scegli Provider API OpenAI Compatible, imposta Base URL su https://inference.broadnet.ai/v1, incolla la tua chiave BroadNet e aggiungi a mano un ID di modello come broadnet/glm-5.3. In kilo.json usa npm @ai-sdk/openai-compatible con options.baseURL e imposta limit.context e limit.output.

Kilo Code è un agente di coding open source per VS Code e per il terminale. Qualsiasi provider con un’API OpenAI Chat Completions si può aggiungere come **custom provider**. BroadNet Inference serve quel formato su `https://inference.broadnet.ai/v1`. BroadRouter è il sito di BroadNet; questa guida segue [la documentazione di Kilo sui provider](https://kilo.ai/docs/ai-providers/openai-compatible) come si presentava il 15 novembre 2026.

## Configurazione in VS Code

1.  **Procurati una chiave.** Crea una chiave a consumo nella console di BroadNet, oppure usa la chiave di un [piano illimitato](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/).
    
2.  Apri **Settings** (icona a ingranaggio) e vai nella scheda **Providers**.
    
3.  Scorri fino in fondo e clicca **Custom provider**.
    
4.  Compila la finestra:
    
    | Campo | Valore |
    | --- | --- |
    | Provider ID | `broadnet` |
    | Display name | BroadNet Inference |
    | Provider API | **OpenAI Compatible** |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API key | la tua chiave BroadNet |
    | Models | aggiungi a mano `broadnet/glm-5.3` (vedi sotto) |
    
5.  Clicca **Submit**. Il modello compare nel selettore dei modelli.
    
6.  **Provalo.** Avvia un task come “explain this file”. Se risponde, la connessione funziona.
    

Kilo prova a riempire l’elenco dei modelli da `/v1/models` dell’endpoint. La documentazione di BroadNet descrive quell’endpoint come metadati del catalogo per i sistemi di monitoraggio, e al nostro controllo del 15 novembre 2026 elencava solo i due modelli di trascrizione. Scrivi tu gli ID dei modelli di chat e non scegliere i modelli di trascrizione.

## Configurazione in kilo.json (CLI, oppure per limiti e flag degli strumenti)

La finestra di Kilo non imposta né i limiti di token né il tool calling. Per questo la sua documentazione rimanda al file di configurazione: `~/.config/kilo/kilo.json`, oppure `./kilo.json` in un progetto.

```jsonc
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "broadnet/glm-5.3",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["BROADNET_API_KEY"],
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "id": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "id": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "tool_call": true,
          "reasoning": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "id": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        }
      }
    }
  }
}
```

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

-   Il valore `model` di primo livello, `broadnet/glm-5.3`, è il nome del provider più la chiave della mappa (`glm-5.3`), non l’ID BroadNet. Il campo `id` è l’ID del modello che Kilo invia a BroadNet. La documentazione di Kilo dice che `id` prende di default il valore della chiave della mappa, quindi impostalo ogni volta che la chiave non è l’ID BroadNet completo, come con le chiavi brevi qui.
-   Imposta sempre `limit.context` e `limit.output`. Per un modello personalizzato senza corrispondenza nel catalogo, la documentazione di Kilo dice che entrambi valgono 0, e questo disattiva la gestione automatica del contesto. Il valore di output di 16.000 è un nostro suggerimento; lascia spazio al ragionamento.
-   `tool_call` è omesso di proposito per DeepSeek V4.1 Flash: la documentazione di BroadNet non indica il tool calling per quel modello. Aggiungilo dopo averlo testato.

## Quale modello scegliere

| Attività | Modello | Note |
| --- | --- | --- |
| Coding da agente 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 lunghe, prezzo fisso | [DeepSeek V4.1 Flash](https://broadrouter.com/it/models/deepseek-v4.1-flash/) | Piani illimitati; strumenti non indicati da BroadNet |

Prova il piano illimitato con un’ora di Meteor ($1) prima di un mese di Full Moon ($60).

## Risoluzione dei problemi

-   **“Invalid API Key” o 401.** Incolla di nuovo la chiave. Controlla che abbia ancora quota disponibile e che `BROADNET_API_KEY` sia impostata nel processo che esegue Kilo.
-   **“Model Not Found”.** Controlla che l’ID corrisponda esattamente a quello di BroadNet, con il prefisso `broadnet/`. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **Risposta vuota o “response may be incomplete”.** Kilo avvisa quando un modello di ragionamento spende tutto l’output nel ragionamento. Alza `limit.output`. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429.** Una chiave a consumo consente 30 richieste al minuto e 4 in corso contemporaneamente. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Subagent in parallelo su una chiave del piano attendono o falliscono.** Una sessione del piano esegue una richiesta alla volta, quindi dai a ogni subagent in parallelo la sua sessione.
-   **Errori di connessione.** Il Base URL deve finire con `/v1`. Se la chiave ha una [allowlist di IP](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/), aggiungi l’indirizzo della tua macchina.

## 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.

[Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/)

La base URL è l’indirizzo radice fisso di un’API, come https://api.example.com/v1, che un client antepone a ogni percorso di endpoint, come /chat/completions. Negli SDK compatibili con OpenAI, cambiare la base URL, insieme alla chiave API e all’ID del modello, punta lo stesso codice verso un altro provider.

[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.

[Subagent (sub-agente)](https://broadrouter.com/it/glossary/subagent/)

Un subagent è un agente separato che un agente principale avvia per gestire un compito specifico. Lavora con una propria finestra di contesto, un proprio system prompt e propri strumenti, svolge il lavoro e restituisce all’agente principale solo un risultato o un riepilogo, mantenendo piccola la conversazione principale.

[Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/)

Una chiave API è una stringa segreta che identifica e autorizza un client che chiama un’API. Le API LLM di solito la vogliono in un header Authorization: Bearer, e chiunque possieda la chiave può fare richieste fatturate all’account a cui appartiene.

[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.

[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.

## Domande frequenti

### Perché Kilo Code non elenca i modelli di chat di BroadNet dopo che inserisco il Base URL?

Kilo prende i modelli dall’elenco /v1/models dell’endpoint. Al nostro controllo del 15 novembre 2026, il /v1/models pubblico di BroadNet elencava solo i suoi due modelli di trascrizione, quindi aggiungi a mano gli ID dei modelli di chat.

### Che valore deve avere limit.context per i modelli BroadNet?

1048576 per GLM 5.3 e DeepSeek V4.1 Flash, 262144 per Qwen3.8 27B e 32768 per BroadNet Gemma 4 VL 26B. La documentazione di Kilo dice che per i modelli personalizzati un limite mancante vale 0, e questo disattiva la gestione automatica del contesto.

### Posso usare Kilo Code con il piano illimitato di BroadNet?

Sì. I piani coprono DeepSeek V4.1 Flash, ID broadnet/deepseek-v4.1-flash. Usa la chiave del piano come chiave API. La documentazione di BroadNet non indica il tool calling per quel modello, quindi prova prima un task da agente.

### Come Provider API devo scegliere OpenAI Compatible o OpenAI Responses?

OpenAI Compatible. BroadNet serve chat completions su /v1/chat/completions e non elenca la Responses API.

## Guide correlate

-   [Usare Cline con BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/it/guides/cline-openai-compatible/)
-   [Aggiungere BroadNet Inference a opencode come provider personalizzato](https://broadrouter.com/it/guides/opencode-custom-provider/)
-   [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/)
-   [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-kilo-code-openai-compatible&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Kilo Code, Using OpenAI-Compatible Providers (verificata il 2026-11-15)](https://kilo.ai/docs/ai-providers/openai-compatible)
-   [Documentazione di Kilo Code, Custom Models (campi id, tool\_call, limit) (verificata il 2026-11-15)](https://kilo.ai/docs/code-with-ai/agents/custom-models)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-kilo-code-openai-compatible&utm_content=sources)
