Vai al contenuto principale
Interfaccia Claude Code su desktop

Claude Code su desktop (Anteprima)

L’app desktop Claude fornisce un’interfaccia nativa per eseguire più sessioni Claude Code sulla tua macchina locale e integrazione perfetta con Claude Code sul web.

Installazione

Scarica l’app desktop Claude per la tua piattaforma: Per Windows ARM64, scarica qui.
Le sessioni locali non sono disponibili su Windows ARM64.

Funzionalità

Claude Code su desktop fornisce:
  • Sessioni locali parallele con git worktrees: Esegui più sessioni Claude Code contemporaneamente nello stesso repository, ognuna con il proprio git worktree isolato
  • Includi file elencati nel tuo .gitignore nei tuoi worktrees: Copia automaticamente i file nel tuo .gitignore, come .env, nei nuovi worktrees utilizzando .worktreeinclude
  • Avvia Claude Code sul web: Avvia sessioni cloud sicure direttamente dall’app desktop

Utilizzo di Git worktrees

Claude Code su desktop consente di eseguire più sessioni Claude Code nello stesso repository utilizzando Git worktrees. Ogni sessione ottiene il proprio worktree isolato, permettendo a Claude di lavorare su diversi compiti senza conflitti. La posizione predefinita per i worktrees è ~/.claude-worktrees ma questo può essere configurato nelle tue impostazioni sull’app desktop Claude.
Se avvii una sessione locale in una cartella che non ha Git inizializzato, l’app desktop non creerà un nuovo worktree.

Copia di file ignorati con .gitignore

Quando Claude Code crea un worktree, i file ignorati tramite .gitignore non sono automaticamente disponibili. Includere un file .worktreeinclude risolve questo problema specificando quali file ignorati devono essere copiati nei nuovi worktrees. Crea un file .worktreeinclude nella radice del tuo repository:
.env
.env.local
.env.*
**/.claude/settings.local.json
Il file utilizza pattern in stile .gitignore. Quando viene creato un worktree, i file che corrispondono a questi pattern e che sono anche nel tuo .gitignore verranno copiati dal tuo repository principale al worktree.
Solo i file che corrispondono sia a .worktreeinclude CHE sono elencati in .gitignore vengono copiati. Questo previene la duplicazione accidentale di file tracciati.

Avvia Claude Code sul web

Dall’app desktop, puoi avviare sessioni Claude Code che vengono eseguite sull’infrastruttura cloud sicura di Anthropic. Per avviare una sessione web da desktop, seleziona un ambiente remoto quando crei una nuova sessione. Per ulteriori dettagli, vedi Claude Code sul web.

Versione Claude Code in bundle

Claude Code su desktop include una versione stabile di Claude Code in bundle per garantire un’esperienza coerente per tutti gli utenti desktop. La versione in bundle è obbligatoria e viene scaricata al primo avvio anche se una versione di Claude Code esiste già sul computer. Desktop gestisce automaticamente gli aggiornamenti delle versioni e pulisce le versioni precedenti.
La versione Claude Code in bundle in Desktop potrebbe differire dalla versione CLI più recente. Desktop dà priorità alla stabilità mentre la CLI potrebbe avere funzionalità più recenti.

Configurazione dell’ambiente

Per gli ambienti locali, Claude Code su desktop estrae automaticamente la tua variabile di ambiente $PATH dalla configurazione della tua shell. Questo consente alle sessioni locali di accedere a strumenti di sviluppo come yarn, npm, node e altri comandi disponibili nel tuo terminale senza configurazione aggiuntiva.

Variabili di ambiente personalizzate

Seleziona l’ambiente “Local”, quindi a destra, seleziona il pulsante delle impostazioni. Questo aprirà una finestra di dialogo in cui puoi aggiornare le variabili di ambiente locali. Questo è utile per impostare variabili specifiche del progetto o chiavi API che i tuoi flussi di lavoro di sviluppo richiedono. I valori delle variabili di ambiente sono mascherati nell’interfaccia utente per motivi di sicurezza.
Le variabili di ambiente devono essere specificate come coppie chiave-valore, in formato .env. Ad esempio:
API_KEY=your_api_key
DEBUG=true

# Valori multilinea - racchiudi tra virgolette
CERT="---BEGIN CERT---
MIIE...
---END CERT---"

Configurazione aziendale

Le organizzazioni possono disabilitare l’uso locale di Claude Code nell’applicazione desktop con l’opzione di policy aziendale isClaudeCodeForDesktopEnabled enterprise policy option. Inoltre, Claude Code sul web può essere disabilitato nelle tue impostazioni di amministrazione.

Risorse correlate