> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Autenticazione
> Accedi a Claude Code e configura l'autenticazione per singoli utenti, team e organizzazioni.
Claude Code supporta molteplici metodi di autenticazione a seconda della Vostra configurazione. I singoli utenti possono accedere con un account Claude.ai, mentre i team possono utilizzare Claude for Teams o Enterprise, la Claude Console, o un provider cloud come Amazon Bedrock, Google Vertex AI, o Microsoft Foundry.
Accedi a Claude Code
Dopo aver [installato Claude Code](/it/setup#install-claude-code), eseguite `claude` nel vostro terminale. Al primo avvio, Claude Code apre una finestra del browser per consentirvi di accedere.
Se il browser non si apre automaticamente, premete `c` per copiare l'URL di accesso negli appunti, quindi incollatelo nel vostro browser.
Se il vostro browser mostra un codice di accesso invece di reindirizzarvi dopo aver effettuato l'accesso, incollatelo nel terminale al prompt `Paste code here if prompted`. Questo accade quando il browser non riesce a raggiungere il server di callback locale di Claude Code, il che è comune in WSL2, sessioni SSH e container.
Potete autenticarvi con uno di questi tipi di account:
* **Sottoscrizione Claude Pro o Max**: accedete con il vostro account Claude.ai. Sottoscrivete su [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).
* **Claude for Teams o Enterprise**: accedete con l'account Claude.ai che l'amministratore del vostro team vi ha invitato a utilizzare.
* **Claude Console**: accedete con le vostre credenziali Console. L'amministratore deve avervi [invitato](#claude-console-authentication) prima.
* **Provider cloud**: se la vostra organizzazione utilizza [Amazon Bedrock](/it/amazon-bedrock), [Google Vertex AI](/it/google-vertex-ai), o [Microsoft Foundry](/it/microsoft-foundry), impostate le variabili di ambiente richieste prima di eseguire `claude`. Non è necessario alcun accesso tramite browser.
* **Cloud gateway**: se la vostra organizzazione esegue un [gateway di app Claude](/it/claude-apps-gateway) auto-ospitato, accedete con SSO aziendale tramite `/login`. Il token emesso dal gateway è l'unica credenziale della sessione.
Per disconnettervi e autenticarvi di nuovo, digitate `/logout` al prompt di Claude Code.
Se avete difficoltà ad accedere, consultate la sezione [risoluzione dei problemi di autenticazione](/it/troubleshoot-install#login-and-authentication).
Configurare l'autenticazione del team
Per team e organizzazioni, potete configurare l'accesso a Claude Code in uno di questi modi:
* [Claude for Teams o Enterprise](#claude-for-teams-or-enterprise), consigliato per la maggior parte dei team
* [Claude Console](#claude-console-authentication)
* [Claude apps gateway](/it/claude-apps-gateway), un gateway auto-ospitato che consente ai sviluppatori di accedere con il vostro IdP e instrada l'inferenza al provider cloud che configurate
* [Amazon Bedrock](/it/amazon-bedrock)
* [Google Vertex AI](/it/google-vertex-ai)
* [Microsoft Foundry](/it/microsoft-foundry)
Claude for Teams o Enterprise
[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) e [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) offrono la migliore esperienza per le organizzazioni che utilizzano Claude Code. I membri del team ottengono accesso sia a Claude Code che a Claude sul web con fatturazione centralizzata e gestione del team.
* **Claude for Teams**: piano self-service con funzionalità di collaborazione, strumenti di amministrazione e gestione della fatturazione. Ideale per team più piccoli.
* **Claude for Enterprise**: aggiunge SSO, domain capture, autorizzazioni basate su ruoli, API di conformità e impostazioni di policy gestite per configurazioni Claude Code a livello organizzativo. Ideale per organizzazioni più grandi con requisiti di sicurezza e conformità.
Sottoscrivete a [Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams_step#team-&-enterprise) o contattate il team di vendita per [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise_step).
Invitate i membri del team dalla dashboard di amministrazione.
I membri del team installano Claude Code e accedono con i loro account Claude.ai.
Autenticazione Claude Console
Per le organizzazioni che preferiscono la fatturazione basata su API, potete configurare l'accesso tramite la Claude Console.
Utilizzate il Vostro account Claude Console esistente o createne uno nuovo.
Potete aggiungere utenti tramite uno dei due metodi:
* Invitate utenti in massa dalla Console: Settings -> Members -> Invite
* [Configurate SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)
Quando invitate utenti, assegnate uno dei seguenti:
* **Ruolo Claude Code**: gli utenti possono solo creare chiavi API Claude Code
* **Ruolo Developer**: gli utenti possono creare qualsiasi tipo di chiave API
Ogni utente invitato deve:
* Accettare l'invito Console
* [Controllare i requisiti di sistema](/it/setup#system-requirements)
* [Installare Claude Code](/it/setup#install-claude-code)
* Accedere con le credenziali dell'account Console
Autenticazione del provider cloud
Per i team che utilizzano Amazon Bedrock, Google Vertex AI, o Microsoft Foundry:
Seguite la [documentazione Bedrock](/it/amazon-bedrock), la [documentazione Vertex](/it/google-vertex-ai), o la [documentazione Microsoft Foundry](/it/microsoft-foundry).
Distribuite le variabili di ambiente e le istruzioni per generare credenziali cloud ai Vostri utenti. Leggete di più su come [gestire la configurazione qui](/it/settings).
Gli utenti possono [installare Claude Code](/it/setup#install-claude-code).
Gestione delle credenziali
Claude Code gestisce in modo sicuro le Vostre credenziali di autenticazione:
* **Posizione di archiviazione**:
* Su macOS, le credenziali sono archiviate nel Keychain macOS crittografato.
* Su Linux, le credenziali sono archiviate in `~/.claude/.credentials.json` con modalità file `0600`.
* Su Windows, le credenziali sono archiviate in `%USERPROFILE%\.claude\.credentials.json` e ereditano i controlli di accesso della directory del profilo utente, che limita il file al Vostro account utente per impostazione predefinita.
* Se avete impostato la variabile di ambiente `CLAUDE_CONFIG_DIR` su Linux o Windows, il file `.credentials.json` si trova in quella directory.
* Claude Code gestisce `.credentials.json` attraverso `/login` e `/logout`. Per instradare le richieste attraverso un endpoint API personalizzato, impostate invece la variabile di ambiente [`ANTHROPIC_BASE_URL`](/it/env-vars).
* **Tipi di autenticazione supportati**: credenziali Claude.ai, credenziali API Claude, Azure Auth, Bedrock Auth, Vertex Auth, e token di sessione del [gateway delle app Claude](/it/claude-apps-gateway).
* **Script di credenziali personalizzati**: l'impostazione [`apiKeyHelper`](/it/settings#available-settings) può essere configurata per eseguire uno script shell che restituisce una chiave API.
* **Intervalli di aggiornamento**: per impostazione predefinita, `apiKeyHelper` viene chiamato dopo 5 minuti o in risposta a HTTP 401. Impostate la variabile di ambiente `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` per intervalli di aggiornamento personalizzati.
* **Avviso di helper lento**: se `apiKeyHelper` impiega più di 10 secondi per restituire una chiave, Claude Code visualizza un avviso nella barra del prompt mostrando il tempo trascorso. Se vedete questo avviso regolarmente, verificate se lo script di credenziali può essere ottimizzato.
`apiKeyHelper`, `ANTHROPIC_API_KEY`, e `ANTHROPIC_AUTH_TOKEN` si applicano alla CLI e alle superfici che la avvolgono, inclusa l'estensione VS Code, l'Agent SDK, e GitHub Actions. Claude Desktop e le sessioni cloud non chiamano `apiKeyHelper` né leggono queste variabili di ambiente: utilizzano OAuth, ad eccezione delle sessioni desktop che eseguono una [configurazione di inferenza di terze parti distribuita dall'organizzazione](/it/llm-gateway-connect#desktop-app), che si autenticano con le credenziali di quella configurazione.
Precedenza di autenticazione
Quando sono presenti più credenziali, Claude Code ne sceglie una in questo ordine:
1. Credenziali del provider cloud, quando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, o `CLAUDE_CODE_USE_FOUNDRY` è impostato. Consultate [integrazioni di terze parti](/it/third-party-integrations) per la configurazione.
2. Variabile di ambiente `ANTHROPIC_AUTH_TOKEN`. Inviata come header `Authorization: Bearer`. Utilizzatela quando si instrada attraverso un [gateway LLM o proxy](/it/llm-gateway) che si autentica con bearer token anziché chiavi API Anthropic.
3. Variabile di ambiente `ANTHROPIC_API_KEY`. Inviata come header `X-Api-Key`. Utilizzatela per l'accesso diretto all'API Anthropic con una chiave dalla [Claude Console](https://platform.claude.com). In modalità interattiva, vi viene chiesto una volta di approvare o rifiutare la chiave, e la Vostra scelta viene ricordata. Per cambiarla in seguito, utilizzate l'interruttore "Use custom API key" in `/config`. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente.
4. Output dello script [`apiKeyHelper`](/it/settings#available-settings). Utilizzatelo per credenziali dinamiche o rotanti, come token di breve durata recuperati da un vault.
5. Variabile di ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth di lunga durata generato da [`claude setup-token`](#generate-a-long-lived-token). Utilizzatelo per pipeline CI e script dove l'accesso tramite browser non è disponibile.
6. Credenziali OAuth di sottoscrizione da `/login`. Questo è il valore predefinito per gli utenti Claude Pro, Max, Team, ed Enterprise.
Una sessione del [gateway delle app Claude](/it/claude-apps-gateway) autenticata si trova al di fuori di questo elenco: è una selezione di provider come Bedrock o Vertex, e ha la precedenza su di essi. Quando esiste una sessione gateway, la CLI si autentica con il token gateway anche se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, o `CLAUDE_CODE_USE_FOUNDRY` è impostato, e le voci bearer token, chiave API e `apiKeyHelper` sopra non vengono utilizzate.
Se avete una sottoscrizione Claude attiva ma avete anche `ANTHROPIC_API_KEY` impostato nel Vostro ambiente, la chiave API ha la precedenza una volta approvata. Questo può causare errori di autenticazione se la chiave appartiene a un'organizzazione disabilitata o scaduta. Eseguite `unset ANTHROPIC_API_KEY` per tornare alla Vostra sottoscrizione, e controllate `/status` per confermare quale metodo è attivo.
[Claude Code sul Web](/it/claude-code-on-the-web) utilizza sempre le Vostre credenziali di sottoscrizione. `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN` nell'ambiente sandbox non le sovrascrivono.
Generare un token di lunga durata
Per pipeline CI, script, o altri ambienti dove l'accesso interattivo tramite browser non è disponibile, generate un token OAuth di un anno con `claude setup-token`:
```bash theme={null}
claude setup-token
```
Il comando vi guida attraverso l'autorizzazione OAuth e stampa un token nel terminale. Non salva il token da nessuna parte; copiatelo e impostatelo come variabile di ambiente `CLAUDE_CODE_OAUTH_TOKEN` ovunque vogliate autenticarvi:
```bash theme={null}
export CLAUDE_CODE_OAUTH_TOKEN=your-token
```
Questo token si autentica con la Vostra sottoscrizione Claude e richiede un piano Pro, Max, Team, o Enterprise. È limitato solo all'inferenza e non può stabilire sessioni di [Remote Control](/it/remote-control).
[Bare mode](/it/headless#start-faster-with-bare-mode) non legge `CLAUDE_CODE_OAUTH_TOKEN`. Se il Vostro script passa `--bare`, autenticatevi con `ANTHROPIC_API_KEY` o un `apiKeyHelper` invece.