Errore "Invalid Anthropic key" al salvataggio
Quando clicchi su Salva nella barra di salvataggio della pagina Chiave API, Olvio prima ripulisce la chiave che hai incollato e verifica che abbia il formato di una chiave Anthropic. Poi invia ad Anthropic una richiesta di test molto piccola con il modello selezionato in Modello Claude. Se uno di questi controlli non va a buon fine, non viene salvato nulla e Olvio mostra un messaggio di errore. Il messaggio compare solo per pochi istanti in fondo alla pagina. Se scompare prima che tu riesca a leggerlo, clicca di nuovo su Salva nella barra di salvataggio. Questo articolo spiega i messaggi che puoi vedere e come risolverli. Per collegare una chiave per la prima volta, consulta Connetti la tua chiave API Anthropic (Claude).
Questi messaggi di errore vengono sempre mostrati in inglese, qualunque sia la lingua del tuo pannello di amministrazione Olvio.
"Invalid Anthropic key. Please check it and try again."
Anthropic ha rifiutato la chiave stessa. La chiave potrebbe essere digitata male, incompleta, disattivata, eliminata o scaduta, oppure potrebbe non avere l'autorizzazione a usare l'API Claude nel suo workspace. Una chiave smette di funzionare anche quando la persona o l'account di servizio a cui è collegata non ha più accesso alla tua organizzazione o al tuo workspace Anthropic.
Nella Claude Console, apri Settings → API keys. La Claude Console si trova su platform.claude.com (console.anthropic.com, l'indirizzo citato nei messaggi di Olvio, reindirizza lì).
Trova la chiave e verifica che sia attiva e non scaduta. Puoi riattivare una chiave disattivata con Re-enable. Una chiave scaduta non può essere riattivata.
Se la chiave è scaduta o è stata eliminata, o se non sei sicuro che sia quella giusta, clicca su Create key. Scegli una scadenza adatta a quanto a lungo vuoi che Olvio continui a funzionare: non potrà essere modificata in seguito e, una volta scaduta la chiave, la chat smette di rispondere finché non salvi una nuova chiave. Limita la chiave a un solo workspace, poi copia la nuova chiave.
In Olvio, incolla la chiave nel campo Chiave API e clicca su Salva nella barra di salvataggio.
Se Anthropic rifiuta anche una chiave appena creata, controlla gli accessi della tua organizzazione e le impostazioni del workspace nella Claude Console. Se più persone gestiscono il tuo account Anthropic, imposta Linked account su un account di servizio quando crei la chiave, così la chiave non smette di funzionare quando una persona se ne va. Gli account di servizio vengono creati da un amministratore dell'organizzazione nella Claude Console.
"The key doesn't look like an Anthropic API key"
Olvio mostra questo messaggio prima di contattare Anthropic, quando ciò che hai incollato non ha il formato di una chiave Anthropic. Una chiave Anthropic inizia con sk-ant- e contiene solo lettere, cifre, trattini e trattini bassi.
Olvio rimuove già da ciò che incolli gli spazi (compresi quelli a larghezza zero e quelli non separabili), gli a capo e le virgolette tipografiche, e trasforma le lineette lunghe in trattini. Se vedi comunque questo messaggio, le cause più probabili sono:
La chiave proviene da un altro servizio, non da Anthropic.
Manca una parte della chiave, oppure insieme alla chiave è stato copiato del testo in più, come virgolette dritte o un nome o un'etichetta davanti alla chiave.
La chiave è stata copiata passando da Word, Notion o un'email formattata, che possono sostituire alcuni caratteri con altri dall'aspetto simile.
Incolla di nuovo la chiave dal punto in cui l'hai conservata quando l'hai creata, senza copiarla attraverso un documento formattato. La Claude Console mostra una chiave una sola volta, quindi se non ce l'hai più, crea una nuova chiave in Settings → API keys.
Se invece vedi "Please enter an API key.", non è stato incollato nulla di utilizzabile (ad esempio solo spazi) e non è ancora salvata nessuna chiave. Copia di nuovo la chiave e incollala nel campo Chiave API.
"Anthropic rejected this model for your account"
Anthropic ha rifiutato la richiesta di test, e il modello non è sempre la causa. Quando Anthropic indica un motivo, il messaggio lo riporta subito dopo i due punti, ed è quel motivo a dirti cosa correggere. Il suggerimento finale di provare un altro modello Claude è aggiunto da Olvio e serve solo quando il motivo riguarda il modello:
Il motivo indica che il modello selezionato non è disponibile per la tua organizzazione. Scegli Claude Haiku 4.5 — il più veloce, costo più basso (consigliato) in Modello Claude e clicca su Salva nella barra di salvataggio. Se invece la barra di salvataggio si chiude, Claude Haiku 4.5 è già il tuo modello salvato e non c'è nulla da salvare.
Il tuo utilizzo ha raggiunto un limite di spesa che hai impostato per la tua organizzazione o il tuo workspace Anthropic. In questo caso il motivo inizia con "You have reached your specified". Cambiare modello non servirà. Per un limite dell'organizzazione, apri Settings → Billing nella Claude Console, clicca su Adjust limit nella sezione Spend limits e aumenta il limite. Se il motivo cita il tuo workspace, apri Settings → Workspaces, seleziona il workspace e aumenta il limite nella sua scheda Spend limits. Poi salva di nuovo.
Il motivo cita il saldo dei crediti. Cambiare modello non servirà: aggiungi crediti come descritto più sotto in Il tuo account Anthropic ha esaurito i crediti, poi salva di nuovo.
Il motivo dice "anthropic-workspace-id is required". La tua chiave non è limitata a un solo workspace (vale anche se la tua organizzazione ha un solo workspace) e le richieste di Olvio non indicano alcun workspace. Crea una chiave limitata a un solo workspace, poi incollala in Olvio.
Se il messaggio non indica alcun motivo ("Anthropic rejected this model for your account. Your tier may not allow this model…"), scegli Claude Haiku 4.5 — il più veloce, costo più basso (consigliato) in Modello Claude e clicca una volta su Salva nella barra di salvataggio. Se invece la barra di salvataggio si chiude, Claude Haiku 4.5 è già il tuo modello salvato, ma la causa potrebbe comunque riguardare la chiave salvata: controlla i limiti di spesa e il saldo dei crediti nella Claude Console, oppure incolla la chiave nel campo Chiave API e clicca su Salva per testarla con Haiku. Se il salvataggio continua a non riuscire, controlla i limiti di spesa e il saldo dei crediti nella Claude Console, poi contattaci. Consulta Contattaci e orari di supporto.
Anthropic ha restituito un codice di errore HTTP
Il messaggio dice, ad esempio, "Anthropic returned HTTP 402. Please retry; if it persists, contact Olvio support with this code." Anthropic ha risposto con un errore che non ha un messaggio dedicato in Olvio, e il codice ti indica di che tipo di problema si tratta. 402 significa che Anthropic ha rilevato un problema con i tuoi dati di fatturazione o di pagamento: controlla i dati di pagamento nella Claude Console, poi salva di nuovo.
Se il messaggio continua a comparire, contattaci indicando il codice. Consulta Contattaci e orari di supporto.
Il tuo account Anthropic ha esaurito i crediti
A meno che Anthropic non fatturi mensilmente la tua organizzazione, l'utilizzo dell'API Claude si paga con crediti prepagati. Quando il saldo dei crediti si esaurisce, Anthropic rifiuta tutte le richieste, qualunque sia il modello, finché non ne aggiungi altri. Anche la richiesta di test di Olvio viene rifiutata, quindi il salvataggio non riesce e compare uno dei messaggi di questo articolo. Se il salvataggio continua a non riuscire, controlla il saldo:
Accedi alla Claude Console con un ruolo Admin o Billing e apri Settings → Billing.
Clicca su Buy credits e inserisci l'importo che desideri. Per evitare che il saldo si esaurisca di nuovo, clicca su Edit nella sezione Auto-reload e attivalo.
In Olvio, clicca di nuovo su Salva nella barra di salvataggio.
Errori temporanei
Questi messaggi non significano che la tua chiave sia sbagliata:
"Anthropic rate-limited the validation request." La chiave potrebbe essere valida. Aspetta un minuto e salva di nuovo. Se continua a non riuscire, la tua organizzazione Anthropic potrebbe aver raggiunto il tetto di spesa mensile del suo livello di utilizzo. In questo caso Anthropic rifiuta le richieste fino al primo giorno del mese successivo, a meno che il tuo limite non venga aumentato prima. Per chiedere ad Anthropic un tetto più alto, usa Request rate limit increase nella pagina Rate limits della Claude Console.
"Anthropic is currently unavailable. Try again in a moment." Il problema è dal lato di Anthropic, quindi non devi cambiare la chiave. Salva di nuovo tra poco.
"Could not save your key. Try again in a moment." Si è verificato un problema imprevisto, ad esempio Anthropic ha impiegato troppo tempo a rispondere. Salva di nuovo.
"Too many requests. Try again in a moment." Olvio limita il numero di richieste che il tuo negozio può effettuare in poco tempo, comprese quelle degli acquirenti sul tuo negozio online. Aspetta un momento, poi salva di nuovo.
Quando cambi solo il modello
Se hai già salvato una chiave e scegli un altro modello senza incollare una chiave, Olvio testa la chiave salvata con il nuovo modello prima di salvare. Anche in questo caso possono comparire i messaggi di Anthropic descritti sopra. Un ulteriore messaggio può comparire solo qui:
"Could not read your saved key. Re-enter it to switch models." Incolla la chiave nel campo Chiave API, oppure crea una nuova chiave nella Claude Console se non ce l'hai più. Lascia selezionato il modello che vuoi e clicca su Salva nella barra di salvataggio.
Per scegliere un modello e vedere a cosa serve, consulta Scegli il tuo modello Claude.
Cosa succede alla chiave salvata quando il salvataggio non riesce
Olvio non salva mai una chiave che non ha superato il controllo. Se una chiave era già salvata, resta in uso, il badge Stato mostra ancora Connessa e il modello salvato non cambia. La pagina conserva ciò che hai digitato perché tu possa correggerlo, e il menu Modello Claude continua a mostrare il modello che hai scelto anche se non è stato salvato. Per cancellare ciò che hai digitato e tornare al modello salvato, clicca su Scarta nella barra di salvataggio. Quando il salvataggio riesce, vedi Impostazioni salvate.
Se la chiave smette di funzionare dopo il salvataggio
Olvio controlla la chiave solo quando la salvi. Il badge Connessa indica che una chiave è salvata, non che Anthropic la accetti ancora. Gli acquirenti vedono Siamo spiacenti, si è verificato un errore. Riprova. nella chat (o la sua traduzione su un negozio online in un'altra lingua), ad esempio in questi casi:
La chiave è disattivata, eliminata o scaduta.
La persona o l'account di servizio a cui è collegata la chiave non ha più accesso alla tua organizzazione o al tuo workspace Anthropic.
Il saldo dei crediti si esaurisce.
Anthropic rifiuta le richieste per altri motivi legati alla fatturazione, perché è stato raggiunto un limite di spesa o perché la tua organizzazione ha raggiunto il tetto di spesa mensile del suo livello di utilizzo.
Per risolvere, correggi il problema nella Claude Console, oppure crea una nuova chiave, incollala nella pagina Chiave API e clicca su Salva nella barra di salvataggio. La chat risponde "Siamo spiacenti, si è verificato un errore. Riprova." elenca altre cause di questo messaggio nella chat.