Kilo Code con UberLLM: aggiungi un provider personalizzato in 1 minuto

La versione attuale di Kilo Code (7.x) condivide un unico file di impostazioni tra VS Code, JetBrains e la kilo CLI, così configuri UberLLM una sola volta. Le guide più vecchie che mostrano un menu a discesa del provider con campi di informazioni sul modello descrivono l'estensione legacy.

Passaggi (nell'editor)

1. Crea una chiave sulla tua pagina delle chiavi e aggiungi credito.
2. Apri Kilo Code, clicca sull'icona a forma di ingranaggio → scheda Providers, scorri fino in fondo e clicca su Custom provider.
3. Compila:
   • Provider ID: uberllm
   • Nome visualizzato: UberLLM
   • Provider API: OpenAI Compatible
   • Base URL: https://api.uberllm.dev/v1
   • API key: la tua chiave ull_…
4. Premi Fetch models. L'elenco proviene da UberLLM; mantieni quelli che desideri, ad esempio moonshotai/kimi-k3.
5. Clicca su Submit, quindi scegli il modello nel selettore di modelli di Kilo.

Passaggi (file di configurazione)

Lo stesso provider in ~/.config/kilo/kilo.jsonc (Windows: C:\Users\<you>\.config\kilo\kilo.jsonc; per un progetto, .kilo/kilo.jsonc nel progetto):

{
  "provider": {
    "uberllm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UberLLM",
      "env": ["UBERLLM_API_KEY"],
      "options": { "baseURL": "https://api.uberllm.dev/v1" },
      "models": {
        "moonshotai/kimi-k3": {
          "name": "moonshotai/kimi-k3",
          "tool_call": true,
          "limit": { "context": 200000, "output": 32000 }
        }
      }
    }
  },
  "model": "uberllm/moonshotai/kimi-k3"
}

Poi imposta UBERLLM_API_KEY=ull_your_key nel tuo ambiente. I numeri limit sono un esempio: copia la lunghezza reale del contesto dalla pagina del modello su uberllm.dev/models.

Due impostazioni che spesso vengono dimenticate

• limit: senza di essa Kilo tratta il contesto come 0 e non compatta mai un'attività lunga, quindi alla fine fallisce. La finestra di dialogo dell'editor non può impostarla; aggiungila nel file ("modifica le impostazioni avanzate nel file di configurazione JSON").
• tool_call: true: L'agente di Kilo funziona tramite strumenti. Se il modello risponde in testo semplice invece di modificare i file, questo manca.

Preferisci il formato Anthropic?

Kilo offre anche Provider API → Anthropic Messages. Con UberLLM, usa https://api.uberllm.dev/v1 come Base URL anche lì (non l'host puro), e la stessa key. Il recupero dei modelli non è disponibile in quella modalità, quindi digita gli id tu stesso.

Risoluzione dei problemi

• "Authentication failed. Check the API key above and try again." durante il recupero: la chiave è mancante o contiene uno spazio.
• Modello non presente nel selettore: la chiave del modello deve corrispondere a uberllm/<model id>. Esegui kilo models per vedere cosa ha caricato Kilo.
• L'Agent non modifica mai i file: aggiungi "tool_call": true al modello.
• Il Task fallisce dopo una sessione lunga: imposta limit.context.
• 402 crediti insufficienti: aggiungi credito sulla pagina dei crediti.

Continua a leggere

• Pagina di riferimento: Documentazione Kilo Code
• Configurazione OpenCode (Il formato di configurazione di Kilo deriva da OpenCode)
• Configurazione Cline