Installa NodeJS 18+, poi esegui:

npm install -g @anthropic-ai/claude-code

NON usare sudo npm install -g poiché può causare problemi di permessi e rischi per la sicurezza. Se riscontri errori di permesso, consulta configura Claude Code per le soluzioni consigliate.

Claude Code è uno strumento di codifica basato su agenti che vive nel tuo terminale, comprende la tua codebase e ti aiuta a programmare più velocemente attraverso comandi in linguaggio naturale. Integrando direttamente con il tuo ambiente di sviluppo, Claude Code semplifica il tuo flusso di lavoro senza richiedere server aggiuntivi o configurazioni complesse.

Le capacità chiave di Claude Code includono:

  • Modificare file e correggere bug in tutta la tua codebase
  • Rispondere a domande sull’architettura e la logica del tuo codice
  • Eseguire e correggere test, linting e altri comandi
  • Cercare nella cronologia git, risolvere conflitti di merge e creare commit e PR

Anteprima di ricerca

Code è in beta come anteprima di ricerca. Stiamo raccogliendo feedback dagli sviluppatori sulle preferenze di collaborazione con l’IA, quali flussi di lavoro beneficiano maggiormente dell’assistenza dell’IA e come migliorare l’esperienza dell’agente.

Questa versione iniziale si evolverà in base al feedback degli utenti. Prevediamo di migliorare l’affidabilità dell’esecuzione degli strumenti, il supporto per comandi a lunga esecuzione, il rendering del terminale e l’auto-conoscenza di Claude delle sue capacità nelle prossime settimane.

Segnala bug direttamente con il comando /bug o tramite il nostro repository GitHub.


Prima di iniziare

Verifica i requisiti di sistema

  • Sistemi operativi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows tramite WSL
  • Hardware: minimo 4GB di RAM
  • Software:
    • Node.js 18+
    • git 2.23+ (opzionale)
    • GitHub o GitLab CLI per i flussi di lavoro PR (opzionale)
    • ripgrep (rg) per la ricerca avanzata di file (opzionale)
  • Rete: Connessione Internet richiesta per l’autenticazione e l’elaborazione IA
  • Posizione: Disponibile solo nei paesi supportati

Risoluzione dei problemi di installazione WSL

Attualmente, Claude Code non funziona direttamente in Windows, ma richiede WSL. Se riscontri problemi in WSL:

  1. Problemi di rilevamento OS/piattaforma: Se ricevi un errore durante l’installazione, WSL potrebbe utilizzare npm di Windows. Prova:

    • Esegui npm config set os linux prima dell’installazione
    • Installa con npm install -g @anthropic-ai/claude-code --force --no-os-check (NON usare sudo)
  2. Errori “Node not found”: Se vedi exec: node: not found quando esegui claude, il tuo ambiente WSL potrebbe utilizzare un’installazione Windows di Node.js. Puoi confermarlo con which npm e which node, che dovrebbero puntare a percorsi Linux che iniziano con /usr/ anziché /mnt/c/. Per risolvere, prova a installare Node tramite il gestore pacchetti della tua distribuzione Linux o tramite nvm.

Installa e autentica

1

Installa Claude Code

Esegui nel tuo terminale: npm install -g @anthropic-ai/claude-code

NON usare sudo npm install -g poiché può causare problemi di permessi e rischi per la sicurezza. Se riscontri errori di permesso, consulta configura Claude Code per le soluzioni consigliate.

2

Naviga al tuo progetto

cd directory-del-tuo-progetto
3

Avvia Claude Code

Esegui claude per avviarlo
4

Completa l'autenticazione

Claude Code offre due opzioni di autenticazione:

  • Anthropic Console: L’opzione predefinita. Connettiti tramite Anthropic Console e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com.

  • Piano Max: Abbonati al piano Max di Claude per un’unica sottoscrizione che include sia Claude Code che l’interfaccia web. Ottieni più valore allo stesso prezzo gestendo il tuo account in un unico posto. Accedi con il tuo account Claude.ai. Durante l’avvio, scegli l’opzione che corrisponde al tuo tipo di abbonamento.


Funzionalità principali e flussi di lavoro

