Configurare una chiave API personalizzata in Cline

Cline è il client di codifica. Il provider API fornisce il modello, autentica la richiesta e fattura i token. Una chiave API personalizzata collega questi due livelli; non rende gratuito l'utilizzo del modello e non aggira le regole di accesso del fornitore.

La configurazione ufficiale OpenAI compatibile di Cline espone i campi necessari per questa connessione: Fornitore API, Base URL, Chiave API e Model ID. Con OmniaKey, una chiave può raggiungere Claude, GPT, Gemini, DeepSeek e altri modelli supportati tramite quell'interfaccia.

Cline impostazioni personalizzate dei tasti API

Apri Cline in VS Code, seleziona l'icona delle impostazioni, quindi inserisci:

Il suffisso /v1 fa parte del Base URL compatibile con OpenAI. Non utilizzare qui la nuda origine e non aggiungere /chat/completions; Cline crea il percorso della richiesta.

Configura Cline passo dopo passo

1. Crea una chiave API separata

Accedi a OmniaKey, finanzia il saldo prepagato e crea una chiave API. Una chiave separata per Cline semplifica i limiti, la rotazione e la revisione dell'utilizzo rispetto alla condivisione di una credenziale su ogni strumento.

Non inserire mai la chiave letterale nel codice sorgente, in un file di repository, in un problema o in uno screenshot. Incollalo solo nel campo Chiave API di Cline.

2. Seleziona OpenAI compatibile

Apri le impostazioni Cline e scegli OpenAI Compatible in API Provider. Non scegliere il provider ufficiale OpenAI quando la chiave appartiene a un altro provider: la scelta del provider determina quali campi di configurazione ed endpoint Cline utilizzerà.

3. Immettere Base URL

Utilizzare esattamente:

https://api.omniakey.com/v1

Valori errati comuni: https://api.omniakey.com, un /v1/v1 duplicato o il percorso completo /v1/chat/completions.

4. Inserisci un Model ID esatto

Inizia con un modello attualmente elencato nel catalogo dei modelli OmniaKey:

Questi esempi non sono alias. Maiuscole/minuscole, punteggiatura e suffissi di versione contano. Copia l'ID anziché ridigitarlo dalla memoria.

5. Verificare prima di assegnare un compito reale

Utilizzare il controllo Verifica di Cline se viene visualizzato per il provider selezionato. Quindi esegui un'attività ristretta e reversibile:

Read package.json and name the package manager. Do not edit files.

Una verifica utile stabilisce quattro cose:

1. Cline ha accettato le impostazioni personalizzate del provider.
2. Il provider ha accettato la chiave API.
3. Esiste il modello esatto per quella chiave.
4. Viene restituita una semplice risposta del modello senza una modifica o un ciclo di strumenti.

Solo allora passa a un'attività di modifica del repository. La panoramica sulla configurazione dell'agente di codifica copre il flusso di lavoro più ampio.

Come funziona la fatturazione Cline BYOK

BYOK significa portare la propria chiave. Cline invia richieste utilizzando le impostazioni del provider fornite e il provider addebita l'utilizzo del modello in base a tale account. Cline non trasforma un API a pagamento in un utilizzo gratuito.

Esamina l'input effettivo, l'input memorizzato nella cache e i token di output anziché fare una stima in base alla risposta visibile. Il lavoro dell'agente include il contesto del repository, le chiamate agli strumenti, i tentativi e il ragionamento intermedio. La guida alla fatturazione trasparente spiega perché il costo dell'attività completata è più utile della tariffa del token principale.

Se la scelta del modello è ancora aperta, confronta le famiglie nella guida al modello dell'agente di codifica prima di ottimizzare la configurazione Cline.

Risolvere i problemi relativi a una chiave Cline API che non funziona

Chiave API o HTTP 401 non valida

Un 401 significa che l'endpoint non ha accettato le credenziali fornite con la richiesta.

Controlla che:

• la chiave proviene dallo stesso fornitore di Base URL;
• non sono stati incollati spazi iniziali o finali;
• la chiave è attiva e non è stata ruotata o cancellata;
• il conto ha un saldo utilizzabile;
• Cline è ancora impostato su OpenAI Compatible.

