1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Autenticazione

6 

7> Accedi a Claude Code e configura l'autenticazione per singoli utenti, team e organizzazioni.

8 

9Claude 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.

10 

11## Accedi a Claude Code

12 

13Dopo 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.

14 

15Se il browser non si apre automaticamente, premete `c` per copiare l'URL di accesso negli appunti, quindi incollatelo nel vostro browser.

16 

17Se 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.

18 

19Potete autenticarvi con uno di questi tipi di account:

20 

21* **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).

22* **Claude for Teams o Enterprise**: accedete con l'account Claude.ai che l'amministratore del vostro team vi ha invitato a utilizzare.

23* **Claude Console**: accedete con le vostre credenziali Console. L'amministratore deve avervi [invitato](#claude-console-authentication) prima.

24* **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.

25 

26Per disconnettervi e autenticarvi di nuovo, digitate `/logout` al prompt di Claude Code.

27 

28Se avete difficoltà ad accedere, consultate la sezione [risoluzione dei problemi di autenticazione](/it/troubleshoot-install#login-and-authentication).

29 

30## Configurare l'autenticazione del team

31 

32Per team e organizzazioni, potete configurare l'accesso a Claude Code in uno di questi modi:

33 

34* [Claude for Teams o Enterprise](#claude-for-teams-or-enterprise), consigliato per la maggior parte dei team

35* [Claude Console](#claude-console-authentication)

36* [Amazon Bedrock](/it/amazon-bedrock)

37* [Google Vertex AI](/it/google-vertex-ai)

38* [Microsoft Foundry](/it/microsoft-foundry)

39 

40### Claude for Teams o Enterprise

41 

42[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.

43 

44* **Claude for Teams**: piano self-service con funzionalità di collaborazione, strumenti di amministrazione e gestione della fatturazione. Ideale per team più piccoli.

45* **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à.

46 

47<Steps>

48 <Step title="Sottoscrivete">

49 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).

50 </Step>

51 

52 <Step title="Invitate i membri del team">

53 Invitate i membri del team dalla dashboard di amministrazione.

54 </Step>

55 

56 <Step title="Installate e accedete">

57 I membri del team installano Claude Code e accedono con i loro account Claude.ai.

58 </Step>

59</Steps>

60 

61### Autenticazione Claude Console

62 

63Per le organizzazioni che preferiscono la fatturazione basata su API, potete configurare l'accesso tramite la Claude Console.

64 

65<Steps>

66 <Step title="Creare o utilizzare un account Console">

67 Utilizzate il Vostro account Claude Console esistente o createne uno nuovo.

68 </Step>

69 

70 <Step title="Aggiungere utenti">

71 Potete aggiungere utenti tramite uno dei due metodi:

72 

73 * Invitate utenti in massa dalla Console: Settings -> Members -> Invite

74 * [Configurate SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)

75 </Step>

76 

77 <Step title="Assegnare ruoli">

78 Quando invitate utenti, assegnate uno dei seguenti:

79 

80 * **Ruolo Claude Code**: gli utenti possono solo creare chiavi API Claude Code

81 * **Ruolo Developer**: gli utenti possono creare qualsiasi tipo di chiave API

82 </Step>

83 

84 <Step title="Gli utenti completano la configurazione">

85 Ogni utente invitato deve:

86 

87 * Accettare l'invito Console

88 * [Controllare i requisiti di sistema](/it/setup#system-requirements)

89 * [Installare Claude Code](/it/setup#install-claude-code)

90 * Accedere con le credenziali dell'account Console

91 </Step>

92</Steps>

93 

94### Autenticazione del provider cloud

95 

96Per i team che utilizzano Amazon Bedrock, Google Vertex AI, o Microsoft Foundry:

97 

98<Steps>

99 <Step title="Seguire la configurazione del provider">

100 Seguite la [documentazione Bedrock](/it/amazon-bedrock), la [documentazione Vertex](/it/google-vertex-ai), o la [documentazione Microsoft Foundry](/it/microsoft-foundry).

101 </Step>

102 

103 <Step title="Distribuire la configurazione">

104 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).

105 </Step>

106 

107 <Step title="Installare Claude Code">

108 Gli utenti possono [installare Claude Code](/it/setup#install-claude-code).

109 </Step>

110</Steps>

111 

112## Gestione delle credenziali

113 

114Claude Code gestisce in modo sicuro le Vostre credenziali di autenticazione:

115 

116* **Posizione di archiviazione**: su macOS, le credenziali sono archiviate nel Keychain macOS crittografato. Su Linux e Windows, le credenziali sono archiviate in `~/.claude/.credentials.json`, o sotto `$CLAUDE_CONFIG_DIR` se quella variabile è impostata. Su Linux, il file viene scritto con modalità `0600`; su Windows, eredita i controlli di accesso della directory del profilo utente.

117* **Tipi di autenticazione supportati**: credenziali Claude.ai, credenziali API Claude, Azure Auth, Bedrock Auth, e Vertex Auth.

118* **Script di credenziali personalizzati**: l'impostazione [`apiKeyHelper`](/it/settings#available-settings) può essere configurata per eseguire uno script shell che restituisce una chiave API.

119* **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.

120* **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.

121 

122`apiKeyHelper`, `ANTHROPIC_API_KEY`, e `ANTHROPIC_AUTH_TOKEN` si applicano solo alle sessioni CLI del terminale. Claude Desktop e le sessioni remote utilizzano esclusivamente OAuth e non chiamano `apiKeyHelper` né leggono variabili di ambiente della chiave API.

123 

124### Precedenza di autenticazione

125 

126Quando sono presenti più credenziali, Claude Code ne sceglie una in questo ordine:

127 

1281. 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.

1292. 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.

1303. 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.

1314. Output dello script [`apiKeyHelper`](/it/settings#available-settings). Utilizzatelo per credenziali dinamiche o rotanti, come token di breve durata recuperati da un vault.

1325. 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.

1336. Credenziali OAuth di sottoscrizione da `/login`. Questo è il valore predefinito per gli utenti Claude Pro, Max, Team, ed Enterprise.

134 

135Se 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.

136 

137[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.

138 

139### Generare un token di lunga durata

140 

141Per 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`:

142 

143```bash theme={null}

144claude setup-token

145```

146 

147Il 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:

148 

149```bash theme={null}

150export CLAUDE_CODE_OAUTH_TOKEN=your-token

151```

152 

153Questo 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).

154 

155[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.