Kilo Code con MartLLM: aggiungi un provider personalizzato in 1 minuto
In Kilo Code apri Impostazioni → Provider → Provider personalizzato, imposta Provider API su OpenAI Compatible, Base URL su https://api.martllm.com/v1, incolla la tua chiave MartLLM, premi Recupera modelli, scegli quelli che desideri e Invia. La stessa configurazione può risiedere in ~/.config/kilo/kilo.jsonc.
La versione attuale di Kilo Code (7.x) condivide un unico file di impostazioni tra VS Code, JetBrains e la kilo CLI, così configuri MartLLM 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.
Il più veloce: un comando
npx uberllm init --tool kilo-code
Per VS Code, JetBrains e la CLI kilo in una volta sola: crea una chiave nel tuo browser, aggiunge il provider a ~/.config/kilo/kilo.jsonc con i limiti reali di contesto e output di ogni modello, e aggiunge una riga al tuo profilo shell che carica la chiave. Il file viene prima sottoposto a backup, e npx uberllm init --undo lo ripristina. Cosa cambia. Per farlo manualmente, segui i passaggi seguenti.
Passaggi (nell'editor)
- Crea una chiave sulla tua pagina delle chiavi e aggiungi credito.
- Apri Kilo Code, clicca sull'icona a forma di ingranaggio → scheda Providers, scorri fino in fondo e clicca su Custom provider.
- Compila:
- Provider ID:
uberllm - Nome visualizzato:
MartLLM - Provider API: OpenAI Compatible
- Base URL:
https://api.martllm.com/v1 - API key: la tua chiave
ull_…
- Provider ID:
- Premi Fetch models. L'elenco proviene da MartLLM; mantieni quelli che desideri, ad esempio
moonshotai/kimi-k3. - 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": "MartLLM",
"env": ["UBERLLM_API_KEY"],
"options": { "baseURL": "https://api.martllm.com/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 martllm.com/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 MartLLM, usa https://api.martllm.com/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>. Eseguikilo modelsper vedere cosa ha caricato Kilo. - L'Agent non modifica mai i file: aggiungi
"tool_call": trueal 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