Vai al contenuto principale

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.

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, 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.
  • 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 prima.
  • Provider cloud: se la vostra organizzazione utilizza Amazon Bedrock, Google Vertex AI, o Microsoft Foundry, impostate le variabili di ambiente richieste prima di eseguire claude. Non è necessario alcun accesso tramite browser.
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.

​
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 e Claude for 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à.
1

Sottoscrivete

Sottoscrivete a Claude for Teams o contattate il team di vendita per Claude for Enterprise.
2

Invitate i membri del team

Invitate i membri del team dalla dashboard di amministrazione.
3

Installate e accedete

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

Creare o utilizzare un account Console

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

Aggiungere utenti

Potete aggiungere utenti tramite uno dei due metodi:
  • Invitate utenti in massa dalla Console: Settings -> Members -> Invite
  • Configurate SSO
3

Assegnare ruoli

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
4

Gli utenti completano la configurazione

Ogni utente invitato deve:

​
Autenticazione del provider cloud

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

Seguire la configurazione del provider

Seguite la documentazione Bedrock, la documentazione Vertex, o la documentazione Microsoft Foundry.
2

Distribuire la configurazione

Distribuite le variabili di ambiente e le istruzioni per generare credenziali cloud ai Vostri utenti. Leggete di più su come gestire la configurazione qui.
3

Installare Claude Code

Gli utenti possono installare 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.
  • Tipi di autenticazione supportati: credenziali Claude.ai, credenziali API Claude, Azure Auth, Bedrock Auth, e Vertex Auth.
  • Script di credenziali personalizzati: l’impostazione apiKeyHelper 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 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.

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

Starting June 15, 2026, Agent SDK and claude -p usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See Use the Claude Agent SDK with your Claude plan for details.
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: 
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: 
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. Bare mode non legge CLAUDE_CODE_OAUTH_TOKEN. Se il Vostro script passa --bare, autenticatevi con ANTHROPIC_API_KEY o un apiKeyHelper invece.