Claude Code opera direttamente nel tuo terminale, comprendendo il contesto del tuo progetto e intraprendendo azioni reali. Non è necessario aggiungere manualmente file al contesto - Claude esplorerà la tua codebase secondo necessità.

Sicurezza e privacy by design

La sicurezza del tuo codice è fondamentale. L’architettura di Claude Code garantisce:

  • Connessione API diretta: Le tue query vanno direttamente all’API di Anthropic senza server intermedi
  • Funziona dove lavori tu: Opera direttamente nel tuo terminale
  • Comprende il contesto: Mantiene la consapevolezza dell’intera struttura del progetto
  • Intraprende azioni: Esegue operazioni reali come modificare file e creare commit

Dalle domande alle soluzioni in pochi secondi

# Fai domande sulla tua codebase
claude
> come funziona il nostro sistema di autenticazione?

# Crea un commit con un solo comando
claude commit

# Risolvi problemi su più file
claude "correggi gli errori di tipo nel modulo auth"

Inizializza il tuo progetto

Per i nuovi utenti, consigliamo:

  1. Avvia Claude Code con claude
  2. Prova un comando semplice come riassumi questo progetto
  3. Genera una guida CLAUDE.md per il progetto con /init
  4. Chiedi a Claude di fare il commit del file CLAUDE.md generato nel tuo repository

Usa Claude Code per attività comuni

Claude Code opera direttamente nel tuo terminale, comprendendo il contesto del tuo progetto e intraprendendo azioni reali. Non è necessario aggiungere manualmente file al contesto - Claude esplorerà la tua codebase secondo necessità.

Comprendi codice non familiare

> cosa fa il sistema di elaborazione dei pagamenti?
> trova dove vengono controllati i permessi utente
> spiega come funziona il livello di caching

Automatizza le operazioni Git

> fai il commit delle mie modifiche
> crea una pr
> quale commit ha aggiunto i test per markdown a dicembre?
> fai il rebase su main e risolvi eventuali conflitti di merge

Modifica il codice in modo intelligente

> aggiungi la convalida dell'input al modulo di registrazione
> refactorizza il logger per utilizzare la nuova API
> correggi la race condition nella coda dei worker

Testa e debug il tuo codice

> esegui i test per il modulo auth e correggi i fallimenti
> trova e correggi le vulnerabilità di sicurezza
> spiega perché questo test sta fallendo

Incoraggia un pensiero più profondo

Per problemi complessi, chiedi esplicitamente a Claude di pensare più a fondo:

> pensa a come dovremmo architettare il nuovo servizio di pagamento
> pensa attentamente ai casi limite nel nostro flusso di autenticazione

Claude Code mostrerà quando Claude sta utilizzando il pensiero esteso (disponibile su Claude Sonnet 3.7, Claude Opus 4). Puoi proattivamente invitare Claude a “pensare” o “pensare profondamente” per attività che richiedono più pianificazione. Ti suggeriamo di informare prima Claude sul tuo compito e lasciare che raccolga il contesto dal tuo progetto. Poi, chiedigli di “pensare” per creare un piano.

Claude penserà di più in base alle parole che usi. Ad esempio, “pensa attentamente” attiverà un pensiero più esteso rispetto a dire solo “pensa”.

Per ulteriori suggerimenti, consulta Suggerimenti per il pensiero esteso.

Automatizza i flussi di lavoro CI e infrastruttura

Claude Code include una modalità non interattiva per l’esecuzione headless. Questo è particolarmente utile per eseguire Claude Code in contesti non interattivi come script, pipeline e Github Actions.

Usa --print (-p) per eseguire Claude in modalità non interattiva. In questa modalità, puoi impostare la variabile d’ambiente ANTHROPIC_API_KEY per fornire una chiave API personalizzata.

La modalità non interattiva è particolarmente utile quando preconfiguri l’insieme di comandi che Claude può utilizzare:

export ANTHROPIC_API_KEY=sk_...
claude -p "aggiorna il README con le ultime modifiche" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Write --disallowedTools ...

Controlla Claude Code con i comandi

Comandi CLI

