Home → Guide → Cline con un'API personalizzata: provider, base URL e il modello che gestisce bene i suoi strumenti

Cline con un'API personalizzata: provider, base URL e il modello che gestisce bene i suoi strumenti

Cline chiede a un'API tre cose: base URL, chiave e ID del modello. A decidere se un agente funziona è qualcosa di meno evidente: se il modello chiama gli strumenti esattamente con gli argomenti definiti da Cline. Lo abbiamo verificato su sei modelli prima di scrivere questa guida.

Collegare Cline in quattro passaggi

Apri il pannello di Cline in VS Code e fai clic sull'icona a ingranaggio. Poi:

1. In API Provider scegli OpenAI Compatible (va bene per tutti i modelli) oppure Anthropic per Claude.
2. Inserisci la base URL della tabella. Con Anthropic, spunta prima Use custom base URL.
3. Incolla la chiave API presa dalla console.
4. Scrivi l'ID del modello esattamente come indicato, fai clic su Done e prova con un compito breve.

API Provider	Base URL	Model ID
OpenAI Compatible	https://apiclan.us/v1	gpt-6.1-sol, deepseek-v4-pro, claude-opus-5-5
Anthropic (base URL personalizzata)	https://apiclan.us	claude-opus-5-5, claude-fable-5-1

Le due base URL sono diverse di proposito. OpenAI Compatible aggiunge /chat/completions, quindi serve /v1; Anthropic aggiunge da solo /v1/messages, quindi non deve averlo. Un /v1 nel posto sbagliato è la causa più comune di un 404.

Usa una chiave del gruppo giusto

Ogni chiave API di questo gateway appartiene a un solo gruppo di modelli e può chiamare solo i modelli di quel gruppo. Per usare Claude in Cline crea la chiave in un gruppo Claude; per GPT in un gruppo GPT; per DeepSeek nel gruppo DeepSeek. Se in Cline cambi famiglia di modelli, cambia anche la chiave.

Impostazioni del modello con OpenAI Compatible

Con OpenAI Compatible, Cline non può consultare il modello e mostra i campi di Model Configuration: finestra di contesto, token di output massimi e supporto immagini. Inserisci il limite di contesto reale del modello. Troppo basso e Cline taglia la conversazione presto; troppo alto e le attività lunghe falliscono con un errore di lunghezza del contesto invece di essere compattate.

Il nostro test: i modelli chiamano correttamente gli strumenti di Cline?

L'agente di Cline lavora con strumenti come read_file. Abbiamo dato a ogni modello uno strumento read_file con un solo argomento, path, chiesto di aprire src/app.ts e controllato due cose: se la chiamata usava esattamente il nome di argomento dichiarato nello schema e quanto impiegava la prima risposta (mediana, streaming attivo). Un argomento rinominato è il motivo tipico per cui un passo dell'agente fallisce senza un errore chiaro.

Modello	Chiamate corrette	Prima risposta
claude-opus-5-5	13 / 13	3.3 s
claude-fable-5-1	13 / 13	2.8 s
gpt-6.1-sol	3 / 3	2.6 s
gpt-5.6-sol	3 / 3	3.3 s
deepseek-v4-pro	3 / 3	2.6 s
deepseek-v4.1-flash	3 / 3	1.5 s

Ogni modello ha chiamato lo strumento correttamente ogni volta. I campioni sono piccoli — 13 prove per ciascun modello Claude, 3 per gli altri — e una prova di gpt-5.6-sol ha richiesto 40 secondi per un avvio a freddo; la tabella riporta la mediana. Test del 12 ottobre 2026.

Quale modello scegliere

• Lunghe sessioni di agente su un progetto reale: claude-opus-5-5 tramite il provider Anthropic, il protocollo nativo di Claude, su cui Cline invia i marcatori di cache del prompt.
• La maggior parte del lavoro a costo minore: gpt-6.1-sol o claude-fable-5-1.
• Modifiche rapide ed economiche, tanti piccoli passi: deepseek-v4.1-flash, il più veloce nel nostro test.

I quattro errori più comuni

• 401 Unauthorized → la chiave è sbagliata o ha uno spazio all'inizio o alla fine. Incollala di nuovo.
• 404 → la base URL non corrisponde al provider: OpenAI Compatible vuole /v1, Anthropic no.
• model_not_found (is not supported by any configured account in this group) → l'ID del modello è scritto male, oppure la tua chiave appartiene a un gruppo che non lo include.
• Timeout sui passaggi lunghi → usa https://api.apiclan.us/v1 (o https://api.apiclan.us per Anthropic), che aggira il limite di 100 secondi del proxy.

Configuri altri strumenti? Base URL di Claude Code · Codex con un'API personalizzata.

Inizia a usarlo

Nessun abbonamento, nessun minimo mensile, nessuna telefonata commerciale. Ricarica in USDT e spendi quello che usi — 1 USDT ti dà 2 crediti di saldo API.

Leggi l'avvio rapido da 30 secondi

Lingua: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

I prezzi di questa pagina sono compilati automaticamente dai dati di fatturazione reali. Le condizioni di terzi sono citate dalla loro documentazione.