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

NON utilizzare sudo npm install -g poiché può portare a problemi di permessi e rischi per la sicurezza. Se riscontri errori di permessi, 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. Integrandosi 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 IA e come migliorare l’esperienza dell’agente.

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

Segnala i bug direttamente con il comando /bug o attraverso 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 RAM
  • Software:
    • Node.js 18+
    • git 2.23+ (opzionale)
    • CLI di GitHub o GitLab per i flussi di lavoro PR (opzionale)
    • ripgrep (rg) per ricerca file avanzata (opzionale)
  • Rete: Connessione Internet richiesta per autenticazione ed elaborazione IA
  • Posizione: Disponibile solo nei paesi supportati

Risoluzione dei problemi di installazione WSL

Attualmente, Claude Code non funziona direttamente in Windows e 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 non trovato: 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/ invece di /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 utilizzare sudo npm install -g poiché può portare a problemi di permessi e rischi per la sicurezza. Se riscontri errori di permessi, consulta configura Claude Code per le soluzioni consigliate.

2

Naviga nel tuo progetto

cd directory-del-tuo-progetto
3

Avvia Claude Code

Esegui claude per avviare
4

Completa l'autenticazione

Segui il processo OAuth una tantum con il tuo account Console. Avrai bisogno di fatturazione attiva su console.anthropic.com.

​
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à. Claude Code utilizza claude-3-7-sonnet-20250219 per impostazione predefinita.

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

# Fai domande sulla tua codebase
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"

​
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 del progetto 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 è 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 layer di caching

​
Automatizza operazioni Git

> committa le 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 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
> pensa attentamente ai casi limite nel nostro flusso di autenticazione

Claude Code mostrerà quando Claude (3.7 Sonnet) sta utilizzando il pensiero esteso. Puoi proattivamente chiedere a Claude di “pensare” o “pensare profondamente” per attività che richiedono più pianificazione. Ti suggeriamo di spiegare prima a Claude il 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. Per esempio, “pensa attentamente” attiverà un pensiero più esteso rispetto a dire solo “pensa”.

Per altri suggerimenti, vedi Suggerimenti per il pensiero esteso.

​
Automatizza flussi di lavoro CI e infrastruttura

Claude Code viene fornito con 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:*)" Edit

[Continuo la traduzione nella prossima parte per mantenere una risposta gestibile e accurata]

Was this page helpful?

EmbeddingsTutorial su Claude Code