ComandoDescrizioneEsempio
claudeAvvia REPL interattivoclaude
claude "query"Avvia REPL con prompt inizialeclaude "spiega questo progetto"
claude -p "query"Esegue una query singola, poi esceclaude -p "spiega questa funzione"
cat file | claude -p "query"Elabora contenuto tramite pipecat logs.txt | claude -p "spiega"
claude configConfigura impostazioniclaude config set --global theme dark
claude updateAggiorna all’ultima versioneclaude update
claude mcpConfigura server Model Context ProtocolVedi sezione MCP nei tutorial

Flag CLI:

  • --print (-p): Stampa la risposta senza modalità interattiva
  • --json: Restituisce output JSON in modalità --print, utile per script e automazione
  • --verbose: Abilita logging dettagliato, mostra l’output completo turno per turno (utile per il debug in entrambe le modalità print e interattiva)
  • --dangerously-skip-permissions: Salta le richieste di permesso

Comandi slash

Controlla il comportamento di Claude durante una sessione:

ComandoScopo
/bugSegnala bug (invia la conversazione ad Anthropic)
/clearCancella la cronologia della conversazione
/compact [istruzioni]Compatta la conversazione con istruzioni di focus opzionali
/configVisualizza/modifica la configurazione
/costMostra statistiche sull’utilizzo dei token
/doctorControlla lo stato di salute dell’installazione di Claude Code
/helpOttieni aiuto sull’utilizzo
/initInizializza il progetto con la guida CLAUDE.md
/loginCambia account Anthropic
/logoutDisconnettiti dal tuo account Anthropic
/memoryModifica i file di memoria CLAUDE.md
/pr_commentsVisualizza i commenti delle pull request
/reviewRichiedi una revisione del codice
/terminal-setupInstalla la combinazione di tasti Shift+Enter per nuove righe (solo iTerm2 e VSCode)
/vimEntra in modalità vim per alternare modalità di inserimento e comando

Gestisci la memoria di Claude

Claude Code può ricordare le tue preferenze tra le sessioni, come linee guida di stile e comandi comuni nel tuo flusso di lavoro.

Determina il tipo di memoria

Claude Code offre tre posizioni di memoria, ciascuna con uno scopo diverso:

Tipo di memoriaPosizioneScopoEsempi di casi d’uso
Memoria del progetto./CLAUDE.mdConvenzioni e conoscenze condivise dal teamArchitettura del progetto, standard di codifica, flussi di lavoro comuni
Memoria del progetto (locale)./CLAUDE.local.mdPreferenze personali specifiche del progettoI tuoi URL sandbox, dati di test preferiti
Memoria utente~/.claude/CLAUDE.mdPreferenze personali globaliPreferenze di stile del codice, scorciatoie personali per gli strumenti

Tutti i file di memoria vengono caricati automaticamente nel contesto di Claude Code all’avvio.

Come Claude cerca nelle memorie

Claude Code legge le memorie in modo ricorsivo: partendo dalla cwd, Claude Code risale fino a / e legge qualsiasi file CLAUDE.md o CLAUDE.local.md che trova. Questo è particolarmente conveniente quando si lavora in repository di grandi dimensioni dove si esegue Claude Code in foo/bar/, e si hanno memorie sia in foo/CLAUDE.md che in foo/bar/CLAUDE.md.

Aggiungi rapidamente memorie con la scorciatoia #

Il modo più veloce per aggiungere una memoria è iniziare l’input con il carattere #:

# Usa sempre nomi di variabili descrittivi

Ti verrà chiesto di selezionare in quale file di memoria memorizzare questo.

Modifica direttamente le memorie con /memory

Usa il comando slash /memory durante una sessione per aprire qualsiasi file di memoria nel tuo editor di sistema per aggiunte o organizzazione più estese.

Best practice per la memoria

  • Sii specifico: “Usa indentazione a 2 spazi” è meglio di “Formatta il codice correttamente”.
  • Usa la struttura per organizzare: Formatta ogni memoria individuale come un punto elenco e raggruppa le memorie correlate sotto titoli markdown descrittivi.
  • Rivedi periodicamente: Aggiorna le memorie man mano che il tuo progetto si evolve per assicurarti che Claude stia sempre utilizzando le informazioni e il contesto più aggiornati.

Gestisci permessi e sicurezza

Claude Code utilizza un sistema di permessi a livelli per bilanciare potenza e sicurezza:

