Panoramica di Claude Code

Claude Code è uno strumento di codifica basato su agenti che vive nel tuo terminale, comprende la tua base di codice 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 base di codice
• 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

​

Funzionalità e flussi di lavoro principali

Claude Code opera direttamente nel tuo terminale, comprendendo il contesto del tuo progetto e intraprendendo azioni reali. Non c’è bisogno di aggiungere manualmente file al contesto - Claude esplorerà la tua base di codice secondo necessità. Claude Code utilizza claude-3-7-sonnet-20250219 come predefinito.

​

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: 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 secondi

# Fai domande sulla tua base di codice
$ claude
> come funziona il nostro sistema di autenticazione?

# Crea un commit con un comando
$ claude commit

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

​

Prima di iniziare

​

Verifica i requisiti di sistema

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

​

Installa e autentica

​

Inizializza il tuo progetto

Per i nuovi utenti, raccomandiamo:

1. Avvia Claude Code con claude
2. Prova un comando semplice come riassumi questo progetto
3. Genera una guida CLAUDE.md con /init
4. Chiedi a Claude di committare il 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 c’è bisogno di aggiungere manualmente file al contesto - Claude esplorerà la tua base di codice 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 layer di caching

​

Automatizza operazioni Git

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

​

Modifica il codice in modo intelligente

> aggiungi la validazione degli input al form di registrazione
> refactorizza il logger per usare la nuova API
> correggi la race condition nella coda dei worker

​

Testa e debugga 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
> rifletti attentamente sui casi limite nel nostro flusso di autenticazione

​

Controlla Claude Code con i comandi

​

Comandi CLI

Flag CLI:

• --print: Stampa risposta senza modalità interattiva
• --verbose: Abilita logging dettagliato
• --dangerously-skip-permissions: Salta prompt di permessi (solo in container Docker senza internet)

​

Comandi slash

Controlla il comportamento di Claude durante una sessione:

​

Gestisci permessi e sicurezza

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

​

Strumenti disponibili per Claude

Claude Code ha accesso a un set di potenti strumenti che lo aiutano a comprendere e modificare la tua base di codice:

​

Protezione contro l’iniezione di prompt

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

• Sistema di permessi: Operazioni sensibili richiedono approvazione esplicita
• Analisi consapevole del contesto: Rileva istruzioni potenzialmente dannose analizzando la richiesta completa
• Sanitizzazione input: Previene l’iniezione di comandi processando gli input utente
• Lista nera comandi: Blocca comandi rischiosi che scaricano 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 contenuti non fidati a Claude via pipe
3. Verifica le modifiche proposte ai file critici
4. Segnala comportamenti sospetti con /bug

​

Configura accesso di rete

Claude Code richiede accesso a:

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

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

​

Ottimizza la configurazione del terminale e configura il tuo ambiente

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

Shell supportate:

• Bash
• Zsh (Shell Fish non attualmente supportata)

​

Temi e aspetto

Claude non può controllare il tema del tuo terminale. Quello è gestito dalla tua applicazione terminale. Puoi far corrispondere 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 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. Spunta “Usa Option come tasto Meta”

Per iTerm2 e terminale VSCode:

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

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

​

Configurazione notifiche

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

​

Notifiche campanello terminale

Abilita avvisi sonori quando le attività sono completate:

claude config set --global preferredNotifChannel terminal_bell

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

​

Notifiche di sistema iTerm 2

Per avvisi iTerm 2 quando le attività sono completate:

1. Apri Preferenze iTerm 2
2. Naviga a Profili → Terminale
3. Abilita “Silenzia campanello” 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 input lunghi

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 dei limiti di VS Code: Il terminale VS Code è particolarmente soggetto a troncare gli incollaggi lunghi

Configurando queste impostazioni, creerai un flusso di lavoro più fluido ed efficiente con Claude Code.

​

Gestisci i costi efficacemente

Claude Code consuma token per ogni interazione. I costi tipici di utilizzo vanno da 5-10$per sviluppatore al giorno, ma possono superare i 100$ all’ora durante un uso intensivo.

​

Traccia i tuoi costi

• Usa /cost per vedere l’utilizzo della sessione corrente
• Rivedi il riepilogo dei costi visualizzato all’uscita
• Controlla l’utilizzo storico in Anthropic Console
• Imposta Limiti di spesa

​

Riduci l’utilizzo dei token

• Compatta le conversazioni: Usa /compact quando il contesto diventa grande
• Scrivi query specifiche: Evita richieste vaghe che attivano scansioni non necessarie
• Suddividi attività complesse: Dividi grandi attività in interazioni mirate
• Cancella la cronologia tra le attività: Usa /clear per resettare il contesto

I costi possono variare significativamente in base a:

• Dimensione della base di codice analizzata
• Complessità delle query
• Numero di file cercati o modificati
• Lunghezza della cronologia conversazione
• Frequenza di compattamento delle conversazioni

​

Uso con API di terze parti

​

Connetti ad Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1
ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Se non hai abilitato il caching dei prompt, imposta anche:

DISABLE_PROMPT_CACHING=1

Richiede credenziali AWS SDK standard (es., ~/.aws/credentials o variabili d’ambiente rilevanti come AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Contatta Amazon Bedrock per il caching dei prompt per costi ridotti e limiti di velocità più alti.

​

Connetti a Google Vertex AI

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

Richiede credenziali GCP standard configurate attraverso google-auth-library. Per la migliore esperienza, contatta Google per limiti di velocità aumentati.

​

Implementazione di riferimento container di sviluppo

Claude Code fornisce una configurazione container di sviluppo per 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 i prompt di permesso per operazioni non presidiate. Abbiamo incluso una implementazione di riferimento che puoi personalizzare per le tue necessità.

​

Caratteristiche chiave

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

​

Inizia in 4 passi

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

​

Dettaglio configurazione

Il setup devcontainer consiste di tre componenti principali:

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

​

Funzionalità di sicurezza

Il container implementa un approccio di sicurezza multi-livello con la sua configurazione firewall:

• Controllo accesso preciso: Restringe le connessioni in uscita solo ai domini in whitelist (registro npm, GitHub, API Anthropic, ecc.)
• Policy default-deny: Blocca tutti gli altri accessi di rete esterni
• Verifica all’avvio: Valida le regole 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 necessità:

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

​

Prossimi passi

​

Licenza e utilizzo dati

Claude Code è fornito come anteprima Beta di ricerca 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 del feedback utente solo per 30 giorni.

​

Trascrizioni feedback

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

​

Salvaguardie privacy

Abbiamo implementato diverse salvaguardie per proteggere i tuoi dati, inclusi periodi di conservazione limitati per informazioni sensibili, accesso ristretto 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 Privacy Policy.

​

Licenza

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