La creazione di un nuovo ID modello non risolve un errore di autenticazione.

Modello non trovato o HTTP 404

Uno 404 può significare che Base URL è sbagliato o che Model ID non è disponibile. Per prima cosa conferma che Base URL termina una volta in /v1. Quindi copiare l'ID modello esatto dal catalogo.

Se l'endpoint funziona con un modello elencato ma non con un altro, la connessione è valida e il problema rimanente riguarda la disponibilità o la denominazione del modello.

Errore di connessione

Confermare che https://api.omniakey.com/v1 sia raggiungibile dalla stessa macchina che esegue Cline. Le regole VPN, proxy, DNS, ispezione TLS e firewall possono influire sull'IDE anche quando una pagina del browser viene caricata altrove.

Non disabilitare la verifica TLS per nascondere un errore del certificato. Correggi invece la rete o la configurazione attendibile.

Il modello risponde ma gli strumenti falliscono

Una risposta testuale riuscita dimostra solo la generazione di base. Cline dipende anche dalle chiamate di strumenti strutturati per la lettura, la modifica e l'esecuzione dei comandi. Testare un'attività del repository di sola lettura prima di una modifica autonoma di grandi dimensioni.

Se un modello produce ripetutamente chiamate a strumenti in formato non corretto, confrontare un modello documentato per il lavoro degli agenti anziché aumentare ciecamente i limiti di output.

I costi sono più alti del previsto

Il lungo contesto del repository può dominare il conto anche quando la risposta finale è breve. Inizia con un'attività ristretta, mantieni le cartelle non correlate fuori contesto e confronta il costo per modifica accettata.

Utilizza tasti o maiuscoli separati per gli esperimenti. Un limite limita l’esposizione finanziaria; non riduce i token consumati da un'attività inefficiente.

Lista di controllo di sicurezza

• Utilizza una chiave Cline dedicata anziché una credenziale condivisa con i servizi di produzione.
• Imposta un limite appropriato per la dimensione del progetto e dell'attività.
• Ruota una chiave visualizzata in un repository, una registrazione del terminale, uno screenshot o un problema.
• Esamina le autorizzazioni dello strumento prima di consentire comandi shell o modifiche ai file.
• Avvia repository nuovi o non attendibili con attività di sola lettura.
• Controlla il registro di utilizzo del provider dopo la prima sessione riuscita.

La chiave API controlla l'accesso al modello. Le autorizzazioni per file e comandi di Cline controllano ciò che l'agente può fare localmente. Trattateli come confini di sicurezza separati.

Domande frequenti

Posso utilizzare la mia chiave API con Cline?

Sì. Seleziona OpenAI Compatible, quindi inserisci la chiave Base URL, API del provider e l'esatto Model ID. Il provider deve esporre un API compatibile con l'interfaccia prevista da Cline.

Una chiave API personalizzata Cline è gratuita?

No. BYOK cambia chi autentica e fattura la richiesta del modello. Il provider può comunque addebitare i token di input, input memorizzati nella cache e output.

Quale Base URL dovrebbe utilizzare Cline per OmniaKey?

Utilizzare https://api.omniakey.com/v1. Non aggiungere /chat/completions e non duplicare /v1.

Quale modello dovrei usare in Cline?

Inizia con un modello corrente dal catalogo adatto all'attività. gpt-5.6-terra è un punto di partenza equilibrato; utilizzare modelli più forti o più economici solo dopo aver confrontato i risultati dei compiti accettati.

Perché Cline dice Modello non trovato?

Controlla l'esatto Model ID e Base URL. Una chiave API valida può comunque non avere accesso a un modello particolare e una chiave 404 può anche provenire da un URL non valido.

Cline memorizza la mia chiave nel repository?

Le credenziali del provider appartengono alle impostazioni di Cline, non ai file di progetto. Indipendentemente dall'implementazione dell'archiviazione del client, non copiare la chiave nell'origine, nei prompt, negli screenshot o nei report dei problemi.

Fonti controllate

• Cline: OpenAI Fornitore compatibile
• Cline: Autorizzazione e BYOK
• Riferimento configurazione OmniaKey Cline
• Catalogo modelli OmniaKey