Tipo di strumentoEsempioApprovazione richiestaComportamento “Sì, non chiedere più”
Sola letturaLetture file, LS, GrepNoN/A
Comandi BashEsecuzione shellPermanentemente per directory di progetto e comando
Modifica fileModifica/scrittura fileFino alla fine della sessione

Strumenti disponibili per Claude

Claude Code ha accesso a un insieme di potenti strumenti che lo aiutano a comprendere e modificare la tua codebase:

StrumentoDescrizionePermesso richiesto
AgentEsegue un sub-agente per gestire attività complesse e multi-stepNo
BashEsegue comandi shell nel tuo ambiente
GlobTrova file basati su pattern matchingNo
GrepCerca pattern nei contenuti dei fileNo
LSElenca file e directoryNo
ReadLegge i contenuti dei fileNo
EditEffettua modifiche mirate a file specifici
WriteCrea o sovrascrive file
NotebookEditModifica celle di Jupyter notebook
NotebookReadLegge e visualizza contenuti di Jupyter notebookNo
WebFetchRecupera contenuti da un URL specificato

Le regole di permesso possono essere configurate usando /allowed-tools o nelle impostazioni dei permessi.

Protezione contro l’iniezione di prompt

L’iniezione di prompt è una tecnica in cui un attaccante tenta di sovrascrivere o manipolare le istruzioni di un assistente AI inserendo testo dannoso. Claude Code include diverse protezioni contro questi attacchi:

  • Sistema di permessi: Le operazioni sensibili richiedono un’approvazione esplicita
  • Analisi contestuale: Rileva istruzioni potenzialmente dannose analizzando la richiesta completa
  • Sanitizzazione dell’input: Previene l’iniezione di comandi elaborando gli input dell’utente
  • Blocklist di comandi: Blocca comandi rischiosi che recuperano contenuti arbitrari dal web come curl e wget

Best practice per lavorare con contenuti non fidati:

  1. Rivedi i comandi suggeriti prima dell’approvazione
  2. Evita di inviare direttamente a Claude contenuti non fidati tramite pipe
  3. Verifica le modifiche proposte ai file critici
  4. Segnala comportamenti sospetti con /bug

Mentre queste protezioni riducono significativamente il rischio, nessun sistema è completamente immune a tutti gli attacchi. Mantieni sempre buone pratiche di sicurezza quando lavori con qualsiasi strumento di IA.

Configura l’accesso alla rete

Claude Code richiede accesso a:

  • api.anthropic.com
  • statsig.anthropic.com
  • sentry.io

Inserisci questi URL nella whitelist quando usi Claude Code in ambienti containerizzati.

Variabili d’ambiente

Claude Code supporta le seguenti variabili d’ambiente per controllare il suo comportamento:

VariabileScopo
DISABLE_AUTOUPDATERImposta a 1 per disabilitare l’aggiornamento automatico
DISABLE_BUG_COMMANDImposta a 1 per disabilitare il comando /bug
DISABLE_COST_WARNINGSImposta a 1 per disabilitare i messaggi di avviso sui costi
DISABLE_ERROR_REPORTINGImposta a 1 per disattivare la segnalazione degli errori a Sentry
DISABLE_TELEMETRYImposta a 1 per disattivare la telemetria Statsig (nota che gli eventi Statsig non includono dati utente come codice, percorsi file o comandi bash)
HTTP_PROXYSpecifica il server proxy HTTP per le connessioni di rete
HTTPS_PROXYSpecifica il server proxy HTTPS per le connessioni di rete
MCP_TIMEOUTTimeout in millisecondi per l’avvio del server MCP
MCP_TOOL_TIMEOUTTimeout in millisecondi per l’esecuzione degli strumenti MCP

Configura Claude Code

Configura Claude Code eseguendo claude config nel tuo terminale, o il comando /config quando usi il REPL interattivo.

Opzioni di configurazione

Claude Code supporta configurazioni globali e a livello di progetto.

Per gestire le tue configurazioni, usa i seguenti comandi:

  • Elenca impostazioni: claude config list
  • Visualizza un’impostazione: claude config get <chiave>
  • Modifica un’impostazione: claude config set <chiave> <valore>
  • Aggiungi a un’impostazione (per liste): claude config add <chiave> <valore>
  • Rimuovi da un’impostazione (per liste): claude config remove <chiave> <valore>

