Claude Code serie tutorial 6: Come autenticarsi - Accesso tramite browser e configurazione manuale della chiave API

Processo di autenticazione: accesso tramite browser e configurazione manuale della chiave API

Dopo aver installato Claude Code, è necessario autenticarsi per poterlo utilizzare. Devi collegare lo strumento al tuo account Anthropic. Ci sono due modi: accesso tramite browser e configurazione manuale della chiave API. Entrambi i metodi portano allo stesso risultato, scegli quello che preferisci.

Metodo 1: Accesso tramite browser (consigliato)

Claude Code fornisce un comando di autenticazione automatica claude login che apre il browser, ti permette di autorizzare sul web e scrive automaticamente le credenziali nel terminale.

Passaggi:

Nel terminale, digita:

bash claude login

Il sistema mostrerà un messaggio e aprirà automaticamente la pagina di autorizzazione di Anthropic nel tuo browser predefinito.
Se non si apre automaticamente, il terminale stamperà un link che puoi copiare e aprire manualmente nel browser.
Accedi al tuo account Anthropic nel browser (se già connesso, questa pagina richiederà direttamente l'autorizzazione).
Fai clic su "Consenti" o "Autorizza", la pagina del browser mostrerà "Autorizzazione riuscita, puoi chiudere questa pagina".
Torna al terminale: vedrai un messaggio di autenticazione completata. Ora eseguendo il comando claude, sarà associato al tuo account.

Metodo 2: Configurazione manuale della chiave API

Se stai usando un server senza interfaccia grafica, un contenitore, o non vuoi passare per l'autorizzazione del browser, puoi ottenere una chiave API dalla console Anthropic e configurarla in Claude Code.

Passaggi:

Apri il browser, visita https://console.anthropic.com, accedi al tuo account Anthropic.
Vai alla pagina API Keys (solitamente in Impostazioni o Opzioni sviluppatore), fai clic su "Crea chiave API".
Dai un nome alla chiave (es. claude-code-local), e copiala subito dopo averla generata.
Nota: questa chiave viene mostrata una sola volta; se chiudi la pagina non sarà più visibile. Se dimentichi di salvarla, elimina quella vecchia e generane una nuova.
Torna al terminale, ci sono due modi per fornire la chiave a Claude Code:

A. Variabile d'ambiente:

bash export ANTHROPIC_API_KEY=la-tua-chiave-api

Aggiungi questa riga al tuo ~/.bashrc o ~/.zshrc per renderla persistente.

B. Scrittura in un file di configurazione:

Claude Code legge anche il suo file di configurazione. Modifica manualmente ~/.claude/config.json (crealo se non esiste), inserendo:

json { "apiKey": "la-tua-chiave-api" }

Nota: si consiglia di impostare i permessi del file a 600 (chmod 600 ~/.claude/config.json) per evitare che altri utenti lo leggano.

Test della connessione:

bash claude "Ciao, rispondi con 'OK'"

Se ricevi una risposta normale, la chiave è configurata correttamente.

Errori comuni nella configurazione manuale:

La chiave non inizia con sk-ant- o sk-? No, la chiave API di Anthropic inizia effettivamente con sk-ant-api03- ed è una lunga stringa. Quando copi, non omettere caratteri.
Se imposti sia la variabile d'ambiente che il file, la variabile d'ambiente ha priorità più alta. Tienine solo una per evitare confusione.
La chiave è un credenziale a pagamento, non commetterla in un repository Git. Si consiglia di ignorare l'intera directory ~/.claude o il file di configurazione tramite .gitignore.

Cambiare account o disconnettersi

Se vuoi cambiare account o cancellare le credenziali locali:

Se hai usato claude login: esegui claude logout, poi di nuovo claude login.
Se hai configurato manualmente la chiave: elimina la vecchia chiave dalla variabile d'ambiente o dal file di configurazione e sostituiscila con quella nuova.

Verificare che l'autenticazione funzioni

claude "Spiega a cosa serve la directory corrente"

Se riesce a leggere il tuo progetto, significa che l'ambiente è pronto.