Panoramica di Claude Code
Scopri Claude Code, uno strumento di codifica basato su agenti creato da Anthropic. Attualmente in beta come anteprima di ricerca.
Installa NodeJS 18+, poi esegui:
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:
- 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:
-
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 usaresudo
)
- Esegui
-
Errori “Node not found”: Se vedi
exec: node: not found
quando eseguiclaude
, il tuo ambiente WSL potrebbe utilizzare un’installazione Windows di Node.js. Puoi confermarlo conwhich npm
ewhich 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 tramitenvm
.
Installa e autentica
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.
Naviga al tuo progetto
cd directory-del-tuo-progetto
Avvia Claude Code
claude
per avviarloCompleta 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
Inizializza il tuo progetto
Per i nuovi utenti, consigliamo:
- Avvia Claude Code con
claude
- Prova un comando semplice come
riassumi questo progetto
- Genera una guida CLAUDE.md per il progetto con
/init
- 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
Automatizza le operazioni Git
Modifica il codice in modo intelligente
Testa e debug il tuo codice
Incoraggia un pensiero più profondo
Per problemi complessi, chiedi esplicitamente a Claude di pensare più a fondo:
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:
Controlla Claude Code con i comandi
Comandi CLI
Comando | Descrizione | Esempio |
---|---|---|
claude | Avvia REPL interattivo | claude |
claude "query" | Avvia REPL con prompt iniziale | claude "spiega questo progetto" |
claude -p "query" | Esegue una query singola, poi esce | claude -p "spiega questa funzione" |
cat file | claude -p "query" | Elabora contenuto tramite pipe | cat logs.txt | claude -p "spiega" |
claude config | Configura impostazioni | claude config set --global theme dark |
claude update | Aggiorna all’ultima versione | claude update |
claude mcp | Configura server Model Context Protocol | Vedi 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:
Comando | Scopo |
---|---|
/bug | Segnala bug (invia la conversazione ad Anthropic) |
/clear | Cancella la cronologia della conversazione |
/compact [istruzioni] | Compatta la conversazione con istruzioni di focus opzionali |
/config | Visualizza/modifica la configurazione |
/cost | Mostra statistiche sull’utilizzo dei token |
/doctor | Controlla lo stato di salute dell’installazione di Claude Code |
/help | Ottieni aiuto sull’utilizzo |
/init | Inizializza il progetto con la guida CLAUDE.md |
/login | Cambia account Anthropic |
/logout | Disconnettiti dal tuo account Anthropic |
/memory | Modifica i file di memoria CLAUDE.md |
/pr_comments | Visualizza i commenti delle pull request |
/review | Richiedi una revisione del codice |
/terminal-setup | Installa la combinazione di tasti Shift+Enter per nuove righe (solo iTerm2 e VSCode) |
/vim | Entra 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 memoria | Posizione | Scopo | Esempi di casi d’uso |
---|---|---|---|
Memoria del progetto | ./CLAUDE.md | Convenzioni e conoscenze condivise dal team | Architettura del progetto, standard di codifica, flussi di lavoro comuni |
Memoria del progetto (locale) | ./CLAUDE.local.md | Preferenze personali specifiche del progetto | I tuoi URL sandbox, dati di test preferiti |
Memoria utente | ~/.claude/CLAUDE.md | Preferenze personali globali | Preferenze 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 #
:
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 strumento | Esempio | Approvazione richiesta | Comportamento “Sì, non chiedere più” |
---|---|---|---|
Sola lettura | Letture file, LS, Grep | No | N/A |
Comandi Bash | Esecuzione shell | Sì | Permanentemente per directory di progetto e comando |
Modifica file | Modifica/scrittura file | Sì | Fino 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:
Strumento | Descrizione | Permesso richiesto |
---|---|---|
Agent | Esegue un sub-agente per gestire attività complesse e multi-step | No |
Bash | Esegue comandi shell nel tuo ambiente | Sì |
Glob | Trova file basati su pattern matching | No |
Grep | Cerca pattern nei contenuti dei file | No |
LS | Elenca file e directory | No |
Read | Legge i contenuti dei file | No |
Edit | Effettua modifiche mirate a file specifici | Sì |
Write | Crea o sovrascrive file | Sì |
NotebookEdit | Modifica celle di Jupyter notebook | Sì |
NotebookRead | Legge e visualizza contenuti di Jupyter notebook | No |
WebFetch | Recupera contenuti da un URL specificato | Sì |
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
ewget
Best practice per lavorare con contenuti non fidati:
- Rivedi i comandi suggeriti prima dell’approvazione
- Evita di inviare direttamente a Claude contenuti non fidati tramite pipe
- Verifica le modifiche proposte ai file critici
- 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:
Variabile | Scopo |
---|---|
DISABLE_AUTOUPDATER | Imposta a 1 per disabilitare l’aggiornamento automatico |
DISABLE_BUG_COMMAND | Imposta a 1 per disabilitare il comando /bug |
DISABLE_COST_WARNINGS | Imposta a 1 per disabilitare i messaggi di avviso sui costi |
DISABLE_ERROR_REPORTING | Imposta a 1 per disattivare la segnalazione degli errori a Sentry |
DISABLE_TELEMETRY | Imposta a 1 per disattivare la telemetria Statsig (nota che gli eventi Statsig non includono dati utente come codice, percorsi file o comandi bash) |
HTTP_PROXY | Specifica il server proxy HTTP per le connessioni di rete |
HTTPS_PROXY | Specifica il server proxy HTTPS per le connessioni di rete |
MCP_TIMEOUT | Timeout in millisecondi per l’avvio del server MCP |
MCP_TOOL_TIMEOUT | Timeout 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>
:
Chiave | Valore | Descrizione |
---|---|---|
autoUpdaterStatus | disabled o enabled | Abilita o disabilita l’aggiornamento automatico (predefinito: enabled ) |
env | JSON (es. '{"FOO": "bar"}' ) | Variabili d’ambiente che verranno applicate a ogni sessione |
preferredNotifChannel | iterm2 , iterm2_with_bell , terminal_bell , o notifications_disabled | Dove vuoi ricevere le notifiche (predefinito: iterm2 ) |
theme | dark , light , light-daltonized , o dark-daltonized | Tema colore |
verbose | true o false | Se 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
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:
Configurazione del progetto
Gestisci la configurazione del progetto con claude config set <chiave> <valore>
(senza il flag -g
):
Chiave | Valore | Descrizione |
---|---|---|
allowedTools | array di strumenti | Quali strumenti possono essere eseguiti senza approvazione manuale |
ignorePatterns | array di stringhe glob | Quali file/directory vengono ignorati quando si utilizzano gli strumenti |
Per esempio:
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:
- Apri Impostazioni → Profili → Tastiera
- Seleziona “Usa Option come tasto Meta”
Per iTerm2 e terminale VSCode:
- Apri Impostazioni → Profili → Tasti
- 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:
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:
- Apri Preferenze di iTerm 2
- Naviga a Profili → Terminale
- Abilita “Silenzia suono” e “Invia notifica quando inattivo”
- 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:
- Controlla l’utilizzo storico nella Anthropic Console (richiede ruolo Admin o Billing)
- Imposta limiti di spesa del workspace per il workspace Claude Code (richiede ruolo Admin)
- 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:
-
-
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:
Puoi anche impostare queste variabili usando la configurazione globale:
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
Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_BEDROCK_BASE_URL
:
Se non hai abilitato la cache dei prompt, imposta anche:
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:
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
Se desideri accedere a Claude Code tramite proxy, puoi utilizzare la variabile d’ambiente ANTHROPIC_VERTEX_BASE_URL
:
Se non hai abilitato la cache dei prompt, imposta anche:
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:
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 headerAuthorization
eProxy-Authorization
(il valore che imposti qui sarà preceduto daBearer
)ANTHROPIC_CUSTOM_HEADERS
: Header personalizzati che vuoi aggiungere alla richiesta (nel formatoNome: Valore
)HTTP_PROXY
: Imposta l’URL del proxy HTTPHTTPS_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
- Installa VS Code e l’estensione Remote - Containers
- Clona il repository implementazione di riferimento di Claude Code
- Apri il repository in VS Code
- 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
Tutorial di Claude Code
Guide passo-passo per attività comuni
Risoluzione dei problemi
Soluzioni per problemi comuni con Claude Code
Implementazione di riferimento
Clona la nostra implementazione di riferimento del container di sviluppo.
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.