Per impostazione predefinita config modifica la configurazione del progetto. Per gestire la configurazione globale, usa il flag --global (o -g).

Configurazione globale

Per impostare una configurazione globale, usa claude config set -g <chiave> <valore>:

ChiaveValoreDescrizione
autoUpdaterStatusdisabled o enabledAbilita o disabilita l’aggiornamento automatico (predefinito: enabled)
envJSON (es. '{"FOO": "bar"}')Variabili d’ambiente che verranno applicate a ogni sessione
preferredNotifChanneliterm2, iterm2_with_bell, terminal_bell, o notifications_disabledDove vuoi ricevere le notifiche (predefinito: iterm2)
themedark, light, light-daltonized, o dark-daltonizedTema colore
verbosetrue o falseSe mostrare output completi di bash e comandi (predefinito: false)

Opzioni di permesso per l’aggiornamento automatico

Quando Claude Code rileva che non ha permessi sufficienti per scrivere nella directory del prefisso npm globale (necessario per gli aggiornamenti automatici), vedrai un avviso che rimanda a questa pagina di documentazione. Per soluzioni dettagliate ai problemi dell’aggiornatore automatico, consulta la guida alla risoluzione dei problemi.

Consigliato: Crea un nuovo prefisso npm scrivibile dall’utente

# Prima, salva un elenco dei tuoi pacchetti globali esistenti per la migrazione successiva
npm list -g --depth=0 > ~/npm-global-packages.txt

# Crea una directory per i tuoi pacchetti globali
mkdir -p ~/.npm-global

# Configura npm per utilizzare il nuovo percorso della directory
npm config set prefix ~/.npm-global

# Nota: Sostituisci ~/.bashrc con ~/.zshrc, ~/.profile o altro file appropriato per la tua shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Applica la nuova impostazione PATH
source ~/.bashrc

# Ora reinstalla Claude Code nella nuova posizione
npm install -g @anthropic-ai/claude-code

# Opzionale: Reinstalla i tuoi precedenti pacchetti globali nella nuova posizione
# Guarda ~/npm-global-packages.txt e installa i pacchetti che vuoi mantenere
# npm install -g package1 package2 package3...

Perché consigliamo questa opzione:

  • Evita di modificare i permessi delle directory di sistema
  • Crea una posizione pulita e dedicata per i tuoi pacchetti npm globali
  • Segue le best practice di sicurezza

Poiché Claude Code è in fase di sviluppo attivo, consigliamo di configurare gli aggiornamenti automatici utilizzando l’opzione consigliata sopra.

Disabilitare l’aggiornamento automatico

Se preferisci disabilitare l’aggiornamento automatico invece di correggere i permessi, puoi usare:

claude config set -g autoUpdaterStatus disabled

Configurazione del progetto

Gestisci la configurazione del progetto con claude config set <chiave> <valore> (senza il flag -g):

ChiaveValoreDescrizione
allowedToolsarray di strumentiQuali strumenti possono essere eseguiti senza approvazione manuale
ignorePatternsarray di stringhe globQuali file/directory vengono ignorati quando si utilizzano gli strumenti

Per esempio:

# Permetti a npm test di essere eseguito senza approvazione
claude config add allowedTools "Bash(npm test)"

# Permetti a npm test e a qualsiasi suo sotto-comando di essere eseguito senza approvazione
claude config add allowedTools "Bash(npm test:*)"

# Istruisci Claude a ignorare node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"

Vedi Permessi per il formato delle regole allowedTools.

Ottimizza la configurazione del terminale

Claude Code funziona meglio quando il tuo terminale è configurato correttamente. Segui queste linee guida per ottimizzare la tua esperienza.

Shell supportate:

  • Bash
  • Zsh
  • Fish

Temi e aspetto

Claude non può controllare il tema del tuo terminale. Questo è gestito dalla tua applicazione terminale. Puoi abbinare il tema di Claude Code al tuo terminale durante l’onboarding o in qualsiasi momento tramite il comando /config

Interruzioni di riga

