Come usare Claude in modo ufficiale con Claude Code Setup

Per usare Claude Code in modo ufficiale servono tre passaggi: un piano a pagamento, perché il piano gratuito non lo include, e il più economico è Pro a 20 dollari al mese o 17 dollari con fatturazione annuale; poi il comando di installazione ufficiale di claude.ai per il tuo sistema; infine l'accesso dal browser al primo avvio. L'Arabia Saudita è nell'elenco delle regioni supportate da Anthropic, quindi non ti servono intermediari né account presi in prestito. Dopo, installa il plugin Claude Code Setup dal marketplace ufficiale, così legge il tuo progetto e consiglia la configurazione giusta senza modificare un solo file.

Perché proprio la via ufficiale?

La politica sulle regioni supportate di Anthropic stabilisce che i suoi prodotti, tra cui le app web, Claude Code e l'API, sono disponibili solo nei Paesi elencati, e l'Arabia Saudita è nell'elenco insieme a Emirati Arabi Uniti, Kuwait, Qatar, Bahrein e Oman. La stessa politica considera non supportato l'uso da un Paese non elencato, anche quando l'account appartiene a un ente supportato. Se ti trovi nel Regno e usi il tuo account, sei sulla strada giusta, e non c'è motivo di ricorrere a scorciatoie che possono far sospendere l'account.

C'è un secondo motivo: l'installer ufficiale aggiorna lo strumento in automatico in background, così le correzioni di sicurezza ti arrivano appena escono. I plugin, invece, possono eseguire comandi automatici e server di connessione esterni sul tuo computer, perciò la documentazione ufficiale consiglia di leggere i dettagli di un plugin prima di installarlo, e il punto di partenza più sicuro è il marketplace ufficiale di Anthropic.

Cosa ti serve prima dell'installazione?

Secondo la pagina ufficiale di configurazione, questi sono i requisiti:

Quanto costa Claude Code?

Lo strumento si scarica gratis, ma per usarlo serve un account a pagamento. Questi sono i piani come appaiono nella pagina ufficiale dei prezzi:

Per un singolo, Pro basta per iniziare. Per un'azienda, la guida all'autenticazione consiglia Team o Enterprise, perché riunisce fatturazione e permessi in un unico pannello e permette di imporre le stesse impostazioni a tutti gli sviluppatori.

Come si installa Claude Code passo dopo passo?

Apri un terminale e incolla il comando per il tuo sistema. I comandi qui sotto sono copiati alla lettera dalla documentazione ufficiale, e nessuno richiede diritti di amministratore.

Su Mac, Linux o WSL

curl -fsSL https://claude.ai/install.sh | bash

Su Windows

In PowerShell, che riconosci dal PS prima del percorso:

irm https://claude.ai/install.ps1 | iex

E in CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

La documentazione consiglia di installare Git for Windows perché lo strumento possa eseguire comandi Bash; senza, funziona tramite PowerShell.

Con Homebrew o WinGet

Puoi anche installare con brew install --cask claude-code su Mac, oppure winget install Anthropic.ClaudeCode su Windows. Tieni presente che questi due metodi non aggiornano lo strumento in automatico, quindi il comando di aggiornamento lo lanci tu, e che la versione stabile di Homebrew di solito è indietro di circa una settimana rispetto all'ultima versione.

L'installer non mostra una barra di avanzamento durante il download, quindi non preoccuparti se sembra fermo. Al termine, apri una nuova finestra del terminale prima del passaggio successivo.

Come accedi con il tuo account?

1. Vai nella cartella del tuo progetto dal terminale e digita claude.
2. Lo strumento apre una finestra del browser per accedere con il tuo account claude.ai. Se non si apre, premi c per copiare il link e incollalo nel browser.
3. Se il browser mostra un codice invece di reindirizzarti, incollalo nel terminale alla riga Paste code here if prompted. Succede di solito in WSL2, nelle sessioni SSH o nei container.
4. Quando compare Login successful, premi Invio e inizia a lavorare.

Per uscire, digita /logout nella sessione. Se hai un account di lavoro e uno personale, il modo ufficiale è dare a ciascun account la propria cartella di impostazioni con la variabile CLAUDE_CONFIG_DIR, come in questo alias:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Come verifichi che l'installazione sia corretta?

claude --version
claude doctor

Il primo comando stampa il numero di versione, per esempio 2.1.211, e il secondo controlla l'installazione e i file di impostazioni senza aprire una sessione, mostrando ogni avviso con la relativa soluzione.

Che cos'è il plugin Claude Code Setup?

Claude Code Setup è un plugin ufficiale di Anthropic nel marketplace dei plugin che analizza il tuo progetto e consiglia le automazioni più adatte. Legge file come package.json, la struttura delle cartelle e il linguaggio di programmazione, poi mostra il miglior suggerimento o i due migliori in ognuna di cinque categorie, come spiega il suo repository ufficiale:

La cosa più importante è che funziona in sola lettura: suggerisce e non cambia nulla nei tuoi file, quindi la decisione resta a te. Se gli chiedi di una sola categoria, allarga la scelta a tre-cinque opzioni.

Come si installa e si usa il plugin Claude Code Setup?

1. Avvia claude nel tuo progetto, poi digita:

/plugin install claude-code-setup@claude-plugins-official

2. Si apre il pannello dei dettagli del plugin: cosa aggiungerà, quando è stato aggiornato l'ultima volta e quanto contesto usa. Leggilo prima di accettare.
3. Scegli l'ambito di installazione: per te in tutti i tuoi progetti, per tutti quelli che lavorano su questo repository, o solo per te in questo repository.
4. Dopo l'installazione, scrivi una richiesta come recommend automations for this project, oppure chiedi: what hooks should I use?

La pagina ufficiale dei plugin spiega che il plugin può richiedere un ricaricamento con /reload-plugins se il riepilogo dell'installazione lo indica.

Quali sono gli errori di installazione più comuni e come si risolvono?

• claude not found: la cartella di installazione non è ancora nel PATH. Apri una nuova finestra del terminale e, se l'errore resta, consulta la sezione della documentazione su come correggere il PATH.
• The token '&&' is not a valid statement separator: sei in PowerShell e stai usando il comando per CMD, quindi usa quello per PowerShell.
• 'irm' is not recognized: il contrario, sei in CMD e stai usando il comando per PowerShell.
• Piano gratuito: accedere con un account gratuito non basta, perché Claude Code non è incluso.
• Versione vecchia: se hai installato con Homebrew o WinGet, aggiorna a mano con brew upgrade claude-code oppure winget upgrade Anthropic.ClaudeCode.

E se la riga di comando proprio non ti piace, l'app desktop ufficiale offre Claude Code con interfaccia grafica su Mac, Windows e Linux. Abbiamo raccontato le ultime novità dello strumento in Le novità di Claude Code, agosto 2026.

Fonti

• Documentazione di Claude Code: configurazione e requisiti di sistema
• Documentazione di Claude Code: autenticazione
• Documentazione di Claude Code: installare e gestire i plugin
• Claude Code Setup nel marketplace di Claude
• Il plugin nel repository GitHub ufficiale di Anthropic
• Prezzi dei piani di Claude
• Politica sulle regioni supportate di Anthropic