Errori comuni e risoluzione dei problemi di accesso
401 / invalid_api_key
Verifica che la richiesta venga inviata al Base URL di questo sito e che Authorization utilizzi Bearer sk-.... Controlla che la chiave sia completa, non sia stata revocata e appartenga al gruppo corretto.
404 / modello non trovato
Controlla, nell'ordine, l'ID del modello, l'indirizzo del protocollo e il gruppo della chiave. OpenAI Compatible usa generalmente un indirizzo con /v1; Claude Code usa generalmente l'indirizzo di base senza /v1.
403 o blocco del controllo dei rischi
Imposta un User-Agent esplicito negli script per ridurre il rischio che il gateway blocchi richieste con User-Agent vuoto. Non tentare di aggirare le restrizioni ripetendo continuamente le richieste.
Richieste lente
Prova prima con domande brevi. Se le domande brevi sono veloci ma le attività complesse sono lente, la causa è generalmente la lunghezza del contesto o il tempo di inferenza del modello. Se anche le domande brevi sono lente, controlla la rete locale, la connessione e lo stato del servizio.
Connesso, ma il client non mostra modifiche
Chiudi completamente il client e riaprilo. Verifica la presenza di più file di configurazione, variabili d'ambiente precedenti che sovrascrivono le nuove impostazioni o un fornitore non effettivamente abilitato in CC Switch.
Controlli prima dell'avvio
- Verifica chiave, Base URL e modello con una richiesta minima.
- Imposta limiti per timeout, tentativi, concorrenza e budget.
- Prepara connessioni o modelli di riserva.
- Oscura i dati sensibili nei log; non registrare mai la chiave completa.