Hai diverse opzioni per inserire interruzioni di riga in Claude Code:

  • Escape rapido: Digita \ seguito da Invio per creare una nuova riga
  • Scorciatoia da tastiera: Premi Option+Invio (Meta+Invio) con la configurazione appropriata

Per configurare Option+Invio nel tuo terminale:

Per Mac Terminal.app:

  1. Apri Impostazioni → Profili → Tastiera
  2. Seleziona “Usa Option come tasto Meta”

Per iTerm2 e terminale VSCode:

  1. Apri Impostazioni → Profili → Tasti
  2. In Generale, imposta il tasto Option sinistro/destro su “Esc+”

Suggerimento per utenti iTerm2 e VSCode: Esegui /terminal-setup all’interno di Claude Code per configurare automaticamente Shift+Invio come alternativa più intuitiva.

Configurazione delle notifiche

Non perdere mai quando Claude completa un’attività con la configurazione appropriata delle notifiche:

Notifiche con suono del terminale

Abilita gli avvisi sonori quando le attività vengono completate:

claude config set --global preferredNotifChannel terminal_bell

Per utenti macOS: Non dimenticare di abilitare i permessi per le notifiche in Impostazioni di Sistema → Notifiche → [La tua app terminale].

Notifiche di sistema iTerm 2

Per avvisi iTerm 2 quando le attività vengono completate:

  1. Apri Preferenze di iTerm 2
  2. Naviga a Profili → Terminale
  3. Abilita “Silenzia suono” e “Invia notifica quando inattivo”
  4. Imposta il ritardo di notifica preferito

Nota che queste notifiche sono specifiche per iTerm 2 e non disponibili nel Terminale macOS predefinito.

Gestione di input di grandi dimensioni

Quando lavori con codice esteso o istruzioni lunghe:

  • Evita l’incollaggio diretto: Claude Code potrebbe avere difficoltà con contenuti incollati molto lunghi
  • Usa flussi di lavoro basati su file: Scrivi il contenuto in un file e chiedi a Claude di leggerlo
  • Sii consapevole delle limitazioni di VS Code: Il terminale di VS Code è particolarmente incline a troncare incollamenti lunghi

Modalità Vim

Claude Code supporta un sottoinsieme di keybinding Vim che può essere abilitato con /vim o configurato tramite /config.

Il sottoinsieme supportato include:

  • Cambio di modalità: Esc (a NORMAL), i/I, a/A, o/O (a INSERT)
  • Navigazione: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Modifica: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (ripeti)

Gestisci i costi in modo efficace

Claude Code consuma token per ogni interazione. Il costo medio è di $6 per sviluppatore al giorno, con costi giornalieri che rimangono sotto i $12 per il 90% degli utenti.

Traccia i tuoi costi

  • Usa /cost per vedere l’utilizzo della sessione corrente
  • Utenti Anthropic Console:
  • Utenti piano Max: L’utilizzo è incluso nel tuo abbonamento al piano Max

Riduci l’utilizzo dei token

  • Compatta le conversazioni:

    • Claude usa la compattazione automatica per impostazione predefinita quando il contesto supera il 95% della capacità

    • Attiva/disattiva la compattazione automatica: Esegui /config e naviga a “Auto-compact enabled”

    • Usa /compact manualmente quando il contesto diventa grande

    • Aggiungi istruzioni personalizzate: /compact Concentrati su esempi di codice e utilizzo API

    • Personalizza la compattazione aggiungendo a CLAUDE.md:

      # Istruzioni di riepilogo
      
      Quando usi compact, per favore concentrati sull'output dei test e sulle modifiche al codice
      
  • Scrivi query specifiche: Evita richieste vaghe che attivano scansioni non necessarie

  • Suddividi attività complesse: Dividi attività grandi in interazioni mirate

  • Cancella la cronologia tra le attività: Usa /clear per reimpostare il contesto

I costi possono variare significativamente in base a:

  • Dimensione della codebase analizzata
  • Complessità delle query
  • Numero di file cercati o modificati
  • Lunghezza della cronologia della conversazione
  • Frequenza di compattazione delle conversazioni

Per le implementazioni di team, consigliamo di iniziare con un piccolo gruppo pilota per stabilire modelli di utilizzo prima di un’implementazione più ampia.


Configurazione del modello

