Claude Code 401 e 403: credenziali di autenticazione non valide, chiave API non valida, "Accesso non effettuato", host_not_allowed

I messaggi

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}
API Error: 401 invalid x-api-key
Invalid API key · Fix external API key
Not logged in · Please run /login
Login expired · Please run /login
API Error: 403 x-deny-reason: host_not_allowed
Error: Poll: Access denied (403): Account is no longer a member of the organization associated with this token.

Passaggio 1: quale credenziale viene inviata?

claude
/status                       # auth method, endpoint, model
echo $ANTHROPIC_API_KEY | cut -c1-12
echo $ANTHROPIC_BASE_URL
grep -n apiKeyHelper ~/.claude/settings.json

L'ordine di precedenza è semplice, una volta che lo conosci: un ANTHROPIC_API_KEY nell'ambiente (o il valore restituito da apiKeyHelper) viene usato al posto dell'accesso OAuth. Una chiave obsoleta esportata in .bashrc mesi fa, o una chiave di un altro gateway, è la causa tipica di un errore 401 che persiste dopo ogni /login. Rimuovila dall'ambiente oppure imposta quella corretta.

401 con una chiave API: chiave ed endpoint non corrispondono

invalid x-api-key e Invalid API key · Fix external API key significano che l'endpoint non ha riconosciuto la chiave. Una chiave appartiene a un solo endpoint: una chiave della console Anthropic funziona solo con api.anthropic.com; una chiave del gateway funziona solo con il relativo ANTHROPIC_BASE_URL. Inviare una chiave della console a https://aiprimetech.io o una chiave del gateway ad Anthropic restituisce in entrambi i casi 401. Controlla anche che nella variabile non sia stato incollato un carattere di nuova riga o una virgoletta finale e che la chiave non sia stata revocata o sostituita nella dashboard.

curl -s https://aiprimetech.io/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" | head -c 300
# a JSON list = key accepted; authentication_error = wrong key for this host

401 dopo /login: il token OAuth

API Error: 401 Invalid authentication credentials subito dopo un accesso riuscito tramite browser è il caso più segnalato (#69706, aperta, Windows, abbonamento Pro attivo; #44265, token segnalato come scaduto subito dopo l'accesso).

Un commentatore nella prima discussione ha scoperto che il valore salvato di refreshToken era una stringa vuota in ~/.claude/.credentials.json, il che fa sì che ogni richiesta restituisca 401 finché il file non viene sostituito tramite un nuovo accesso. #54443 documenta il rifiuto delle sessioni da parte del server prima della scadenza salvata localmente e la chiamata di rinnovo che restituisce 400, quindi Please run /login ricompare ogni poche ore; eseguire più istanze di Claude Code sullo stesso account peggiora la situazione, perché tentano contemporaneamente di rinnovare lo stesso token. #44585: /login mostra *Accesso riuscito* e torna subito a *Accesso non effettuato*.

• /logout, quindi elimina la credenziale salvata (~/.claude/.credentials.json su Linux e Windows; l'elemento *Claude Code-credentials* in Portachiavi su macOS), quindi /login in un browser senza l'estensione Claude in Chrome.
• Chiudi le altre finestre di Claude Code, l'app desktop e le estensioni dell'IDE prima di accedere: rinnovano lo stesso token. La pagina sugli errori OAuth tratta *Impossibile rinnovare il token OAuth: un altro processo di Claude Code lo sta rinnovando*.
• claude update: #54235 ha ricondotto un errore 401 a una versione specifica e a una variabile d'ambiente per un flag beta; le regressioni nell'autenticazione vengono corrette rapidamente.
• Macchina senza interfaccia grafica o accessibile via SSH: claude setup-token su una macchina in cui l'accesso tramite browser funziona, quindi usa il token sulla macchina di destinazione.
• Riuscire a lavorare subito è meglio che fare debug: con ANTHROPIC_API_KEY impostato, Claude Code non usa mai OAuth.

403: autenticazione consentita, operazione non consentita

• `x-deny-reason: host_not_allowed` — un proxy che intercetta la richiesta rifiuta la destinazione. Riscontrato con la lista dei domini consentiti per il traffico in uscita dalla sandbox web/desktop (#93562, aperta: gli host non inclusi in un elenco predefinito ricevono 403 su CONNECT anche quando è selezionato *Tutti i domini*) e con i proxy aziendali. Aggiungi l'host alla lista dei domini consentiti oppure esegui la CLI fuori dalla sandbox.
• Proxy git della sandbox 403 su git push verso un branch esistente (#57356) — dipende dalle regole del proxy git della sandbox, non da GitHub. Esegui il push da un normale terminale.
• `Account is no longer a member of the organization associated with this token` — il token è stato emesso per un'organizzazione che hai lasciato o che è cambiata; claude remote-control in passato causava l'arresto anomalo di ogni sessione in questo caso (#53563). Esci e accedi di nuovo per generare un token per l'organizzazione attuale.
• 403 da un gateway — la chiave è valida, ma l'account è disabilitato, il saldo è insufficiente per quel modello oppure il modello non è incluso nel tuo piano; il corpo della risposta specifica la causa. Controlla la dashboard prima di modificare qualsiasi cosa lato client.
• `/feedback` che restituisce 403 (#55348) — un'interruzione lato servizio di quel singolo endpoint; non influisce sul modello.

L'alternativa della chiave API

unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL   # back to the subscription login
# or: bypass OAuth entirely
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Una chiave del gateway è una normale chiave API: niente OAuth, rinnovo dei token o appartenenza all'organizzazione, e la famiglia di errori 401 si riduce a *la chiave corrisponde all'host?*. Se sei bloccato in un /login ciclo e devi consegnare oggi, è la via d'uscita più rapida; la tua prima ricarica in criptovaluta viene raddoppiata (+50%).

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.