Per impostazione predefinita, Claude Code utilizza claude-opus-4-20250514. Puoi sovrascrivere questo usando le seguenti variabili d’ambiente:

# Anthropic API
ANTHROPIC_MODEL='claude-opus-4-20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-opus-4@20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

Puoi anche impostare queste variabili usando la configurazione globale:

# Configura per Anthropic API
claude config set --global env '{"ANTHROPIC_MODEL": "claude-opus-4-20250514"}'

# Configura per Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0"}'

# Configura per Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-opus-4@20250514"}'

Consulta il nostro riferimento ai nomi dei modelli per tutti i modelli disponibili tra i diversi provider.

Uso con API di terze parti

Claude Code richiede l’accesso sia ai modelli Claude Sonnet 3.7 che Claude Haiku 3.5, indipendentemente dal provider API che utilizzi.

Connessione ad Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_BEDROCK_BASE_URL:

ANTHROPIC_BEDROCK_BASE_URL='https://tuo-url-proxy'

Se non hai abilitato la cache dei prompt, imposta anche:

DISABLE_PROMPT_CACHING=1

Richiede credenziali AWS SDK standard (ad es., ~/.aws/credentials o variabili d’ambiente pertinenti come AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Per configurare le credenziali AWS, esegui:

aws configure

Contatta Amazon Bedrock per la cache dei prompt per costi ridotti e limiti di frequenza più elevati.

Gli utenti avranno bisogno di accesso sia ai modelli Claude Sonnet 3.7 che Claude Haiku 3.5 nel loro account AWS. Se hai un ruolo di accesso al modello, potresti dover richiedere l’accesso a questi modelli se non sono già disponibili. L’accesso a Bedrock in ogni regione è necessario perché i profili di inferenza richiedono capacità cross-region.

Connessione a Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=tuo-id-progetto

Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_VERTEX_BASE_URL:

ANTHROPIC_VERTEX_BASE_URL='https://tuo-url-proxy'

Se non hai abilitato la cache dei prompt, imposta anche:

DISABLE_PROMPT_CACHING=1

Claude Code su Vertex AI attualmente supporta solo la regione us-east5. Assicurati che il tuo progetto abbia quota allocata in questa regione specifica.

Gli utenti avranno bisogno di accesso sia ai modelli Claude Sonnet 3.7 che Claude Haiku 3.5 nel loro progetto Vertex AI.

Richiede credenziali GCP standard configurate tramite google-auth-library. Per configurare le credenziali GCP, esegui:

gcloud auth application-default login

Per la migliore esperienza, contatta Google per limiti di frequenza più elevati.

Connessione tramite proxy

Quando usi Claude Code con un proxy LLM (come LiteLLM), puoi controllare il comportamento di autenticazione utilizzando le seguenti variabili d’ambiente e configurazioni. Nota che puoi combinare queste con le impostazioni specifiche di Bedrock e Vertex.

Variabili d’ambiente

  • ANTHROPIC_AUTH_TOKEN: Valore personalizzato per gli header Authorization e Proxy-Authorization (il valore che imposti qui sarà preceduto da Bearer )
  • ANTHROPIC_CUSTOM_HEADERS: Header personalizzati che vuoi aggiungere alla richiesta (nel formato Nome: Valore)
  • HTTP_PROXY: Imposta l’URL del proxy HTTP
  • HTTPS_PROXY: Imposta l’URL del proxy HTTPS

Se preferisci configurare tramite un file invece che con variabili d’ambiente, puoi aggiungere qualsiasi di queste variabili all’oggetto env nella tua configurazione globale Claude (in ~/.claude.json).

Opzioni di configurazione globale

  • apiKeyHelper: Uno script shell personalizzato per ottenere una chiave API (invocato una volta all’avvio e memorizzato nella cache per la durata di ogni sessione)

Implementazione di riferimento del container di sviluppo

Claude Code fornisce una configurazione di container di sviluppo per i team che necessitano di ambienti coerenti e sicuri. Questa configurazione devcontainer preconfigurata funziona perfettamente con l’estensione Remote - Containers di VS Code e strumenti simili.

Le misure di sicurezza avanzate del container (isolamento e regole firewall) ti permettono di eseguire claude --dangerously-skip-permissions per bypassare le richieste di permesso per operazioni non presidiate. Abbiamo incluso un’implementazione di riferimento che puoi personalizzare per le tue esigenze.

Mentre il devcontainer fornisce protezioni sostanziali, nessun sistema è completamente immune a tutti gli attacchi. Mantieni sempre buone pratiche di sicurezza e monitora le attività di Claude.

Caratteristiche principali

  • Node.js pronto per la produzione: Basato su Node.js 20 con dipendenze di sviluppo essenziali
  • Sicurezza by design: Firewall personalizzato che limita l’accesso alla rete solo ai servizi necessari
  • Strumenti per sviluppatori: Include git, ZSH con miglioramenti di produttività, fzf e altro
  • Integrazione perfetta con VS Code: Estensioni pre-configurate e impostazioni ottimizzate
  • Persistenza della sessione: Conserva la cronologia dei comandi e le configurazioni tra i riavvii del container
  • Funziona ovunque: Compatibile con ambienti di sviluppo macOS, Windows e Linux

Iniziare in 4 passaggi

  1. Installa VS Code e l’estensione Remote - Containers
  2. Clona il repository implementazione di riferimento di Claude Code
  3. Apri il repository in VS Code
  4. Quando richiesto, clicca su “Riapri nel Container” (o usa la Palette dei Comandi: Cmd+Shift+P → “Remote-Containers: Riapri nel Container”)

Scomposizione della configurazione

La configurazione devcontainer consiste in tre componenti principali:

  • devcontainer.json: Controlla le impostazioni del container, le estensioni e i mount dei volumi
  • Dockerfile: Definisce l’immagine del container e gli strumenti installati
  • init-firewall.sh: Stabilisce le regole di sicurezza della rete

Funzionalità di sicurezza

Il container implementa un approccio di sicurezza a più livelli con la sua configurazione firewall:

  • Controllo preciso degli accessi: Limita le connessioni in uscita solo ai domini nella whitelist (registry npm, GitHub, API Anthropic, ecc.)
  • Politica di default-deny: Blocca tutti gli altri accessi esterni alla rete
  • Verifica all’avvio: Convalida le regole del firewall quando il container si inizializza
  • Isolamento: Crea un ambiente di sviluppo sicuro separato dal tuo sistema principale

Opzioni di personalizzazione

La configurazione devcontainer è progettata per essere adattabile alle tue esigenze:

  • Aggiungi o rimuovi estensioni VS Code in base al tuo flusso di lavoro
  • Modifica le allocazioni di risorse per diversi ambienti hardware
  • Regola i permessi di accesso alla rete
  • Personalizza le configurazioni della shell e gli strumenti per sviluppatori

Prossimi passi


Licenza e utilizzo dei dati

Claude Code è fornito come anteprima di ricerca Beta secondo i Termini di Servizio Commerciali di Anthropic.

Come utilizziamo i tuoi dati

Miriamo ad essere completamente trasparenti su come utilizziamo i tuoi dati. Potremmo utilizzare il feedback per migliorare i nostri prodotti e servizi, ma non addestreremo modelli generativi utilizzando il tuo feedback da Claude Code. Data la loro natura potenzialmente sensibile, conserviamo le trascrizioni di feedback degli utenti per soli 30 giorni.

Trascrizioni di feedback

Se scegli di inviarci feedback su Claude Code, come trascrizioni del tuo utilizzo, Anthropic può utilizzare quel feedback per risolvere problemi correlati e migliorare la funzionalità di Claude Code (ad esempio, per ridurre il rischio che bug simili si verifichino in futuro). Non addestreremo modelli generativi utilizzando questo feedback.

Salvaguardie per la privacy

Abbiamo implementato diverse salvaguardie per proteggere i tuoi dati, inclusi periodi di conservazione limitati per informazioni sensibili, accesso limitato ai dati delle sessioni utente e politiche chiare contro l’utilizzo del feedback per l’addestramento dei modelli.

Per dettagli completi, consulta i nostri Termini di Servizio Commerciali e la Politica sulla Privacy.

Licenza

© Anthropic PBC. Tutti i diritti riservati. L’utilizzo è soggetto ai Termini di Servizio Commerciali di Anthropic.