Documentation 2026-07-11 19:03 UTC to 2026-07-13 23:57 UTC

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Usa Claude Code con un lettore di schermo

6 

7> Configura Claude Code per lettori di schermo come VoiceOver e NVDA, oltre alle impostazioni per ingranditori dello schermo, movimento ridotto e temi adatti ai daltonici.

8 

9Claude Code ha una modalità lettore di schermo che sostituisce la sua interfaccia terminale visiva con testo semplice e lineare. Invece di caselle, animazioni di progresso e ridisegni in-place, la modalità stampa righe etichettate che un lettore di schermo come VoiceOver o NVDA legge in ordine, in modo che possiate mantenere una conversazione completa, approvare i permessi degli strumenti e rivedere l'output da capo a fondo.

10 

11La modalità lettore di schermo è facoltativa. Se utilizzate un ingranditore dello schermo, movimento ridotto o un tema adatto ai daltonici invece di un lettore di schermo, consultate [Impostazioni di accessibilità oltre la modalità lettore di schermo](#accessibility-settings-beyond-screen-reader-mode).

12 

13<Note>

14 La modalità lettore di schermo richiede Claude Code v2.1.181 o successivo. Le versioni precedenti rifiutano il flag `--ax-screen-reader` con `error: unknown option '--ax-screen-reader'`.

15</Note>

16 

17<h2 id="turn-on-screen-reader-mode">

18 Attiva la modalità lettore di schermo

19</h2>

20 

21Scegli il metodo che corrisponde a quanto spesso utilizzi un lettore di schermo:

22 

23* Per una sessione: esegui `claude --ax-screen-reader`.

24* Per sessioni avviate da una shell: imposta la variabile di ambiente `CLAUDE_AX_SCREEN_READER` su `1`. In Bash o Zsh, esegui `export CLAUDE_AX_SCREEN_READER=1`; in PowerShell, esegui `$env:CLAUDE_AX_SCREEN_READER = "1"`. Aggiungi la riga al tuo profilo shell per coprire ogni shell.

25* Per ogni sessione sulla macchina: aggiungi `"axScreenReader": true` al tuo [file di impostazioni](/it/settings) dell'utente. Questo copre qualsiasi terminale, incluso il terminale integrato di VS Code.

26 

27<Note>

28 I metodi sono elencati in ordine di precedenza: il flag [`--ax-screen-reader`](/it/cli-reference#cli-flags) sostituisce la variabile di ambiente [`CLAUDE_AX_SCREEN_READER`](/it/env-vars), che sostituisce l'impostazione [`axScreenReader`](/it/settings#available-settings).

29</Note>

30 

31Se utilizzi Claude Code su SSH, imposta la variabile di ambiente o l'impostazione sulla macchina remota dove Claude Code viene eseguito.

32 

33Quando la modalità è attiva, la prima cosa che Claude Code stampa è una riga di conferma che nomina il metodo che l'ha attivata: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]`, o `[Screen Reader Mode: on via settings]`; questo formato di denominazione del metodo richiede Claude Code v2.1.206 o successivo.

34{/* max-version: 2.1.205 */}Le versioni precedenti stampano `[Accessible screen reader mode: on]`.

35 

36<h2 id="turn-off-screen-reader-mode">

37 Disattiva la modalità lettore di schermo

38</h2>

39 

40Inverti il metodo che ha attivato la modalità: avvia senza il flag, annulla l'impostazione della variabile di ambiente o imposta `axScreenReader` su `false`. L'impostazione di `CLAUDE_AX_SCREEN_READER=0` mantiene la modalità disattivata anche quando l'impostazione è `true`.

41 

42<h2 id="what-your-screen-reader-hears">

43 Cosa sente il tuo lettore di schermo

44</h2>

45 

46In modalità lettore di schermo, Claude Code scrive testo semplice:

47 

48* nessun carattere di disegno di caselle per il chrome dell'interfaccia

49* nessun suggerimento basato solo sul colore

50* nessun ridisegno del contenuto che non è cambiato; i spinner di progresso vengono renderizzati come testo statico

51* le tabelle nelle risposte di Claude vengono lette come frasi `Header: value` invece di una griglia di caratteri di casella. {/* min-version: 2.1.198 */}Richiede Claude Code v2.1.198 o successivo; le versioni precedenti disegnano le tabelle come griglie anche in modalità lettore di schermo.

52 

53L'output si accumula nello scrollback del tuo terminale, in modo che tu possa rileggere i turni precedenti con i comandi di revisione del tuo lettore di schermo o la ricerca del tuo terminale.

54 

55La modalità lettore di schermo viene renderizzata come testo scorrevole semplice, anche se hai attivato il [rendering a schermo intero](/it/fullscreen) con l'[impostazione `tui`](/it/settings#available-settings); l'impostazione non ha effetto mentre la modalità è attiva. Le sessioni in background allegate vengono comunque renderizzate a schermo intero; consulta [Limitazioni note](#known-limitations).

56 

57Ogni messaggio nella trascrizione inizia con un'etichetta che il tuo lettore di schermo annuncia, denominando cosa sia: i tuoi messaggi, le risposte di Claude, l'attività degli strumenti, gli errori e i prompt. Le etichette sono anche ricercabili, in modo che tu possa saltare tra le sezioni della trascrizione cercando nello scrollback del tuo terminale:

58 

59| Etichetta | Significato |

60| :--------------------- | :----------------------------------------------------------------------------------------------------------- |

61| `you:` | I tuoi messaggi |

62| `claude:` | Le risposte di Claude |

63| `tool:` | Attività degli strumenti, come una modifica di file o un comando eseguito |

64| `tool error:` | Uno strumento che ha fallito |

65| `error:` | Un errore nella conversazione, come una richiesta API non riuscita |

66| `Permission Required:` | Un prompt di permesso in attesa della tua risposta |

67| `Cost:` | Il riepilogo dei costi della sessione quando Claude Code esce, se il tuo account [mostra i costi](/it/costs) |

68 

69Il cursore del terminale segue il cursore di input, quindi il comando di lettura della riga corrente di un lettore di schermo risponde a "dove sono" con il prompt che stai modificando.

70 

71<h3 id="jump-between-turns">

72 Salta tra i turni

73</h3>

74 

75Claude Code emette marcatori di integrazione shell OSC 133 ai confini dei turni, in modo che il tasto per saltare al prompt precedente del tuo terminale si sposti tra i turni senza leggere l'intera trascrizione:

76 

77* iTerm2: Cmd+Shift+Up

78* Terminale VS Code: Ctrl+Up su Windows, Cmd+Up su macOS

79* Windows Terminal: nessun tasto per impostazione predefinita; associa l'azione `scrollToMark` nelle sue impostazioni

80* Kitty e Ghostty: consulta la documentazione del terminale per il suo tasto di salto al prompt

81 

82macOS Terminal non agisce sui marcatori e Claude Code non li emette in WezTerm. In quei terminali, cerca nello scrollback l'etichetta `you:` invece.

83 

84<h2 id="answer-menus-and-prompts">

85 Rispondi a menu e prompt

86</h2>

87 

88In modalità lettore di schermo, i menu che normalmente navigheresti con i tasti freccia, inclusi i prompt di permesso, diventano elenchi numerati. Ogni opzione viene annunciata come una riga numerata, seguita da un prompt `Enter selection` che nomina l'intervallo valido. Digita il numero dell'opzione che desideri e premi Invio.

89 

90* Per annullare un menu dismissibile: premi Escape. Il suo prompt termina con `or Escape to cancel`.

91* Se digiti un numero che non è nell'elenco: Claude Code annuncia l'intervallo valido e ti consente di riprovare.

92 

93I prompt sì-o-no chiedono una risposta digitata invece di un menu a due opzioni. Rispondi con `y` o `n` e premi Invio. Funzionano anche `yes` e `no`.

94 

95<h2 id="hear-when-claude-code-needs-you">

96 Ascolta quando Claude Code ha bisogno di te

97</h2>

98 

99In modalità lettore di schermo, Claude Code suona il campanello del terminale quando ha bisogno della tua attenzione, in modo che tu non debba continuare a controllare la trascrizione. Il campanello suona quando:

100 

101* Claude finisce una risposta

102* appare un prompt di permesso

103* uno strumento che è stato eseguito per più di 5 secondi finisce

104 

105Il campanello è l'avviso standard del tuo terminale. Per silenziarlo, modifica l'impostazione del campanello nella tua applicazione terminale. Il campanello non richiede la modalità lettore di schermo: al di fuori della modalità, imposta [`preferredNotifChannel`](/it/settings#available-settings) su `"terminal_bell"` per avvisi simili quando Claude è in attesa di te. Consulta [Ottieni un campanello terminale o una notifica](/it/terminal-config#get-a-terminal-bell-or-notification).

106 

107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 Impostazioni di accessibilità oltre la modalità lettore di schermo

109</h2>

110 

111Queste opzioni affrontano le esigenze di accessibilità al di fuori della modalità lettore di schermo. Tutte funzionano insieme ad essa.

112 

113* La [variabile di ambiente](/it/env-vars) `CLAUDE_CODE_ACCESSIBILITY` è per gli ingranditori di schermo. Imposta `CLAUDE_CODE_ACCESSIBILITY=1` per mantenere visibile il cursore del terminale nativo in modo che gli ingranditori, come macOS Zoom, possano tracciare la posizione del cursore.

114* L'[impostazione](/it/settings#available-settings) `prefersReducedMotion` riduce o disabilita spinner, shimmer e altre animazioni senza modificare il resto dell'interfaccia.

115* L'[impostazione](/it/settings#available-settings) `theme` seleziona i colori dell'interfaccia, inclusi i temi adatti ai daltonici `dark-daltonized` e `light-daltonized`.

116 

117<h2 id="known-limitations">

118 Limitazioni note

119</h2>

120 

121Alcuni comportamenti non sono adattati per la modalità lettore di schermo:

122 

123* La modalità lettore di schermo non si attiva automaticamente quando un lettore di schermo è in esecuzione.

124* I cambiamenti di modalità, come l'ingresso in [plan mode](/it/permission-modes#analyze-before-you-edit-with-plan-mode), non vengono ancora annunciati.

125* L'allegato a una [sessione in background](/it/agent-view) con `claude attach` o dalla vista agente entra nello schermo alternativo del terminale, che non ha scrollback nativo. Questo è lo [stesso comportamento di altre sessioni allegate](/it/fullscreen). Per uscire, premi la freccia sinistra su un prompt vuoto, o Ctrl+Z se un dialogo ha il focus.

126* Claude Code annuncia i costi nel riepilogo che stampa all'uscita, non per turno.

127* La modalità lettore di schermo non modifica la [modalità non interattiva](/it/headless) con il flag `-p`. La modalità non interattiva scrive già testo semplice e rimane un'alternativa per lo scripting.

128 

129<h2 id="report-an-issue">

130 Segnala un problema

131</h2>

132 

133Se qualcosa non funziona con il tuo lettore di schermo, ingranditore o terminale, apri un problema sul [tracker dei problemi di Claude Code](https://github.com/anthropics/claude-code/issues) e menziona la tua tecnologia assistiva nel titolo. Includi il tuo sistema operativo, l'applicazione terminale e il nome e la versione della tecnologia assistiva nel rapporto.

134 

135<h2 id="related-resources">

136 Risorse correlate

137</h2>

138 

139Queste pagine contengono le voci di riferimento complete e la configurazione correlata per ciò che questa pagina copre:

140 

141* [Settings](/it/settings#available-settings): le voci `axScreenReader`, `prefersReducedMotion`, `theme` e `preferredNotifChannel`

142* [Environment variables](/it/env-vars): le voci `CLAUDE_AX_SCREEN_READER` e `CLAUDE_CODE_ACCESSIBILITY`

143* [CLI reference](/it/cli-reference#cli-flags): il flag `--ax-screen-reader`

144* [Terminal configuration](/it/terminal-config): campanelli, notifiche e temi al di fuori della modalità lettore di schermo

145* [Non-interactive mode](/it/headless): esecuzioni `claude -p` con script, che scrivono testo semplice senza modalità lettore di schermo

69 69 

70Consulta [Server-managed settings](/it/server-managed-settings) e [Settings files and precedence](/it/settings#settings-files).70Consulta [Server-managed settings](/it/server-managed-settings) e [Settings files and precedence](/it/settings#settings-files).

71 71 

72<h3 id="wsl-sessions-in-claude-code-desktop">

73 Sessioni WSL in Claude Code Desktop

74</h3>

75 

76Su Windows, [Claude Code Desktop può eseguire sessioni di Code all'interno di una distribuzione WSL 2](/it/desktop-wsl). Il processo Claude Code della sessione viene eseguito all'interno della distribuzione, quindi risolve le impostazioni gestite attraverso il percorso di discovery WSL sopra: le fonti solo Windows non lo raggiungono a meno che `wslInheritsWindowsSettings: true` non sia distribuito.

77 

78Sui dispositivi in cui sono presenti impostazioni gestite, le sessioni WSL Desktop sono disabilitate per impostazione predefinita. Se la tua organizzazione vuole abilitarle, contatta il tuo team di account Anthropic. Quando sono abilitate:

79 

80* Distribuisci `wslInheritsWindowsSettings: true` attraverso il registro HKLM o il file `C:\Program Files\ClaudeCode` in modo che le sessioni WSL ereditino la stessa policy delle sessioni host.

81* Verifica eseguendo `/status` all'interno di una sessione WSL: la riga `Setting sources` dovrebbe mostrare `Enterprise managed settings` con la fonte Windows che hai distribuito, `(HKLM)` o `(file)`.

82 

83I processi all'interno della VM utility WSL 2 non sono visibili ai sensori di rilevamento endpoint lato Windows. Se utilizzi CrowdStrike Falcon, abilita il sensore Falcon per Linux su WSL 2 con le due esclusioni che la documentazione WSL di CrowdStrike richiede, per il processo della macchina virtuale WSL e l'immagine del disco della VM, in modo che l'attività dei processi e dei file all'interno della distribuzione sia osservabile. La [telemetria di esecuzione dello strumento OpenTelemetry](/it/monitoring-usage) di Claude Code viene emessa in modo identico per le sessioni WSL e native.

84 

72<h2 id="decide-what-to-enforce">85<h2 id="decide-what-to-enforce">

73 Decidi cosa applicare86 Decidi cosa applicare

74</h2>87</h2>

100 Configura la visibilità dell'utilizzo113 Configura la visibilità dell'utilizzo

101</h2>114</h2>

102 115 

103Scegli il monitoraggio in base a ciò che devi segnalare.116Scegli il monitoraggio in base a ciò che devi segnalare. Le dashboard, le API e i controlli di spesa differiscono tra i piani Claude for Teams o Enterprise e le organizzazioni Claude Console, quindi controlla la colonna Disponibilità prima di pianificare la tua reportistica attorno a una capacità.

104 117 

105| Capacità | Cosa ottieni | Disponibilità | Da dove iniziare |118| Capacità | Cosa ottieni | Disponibilità | Da dove iniziare |

106| :------------------ | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------- |119| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- |

107| Usage monitoring | Esportazione OpenTelemetry di sessioni, strumenti e token | Tutti i provider | [Monitoring usage](/it/monitoring-usage) |120| Usage monitoring | Esportazione OpenTelemetry di sessioni, strumenti e token | Tutti i provider | [Monitoring usage](/it/monitoring-usage) |

108| Analytics dashboard | Metriche per utente, tracciamento dei contributi, leaderboard | Solo Anthropic | [Analytics](/it/analytics) |121| Analytics dashboard | Metriche di adozione e contributo con una leaderboard su Teams / Enterprise; metriche di utilizzo e spesa per utente su Console | Teams / Enterprise su [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console su [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/it/analytics) |

109| Cost tracking | Limiti di spesa, limiti di velocità e attribuzione dell'utilizzo | Solo Anthropic; sui cloud di terze parti, un [Claude apps gateway](/it/claude-apps-gateway) fornisce attribuzione per utente e [limiti di spesa](/it/claude-apps-gateway-spend-limits) | [Costs](/it/costs) |122| Programmatic reporting | Dati di utilizzo e costo per utente tramite un'API | [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) per Enterprise, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) per Console | [Costs](/it/costs#manage-costs-for-your-organization) |

123| Spend controls | Limiti di spesa e limiti di velocità | Impostazioni amministratore per Teams / Enterprise, limiti dell'area di lavoro per Console; sui cloud di terze parti, controlli del budget cloud o un [Claude apps gateway](/it/claude-apps-gateway) con [limiti di spesa](/it/claude-apps-gateway-spend-limits) per utente | [Costs](/it/costs#manage-costs-for-your-organization) |

110 124 

111I provider cloud espongono la spesa attraverso AWS Cost Explorer, GCP Billing o Azure Cost Management. I piani Claude for Teams e Enterprise includono una dashboard di utilizzo su [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code).125Su Teams e Enterprise, i numeri di utilizzo e spesa per utente provengono dal [rapporto di spesa](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) nelle impostazioni di analisi della tua organizzazione, non dalla dashboard di analisi. I provider cloud espongono la spesa attraverso AWS Cost Explorer, GCP Billing o Azure Cost Management. Per pianificare i budget aziendali su Claude chat, Claude Code e Cowork, consulta la [guida al consumo Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide).

112 126 

113<h2 id="review-data-handling">127<h2 id="review-data-handling">

114 Rivedi la gestione dei dati128 Rivedi la gestione dei dati

6 6 

7> Abbina il tuo modello principale con un modello advisor più potente che Claude consulta nei momenti chiave durante un'attività.7> Abbina il tuo modello principale con un modello advisor più potente che Claude consulta nei momenti chiave durante un'attività.

8 8 

9{/* plan-availability: feature=advisor providers=anthropic */}

10 

11<Note>9<Note>

12 Lo strumento advisor è sperimentale e richiede Claude Code v2.1.98 o successivo con l'API Anthropic. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Il comportamento, i prezzi e la disponibilità potrebbero cambiare.10 Lo strumento advisor è sperimentale e richiede l'API Anthropic. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Il comportamento, i prezzi e la disponibilità potrebbero cambiare.

13</Note>11</Note>

14 12 

15Lo strumento advisor consente a Claude di consultare un secondo modello, tipicamente più potente, nei momenti chiave durante un'attività, ad esempio prima di impegnarsi in un approccio, quando bloccato su un errore ricorrente, o prima di dichiarare un'attività completata. L'advisor riceve l'intera conversazione, incluse tutte le chiamate agli strumenti e i risultati, e restituisce una guida che Claude applica prima di continuare.13Lo strumento advisor consente a Claude di consultare un secondo modello, tipicamente più potente, nei momenti chiave durante un'attività, ad esempio prima di impegnarsi in un approccio, quando bloccato su un errore ricorrente, o prima di dichiarare un'attività completata. L'advisor riceve l'intera conversazione, incluse tutte le chiamate agli strumenti e i risultati, e restituisce una guida che Claude applica prima di continuare.

161 159 

162Lo strumento advisor richiede tutti i seguenti:160Lo strumento advisor richiede tutti i seguenti:

163 161 

164* **Claude Code v2.1.98 o successivo**: esegui `claude update` per aggiornare.

165* **Solo API Anthropic**: l'advisor è uno strumento eseguito dal server. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry. Attraverso un [gateway LLM](/it/llm-gateway) configurato con `ANTHROPIC_BASE_URL`, la disponibilità dipende dal fatto che il gateway inoltri la richiesta intatta all'API Anthropic.162* **Solo API Anthropic**: l'advisor è uno strumento eseguito dal server. Non è disponibile su Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry. Attraverso un [gateway LLM](/it/llm-gateway) configurato con `ANTHROPIC_BASE_URL`, la disponibilità dipende dal fatto che il gateway inoltri la richiesta intatta all'API Anthropic.

166* **Modello principale supportato**: Opus 4.6 o successivo, Sonnet 4.6 o successivo, o Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 si qualifica anche su Claude Code v2.1.170 o successivo.163* **Modello principale supportato**: Opus 4.6 o successivo, Sonnet 4.6 o successivo, o Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5 si qualifica anche su Claude Code v2.1.170 o successivo.

167 164 

497 Autenticazione OAuth2497 Autenticazione OAuth2

498</h3>498</h3>

499 499 

500La [specifica MCP supporta OAuth 2.1](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) per l'autorizzazione. L'SDK non gestisce i flussi OAuth automaticamente, ma puoi passare i token di accesso tramite intestazioni dopo aver completato il flusso OAuth nella tua applicazione:500La [specifica MCP supporta OAuth 2.1](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) per l'autorizzazione. L'SDK non apre un browser né esegue un flusso OAuth interattivo. Quando un server configurato restituisce una sfida di autorizzazione e nessun token memorizzato è disponibile, l'esecuzione dell'agente continua senza gli strumenti di quel server, e il server viene segnalato con lo stato `needs-auth` nell'array `mcp_servers` del [messaggio di inizializzazione del sistema](/it/agent-sdk/typescript#sdksystemmessage). Controlla quell'array all'avvio se il tuo agente dipende da uno specifico server connesso.

501 

502Per fornire le credenziali, completa il flusso OAuth nella tua applicazione e passa il token di accesso risultante nelle `headers` del server:

501 503 

502<CodeGroup>504<CodeGroup>

503 ```typescript TypeScript theme={null}505 ```typescript TypeScript theme={null}

62 ```62 ```

63 </Tab>63 </Tab>

64 64 

65 <Tab title="Python">65 <Tab title="Python (uv)">

66 [uv](https://docs.astral.sh/uv/) è un gestore di pacchetti Python veloce che gestisce automaticamente gli ambienti virtuali:

67 

68 ```bash theme={null}

69 uv init

70 uv add claude-agent-sdk

71 ```

72 </Tab>

73 

74 <Tab title="Python (pip)">

75 Crea e attiva un ambiente virtuale, quindi installa il pacchetto. L'installazione in un ambiente virtuale evita l'errore `error: externally-managed-environment` che Python di sistema su recenti installazioni Debian, Ubuntu e Homebrew restituisce per `pip install` al di fuori di un venv.

76 

77 Su macOS o Linux:

78 

66 ```bash theme={null}79 ```bash theme={null}

80 python3 -m venv .venv

81 source .venv/bin/activate

82 pip install claude-agent-sdk

83 ```

84 

85 Su Windows:

86 

87 ```powershell theme={null}

88 py -m venv .venv

89 .venv\Scripts\Activate.ps1

67 pip install claude-agent-sdk90 pip install claude-agent-sdk

68 ```91 ```

69 92 

93 Se PowerShell blocca `Activate.ps1` con un errore di criterio di esecuzione, esegui prima `Set-ExecutionPolicy -Scope Process RemoteSigned`.

94 

70 Il pacchetto Python richiede Python 3.10 o versioni successive. Se pip segnala `No matching distribution found for claude-agent-sdk`, il tuo interprete è più vecchio di 3.10. Esegui `python3 --version` su macOS o Linux, oppure `py --version` su Windows, per verificare.95 Il pacchetto Python richiede Python 3.10 o versioni successive. Se pip segnala `No matching distribution found for claude-agent-sdk`, il tuo interprete è più vecchio di 3.10. Esegui `python3 --version` su macOS o Linux, oppure `py --version` su Windows, per verificare.

71 </Tab>96 </Tab>

72 </Tabs>97 </Tabs>

77 </Step>102 </Step>

78 103 

79 <Step title="Imposta la tua chiave API">104 <Step title="Imposta la tua chiave API">

80 Ottieni una chiave API dalla [Console](https://platform.claude.com/), quindi impostala come variabile di ambiente:105 Ottieni una chiave API dalla [Console](https://platform.claude.com/), quindi impostala come variabile di ambiente.

106 

107 Su macOS o Linux:

81 108 

82 ```bash theme={null}109 ```bash theme={null}

83 export ANTHROPIC_API_KEY=your-api-key110 export ANTHROPIC_API_KEY=sk-ant-xxxxx

111 ```

112 

113 Su Windows PowerShell:

114 

115 ```powershell theme={null}

116 $env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

84 ```117 ```

85 118 

86 L'SDK supporta anche l'autenticazione tramite provider API di terze parti:119 L'SDK supporta anche l'autenticazione tramite provider API di terze parti:

10 Installazione10 Installazione

11</h2>11</h2>

12 12 

13Installare il pacchetto in un ambiente virtuale. Su recenti installazioni di Debian, Ubuntu e Homebrew Python, l'esecuzione di `pip install` su Python di sistema fallisce con `error: externally-managed-environment`.

14 

13```bash theme={null}15```bash theme={null}

16python3 -m venv .venv

17source .venv/bin/activate

14pip install claude-agent-sdk18pip install claude-agent-sdk

15```19```

16 20 

21Per uv, Windows PowerShell e configurazione della chiave API, vedere [Iniziare nella panoramica di Agent SDK](/it/agent-sdk/overview#get-started).

22 

17<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

18 Scelta tra `query()` e `ClaudeSDKClient`24 Scelta tra `query()` e `ClaudeSDKClient`

19</h2>25</h2>

332 Controlli del modello all'avvio332 Controlli del modello all'avvio

333</h2>333</h2>

334 334 

335Quando Claude Code si avvia con Amazon Bedrock configurato, verifica che i modelli che intende utilizzare siano accessibili nel tuo account. Questo controllo richiede Claude Code v2.1.94 o successivo.335Quando Claude Code si avvia con Amazon Bedrock configurato, verifica che i modelli che intende utilizzare siano accessibili nel tuo account.

336 336 

337Se hai fissato una versione del modello più vecchia rispetto al valore predefinito corrente di Claude Code, e il tuo account può invocare la versione più recente, Claude Code ti chiede di aggiornare il fissaggio. Accettare scrive il nuovo ID del modello nel tuo [file di impostazioni utente](/it/settings) e riavvia Claude Code. Rifiutare viene ricordato fino al prossimo cambio di versione predefinita. I fissaggi che puntano a un [ARN del profilo di inferenza dell'applicazione](#map-each-model-version-to-an-inference-profile) vengono saltati, poiché sono gestiti dal tuo amministratore.337Se hai fissato una versione del modello più vecchia rispetto al valore predefinito corrente di Claude Code, e il tuo account può invocare la versione più recente, Claude Code ti chiede di aggiornare il fissaggio. Accettare scrive il nuovo ID del modello nel tuo [file di impostazioni utente](/it/settings) e riavvia Claude Code. Rifiutare viene ricordato fino al prossimo cambio di versione predefinita. I fissaggi che puntano a un [ARN del profilo di inferenza dell'applicazione](#map-each-model-version-to-an-inference-profile) vengono saltati, poiché sono gestiti dal tuo amministratore.

338 338 

435 435 

436Mantle è un endpoint di Amazon Bedrock che serve i modelli Claude attraverso la forma API nativa di Anthropic piuttosto che l'API Invoke di Amazon Bedrock. Utilizza le stesse credenziali AWS, autorizzazioni IAM e configurazione `awsAuthRefresh` descritte in precedenza in questa pagina.436Mantle è un endpoint di Amazon Bedrock che serve i modelli Claude attraverso la forma API nativa di Anthropic piuttosto che l'API Invoke di Amazon Bedrock. Utilizza le stesse credenziali AWS, autorizzazioni IAM e configurazione `awsAuthRefresh` descritte in precedenza in questa pagina.

437 437 

438<Note>

439 Mantle richiede Claude Code v2.1.94 o successivo. Esegui `claude --version` per verificare.

440</Note>

441 

442<h3 id="enable-mantle">438<h3 id="enable-mantle">

443 Abilita Mantle439 Abilita Mantle

444</h3>440</h3>

26* **Leaderboard**: i principali contributori classificati per utilizzo di Claude Code26* **Leaderboard**: i principali contributori classificati per utilizzo di Claude Code

27* **Esportazione dati**: scarica i dati di contributo come CSV per report personalizzati27* **Esportazione dati**: scarica i dati di contributo come CSV per report personalizzati

28 28 

29Per i conteggi dei token per utente e le stime dei costi, configura [esportazione OpenTelemetry](/it/monitoring-usage).29Per i conteggi dei token per utente e le stime dei costi, configura [esportazione OpenTelemetry](/it/monitoring-usage), oppure esporta il [report di spesa](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) dalle impostazioni di analittica della tua organizzazione, che elenca l'utilizzo dei token e la spesa stimata in crediti di utilizzo per utente e per modello.

30 30 

31<h3 id="enable-contribution-metrics">31<h3 id="enable-contribution-metrics">

32 Enable contribution metrics32 Enable contribution metrics

228 Access data programmatically228 Access data programmatically

229</h4>229</h4>

230 230 

231Per interrogare questi dati tramite GitHub, cerca i PR etichettati con `claude-code-assisted`.231Nel piano Enterprise, l'[API Claude Enterprise Analytics](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) restituisce report di coinvolgimento, utilizzo e costo per utente per la tua organizzazione su tutte le superfici Claude, incluso Claude Code. Un proprietario principale crea una chiave con l'ambito `read:analytics` su [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys). L'API non è disponibile nel piano Teams.

232 

233Per interrogare i dati di contributo tramite GitHub, cerca i PR etichettati con `claude-code-assisted`.

232 234 

233<h2 id="access-analytics-for-api-customers">235<h2 id="access-analytics-for-api-customers">

234 Access analytics for API customers236 Access analytics for API customers

235</h2>237</h2>

236 238 

237I clienti API che utilizzano Claude Console possono accedere all'analittica su [platform.claude.com/claude-code](https://platform.claude.com/claude-code). Hai bisogno dell'autorizzazione UsageView per accedere al dashboard, che viene concessa ai ruoli Developer, Billing, Admin, Owner e Primary Owner.239I clienti API che utilizzano Claude Console possono accedere all'analittica su [platform.claude.com/claude-code](https://platform.claude.com/claude-code). Hai bisogno dell'autorizzazione UsageView per accedere al dashboard, che viene concessa ai ruoli Developer, Billing, Admin, Owner e Primary Owner. Per estrarre le stesse metriche giornaliere per utente a livello di programmazione, utilizza l'[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) con una chiave API Admin.

238 240 

239<Note>241<Note>

240 Le metriche di contributo con integrazione GitHub non sono attualmente disponibili per i clienti API. Il dashboard della console mostra solo le metriche di utilizzo e spesa.242 Le metriche di contributo con integrazione GitHub non sono attualmente disponibili per i clienti API. Il dashboard della console mostra solo le metriche di utilizzo e spesa.

480 480 

481Claude crea automaticamente snapshot dei file prima di ogni modifica in modo che un checkpoint possa ripristinarli. Premete il doppio tasto Escape o eseguite `/rewind` per aprire il menu di rewind. Potete ripristinare solo la conversazione, ripristinare solo il codice, ripristinare entrambi o riassumere da un messaggio selezionato. Consultate [Checkpointing](/it/checkpointing) per i dettagli.481Claude crea automaticamente snapshot dei file prima di ogni modifica in modo che un checkpoint possa ripristinarli. Premete il doppio tasto Escape o eseguite `/rewind` per aprire il menu di rewind. Potete ripristinare solo la conversazione, ripristinare solo il codice, ripristinare entrambi o riassumere da un messaggio selezionato. Consultate [Checkpointing](/it/checkpointing) per i dettagli.

482 482 

483Invece di pianificare attentamente ogni mossa, potete dire a Claude di provare qualcosa di rischioso. Se non funziona, riavvolgete e provate un approccio diverso. I checkpoint persistono tra le sessioni, quindi potete chiudere il vostro terminale e comunque riavvolgere in seguito.483Invece di pianificare attentamente ogni mossa, potete dire a Claude di provare qualcosa di rischioso. Se non funziona, riavvolgete e provate un approccio diverso. I checkpoint vengono salvati con la conversazione, quindi potete chiudere il vostro terminale, riprendere la sessione in seguito e comunque riavvolgere.

484 484 

485<Warning>485<Warning>

486 I checkpoint tracciano solo le modifiche apportate *da Claude*, non i processi esterni. Questo non è un sostituto per git.486 I checkpoint tracciano solo le modifiche apportate attraverso gli strumenti di modifica dei file di Claude. Le modifiche apportate attraverso comandi Bash o processi esterni non vengono acquisite. Questo non è un sostituto per git.

487</Warning>487</Warning>

488 488 

489<h3 id="resume-conversations">489<h3 id="resume-conversations">

514 Utilizzate `claude -p "prompt"` in CI, pre-commit hooks o script. Aggiungete `--output-format stream-json --verbose` per l'output JSON in streaming.514 Utilizzate `claude -p "prompt"` in CI, pre-commit hooks o script. Aggiungete `--output-format stream-json --verbose` per l'output JSON in streaming.

515</Tip>515</Tip>

516 516 

517Con `claude -p "your prompt"`, potete eseguire Claude in modo non interattivo, senza una sessione. [La modalità non interattiva](/it/headless) è il modo in cui integrate Claude nelle pipeline CI, pre-commit hooks o qualsiasi flusso di lavoro automatizzato. I formati di output vi permettono di analizzare i risultati a livello di programmazione: testo semplice, JSON o JSON in streaming.517Con `claude -p "your prompt"`, potete eseguire Claude in modo non interattivo, senza un prompt interattivo. L'esecuzione crea comunque una sessione ripristinabile a meno che non passiate `--no-session-persistence`. [La modalità non interattiva](/it/headless) è il modo in cui integrate Claude nelle pipeline CI, pre-commit hooks o qualsiasi flusso di lavoro automatizzato. I formati di output vi permettono di analizzare i risultati a livello di programmazione: testo semplice, JSON o JSON in streaming.

518 518 

519```bash theme={null}519```bash theme={null}

520# One-off queries520# One-off queries

7> Utilizza i canali per inviare messaggi, avvisi e webhook nella tua sessione Claude Code da un server MCP. Inoltra i risultati CI, i messaggi di chat e gli eventi di monitoraggio in modo che Claude possa reagire mentre sei assente.7> Utilizza i canali per inviare messaggi, avvisi e webhook nella tua sessione Claude Code da un server MCP. Inoltra i risultati CI, i messaggi di chat e gli eventi di monitoraggio in modo che Claude possa reagire mentre sei assente.

8 8 

9<Note>9<Note>

10 I canali sono in [anteprima di ricerca](#research-preview) e richiedono Claude Code v2.1.80 o versione successiva. Richiedono l'autenticazione Anthropic tramite claude.ai o una chiave API Console, e non sono disponibili su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Le organizzazioni Team ed Enterprise devono [abilitarli esplicitamente](#enterprise-controls).10 I canali sono in [anteprima di ricerca](#research-preview). Richiedono l'autenticazione Anthropic tramite claude.ai o una chiave API Console, e non sono disponibili su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Le organizzazioni Team ed Enterprise devono [abilitarli esplicitamente](#enterprise-controls).

11</Note>11</Note>

12 12 

13Un canale è un server MCP che invia eventi nella tua sessione Claude Code in esecuzione, in modo che Claude possa reagire alle cose che accadono mentre non sei al terminale. I canali possono essere bidirezionali: Claude legge l'evento e risponde attraverso lo stesso canale, come un ponte di chat. Gli eventi arrivano solo mentre la sessione è aperta, quindi per una configurazione sempre attiva esegui Claude in un processo in background o in un terminale persistente.13Un canale è un server MCP che invia eventi nella tua sessione Claude Code in esecuzione, in modo che Claude possa reagire alle cose che accadono mentre non sei al terminale. I canali possono essere bidirezionali: Claude legge l'evento e risponde attraverso lo stesso canale, come un ponte di chat. Gli eventi arrivano solo mentre la sessione è aperta, quindi per una configurazione sempre attiva esegui Claude in un processo in background o in un terminale persistente.

7> Crea un server MCP che invia webhook, avvisi e messaggi di chat in una sessione di Claude Code. Riferimento per il contratto del canale: dichiarazione di capacità, eventi di notifica, strumenti di risposta, gating del mittente e inoltro delle autorizzazioni.7> Crea un server MCP che invia webhook, avvisi e messaggi di chat in una sessione di Claude Code. Riferimento per il contratto del canale: dichiarazione di capacità, eventi di notifica, strumenti di risposta, gating del mittente e inoltro delle autorizzazioni.

8 8 

9<Note>9<Note>

10 I canali sono in [anteprima di ricerca](/it/channels#research-preview) e richiedono Claude Code v2.1.80 o successivo. Le organizzazioni Team ed Enterprise devono [abilitarli esplicitamente](/it/channels#enterprise-controls).10 I canali sono in [anteprima di ricerca](/it/channels#research-preview). Le organizzazioni Team ed Enterprise devono [abilitarli esplicitamente](/it/channels#enterprise-controls).

11</Note>11</Note>

12 12 

13Un canale è un server MCP che invia eventi in una sessione di Claude Code in modo che Claude possa reagire a cose che accadono al di fuori del terminale.13Un canale è un server MCP che invia eventi in una sessione di Claude Code in modo che Claude possa reagire a cose che accadono al di fuori del terminale.

453 Inoltro delle richieste di autorizzazione453 Inoltro delle richieste di autorizzazione

454</h2>454</h2>

455 455 

456<Note>

457 L'inoltro delle autorizzazioni richiede Claude Code v2.1.81 o successivo. Le versioni precedenti ignorano la capacità `claude/channel/permission`.

458</Note>

459 

460Quando Claude chiama uno strumento che ha bisogno di approvazione, la finestra di dialogo del terminale locale si apre e la sessione attende. Un canale bidirezionale può optare per ricevere lo stesso prompt in parallelo e inoltrarlo a te su un altro dispositivo. Entrambi rimangono attivi: puoi rispondere nel terminale o sul tuo telefono e Claude Code applica qualsiasi risposta arrivi per prima e chiude l'altra.456Quando Claude chiama uno strumento che ha bisogno di approvazione, la finestra di dialogo del terminale locale si apre e la sessione attende. Un canale bidirezionale può optare per ricevere lo stesso prompt in parallelo e inoltrarlo a te su un altro dispositivo. Entrambi rimangono attivi: puoi rispondere nel terminale o sul tuo telefono e Claude Code applica qualsiasi risposta arrivi per prima e chiude l'altra.

461 457 

462L'inoltro copre le approvazioni di uso dello strumento come `Bash`, `Write` e `Edit`. La fiducia del progetto e i dialoghi di consenso del server MCP non vengono inoltrati; quelli appaiono solo nel terminale locale.458L'inoltro copre le approvazioni di uso dello strumento come `Bash`, `Write` e `Edit`. La fiducia del progetto e i dialoghi di consenso del server MCP non vengono inoltrati; quelli appaiono solo nel terminale locale.

12 Come funziona il checkpointing12 Come funziona il checkpointing

13</h2>13</h2>

14 14 

15Mentre lavori con Claude, il checkpointing cattura automaticamente lo stato del tuo codice prima di ogni modifica. Questa rete di sicurezza ti permette di affrontare compiti ambiziosi e su larga scala sapendo che puoi sempre tornare a uno stato di codice precedente.15Mentre lavori con Claude, il checkpointing cattura automaticamente lo stato del tuo codice prima di ogni prompt dell'utente. Questa rete di sicurezza ti permette di affrontare compiti ambiziosi e su larga scala sapendo che puoi sempre tornare a uno stato di codice precedente.

16 16 

17<h3 id="automatic-tracking">17<h3 id="automatic-tracking">

18 Tracciamento automatico18 Tracciamento automatico

21Claude Code traccia tutti i cambiamenti effettuati dai suoi strumenti di modifica dei file:21Claude Code traccia tutti i cambiamenti effettuati dai suoi strumenti di modifica dei file:

22 22 

23* Ogni prompt dell'utente crea un nuovo checkpoint23* Ogni prompt dell'utente crea un nuovo checkpoint

24* I checkpoint persistono tra le sessioni, quindi puoi accedervi nelle conversazioni riprese24* I checkpoint vengono salvati con la conversazione, quindi una sessione ripresa può comunque `/rewind` verso di essi

25* Puliti automaticamente insieme alle sessioni dopo 30 giorni (configurabile)25* Puliti automaticamente insieme alle sessioni dopo 30 giorni (configurabile)

26 26 

27<h3 id="rewind-and-summarize">27<h3 id="rewind-and-summarize">

36 36 

37* Browser [Google Chrome](https://www.google.com/chrome/) o [Microsoft Edge](https://www.microsoft.com/edge)37* Browser [Google Chrome](https://www.google.com/chrome/) o [Microsoft Edge](https://www.microsoft.com/edge)

38* Estensione [Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versione 1.0.36 o superiore, disponibile nel Chrome Web Store per entrambi i browser38* Estensione [Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versione 1.0.36 o superiore, disponibile nel Chrome Web Store per entrambi i browser

39* [Claude Code](/it/quickstart#step-1-install-claude-code) versione 2.0.73 o superiore39* [Claude Code](/it/quickstart#step-1-install-claude-code)

40* Un piano Anthropic diretto (Pro, Max, Team o Enterprise)40* Un piano Anthropic diretto (Pro, Max, Team o Enterprise)

41 41 

42<Note>42<Note>

59| Flag | Descrizione | Esempio |59| Flag | Descrizione | Esempio |

60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | Aggiungi directory di lavoro aggiuntive per Claude per leggere e modificare file. Concede l'accesso ai file; la maggior parte della configurazione `.claude/` [non viene scoperta](/it/permissions#additional-directories-grant-file-access-not-configuration) da queste directory. Convalida che ogni percorso esista come directory. Per persistere queste directory tra le sessioni, imposta [`permissions.additionalDirectories`](/it/settings#permission-settings) nelle impostazioni | `claude --add-dir ../apps ../lib` |61| `--add-dir` | Aggiungi directory di lavoro aggiuntive per Claude per leggere e modificare file. Concede l'accesso ai file; la maggior parte della configurazione `.claude/` [non viene scoperta](/it/permissions#additional-directories-grant-file-access-not-configuration) da queste directory. Convalida che ogni percorso esista come directory. Per persistere queste directory tra le sessioni, imposta [`permissions.additionalDirectories`](/it/settings#permission-settings) nelle impostazioni | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | {/* min-version: 2.1.98 */}Abilita lo [strumento advisor](/it/advisor) lato server per questa sessione con un alias di modello: `opus`, `sonnet` o `fable` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Ha la precedenza sull'impostazione `advisorModel` per la sessione. Richiede Claude Code v2.1.98 o successivo | `claude --advisor opus` |62| `--advisor <model>` | Abilita lo [strumento advisor](/it/advisor) lato server per questa sessione con un alias di modello: `opus`, `sonnet` o `fable` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Ha la precedenza sull'impostazione `advisorModel` per la sessione | `claude --advisor opus` |

63| `--agent` | Specifica un agent per la sessione corrente (sostituisce l'impostazione `agent`) | `claude --agent my-custom-agent` |63| `--agent` | Specifica un agent per la sessione corrente (sostituisce l'impostazione `agent`) | `claude --agent my-custom-agent` |

64| `--agents` | Definisci subagents personalizzati dinamicamente tramite JSON. Utilizza gli stessi nomi di campo del [frontmatter](/it/sub-agents#supported-frontmatter-fields) dei subagents, più un campo `prompt` per le istruzioni dell'agent | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | Definisci subagents personalizzati dinamicamente tramite JSON. Utilizza gli stessi nomi di campo del [frontmatter](/it/sub-agents#supported-frontmatter-fields) dei subagents, più un campo `prompt` per le istruzioni dell'agent | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

65| `--allow-dangerously-skip-permissions` | Aggiungi `bypassPermissions` al ciclo della modalità `Shift+Tab` senza iniziare in essa. Ti consente di iniziare in una modalità diversa come `plan` e passare a `bypassPermissions` in seguito. Vedi [modalità di autorizzazione](/it/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | Aggiungi `bypassPermissions` al ciclo della modalità `Shift+Tab` senza iniziare in essa. Ti consente di iniziare in una modalità diversa come `plan` e passare a `bypassPermissions` in seguito. Vedi [modalità di autorizzazione](/it/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Aggiungi testo personalizzato alla fine del prompt di sistema di ogni [subagent](/it/sub-agents), inclusi i subagents annidati. Si applica solo in modalità non interattiva con `-p`. Richiede Claude Code v2.1.205 o successivo | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Aggiungi testo personalizzato alla fine del prompt di sistema di ogni [subagent](/it/sub-agents), inclusi i subagents annidati. Si applica solo in modalità non interattiva con `-p`. Richiede Claude Code v2.1.205 o successivo | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

68| `--append-system-prompt` | Aggiungi testo personalizzato alla fine del prompt di sistema predefinito | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | Aggiungi testo personalizzato alla fine del prompt di sistema predefinito | `claude --append-system-prompt "Always use TypeScript"` |

69| `--append-system-prompt-file` | Carica testo di prompt di sistema aggiuntivo da un file e aggiungi al prompt predefinito | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | Carica testo di prompt di sistema aggiuntivo da un file e aggiungi al prompt predefinito | `claude --append-system-prompt-file ./extra-rules.txt` |

70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lettore di schermo: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione [`tui`](/it/settings#available-settings) non ha effetto per la sessione. Ha la precedenza su [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e l'impostazione [`axScreenReader`](/it/settings#available-settings). Richiede Claude Code v2.1.181 o successivo | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lettore di schermo: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione [`tui`](/it/settings#available-settings) non ha effetto; le [sessioni in background](/it/agent-view) allegate si rendono comunque a schermo intero. Ha la precedenza su [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e l'impostazione [`axScreenReader`](/it/settings#available-settings). Richiede Claude Code v2.1.181 o successivo | `claude --ax-screen-reader` |

71| `--bare` | Modalità minima: salta l'auto-discovery di hooks, skills, plugins, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script si avviino più velocemente. Claude ha accesso a strumenti Bash, lettura file e modifica file. Imposta [`CLAUDE_CODE_SIMPLE`](/it/env-vars). Vedi [modalità bare](/it/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |71| `--bare` | Modalità minima: salta l'auto-discovery di hooks, skills, plugins, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script si avviino più velocemente. Claude ha accesso a strumenti Bash, lettura file e modifica file. Imposta [`CLAUDE_CODE_SIMPLE`](/it/env-vars). Vedi [modalità bare](/it/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

72| `--betas` | Intestazioni beta da includere nelle richieste API (solo utenti con chiave API) | `claude --betas interleaved-thinking` |72| `--betas` | Intestazioni beta da includere nelle richieste API (solo utenti con chiave API) | `claude --betas interleaved-thinking` |

73| `--bg`, `--background` | Avvia la sessione come un [agent in background](/it/agent-view) e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con `--exec` per eseguire un comando shell come un job in background invece di una sessione Claude, o con `--agent` per eseguire uno specifico subagent. {/* min-version: 2.1.198 */}Non può essere combinato con `-p`/`--print`; vedi il [riferimento degli errori](/it/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | Avvia la sessione come un [agent in background](/it/agent-view) e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con `--exec` per eseguire un comando shell come un job in background invece di una sessione Claude, o con `--agent` per eseguire uno specifico subagent. {/* min-version: 2.1.198 */}Non può essere combinato con `-p`/`--print`; vedi il [riferimento degli errori](/it/errors#command-line-errors) | `claude --bg "investigate the flaky test"` |

50| Comando | Scopo |50| Comando | Scopo |

51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

52| `/add-dir <path>` | Aggiungi una directory di lavoro per l'accesso ai file durante la sessione corrente. La maggior parte della configurazione `.claude/` [non viene rilevata](/it/permissions#additional-directories-grant-file-access-not-configuration) dalla directory aggiunta. Puoi successivamente riprendere la sessione dalla directory aggiunta con `--continue` o `--resume` |52| `/add-dir <path>` | Aggiungi una directory di lavoro per l'accesso ai file durante la sessione corrente. La maggior parte della configurazione `.claude/` [non viene rilevata](/it/permissions#additional-directories-grant-file-access-not-configuration) dalla directory aggiunta. Puoi successivamente riprendere la sessione dalla directory aggiunta con `--continue` o `--resume` |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}Abilita o disabilita lo [strumento advisor](/it/advisor), che consulta un secondo modello per una guida nei momenti chiave durante un'attività. Accetta `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Senza un argomento, apre un selettore. Richiede Claude Code v2.1.98 o successivo |53| `/advisor [model\|off]` | Abilita o disabilita lo [strumento advisor](/it/advisor), che consulta un secondo modello per una guida nei momenti chiave durante un'attività. Accetta `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Senza un argomento, apre un selettore |

54| `/agents` | {/* min-version: 2.1.198 */}A partire da v2.1.198, eseguire `/agents` stampa un promemoria per chiedere a Claude di creare o gestire [subagent](/it/sub-agents), o di modificare direttamente `.claude/agents/` o `~/.claude/agents/`. {/* max-version: 2.1.197 */}Su v2.1.197 e versioni precedenti, apre un'interfaccia interattiva per creare e gestire le configurazioni dei subagent |54| `/agents` | {/* min-version: 2.1.198 */}A partire da v2.1.198, eseguire `/agents` stampa un promemoria per chiedere a Claude di creare o gestire [subagent](/it/sub-agents), o di modificare direttamente `.claude/agents/` o `~/.claude/agents/`. {/* max-version: 2.1.197 */}Su v2.1.197 e versioni precedenti, apre un'interfaccia interattiva per creare e gestire le configurazioni dei subagent |

55| `/autofix-pr [prompt]` | Avvia una sessione [Claude Code sul web](/it/claude-code-on-the-web#auto-fix-pull-requests) che monitora il PR del ramo corrente e invia correzioni quando la CI fallisce o i revisori lasciano commenti. Rileva il PR aperto dal ramo in cui sei posizionato con `gh pr view`; per monitorare un PR diverso, prima controlla il suo ramo. Per impostazione predefinita, la sessione cloud viene istruita a correggere ogni fallimento della CI e commento di revisione; passa un prompt per darle istruzioni diverse, ad esempio `/autofix-pr only fix lint and type errors`. Richiede la CLI `gh` e l'accesso a [Claude Code sul web](/it/claude-code-on-the-web) |55| `/autofix-pr [prompt]` | Avvia una sessione [Claude Code sul web](/it/claude-code-on-the-web#auto-fix-pull-requests) che monitora il PR del ramo corrente e invia correzioni quando la CI fallisce o i revisori lasciano commenti. Rileva il PR aperto dal ramo in cui sei posizionato con `gh pr view`; per monitorare un PR diverso, prima controlla il suo ramo. Per impostazione predefinita, la sessione cloud viene istruita a correggere ogni fallimento della CI e commento di revisione; passa un prompt per darle istruzioni diverse, ad esempio `/autofix-pr only fix lint and type errors`. Richiede la CLI `gh` e l'accesso a [Claude Code sul web](/it/claude-code-on-the-web) |

56| `/background [prompt]` | Stacca la sessione corrente per eseguirla come un [agente in background](/it/agent-view) e libera questo terminale. Passa un prompt per inviare un'istruzione in più prima di staccarsi. Monitora la sessione con `claude agents`. Alias: `/bg` |56| `/background [prompt]` | Stacca la sessione corrente per eseguirla come un [agente in background](/it/agent-view) e libera questo terminale. Passa un prompt per inviare un'istruzione in più prima di staccarsi. Monitora la sessione con `claude agents`. Alias: `/bg` |

324 Puoi utilizzare uno di questi metodi:324 Puoi utilizzare uno di questi metodi:

325 325 

326 1. Trascina e rilascia un'immagine nella finestra di Claude Code326 1. Trascina e rilascia un'immagine nella finestra di Claude Code

327 2. Copia un'immagine e incollala nella CLI con ctrl+v (Non usare cmd+v)327 2. Copia un'immagine e incollala nella CLI con Ctrl+V. Su macOS, Cmd+V funziona anche in iTerm2.

328 3. Fornisci un percorso di immagine a Claude. Ad esempio, "Analyze this image: /path/to/your/image.png"328 3. Fornisci un percorso di immagine a Claude. Ad esempio, "Analyze this image: /path/to/your/image.png"

329 </Step>329 </Step>

330 330 

7> Abilita computer use in Claude Code CLI affinché Claude possa aprire app, fare clic, digitare e vedere il tuo schermo su macOS. Testa app native, esegui il debug di problemi visivi e automatizza strumenti solo GUI senza lasciare il tuo terminale.7> Abilita computer use in Claude Code CLI affinché Claude possa aprire app, fare clic, digitare e vedere il tuo schermo su macOS. Testa app native, esegui il debug di problemi visivi e automatizza strumenti solo GUI senza lasciare il tuo terminale.

8 8 

9<Note>9<Note>

10 {/* plan-availability: feature=computer-use plans=pro,max */}10 Computer use è un'anteprima di ricerca su macOS che richiede un piano Pro o Max. Non è disponibile nei piani Team o Enterprise. Richiede una sessione interattiva, quindi non è disponibile in modalità non interattiva con il flag `-p`.

11 

12 Computer use è un'anteprima di ricerca su macOS che richiede un piano Pro o Max. Non è disponibile nei piani Team o Enterprise. Richiede Claude Code v2.1.85 o successivo e una sessione interattiva, quindi non è disponibile in modalità non interattiva con il flag `-p`.

13</Note>11</Note>

14 12 

15Computer use consente a Claude di aprire app, controllare il tuo schermo e lavorare sulla tua macchina come faresti tu. Dalla CLI, Claude può compilare un'app Swift, avviarla, fare clic su ogni pulsante e acquisire uno screenshot del risultato, il tutto nella stessa conversazione in cui ha scritto il codice.13Computer use consente a Claude di aprire app, controllare il tuo schermo e lavorare sulla tua macchina come faresti tu. Dalla CLI, Claude può compilare un'app Swift, avviarla, fare clic su ogni pulsante e acquisire uno screenshot del risultato, il tutto nella stessa conversazione in cui ha scritto il codice.

238Il server appare solo su configurazioni idonee. Verifica che:236Il server appare solo su configurazioni idonee. Verifica che:

239 237 

240* Sei su macOS. Computer use nella CLI non è disponibile su Linux o Windows. Su Windows, usa [computer use in Desktop](/it/desktop#let-claude-use-your-computer) invece.238* Sei su macOS. Computer use nella CLI non è disponibile su Linux o Windows. Su Windows, usa [computer use in Desktop](/it/desktop#let-claude-use-your-computer) invece.

241* Stai eseguendo Claude Code v2.1.85 o successivo. Esegui `claude --version` per verificare.

242* Sei su un piano Pro o Max. Esegui `/status` per confermare il tuo abbonamento.239* Sei su un piano Pro o Max. Esegui `/status` per confermare il tuo abbonamento.

243* Sei autenticato tramite claude.ai. Computer use non è disponibile con provider di terze parti come Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry. Se accedi a Claude esclusivamente tramite un provider di terze parti, hai bisogno di un account claude.ai separato per usare questa funzionalità.240* Sei autenticato tramite claude.ai. Computer use non è disponibile con provider di terze parti come Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry. Se accedi a Claude esclusivamente tramite un provider di terze parti, hai bisogno di un account claude.ai separato per usare questa funzionalità.

244* Sei in una sessione interattiva. Computer use non è disponibile in modalità non interattiva con il flag `-p`.241* Sei in una sessione interattiva. Computer use non è disponibile in modalità non interattiva con il flag `-p`.

10 10 

11Nelle distribuzioni aziendali, il costo medio è di circa \$13 per sviluppatore per giorno attivo e \$150-250 per sviluppatore al mese, con costi che rimangono al di sotto di \$30 per giorno attivo per il 90% degli utenti. Per stimare la spesa per il tuo team, inizia con un piccolo gruppo pilota e utilizza gli strumenti di tracciamento di seguito per stabilire una baseline prima di un rollout più ampio.11Nelle distribuzioni aziendali, il costo medio è di circa \$13 per sviluppatore per giorno attivo e \$150-250 per sviluppatore al mese, con costi che rimangono al di sotto di \$30 per giorno attivo per il 90% degli utenti. Per stimare la spesa per il tuo team, inizia con un piccolo gruppo pilota e utilizza gli strumenti di tracciamento di seguito per stabilire una baseline prima di un rollout più ampio.

12 12 

13Questa pagina spiega come [tracciare i tuoi costi](#track-your-costs), [gestire i costi per i team](#managing-costs-for-teams) e [ridurre l'utilizzo dei token](#reduce-token-usage).13Questa pagina spiega come [tracciare i tuoi costi](#track-your-costs), [gestire i costi per la tua organizzazione](#manage-costs-for-your-organization) e [ridurre l'utilizzo dei token](#reduce-token-usage).

14 14 

15<h2 id="track-your-costs">15<h2 id="track-your-costs">

16 Traccia i tuoi costi16 Traccia i tuoi costi

37 37 

38Nell'[estensione VS Code](/it/vs-code#check-account-and-usage), la stessa suddivisione appare nella finestra di dialogo Account & usage con un interruttore Day e Week. Richiede Claude Code v2.1.174 o versione successiva.38Nell'[estensione VS Code](/it/vs-code#check-account-and-usage), la stessa suddivisione appare nella finestra di dialogo Account & usage con un interruttore Day e Week. Richiede Claude Code v2.1.174 o versione successiva.

39 39 

40<h2 id="managing-costs-for-teams">40<h3 id="set-a-spend-limit-on-pro-and-max">

41 Gestione dei costi per i team41 Imposta un limite di spesa su Pro e Max

42</h3>

43 

44Su piani Pro e Max, puoi impostare un limite di spesa mensile sui crediti di utilizzo con il comando `/usage-credits`. Se raggiungi quel limite mentre hai ancora crediti di utilizzo disponibili, Claude Code ti chiede di aumentare o rimuovere il limite in modo da poter continuare senza lasciare la CLI. La modifica del limite richiede l'accesso alla fatturazione sull'account.

45 

46<h2 id="manage-costs-for-your-organization">

47 Gestione dei costi per la tua organizzazione

42</h2>48</h2>

43 49 

44Quando utilizzi Claude API, puoi [impostare i limiti di spesa dell'area di lavoro](https://platform.claude.com/docs/it/build-with-claude/workspaces#workspace-limits) sulla spesa totale dell'area di lavoro di Claude Code. Gli amministratori possono [visualizzare i rapporti di costo e utilizzo](https://platform.claude.com/docs/it/build-with-claude/workspaces#usage-and-cost-tracking) nella Console.50I controlli che hai a disposizione dipendono da come la tua organizzazione accede a Claude Code: un piano Claude for Teams o Enterprise, la Claude Console, o un provider cloud. Nei piani Teams e Enterprise, l'utilizzo viene prelevato dall'indennità di posto di ogni membro. Nella Console e presso i provider cloud, l'utilizzo viene fatturato per token alla tua organizzazione. Se la tua organizzazione mescola metodi di accesso, ogni sviluppatore viene misurato in base a quello con cui si è autenticato.

51 

52La tabella mappa ogni configurazione a dove vedi la spesa, dove la limiti, e come estrai i numeri per utente.

53 

54| La tua configurazione | Visualizza spesa | Limita spesa | Rapporto per utente |

55| :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

56| [Claude for Teams o Enterprise](#claude-for-teams-and-enterprise) | [Rapporto spesa in analitiche org](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | Limiti di spesa nelle impostazioni admin | [CSV rapporto spesa](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans); [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) su Enterprise |

57| [Claude Console (API)](#claude-console) | [Pagina utilizzo Console](https://platform.claude.com/usage) | Limiti di spesa dell'area di lavoro | [Dashboard Console](https://platform.claude.com/claude-code), [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |

58| [Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry](#cloud-providers) | La tua console di fatturazione cloud | I controlli di budget del tuo cloud | [OpenTelemetry](/it/monitoring-usage) o un [gateway LLM](/it/llm-gateway) |

59 

60[L'esportazione OpenTelemetry](/it/monitoring-usage) funziona su ogni configurazione ed è l'unica opzione che trasmette metriche di token e costo per utente nel tuo stack di osservabilità in tempo quasi reale.

45 61 

46Nei piani Pro e Max, puoi impostare un limite di spesa mensile sui crediti di utilizzo con il comando `/usage-credits`. Se raggiungi quel limite mentre hai ancora crediti di utilizzo disponibili, Claude Code ti chiede di aumentare o rimuovere il limite in modo da poter continuare senza uscire dalla CLI. La modifica del limite richiede l'accesso alla fatturazione sull'account.62<h3 id="claude-for-teams-and-enterprise">

63 Claude for Teams e Enterprise

64</h3>

65 

66Nei piani Claude for Teams e Enterprise, l'utilizzo di Claude Code di ogni membro viene prelevato da un'indennità per posto che si ripristina su una finestra mobile di cinque ore e una finestra settimanale. L'indennità è condivisa con Claude chat e Cowork, e la sua dimensione dipende dal [livello di posto](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan). I tuoi controlli si trovano nella console admin di claude.ai, non nella Claude Console.

67 

68* **Visualizza spesa**: il [rapporto spesa in analitiche org](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) mostra la spesa stimata per utente e per modello, con esportazione CSV, aggiornato quotidianamente. Il rapporto copre la spesa in crediti di utilizzo e appare una volta che i crediti di utilizzo sono attivati. L'utilizzo all'interno dell'indennità di posto non viene misurato in dollari.

69* **Visualizza adozione**: il [dashboard analitiche](https://claude.ai/analytics/claude-code) mostra utenti attivi giornalieri, sessioni e metriche di contributo, con esportazione CSV dei dati di contributo. Vedi [traccia l'utilizzo del team con analitiche](/it/analytics).

70* **Limita spesa**: l'indennità di posto è il limite predefinito. Per consentire ai membri di continuare oltre, attiva i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) e imposta limiti di spesa a livello organizzativo, di gruppo o di singolo membro.

71* **Estrai numeri per utente**: nel piano Enterprise, l'[Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) restituisce rapporti di utilizzo e costo per utente su tutte le superfici Claude, incluso Claude Code. Un Primary Owner crea una chiave con l'ambito `read:analytics` su [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys). Nel piano Teams, esporta il [CSV rapporto spesa](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans), che elenca l'utilizzo dei token e la spesa stimata per utente e per modello.

72 

73La [guida al consumo Claude Enterprise](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide) è il riferimento di pianificazione per gli amministratori. Spiega come il consumo differisce tra Claude chat, Claude Code e Cowork, e fornisce punti di partenza in dollari per utente per il budgeting. Stanzia di più per un posto di codifica rispetto a un posto di chat: ogni turno di Claude Code contiene contenuti di file, chiamate di strumenti e ragionamento multi-step, quindi una sessione di debug può consumare più di un giorno di chat.

74 

75<h3 id="claude-console">

76 Claude Console

77</h3>

78 

79Le organizzazioni API gestiscono la spesa di Claude Code attraverso [aree di lavoro](https://platform.claude.com/docs/en/build-with-claude/workspaces). Puoi [impostare limiti di spesa dell'area di lavoro](https://platform.claude.com/docs/en/build-with-claude/workspaces#workspace-limits) sulla spesa totale di Claude Code e [visualizzare rapporti di costo e utilizzo](https://platform.claude.com/docs/en/build-with-claude/workspaces#usage-and-cost-tracking) nella Console.

47 80 

48<Note>81<Note>

49 Quando autentichi per la prima volta Claude Code con il tuo account Claude Console, viene creata automaticamente un'area di lavoro chiamata "Claude Code". Questa area di lavoro fornisce il tracciamento e la gestione centralizzati dei costi per tutto l'utilizzo di Claude Code nella tua organizzazione. Non puoi creare chiavi API per questa area di lavoro; è esclusivamente per l'autenticazione e l'utilizzo di Claude Code.82 Quando autentichi per la prima volta Claude Code con il tuo account Claude Console, viene creata automaticamente un'area di lavoro chiamata "Claude Code". Questa area di lavoro fornisce il tracciamento e la gestione centralizzati dei costi per tutto l'utilizzo di Claude Code nella tua organizzazione. Non puoi creare chiavi API per questa area di lavoro; è esclusivamente per l'autenticazione e l'utilizzo di Claude Code.

51 Per le organizzazioni con limiti di velocità personalizzati, il traffico di Claude Code in questa area di lavoro conta verso i limiti di velocità API complessivi della tua organizzazione. Puoi impostare un [limite di velocità dell'area di lavoro](https://platform.claude.com/docs/it/api/rate-limits#setting-lower-limits-for-workspaces) sulla pagina Limits di questa area di lavoro nella Claude Console per limitare la quota di Claude Code e proteggere altri carichi di lavoro di produzione.84 Per le organizzazioni con limiti di velocità personalizzati, il traffico di Claude Code in questa area di lavoro conta verso i limiti di velocità API complessivi della tua organizzazione. Puoi impostare un [limite di velocità dell'area di lavoro](https://platform.claude.com/docs/it/api/rate-limits#setting-lower-limits-for-workspaces) sulla pagina Limits di questa area di lavoro nella Claude Console per limitare la quota di Claude Code e proteggere altri carichi di lavoro di produzione.

52</Note>85</Note>

53 86 

54Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code non invia metriche dal tuo cloud. Un [gateway di app Claude](/it/claude-apps-gateway) self-hosted fornisce l'attribuzione dell'utilizzo per utente, metriche OTLP con conteggi dei token e [limiti di spesa per utente](/it/claude-apps-gateway-spend-limits) su questi provider. Le organizzazioni che instradano Claude Code attraverso un diverso [gateway LLM](/it/llm-gateway) possono tracciare la spesa al gateway, poiché vede ogni richiesta.87Per la segnalazione per utente, il [dashboard Console](https://platform.claude.com/claude-code) mostra la spesa e le righe accettate per membro, e l'[Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) restituisce le stesse metriche giornaliere per utente a livello di programmazione con una [chiave API Admin](https://platform.claude.com/settings/admin-keys). Vedi [analitiche per clienti API](/it/analytics#access-analytics-for-api-customers).

55 88 

56<h3 id="rate-limit-recommendations">89<h4 id="rate-limit-recommendations">

57 Raccomandazioni sui limiti di velocità90 Raccomandazioni sui limiti di velocità

58</h3>91</h4>

59 92 

60Quando configuri Claude Code per i team, considera queste raccomandazioni Token Per Minuto (TPM) e Richieste Per Minuto (RPM) per utente in base alle dimensioni della tua organizzazione:93Quando configuri Claude Code per i team, considera queste raccomandazioni Token Per Minuto (TPM) e Richieste Per Minuto (RPM) per utente in base alle dimensioni della tua organizzazione:

61 94 

76 Se prevedi scenari con utilizzo concorrente insolitamente elevato (come sessioni di formazione dal vivo con grandi gruppi), potresti aver bisogno di allocazioni TPM più elevate per utente.109 Se prevedi scenari con utilizzo concorrente insolitamente elevato (come sessioni di formazione dal vivo con grandi gruppi), potresti aver bisogno di allocazioni TPM più elevate per utente.

77</Note>110</Note>

78 111 

112<h3 id="cloud-providers">

113 Provider cloud

114</h3>

115 

116Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code viene fatturato per token al tuo account cloud, e i controlli di spesa si trovano nella console di fatturazione del tuo provider cloud. Claude Code non invia metriche dal tuo cloud ad Anthropic, quindi i [dashboard analitiche](/it/analytics) e l'Claude Code Analytics API non coprono questo utilizzo.

117 

118Per l'attribuzione dei costi per utente, hai tre opzioni:

119 

120* **OpenTelemetry**: [esporta metriche](/it/monitoring-usage) dalla macchina di ogni sviluppatore nel tuo stack di osservabilità. Questo ti dà conteggi di token per utente, costi e attività di strumenti indipendentemente dal provider.

121* **Un gateway di app Claude**: un [gateway di app Claude](/it/claude-apps-gateway) self-hosted fornisce l'attribuzione dell'utilizzo per utente, metriche OTLP con conteggi dei token e [limiti di spesa per utente](/it/claude-apps-gateway-spend-limits) su questi provider.

122* **Un gateway LLM**: instrada tutto il traffico di Claude Code attraverso un proxy che traccia la spesa per chiave. Diversi grandi enterprise hanno riferito di utilizzare [LiteLLM](/it/llm-gateway), uno strumento open-source che [traccia la spesa per chiave](https://docs.litellm.ai/docs/proxy/virtual_keys#tracking-spend). Questo progetto non è affiliato ad Anthropic e non è stato sottoposto a audit di sicurezza.

123 

124<h3 id="when-a-developer-asks-about-a-limit">

125 Quando uno sviluppatore chiede informazioni su un limite

126</h3>

127 

128Gli sviluppatori di solito portano domande sui limiti al loro amministratore, quindi è utile sapere quale limite hanno raggiunto. Le tre situazioni significano cose diverse:

129 

130* **"Hai raggiunto il tuo limite di sessione" o "Hai raggiunto il tuo limite settimanale"**: una finestra di utilizzo basata su posto in un piano di abbonamento. Queste finestre sono condivise su tutti i modelli, quindi cambiare modelli con `/model` non ripristina l'accesso, anche se consente allo sviluppatore di continuare a lavorare dopo il messaggio specifico del modello "Hai raggiunto il tuo limite Opus". Il messaggio mostra quando la finestra si ripristina, e lo sviluppatore può eseguire `/usage-credits` per richiedere utilizzo oltre l'indennità se hai i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) attivati. Vedi [errori di limite di utilizzo](/it/errors#youve-hit-your-session-limit).

131* **Un avviso di contesto o auto-compact**: non è un limite di utilizzo. La conversazione è cresciuta vicino alla dimensione massima di input del modello, e Claude Code riassume la cronologia più vecchia per liberare spazio. Indirizza lo sviluppatore a [riduci l'utilizzo dei token](#reduce-token-usage).

132* **Spesa inaspettatamente alta su un piano API o provider cloud**: di solito risale a sessioni lunghe che non sono mai state cancellate o a Opus lasciato come modello predefinito. Le abitudini con il maggiore impatto da condividere sono cancellare tra compiti non correlati e abbinare il modello al lavoro, entrambi coperti in [riduci l'utilizzo dei token](#reduce-token-usage).

133 

79<h3 id="agent-team-token-costs">134<h3 id="agent-team-token-costs">

80 Costi dei token del team di agenti135 Costi dei token del team di agenti

81</h3>136</h3>

19 19 

20Questa pagina spiega come [costruire un link](#build-a-link), [incorporarne uno in un runbook o attivarlo dalla shell](#examples), e [gestire o disabilitare la registrazione del gestore](#registration-and-supported-platforms) su ogni piattaforma.20Questa pagina spiega come [costruire un link](#build-a-link), [incorporarne uno in un runbook o attivarlo dalla shell](#examples), e [gestire o disabilitare la registrazione del gestore](#registration-and-supported-platforms) su ogni piattaforma.

21 21 

22<Note>

23 I deep link richiedono Claude Code v2.1.91 o successivo.

24</Note>

25 

26<h2 id="how-it-works">22<h2 id="how-it-works">

27 Come funziona23 Come funziona

28</h2>24</h2>

44 44 

45Prima di inviare il tuo primo messaggio, configura quattro cose nell'area del prompt:45Prima di inviare il tuo primo messaggio, configura quattro cose nell'area del prompt:

46 46 

47* **Ambiente**: scegli dove Claude viene eseguito. Seleziona **Local** per la tua macchina, **Remote** per sessioni cloud ospitate da Anthropic, o una [**connessione SSH**](#ssh-sessions) per una macchina remota che gestisci. Vedi [configurazione dell'ambiente](#environment-configuration).47* **Ambiente**: scegli dove Claude viene eseguito. Seleziona **Local** per la tua macchina, **Remote** per sessioni cloud ospitate da Anthropic, una [**connessione SSH**](#ssh-sessions) per una macchina remota che gestisci, o su Windows una [**distribuzione WSL**](/it/desktop-wsl). Vedi [configurazione dell'ambiente](#environment-configuration).

48* **Cartella del progetto**: seleziona la cartella o il repository su cui Claude lavora. Per le sessioni remote, puoi aggiungere [più repository](#run-long-running-tasks-remotely).48* **Cartella del progetto**: seleziona la cartella o il repository su cui Claude lavora. Per le sessioni remote, puoi aggiungere [più repository](#run-long-running-tasks-remotely).

49* **Modello**: scegli un [modello](/it/model-config#available-models) dal menu a discesa accanto al pulsante di invio. Puoi cambiare questo durante la sessione.49* **Modello**: scegli un [modello](/it/model-config#available-models) dal menu a discesa accanto al pulsante di invio. Puoi cambiare questo durante la sessione.

50* **Modalità di autorizzazione**: scegli quanta autonomia ha Claude dal [selettore di modalità](#choose-a-permission-mode). Puoi cambiare questo durante la sessione.50* **Modalità di autorizzazione**: scegli quanta autonomia ha Claude dal [selettore di modalità](#choose-a-permission-mode). Puoi cambiare questo durante la sessione.

71 71 

72La casella del prompt supporta due modi per portare contesto esterno:72La casella del prompt supporta due modi per portare contesto esterno:

73 73 

74* **@mention file**: digita `@` seguito da un nome di file per aggiungere un file al contesto della conversazione. Claude può quindi leggere e fare riferimento a quel file. @mention non è disponibile nelle sessioni cloud.74* **@mention file**: digita `@` seguito da un nome di file per aggiungere un file al contesto della conversazione. Claude può quindi leggere e fare riferimento a quel file. @mention non è disponibile nelle sessioni cloud o WSL.

75* **Allega file**: allega immagini, PDF e altri file al tuo prompt usando il pulsante di allegato, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.75* **Allega file**: allega immagini, PDF e altri file al tuo prompt usando il pulsante di allegato, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.

76 76 

77<h3 id="choose-a-permission-mode">77<h3 id="choose-a-permission-mode">

385 385 

386Una chat laterale ti consente di chiedere a Claude una domanda che utilizza il contesto della tua sessione ma non aggiunge nulla di nuovo alla conversazione principale. Usala quando vuoi capire un pezzo di codice, verificare un'assunzione o esplorare un'idea senza sterzare la sessione fuori rotta.386Una chat laterale ti consente di chiedere a Claude una domanda che utilizza il contesto della tua sessione ma non aggiunge nulla di nuovo alla conversazione principale. Usala quando vuoi capire un pezzo di codice, verificare un'assunzione o esplorare un'idea senza sterzare la sessione fuori rotta.

387 387 

388Premi **Cmd+;** su macOS o **Ctrl+;** su Windows per aprire una chat laterale, o digita `/btw` nella casella del prompt. La chat laterale può leggere tutto nel thread principale fino a quel punto. Quando hai finito, chiudi la chat laterale e continua la sessione principale da dove l'hai lasciata. Le chat laterali sono disponibili nelle sessioni locali e SSH.388Premi **Cmd+;** su macOS o **Ctrl+;** su Windows per aprire una chat laterale, o digita `/btw` nella casella del prompt. La chat laterale può leggere tutto nel thread principale fino a quel punto. Quando hai finito, chiudi la chat laterale e continua la sessione principale da dove l'hai lasciata. Le chat laterali sono disponibili nelle sessioni locali, SSH e WSL.

389 389 

390<h3 id="watch-background-tasks">390<h3 id="watch-background-tasks">

391 Guarda le attività in background391 Guarda le attività in background

440 Connetti strumenti esterni440 Connetti strumenti esterni

441</h3>441</h3>

442 442 

443Per le sessioni locali e [SSH](#ssh-sessions), fai clic sul pulsante **+** accanto alla casella del prompt e seleziona **Connectors** per aggiungere integrazioni come Google Calendar, Slack, GitHub, Linear, Notion e altri. Puoi aggiungere connettori prima o durante una sessione. Il pulsante **+** non è disponibile nelle sessioni cloud, ma le [routine](/it/routines) configurano i connettori al momento della creazione della routine.443Per le sessioni locali e [SSH](#ssh-sessions), fai clic sul pulsante **+** accanto alla casella del prompt e seleziona **Connectors** per aggiungere integrazioni come Google Calendar, Slack, GitHub, Linear, Notion e altri. Puoi aggiungere connettori prima o durante una sessione. Il pulsante **+** non è disponibile nelle sessioni cloud o WSL, ma le [routine](/it/routines) configurano i connettori al momento della creazione della routine.

444 444 

445Per gestire o disconnettere i connettori, vai a Impostazioni → Connectors nell'app desktop, o seleziona **Manage connectors** dal menu Connectors nella casella del prompt.445Per gestire o disconnettere i connettori, vai a Impostazioni → Connectors nell'app desktop, o seleziona **Manage connectors** dal menu Connectors nella casella del prompt.

446 446 

462 462 

463Per le sessioni locali e [SSH](#ssh-sessions), fai clic sul pulsante **+** accanto alla casella del prompt e seleziona **Plugins** per vedere i tuoi plugin installati e i loro skills. Per aggiungere un plugin, seleziona **Add plugin** dal sottomenu per aprire il browser dei plugin, che mostra i plugin disponibili dai tuoi [marketplace](/it/plugin-marketplaces) configurati incluso il marketplace ufficiale di Anthropic. Seleziona **Manage plugins** per abilitare, disabilitare o disinstallare plugin.463Per le sessioni locali e [SSH](#ssh-sessions), fai clic sul pulsante **+** accanto alla casella del prompt e seleziona **Plugins** per vedere i tuoi plugin installati e i loro skills. Per aggiungere un plugin, seleziona **Add plugin** dal sottomenu per aprire il browser dei plugin, che mostra i plugin disponibili dai tuoi [marketplace](/it/plugin-marketplaces) configurati incluso il marketplace ufficiale di Anthropic. Seleziona **Manage plugins** per abilitare, disabilitare o disinstallare plugin.

464 464 

465I plugin possono essere limitati al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI. I plugin non sono disponibili per le sessioni cloud. Per il riferimento completo dei plugin inclusa la creazione dei tuoi plugin, vedi [plugin](/it/plugins).465I plugin possono essere limitati al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI. I plugin non sono disponibili per le sessioni cloud o WSL. Per il riferimento completo dei plugin inclusa la creazione dei tuoi plugin, vedi [plugin](/it/plugins).

466 466 

467<h3 id="configure-preview-servers">467<h3 id="configure-preview-servers">

468 Configura server di anteprima468 Configura server di anteprima

628* **Local**: viene eseguito sulla tua macchina con accesso diretto ai tuoi file628* **Local**: viene eseguito sulla tua macchina con accesso diretto ai tuoi file

629* **Remote**: viene eseguito sull'infrastruttura cloud di Anthropic. Le sessioni continuano anche se chiudi l'app.629* **Remote**: viene eseguito sull'infrastruttura cloud di Anthropic. Le sessioni continuano anche se chiudi l'app.

630* **SSH**: viene eseguito su una macchina remota a cui ti connetti tramite SSH, come i tuoi stessi server, VM cloud o dev container630* **SSH**: viene eseguito su una macchina remota a cui ti connetti tramite SSH, come i tuoi stessi server, VM cloud o dev container

631* **WSL** (Windows): viene eseguito all'interno di una [distribuzione WSL 2](/it/desktop-wsl) sulla tua macchina, utilizzando la sua toolchain Linux e i percorsi nativi

631 632 

632<h3 id="local-sessions">633<h3 id="local-sessions">

633 Local sessions634 Local sessions

72 72 

73 * **Remote**: Esegui sessioni sull'infrastruttura cloud di Anthropic che continuano anche se chiudi l'app. Le sessioni cloud utilizzano la stessa infrastruttura di [Claude Code sul web](/it/claude-code-on-the-web).73 * **Remote**: Esegui sessioni sull'infrastruttura cloud di Anthropic che continuano anche se chiudi l'app. Le sessioni cloud utilizzano la stessa infrastruttura di [Claude Code sul web](/it/claude-code-on-the-web).

74 * **SSH**: Connettiti a una macchina remota tramite SSH, come i tuoi server, VM cloud o dev container. Desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti.74 * **SSH**: Connettiti a una macchina remota tramite SSH, come i tuoi server, VM cloud o dev container. Desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti.

75 * **WSL** (Windows): Esegui la sessione all'interno di una [distribuzione WSL 2](/it/desktop-wsl); Claude Code, gli strumenti e git vengono eseguiti sul lato Linux con percorsi nativi.

75 </Step>76 </Step>

76 77 

77 <Step title="Scegli un modello">78 <Step title="Scegli un modello">

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Claude Code Desktop in WSL

6 

7> Esegui sessioni Code all'interno di una distribuzione WSL 2 su Windows

8 

9Su Windows, la scheda Code può eseguire una sessione all'interno di una distribuzione WSL 2 invece che su Windows stesso. Il processo Claude Code della sessione, i suoi strumenti e git vengono tutti eseguiti all'interno della distribuzione, utilizzando la sua toolchain Linux e i percorsi Linux nativi, lo stesso ambiente che il tuo progetto utilizza.

10 

11Utilizza una sessione WSL quando il tuo repository si trova all'interno del filesystem della distribuzione. Lavorare su questi file da Windows passa attraverso un filesystem di rete, che è lento e interrompe il file watching; eseguire la sessione all'interno della distribuzione evita entrambi i problemi.

12 

13<h2 id="requirements">

14 Requisiti

15</h2>

16 

17* Windows 10 o 11 con [WSL 2](https://learn.microsoft.com/windows/wsl/install). WSL 1 non è supportato.

18* Almeno una distribuzione installata (ad esempio, Ubuntu).

19* `git` installato all'interno della distribuzione.

20 

21<h2 id="start-a-wsl-session">

22 Avvia una sessione WSL

23</h2>

24 

25<Steps>

26 <Step title="Scegli una distribuzione">

27 Avvia una nuova sessione nella scheda Code e apri il selezionatore di ambiente. Le tue distribuzioni WSL 2 installate appaiono in una sezione **WSL**. Scegline una.

28 </Step>

29 

30 <Step title="Scegli una cartella">

31 La sessione inizia nella directory home della distribuzione. Utilizza il selezionatore di cartelle per scegliere una cartella di progetto. La navigazione avviene all'interno della distribuzione, con percorsi Linux come `/home/you/project`.

32 </Step>

33 

34 <Step title="Fidati della cartella">

35 La prima sessione in una cartella mostra la finestra di dialogo di fiducia dell'area di lavoro. La fiducia viene concessa per distribuzione e cartella; fidarsi di una cartella in una distribuzione non si applica a un'altra distribuzione o allo stesso percorso su Windows.

36 </Step>

37</Steps>

38 

39La prima sessione in una distribuzione richiede un po' più di tempo mentre Claude si configura al suo interno. Puoi anche aprire una cartella `\\wsl.localhost\...` dal selezionatore di cartelle normale, e si riapre all'interno di quella distribuzione.

40 

41Le cartelle che hai utilizzato di recente appaiono nel selezionatore per distribuzione, quindi riconnettersi a un progetto è un solo clic.

42 

43<h2 id="what-works-in-a-wsl-session">

44 Cosa funziona in una sessione WSL

45</h2>

46 

47Le sessioni parallele, le chat laterali, la revisione visiva dei diff, lo stato dei branch e delle pull request, e i worktrees funzionano tutti, supportati da git e dalla toolchain all'interno della distribuzione. "Open in editor" apre VS Code connesso alla distribuzione tramite [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl).

48 

49Alcune funzionalità non sono ancora disponibili nelle sessioni WSL: il terminale integrato, i connettori e i plugin, il fork della sessione, il riquadro del browser dei file e i suggerimenti di file quando digiti `@` nel compositore.

50 

51<h2 id="managed-devices">

52 Dispositivi gestiti

53</h2>

54 

55Su dispositivi gestiti da un'organizzazione, le sessioni WSL potrebbero non essere disponibili. Se l'avvio della sessione non riesce con un messaggio che il dispositivo è gestito, ciò è controllato dal tuo amministratore. Amministratori: consulta [come le impostazioni raggiungono i dispositivi](/it/admin-setup#decide-how-settings-reach-devices) nella guida di distribuzione.

283You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

284```284```

285 285 

286Claude Code blocca ulteriori richieste fino all'ora di ripristino mostrata nel messaggio.286Claude Code blocca ulteriori richieste fino all'ora di ripristino mostrata nel messaggio. I limiti di sessione e settimanali sono condivisi tra tutti i modelli, quindi il cambio di modello non ripristina l'accesso. Il limite di Opus si applica solo alle richieste di Opus, quindi il passaggio a un altro modello con `/model` vi permette di continuare a lavorare.

287 287 

288**Cosa fare:**288**Cosa fare:**

289 289 

290* Attendete l'ora di ripristino mostrata nell'errore290* Attendete l'ora di ripristino mostrata nell'errore

291* Per il limite di Opus, eseguite `/model` e passate a un altro modello per continuare a lavorare

291* Eseguite `/usage` per vedere i vostri limiti di piano e quando si ripristinano292* Eseguite `/usage` per vedere i vostri limiti di piano e quando si ripristinano

292* Eseguite `/usage-credits` per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al vostro amministratore su Team ed Enterprise. Consultate [usage credits per piani a pagamento](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per informazioni su come viene fatturato.293* Eseguite `/usage-credits` per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al vostro amministratore su Team ed Enterprise. Consultate [usage credits per piani a pagamento](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per informazioni su come viene fatturato.

293* Per aggiornare il vostro piano per limiti di base più elevati, consultate [claude.com/pricing](https://claude.com/pricing)294* Per aggiornare il vostro piano per limiti di base più elevati, consultate [claude.com/pricing](https://claude.com/pricing)

765 766 

766* Premi Esc due volte e torna indietro oltre il turno che ha aggiunto il contenuto di dimensioni eccessive767* Premi Esc due volte e torna indietro oltre il turno che ha aggiunto il contenuto di dimensioni eccessive

767* Fai riferimento ai file di grandi dimensioni per percorso invece di incollarne i contenuti, in modo che Claude possa leggerli in blocchi768* Fai riferimento ai file di grandi dimensioni per percorso invece di incollarne i contenuti, in modo che Claude possa leggerli in blocchi

768* Per le immagini, vedi [L'immagine era troppo grande](#limmagine-era-troppo-grande) di seguito769* Per le immagini, vedi [L'immagine era troppo grande](#image-was-too-large) di seguito

769 770 

770<h3 id="image-was-too-large">771<h3 id="image-was-too-large">

771 L'immagine era troppo grande772 L'immagine era troppo grande

18 La modalità veloce per Opus 4.7 è deprecata a partire dal 25 giugno 2026 e verrà rimossa il 24 luglio 2026. Dopo la rimozione, le richieste di modalità veloce su Opus 4.7 restituiscono un errore e non tornano a Opus 4.7 standard. Esegui la migrazione a Opus 4.8 per mantenere l'accelerazione.18 La modalità veloce per Opus 4.7 è deprecata a partire dal 25 giugno 2026 e verrà rimossa il 24 luglio 2026. Dopo la rimozione, le richieste di modalità veloce su Opus 4.7 restituiscono un errore e non tornano a Opus 4.7 standard. Esegui la migrazione a Opus 4.8 per mantenere l'accelerazione.

19</Warning>19</Warning>

20 20 

21<Note>

22 La modalità veloce richiede Claude Code v2.1.36 o successivo. Controlla la tua versione con `claude --version`.

23</Note>

24 

25Cosa sapere:21Cosa sapere:

26 22 

27* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. La modalità veloce non è supportata nell'estensione VS Code.23* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. La modalità veloce non è supportata nell'estensione VS Code.

38* Digita `/fast` e premi Tab per attivare o disattivare34* Digita `/fast` e premi Tab per attivare o disattivare

39* Imposta `"fastMode": true` nel tuo [file di impostazioni utente](/it/settings)35* Imposta `"fastMode": true` nel tuo [file di impostazioni utente](/it/settings)

40 36 

41Per impostazione predefinita, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni. {/* min-version: 2.1.205 */}In [modalità non interattiva](/it/headless), con il flag `-p`, `/fast` funziona solo in una sessione avviata con la modalità veloce nel suo valore [`--settings`](/it/cli-reference#cli-flags), ad esempio `claude -p --settings '{"fastMode": true}'`; l'attivazione/disattivazione si applica quindi solo a quella sessione e non viene salvata come impostazione predefinita, e in qualsiasi altra sessione non interattiva il comando segnala che la modalità veloce non è disponibile. Gli amministratori possono configurare la modalità veloce per ripristinarsi ogni sessione. Vedi [richiedi opt-in per sessione](#require-per-session-opt-in) per i dettagli.37Per impostazione predefinita, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni. {/* min-version: 2.1.205 */}In [modalità non interattiva](/it/headless), con il flag `-p`, `/fast` funziona solo in una sessione avviata con la modalità veloce nel suo valore [`--settings`](/it/cli-reference#cli-flags), ad esempio `claude -p --settings '{"fastMode": true}'`; l'attivazione/disattivazione si applica quindi solo a quella sessione e non viene salvata come impostazione predefinita, e in qualsiasi altra sessione non interattiva il comando segnala che la modalità veloce non è disponibile. Puoi configurare la modalità veloce per ripristinarsi ogni sessione. Vedi [richiedi opt-in per sessione](#require-per-session-opt-in) per i dettagli.

42 38 

43Per la migliore efficienza dei costi, abilita la modalità veloce all'inizio di una sessione piuttosto che passare a metà conversazione. Vedi [comprendi il compromesso di costo](#understand-the-cost-tradeoff) per i dettagli.39Per la migliore efficienza dei costi, abilita la modalità veloce all'inizio di una sessione piuttosto che passare a metà conversazione. Vedi [comprendi il compromesso di costo](#understand-the-cost-tradeoff) per i dettagli.

44 40 

131 Richiedi opt-in per sessione127 Richiedi opt-in per sessione

132</h3>128</h3>

133 129 

134Per impostazione predefinita, la modalità veloce che un utente abilita in una sessione interattiva persiste tra le sessioni: rimane attiva nelle sessioni future. Gli amministratori sui piani [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) o [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) possono prevenire questo impostando `fastModePerSessionOptIn` a `true` nelle [impostazioni gestite](/it/settings#settings-files) o [impostazioni gestite dal server](/it/server-managed-settings). Questo fa sì che ogni sessione inizi con la modalità veloce disattivata, richiedendo agli utenti di abilitarla esplicitamente con `/fast`.130Per impostazione predefinita, la modalità veloce che un utente abilita in una sessione interattiva persiste tra le sessioni: rimane attiva nelle sessioni future. Per modificare questo, imposta `fastModePerSessionOptIn` a `true` in qualsiasi [file di impostazioni](/it/settings#settings-files), il che fa sì che ogni sessione inizi con la modalità veloce disattivata e richiede agli utenti di abilitarla esplicitamente con `/fast`. I proprietari sui piani [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) o [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) possono distribuirlo a livello organizzativo tramite [impostazioni gestite dal server](/it/server-managed-settings).

135 131 

136```json theme={null}132```json theme={null}

137{133{

169 <tbody>169 <tbody>

170 <tr>170 <tr>

171 <td>[Dashboard analytics e API](/it/analytics)</td>171 <td>[Dashboard analytics e API](/it/analytics)</td>

172 <td>✓ (Team e Enterprise)</td>172 <td>✓ (dashboard: Team e Enterprise; API: Enterprise)</td>

173 <td>✓ <sup><a href="#fn5">5</a></sup></td>173 <td>✓ <sup><a href="#fn5">5</a></sup></td>

174 <td>✗</td>174 <td>✗</td>

175 <td>✗</td>175 <td>✗</td>

287| Dispatch ([Desktop](/it/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |287| Dispatch ([Desktop](/it/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

288| [Code Review](/it/code-review) | ✗ | ✗ | ✓ | ✓ |288| [Code Review](/it/code-review) | ✗ | ✗ | ✓ | ✓ |

289| [Artifacts](/it/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |289| [Artifacts](/it/artifacts) | ✓ | ✓ | ✓ | Admin-enabled |

290| [Dashboard analytics, API e metriche di contribuzione](/it/analytics) | ✗ | ✗ | ✓ | ✓ |290| [Dashboard analytics e metriche di contribuzione](/it/analytics) | ✗ | ✗ | ✓ | ✓ |

291| [Enterprise Analytics API](/it/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

291| [Impostazioni gestite dal server](/it/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |292| [Impostazioni gestite dal server](/it/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |293| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

293| SCIM | ✗ | ✗ | ✗ | ✓ |294| SCIM | ✗ | ✗ | ✗ | ✓ |

7> Abilita una modalità di rendering più fluida e senza sfarfallio con supporto del mouse e utilizzo stabile della memoria nelle conversazioni lunghe.7> Abilita una modalità di rendering più fluida e senza sfarfallio con supporto del mouse e utilizzo stabile della memoria nelle conversazioni lunghe.

8 8 

9<Note>9<Note>

10 Il rendering a schermo intero è un'[anteprima di ricerca](#research-preview) opt-in e richiede Claude Code v2.1.89 o successivo. Eseguire `/tui fullscreen` per passare nella conversazione corrente, oppure impostare `CLAUDE_CODE_NO_FLICKER=1` nelle versioni precedenti a v2.1.110. Il comportamento potrebbe cambiare in base al feedback.10 Il rendering a schermo intero è un'[anteprima di ricerca](#research-preview) opt-in. Eseguire `/tui fullscreen` per passare nella conversazione corrente, oppure impostare `CLAUDE_CODE_NO_FLICKER=1` nelle versioni precedenti a v2.1.110. Il comportamento potrebbe cambiare in base al feedback.

11</Note>11</Note>

12 12 

13Il rendering a schermo intero è un percorso di rendering alternativo per la CLI di Claude Code che elimina lo sfarfallio, mantiene l'utilizzo della memoria costante nelle conversazioni lunghe e aggiunge il supporto del mouse. Disegna l'interfaccia sul buffer dello schermo alternativo del terminale, come `vim` o `htop`, e renderizza solo i messaggi attualmente visibili. Questo riduce la quantità di dati inviati al terminale ad ogni aggiornamento.13Il rendering a schermo intero è un percorso di rendering alternativo per la CLI di Claude Code che elimina lo sfarfallio, mantiene l'utilizzo della memoria costante nelle conversazioni lunghe e aggiunge il supporto del mouse. Disegna l'interfaccia sul buffer dello schermo alternativo del terminale, come `vim` o `htop`, e renderizza solo i messaggi attualmente visibili. Questo riduce la quantità di dati inviati al terminale ad ogni aggiornamento.

215 215 

216Con i clic disabilitati, Claude Code continua a catturare il mouse, quindi la rotella e il touchpad scorrono la conversazione ma i clic sinistri non fanno nulla all'interno di Claude Code. Devi comunque tenere premuto il tasto del terminale per la selezione nativa con clic e trascinamento. Il clic destro e il clic centrale per incollare continuano a funzionare sui terminali che li supportano.216Con i clic disabilitati, Claude Code continua a catturare il mouse, quindi la rotella e il touchpad scorrono la conversazione ma i clic sinistri non fanno nulla all'interno di Claude Code. Devi comunque tenere premuto il tasto del terminale per la selezione nativa con clic e trascinamento. Il clic destro e il clic centrale per incollare continuano a funzionare sui terminali che li supportano.

217 217 

218<h2 id="troubleshooting">

219 Troubleshooting

220</h2>

221 

222<h3 id="stale-or-misplaced-text-on-screen">

223 Testo obsoleto o posizionato male sullo schermo

224</h3>

225 

226Il rendering a schermo intero invia solo le celle che sono cambiate tra i fotogrammi. Alcuni terminali, più comunemente Windows Terminal e altri host supportati da ConPTY, coalescono questi scritti posizionati in modo non corretto e lasciano frammenti dell'output precedente sullo schermo fino a quando non ridimensionate la finestra.

227 

228Impostare [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/it/env-vars) per ridisegnare ogni cella su ogni fotogramma invece di inviare aggiornamenti incrementali.

229 

230Su Windows PowerShell:

231 

232```powershell theme={null}

233$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"

234claude

235```

236 

237Su macOS o Linux:

238 

239```bash theme={null}

240CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

241```

242 

243Su Windows, Claude Code abilita già il ridisegno completo automaticamente per le sessioni in background e la [visualizzazione agente](/it/agent-view), quindi è necessario impostare la variabile solo per una sessione fullscreen interattiva che avete avviato direttamente.

244 

218<h2 id="research-preview">245<h2 id="research-preview">

219 Anteprima di ricerca246 Anteprima di ricerca

220</h2>247</h2>

104 Checkpoint104 Checkpoint

105</h3>105</h3>

106 106 

107Un punto di ripristino creato ad ogni prompt che invii. Claude Code acquisisce snapshot dei file prima di ogni modifica in modo che un checkpoint possa ripristinarli. Premi `Esc` due volte o esegui `/rewind` per ripristinare il codice, la conversazione o entrambi a un punto precedente, o per riassumere parte della conversazione da un messaggio selezionato. I checkpoint sono locali alla sessione, separati da git, e non tracciano le modifiche apportate tramite lo strumento Bash.107Un punto di ripristino creato ad ogni prompt che invii. Claude Code acquisisce snapshot dei file prima di ogni modifica in modo che un checkpoint possa ripristinarli. Premi `Esc` due volte o esegui `/rewind` per ripristinare il codice, la conversazione o entrambi a un punto precedente, o per riassumere parte della conversazione da un messaggio selezionato. I checkpoint sono salvati con la conversazione, quindi una sessione ripresa può ancora `/rewind` verso di essi. Sono separati da git e non tracciano le modifiche apportate tramite lo strumento Bash.

108 108 

109Scopri di più: [Checkpointing](/it/checkpointing)109Scopri di più: [Checkpointing](/it/checkpointing)

110 110 

236 Non-interactive mode236 Non-interactive mode

237</h3>237</h3>

238 238 

239Una modalità che esegue un singolo prompt e esce senza una sessione conversazionale, invocata con `-p` o `--print`. Usata per CI, script e piping. L'[Agent SDK](/it/agent-sdk/overview) è l'equivalente Python e TypeScript. Precedentemente chiamata headless mode.239Una modalità che esegue un singolo prompt e esce senza una sessione conversazionale, invocata con `-p` o `--print`. Usata per CI, script e piping. L'esecuzione viene comunque salvata come una sessione ripristinabile a meno che non si passi `--no-session-persistence`. L'[Agent SDK](/it/agent-sdk/overview) è l'equivalente Python e TypeScript. Precedentemente chiamata headless mode.

240 240 

241Scopri di più: [Run Claude Code programmatically](/it/headless)241Scopri di più: [Run Claude Code programmatically](/it/headless)

242 242 

98 98 

99Se hai credenziali Google Cloud e desideri iniziare a utilizzare Claude Code tramite Google Cloud's Agent Platform, la procedura guidata di accesso ti guida attraverso i passaggi. Completi i prerequisiti lato GCP una volta per progetto; la procedura guidata gestisce il lato Claude Code.99Se hai credenziali Google Cloud e desideri iniziare a utilizzare Claude Code tramite Google Cloud's Agent Platform, la procedura guidata di accesso ti guida attraverso i passaggi. Completi i prerequisiti lato GCP una volta per progetto; la procedura guidata gestisce il lato Claude Code.

100 100 

101<Note>

102 La procedura guidata di configurazione di Google Cloud's Agent Platform richiede Claude Code v2.1.98 o versione successiva. Esegui `claude --version` per verificare.

103</Note>

104 

105<Steps>101<Steps>

106 <Step title="Abilita i modelli Claude nel tuo progetto GCP">102 <Step title="Abilita i modelli Claude nel tuo progetto GCP">

107 [Abilita Google Cloud's Agent Platform API](#1-enable-agent-platform-api) per il tuo progetto, quindi richiedi accesso ai modelli Claude che desideri in [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden). Consulta [Configurazione IAM](#iam-configuration) per le autorizzazioni di cui il tuo account ha bisogno.103 [Abilita Google Cloud's Agent Platform API](#1-enable-agent-platform-api) per il tuo progetto, quindi richiedi accesso ai modelli Claude che desideri in [Google Cloud's Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden). Consulta [Configurazione IAM](#iam-configuration) per le autorizzazioni di cui il tuo account ha bisogno.

262 Controlli del modello all'avvio258 Controlli del modello all'avvio

263</h2>259</h2>

264 260 

265Quando Claude Code si avvia con Google Cloud's Agent Platform configurato, verifica che i modelli che intende utilizzare siano accessibili nel tuo progetto. Questo controllo richiede Claude Code v2.1.98 o versione successiva.261Quando Claude Code si avvia con Google Cloud's Agent Platform configurato, verifica che i modelli che intende utilizzare siano accessibili nel tuo progetto.

266 262 

267Se hai fissato una versione del modello più vecchia del valore predefinito corrente di Claude Code, e il tuo progetto può invocare la versione più recente, Claude Code ti chiede di aggiornare il fissaggio. Accettare scrive il nuovo ID modello nel tuo [file di impostazioni utente](/it/settings) e riavvia Claude Code. Rifiutare viene ricordato fino al prossimo cambio di versione predefinita.263Se hai fissato una versione del modello più vecchia del valore predefinito corrente di Claude Code, e il tuo progetto può invocare la versione più recente, Claude Code ti chiede di aggiornare il fissaggio. Accettare scrive il nuovo ID modello nel tuo [file di impostazioni utente](/it/settings) e riavvia Claude Code. Rifiutare viene ricordato fino al prossimo cambio di versione predefinita.

268 264 

1648 1648 

1649`"defer"` è per le integrazioni che eseguono `claude -p` come subprocess e leggono il suo output JSON, come un'app Agent SDK o un'interfaccia utente personalizzata costruita su Claude Code. Consente a quel processo chiamante di mettere in pausa Claude in una chiamata dello strumento, raccogliere input attraverso la sua interfaccia e riprendere da dove era rimasto. Claude Code onora questo valore solo in [modalità non interattiva](/it/headless) con il flag `-p`. Nelle sessioni interattive registra un avviso e ignora il risultato del hook.1649`"defer"` è per le integrazioni che eseguono `claude -p` come subprocess e leggono il suo output JSON, come un'app Agent SDK o un'interfaccia utente personalizzata costruita su Claude Code. Consente a quel processo chiamante di mettere in pausa Claude in una chiamata dello strumento, raccogliere input attraverso la sua interfaccia e riprendere da dove era rimasto. Claude Code onora questo valore solo in [modalità non interattiva](/it/headless) con il flag `-p`. Nelle sessioni interattive registra un avviso e ignora il risultato del hook.

1650 1650 

1651<Note>

1652 Il valore `defer` richiede Claude Code v2.1.89 o successivo. Le versioni precedenti non lo riconoscono e lo strumento procede attraverso il flusso di autorizzazione normale.

1653</Note>

1654 

1655Lo strumento `AskUserQuestion` è il caso tipico: Claude vuole chiedere qualcosa all'utente, ma non c'è un terminale per rispondere. Il round trip funziona così:1651Lo strumento `AskUserQuestion` è il caso tipico: Claude vuole chiedere qualcosa all'utente, ma non c'è un terminale per rispondere. Il round trip funziona così:

1656 1652 

16571. Claude chiama `AskUserQuestion`. L'hook `PreToolUse` si attiva.16531. Claude chiama `AskUserQuestion`. L'hook `PreToolUse` si attiva.

747 Filtrare per nome dello strumento e argomenti con il campo `if`747 Filtrare per nome dello strumento e argomenti con il campo `if`

748</h4>748</h4>

749 749 

750<Note>

751 Il campo `if` richiede Claude Code v2.1.85 o successivo. Le versioni precedenti lo ignorano e eseguono l'hook su ogni chiamata corrispondente.

752</Note>

753 

754Il campo `if` utilizza la [permission rule syntax](/it/permissions) per filtrare gli hooks per nome dello strumento e argomenti insieme, in modo che il processo dell'hook si generi solo quando la chiamata dello strumento corrisponde. Questo va oltre il `matcher`, che filtra a livello di gruppo per nome dello strumento solo.750Il campo `if` utilizza la [permission rule syntax](/it/permissions) per filtrare gli hooks per nome dello strumento e argomenti insieme, in modo che il processo dell'hook si generi solo quando la chiamata dello strumento corrisponde. Questo va oltre il `matcher`, che filtra a livello di gruppo per nome dello strumento solo.

755 751 

756Ad esempio, questa configurazione esegue un hook solo quando Claude utilizza comandi `git` piuttosto che tutti i comandi Bash:752Ad esempio, questa configurazione esegue un hook solo quando Claude utilizza comandi `git` piuttosto che tutti i comandi Bash:

178 178 

179**Ogni modifica ai file è reversibile.** Prima che Claude modifichi qualsiasi file, crea uno snapshot dei contenuti attuali. Se qualcosa va storto, premi `Esc` due volte per tornare a uno stato precedente, o chiedi a Claude di annullare.179**Ogni modifica ai file è reversibile.** Prima che Claude modifichi qualsiasi file, crea uno snapshot dei contenuti attuali. Se qualcosa va storto, premi `Esc` due volte per tornare a uno stato precedente, o chiedi a Claude di annullare.

180 180 

181I checkpoint sono locali alla tua sessione, separati da git. Coprono solo le modifiche ai file. Le azioni che influenzano i sistemi remoti (database, API, distribuzioni) non possono essere checkpointed, motivo per cui Claude chiede prima di eseguire comandi con effetti collaterali esterni.181I checkpoint sono separati da git e rimangono disponibili quando riprendi una conversazione. Coprono solo le modifiche ai file. Le azioni che influenzano i sistemi remoti (database, API, distribuzioni) non possono essere checkpointed, motivo per cui Claude chiede prima di eseguire comandi con effetti collaterali esterni.

182 182 

183<h3 id="control-what-claude-can-do">183<h3 id="control-what-claude-can-do">

184 Controlla cosa Claude può fare184 Controlla cosa Claude può fare

188 188 

189* **Manual**: Claude chiede prima delle modifiche ai file e dei comandi shell189* **Manual**: Claude chiede prima delle modifiche ai file e dei comandi shell

190* **Accept edits**: Claude modifica i file ed esegue comandi comuni del file system come `mkdir` e `mv` senza chiedere, chiede ancora per altri comandi190* **Accept edits**: Claude modifica i file ed esegue comandi comuni del file system come `mkdir` e `mv` senza chiedere, chiede ancora per altri comandi

191* **Plan**: Claude esplora e propone un piano senza modificare i tuoi file sorgente; i prompt di permesso si applicano ancora come nella modalità Manual191* **Plan**: Claude esplora e propone un piano senza modificare i tuoi file sorgente

192* **Auto**: Claude valuta tutte le azioni con controlli di sicurezza in background192* **Auto**: Claude valuta tutte le azioni con controlli di sicurezza in background

193 193 

194Puoi anche consentire comandi specifici in `.claude/settings.json` in modo che Claude non chieda ogni volta. Questo è utile per comandi affidabili come `npm test` o `git status`. Le impostazioni possono essere scoped da politiche a livello di organizzazione fino alle preferenze personali. Consulta [Permessi](/it/permissions) per i dettagli.194Puoi anche consentire comandi specifici in `.claude/settings.json` in modo che Claude non chieda ogni volta. Questo è utile per comandi affidabili come `npm test` o `git status`. Le impostazioni possono essere scoped da politiche a livello di organizzazione fino alle preferenze personali. Consulta [Permessi](/it/permissions) per i dettagli.

6 6 

7> Personalizzare le scorciatoie da tastiera in Claude Code con un file di configurazione keybindings.7> Personalizzare le scorciatoie da tastiera in Claude Code con un file di configurazione keybindings.

8 8 

9<Note>

10 Le scorciatoie da tastiera personalizzabili richiedono Claude Code v2.1.18 o versioni successive. Controllare la versione con `claude --version`.

11</Note>

12 

13Claude Code supporta scorciatoie da tastiera personalizzabili. Eseguire `/keybindings` per creare o aprire il file di configurazione in `~/.claude/keybindings.json`.9Claude Code supporta scorciatoie da tastiera personalizzabili. Eseguire `/keybindings` per creare o aprire il file di configurazione in `~/.claude/keybindings.json`.

14 10 

15<h2 id="configuration-file">11<h2 id="configuration-file">

722}722}

723```723```

724 724 

725L'URL deve utilizzare `https://`. `authServerMetadataUrl` richiede Claude Code v2.1.64 o successiva. L'`scopes_supported` dell'URL dei metadati sovrascrive gli ambiti che il server upstream pubblicizza.725L'URL deve utilizzare `https://`. L'`scopes_supported` dell'URL dei metadati sovrascrive gli ambiti che il server upstream pubblicizza.

726 726 

727<h3 id="restrict-oauth-scopes">727<h3 id="restrict-oauth-scopes">

728 Limita gli ambiti OAuth728 Limita gli ambiti OAuth

365 365 

366La memoria automatica consente a Claude di accumulare conoscenze tra le sessioni senza che tu scriva nulla. Claude salva note per se stesso mentre lavora: comandi di compilazione, approfondimenti sul debug, note sull'architettura, preferenze di stile del codice e abitudini di flusso di lavoro. Claude non salva qualcosa ogni sessione. Decide cosa vale la pena ricordare in base al fatto che l'informazione sarebbe utile in una conversazione futura.366La memoria automatica consente a Claude di accumulare conoscenze tra le sessioni senza che tu scriva nulla. Claude salva note per se stesso mentre lavora: comandi di compilazione, approfondimenti sul debug, note sull'architettura, preferenze di stile del codice e abitudini di flusso di lavoro. Claude non salva qualcosa ogni sessione. Decide cosa vale la pena ricordare in base al fatto che l'informazione sarebbe utile in una conversazione futura.

367 367 

368<Note>

369 La memoria automatica richiede Claude Code v2.1.59 o successivo. Controlla la tua versione con `claude --version`.

370</Note>

371 

372<h3 id="enable-or-disable-auto-memory">368<h3 id="enable-or-disable-auto-memory">

373 Abilita o disabilita la memoria automatica369 Abilita o disabilita la memoria automatica

374</h3>370</h3>

134 Analizza prima di modificare con plan mode134 Analizza prima di modificare con plan mode

135</h2>135</h2>

136 136 

137Plan mode dice a Claude di ricercare e proporre modifiche senza farle. Claude legge file, esegue comandi shell per esplorare e scrive un piano, ma non modifica il tuo codice sorgente. I prompt di autorizzazione si applicano ancora come nella modalità predefinita.137Plan mode dice a Claude di ricercare e proporre modifiche senza farle. Claude legge file, esegue comandi shell per esplorare e scrive un piano, ma non modifica il tuo codice sorgente. I prompt di autorizzazione si applicano come nella modalità manuale a meno che [auto mode](/it/auto-mode-config) non sia disponibile e `useAutoModeDuringPlan` sia attivo, il che è l'impostazione predefinita. Con auto mode attivo, il classificatore approva i comandi di sola lettura come ricerche e letture di file senza richiedere conferma. Le modifiche rimangono bloccate comunque fino a quando non approvi il piano.

138 138 

139Entra in plan mode premendo `Shift+Tab` o prefissando un singolo prompt con `/plan`. Puoi anche avviare in plan mode dalla CLI:139Entra in plan mode premendo `Shift+Tab` o prefissando un singolo prompt con `/plan`. Puoi anche avviare in plan mode dalla CLI:

140 140 

180 Elimina i prompt di autorizzazione con auto mode180 Elimina i prompt di autorizzazione con auto mode

181</h2>181</h2>

182 182 

183<Note>

184 Auto mode richiede Claude Code v2.1.83 o successivo.

185</Note>

186 

187Auto mode consente a Claude di eseguire senza prompt di autorizzazione di routine. Un modello classificatore separato esamina le azioni prima che vengano eseguite, bloccando qualsiasi cosa che si escalation oltre la tua richiesta, mira a infrastruttura non riconosciuta o sembra guidata da contenuto ostile che Claude ha letto. Le [regole di richiesta](/it/permissions#manage-permissions) esplicite forzano comunque un prompt.183Auto mode consente a Claude di eseguire senza prompt di autorizzazione di routine. Un modello classificatore separato esamina le azioni prima che vengano eseguite, bloccando qualsiasi cosa che si escalation oltre la tua richiesta, mira a infrastruttura non riconosciuta o sembra guidata da contenuto ostile che Claude ha letto. Le [regole di richiesta](/it/permissions#manage-permissions) esplicite forzano comunque un prompt.

188 184 

189Auto mode inoltre istruisce Claude a continuare a lavorare senza fermarsi per domande di chiarimento, anche se Claude chiede ancora quando il tuo prompt o una skill si affida esplicitamente a questo. Per un comportamento autonomo più forte mantenendo i prompt di autorizzazione, imposta lo [stile di output proattivo](/it/output-styles) invece.185Auto mode inoltre istruisce Claude a continuare a lavorare senza fermarsi per domande di chiarimento, anche se Claude chiede ancora quando il tuo prompt o una skill si affida esplicitamente a questo. Per un comportamento autonomo più forte mantenendo i prompt di autorizzazione, imposta lo [stile di output proattivo](/it/output-styles) invece.

575 575 

576Claude Code supporta l'installazione di plugin da repository privati. Per l'installazione manuale e gli aggiornamenti, Claude Code utilizza i tuoi helper di credenziali git esistenti, quindi l'accesso HTTPS tramite `gh auth login`, Keychain di macOS o `git-credential-store` funziona come nel tuo terminale. L'accesso SSH funziona finché l'host è già nel tuo file `known_hosts` e la chiave è caricata in `ssh-agent`, poiché Claude Code sopprime i prompt SSH interattivi per l'impronta digitale dell'host e la passphrase della chiave.576Claude Code supporta l'installazione di plugin da repository privati. Per l'installazione manuale e gli aggiornamenti, Claude Code utilizza i tuoi helper di credenziali git esistenti, quindi l'accesso HTTPS tramite `gh auth login`, Keychain di macOS o `git-credential-store` funziona come nel tuo terminale. L'accesso SSH funziona finché l'host è già nel tuo file `known_hosts` e la chiave è caricata in `ssh-agent`, poiché Claude Code sopprime i prompt SSH interattivi per l'impronta digitale dell'host e la passphrase della chiave.

577 577 

578Gli aggiornamenti automatici in background vengono eseguiti all'avvio senza helper di credenziali, poiché i prompt interattivi bloccherebbero l'avvio di Claude Code. Per abilitare gli aggiornamenti automatici per i marketplace privati, imposta il token di autenticazione appropriato nel tuo ambiente:578Gli aggiornamenti automatici in background funzionano diversamente. Per impostazione predefinita, l'aggiornamento in background disabilita gli helper di credenziali git per il suo `git pull`, quindi il pull non può autenticarsi ai repository privati su HTTPS anche quando un helper è configurato. I remote SSH non sono interessati: una chiave caricata in `ssh-agent` autentica i pull in background allo stesso modo delle operazioni manuali. Quando il pull in background non riesce, Claude Code ricade nel ri-clonare il marketplace da zero. Il ri-clone utilizza le tue credenziali git archiviate, ma può [scadere su repository di grandi dimensioni](#git-operations-time-out), quindi gli aggiornamenti automatici del marketplace privato possono non riuscire intermittentemente.

579 579 

580| Provider | Variabili di ambiente | Note |580Due impostazioni rendono i marketplace privati comportarsi in modo prevedibile:

581| :-------- | :-------------------------- | :------------------------------------------------- |

582| GitHub | `GITHUB_TOKEN` o `GH_TOKEN` | Token di accesso personale o token di GitHub App |

583| GitLab | `GITLAB_TOKEN` o `GL_TOKEN` | Token di accesso personale o token di progetto |

584| Bitbucket | `BITBUCKET_TOKEN` | Password dell'app o token di accesso al repository |

585 581 

586Imposta il token nella configurazione della tua shell (ad esempio, `.bashrc`, `.zshrc`) o passalo quando esegui Claude Code:582* Imposta `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` per mantenere il clone esistente quando il pull in background non riesce, invece di eliminare e ri-clonare. I tuoi plugin continuano a funzionare dallo stato sincronizzato più recente, e gli aggiornamenti manuali con `/plugin marketplace update` continuano a eseguire il pull con le tue credenziali.

583* Configura un helper di credenziali git, ad esempio con `gh auth setup-git` per GitHub, in modo che il fallback di ri-clone possa autenticarsi senza richiedere.

584 

585Impostare un token del provider come `GITHUB_TOKEN` nel tuo ambiente non abilita di per sé l'autenticazione in background. I token hanno effetto solo attraverso un helper di credenziali configurato, ad esempio l'helper della CLI `gh`, che legge `GH_TOKEN` e `GITHUB_TOKEN`.

586 

587Per fare in modo che il pull in background stesso si autentichi su HTTPS, configura una riscrittura URL git globale. La riscrittura incorpora un token nell'URL remoto, quindi ha effetto anche se il pull in background disabilita gli helper di credenziali, e un pull riuscito salta il fallback di ri-clone. L'esempio seguente riscrive l'URL del repository del marketplace per includere un token di accesso:

587 588 

588```bash theme={null}589```bash theme={null}

589export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx590git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

590```591```

591 592 

593Limita la riscrittura al repository del marketplace o al percorso dell'organizzazione. Una riscrittura la cui base è solo l'host si applica a ogni fetch e push a quell'host sulla macchina e sostituisce le tue credenziali normali, inclusi i push ai tuoi repository.

594 

595Ogni provider si aspetta un nome utente diverso nell'URL riscritto, e lo stesso scoping del percorso si applica a ogni provider. Per server self-hosted, sostituisci il nome host con il nome host del tuo server:

596 

597| Provider | Forma URL riscritta |

598| :-------- | :---------------------------------------------------------------- |

599| GitHub | `https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins` |

600| GitLab | `https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins` |

601| Bitbucket | `https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins` |

602 

603La riscrittura archivia il token in testo semplice nel tuo gitconfig, quindi utilizza un token con accesso di sola lettura al repository del marketplace.

604 

592<Note>605<Note>

593 Per gli ambienti CI/CD, configura il token come variabile di ambiente segreta. GitHub Actions fornisce automaticamente `GITHUB_TOKEN` per i repository nella stessa organizzazione.606 Negli ambienti CI/CD, configura un helper di credenziali git prima di installare plugin da repository privati. Su GitHub Actions, esporta un token con accesso in lettura al repository del marketplace come `GH_TOKEN`, quindi esegui `gh auth setup-git`. Il token del flusso di lavoro predefinito può accedere solo al repository del flusso di lavoro stesso, quindi un marketplace privato in un altro repository ha bisogno di un token di accesso personale o di un token dell'app. Una riscrittura URL globale configurata nella pipeline autentica anche il pull in background direttamente.

594</Note>607</Note>

595 608 

596<h3 id="test-locally-before-distribution">609<h3 id="test-locally-before-distribution">

1162 1175 

1163Per gli aggiornamenti automatici in background:1176Per gli aggiornamenti automatici in background:

1164 1177 

1165* Imposta il token appropriato nel tuo ambiente: `echo $GITHUB_TOKEN`1178* Per impostazione predefinita, gli aggiornamenti in background disabilitano gli helper di credenziali git per il pull, quindi il pull non può autenticarsi su HTTPS. I remote SSH con una chiave caricata in `ssh-agent` si autenticano ancora. Un pull non riuscito attiva una ri-clonazione da zero, che utilizza le tue credenziali archiviate ma potrebbe scadere su repository di grandi dimensioni

1166* Controlla che il token abbia i permessi richiesti (accesso in lettura al repository)1179* Imposta `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` per mantenere il clone esistente quando il pull in background non riesce

1167* Per GitHub, assicurati che il token abbia lo scope `repo` per i repository privati1180* Configura un helper di credenziali git, ad esempio `gh auth setup-git`, in modo che il fallback di ri-clonazione possa autenticarsi

1168* Per GitLab, assicurati che il token abbia almeno lo scope `read_repository`1181* Se la ri-clonazione scade su un repository di grandi dimensioni, aumenta il limite con [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)

1169* Verifica che il token non sia scaduto1182* Configura una [riscrittura dell'URL git](#private-repositories) limitata al repository del marketplace in modo che il pull in background si autentichi direttamente

1183* Oppure aggiorna i marketplace privati manualmente con `/plugin marketplace update <name>`, che utilizza le tue credenziali

1170 1184 

1171<h3 id="marketplace-updates-fail-in-offline-environments">1185<h3 id="marketplace-updates-fail-in-offline-environments">

1172 Gli aggiornamenti del marketplace non riescono in ambienti offline1186 Gli aggiornamenti del marketplace non riescono in ambienti offline

1173</h3>1187</h3>

1174 1188 

1175**Sintomi**: Il `git pull` del marketplace non riesce e Claude Code cancella la cache esistente, causando l'indisponibilità dei plugin.1189**Sintomi**: Il `git pull` del marketplace non riesce in background e Claude Code tenta ripetutamente una ri-clonazione che non può avere successo.

1176 1190 

1177**Causa**: Per impostazione predefinita, quando un `git pull` non riesce, Claude Code rimuove il clone obsoleto e tenta di ri-clonare. In ambienti offline o airgapped, la ri-clonazione non riesce allo stesso modo, lasciando la directory del marketplace vuota.1191**Causa**: Per impostazione predefinita, quando un `git pull` non riesce, Claude Code tenta una ri-clonazione da zero. In ambienti offline o airgapped, la ri-clonazione non riesce allo stesso modo, e il ripristino della cache precedente successivamente è best-effort. L'aggiornamento viene eseguito in background dopo l'avvio, quindi non ritarda l'avvio, ma ogni sessione ripete i tentativi non riusciti e ogni operazione git può attendere il [timeout di 120 secondi](#git-operations-time-out).

1178 1192 

1179**Soluzione**: Imposta `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` per mantenere la cache esistente quando il pull non riesce invece di cancellarla:1193**Soluzione**: Imposta `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` per saltare il tentativo di ri-clonazione e continuare a utilizzare la cache esistente quando il pull non riesce:

1180 1194 

1181```bash theme={null}1195```bash theme={null}

1182export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=11196export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

520| Deve essere copiato manualmente per condividere | Installa con `/plugin install` |520| Deve essere copiato manualmente per condividere | Installa con `/plugin install` |

521 521 

522<Note>522<Note>

523 Dopo la migrazione, rimuovi i file originali da `.claude/` per evitare duplicati. Le definizioni di `.claude/agents/` a livello di progetto e utente sovrascrivono gli agents del plugin con lo stesso nome, quindi la versione del plugin ha effetto solo una volta rimossi gli originali.523 Dopo la migrazione, rimuovi i file originali da `.claude/` per evitare duplicati. Le definizioni di `.claude/agents/` a livello di progetto e utente sovrascrivono gli agents del plugin con lo stesso nome, quindi la versione del plugin ha effetto solo una volta rimossi gli originali. Le skill del plugin sono spaziate dei nomi come `/plugin-name:skill-name`, quindi sia l'originale `/skill-name` che la copia del plugin rimangono disponibili piuttosto che uno che sovrascrive l'altro.

524</Note>524</Note>

525 525 

526<h2 id="next-steps">526<h2 id="next-steps">

95 95 

96Il costo si applica una volta per conversazione. Dopo il primo turno della fast mode, Claude Code continua a inviare l'intestazione e varia solo l'impostazione di velocità della richiesta, che non fa parte della chiave della cache. Disattivare la fast mode, il [fallback automatico alla velocità standard](/it/fast-mode#handle-rate-limits) dopo un limite di velocità, e riattivarla in seguito mantengono tutti la cache. `/clear` e `/compact` ripristinano questo, poiché ricostruiscono la cache in quei punti comunque.96Il costo si applica una volta per conversazione. Dopo il primo turno della fast mode, Claude Code continua a inviare l'intestazione e varia solo l'impostazione di velocità della richiesta, che non fa parte della chiave della cache. Disattivare la fast mode, il [fallback automatico alla velocità standard](/it/fast-mode#handle-rate-limits) dopo un limite di velocità, e riattivarla in seguito mantengono tutti la cache. `/clear` e `/compact` ripristinano questo, poiché ricostruiscono la cache in quei punti comunque.

97 97 

98<Note>

99 Mantenere l'intestazione tra i toggle richiede Claude Code v2.1.86 o successivo. Nelle versioni precedenti, ogni toggle della fast mode e fallback del limite di velocità invalida la cache.

100</Note>

101 

102<h3 id="connecting-or-disconnecting-an-mcp-server">98<h3 id="connecting-or-disconnecting-an-mcp-server">

103 Connecting or disconnecting an MCP server99 Connecting or disconnecting an MCP server

104</h3>100</h3>

21 21 

22A differenza di [Claude Code sul web](/it/claude-code-on-the-web), che funziona su infrastrutture cloud, le sessioni Remote Control vengono eseguite direttamente sulla tua macchina e interagiscono con il tuo filesystem locale. Le interfacce web e mobile sono solo una finestra in quella sessione locale.22A differenza di [Claude Code sul web](/it/claude-code-on-the-web), che funziona su infrastrutture cloud, le sessioni Remote Control vengono eseguite direttamente sulla tua macchina e interagiscono con il tuo filesystem locale. Le interfacce web e mobile sono solo una finestra in quella sessione locale.

23 23 

24<Note>

25 Remote Control richiede Claude Code v2.1.51 o successivo. Controlla la tua versione con `claude --version`.

26</Note>

27 

28Questa pagina copre la configurazione, come avviare e connettersi alle sessioni, e come Remote Control si confronta con Claude Code sul web.24Questa pagina copre la configurazione, come avviare e connettersi alle sessioni, e come Remote Control si confronta con Claude Code sul web.

29 25 

30<h2 id="requirements">26<h2 id="requirements">

104 </Tab>100 </Tab>

105 101 

106 <Tab title="VS Code">102 <Tab title="VS Code">

107 Nell'[estensione VS Code di Claude Code](/it/vs-code), digita `/remote-control` o `/rc` nella casella del prompt, oppure apri il menu dei comandi con `/` e selezionalo. Richiede Claude Code v2.1.79 o successivo.103 Nell'[estensione VS Code di Claude Code](/it/vs-code), digita `/remote-control` o `/rc` nella casella del prompt, oppure apri il menu dei comandi con `/` e selezionalo.

108 104 

109 ```text theme={null}105 ```text theme={null}

110 /remote-control106 /remote-control

419* Sei autenticato con una chiave API Console o un provider cloud come Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry. `/schedule` richiede un accesso con abbonamento claude.ai. Se `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN` è impostato nella tua shell, o `apiKeyHelper` è impostato in `settings.json`, rimuovilo prima, poiché questi hanno la precedenza su un accesso claude.ai419* Sei autenticato con una chiave API Console o un provider cloud come Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry. `/schedule` richiede un accesso con abbonamento claude.ai. Se `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN` è impostato nella tua shell, o `apiKeyHelper` è impostato in `settings.json`, rimuovilo prima, poiché questi hanno la precedenza su un accesso claude.ai

420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, o `DISABLE_GROWTHBOOK` è impostato nell'ambiente della tua shell o nel blocco `env` di un [file `settings.json`](/it/settings#available-settings). Questi disabilitano il recupero dei flag di funzionalità, da cui `/schedule` dipende420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, o `DISABLE_GROWTHBOOK` è impostato nell'ambiente della tua shell o nel blocco `env` di un [file `settings.json`](/it/settings#available-settings). Questi disabilitano il recupero dei flag di funzionalità, da cui `/schedule` dipende

421* Sei all'interno di una sessione Claude Code sul web. Gestisci le routine dall'[interfaccia web](https://claude.ai/code/routines) invece421* Sei all'interno di una sessione Claude Code sul web. Gestisci le routine dall'[interfaccia web](https://claude.ai/code/routines) invece

422* {/* min-version: 2.1.81 */}La tua CLI è più vecchia della v2.1.81. Esegui `claude update`

423 422 

424Puoi sempre creare e gestire le routine su [claude.ai/code/routines](https://claude.ai/code/routines) indipendentemente da come è configurata la CLI.423Puoi sempre creare e gestire le routine su [claude.ai/code/routines](https://claude.ai/code/routines) indipendentemente da come è configurata la CLI.

425 424 

136 136 

137La directory temporanea della sessione è scrivibile all'interno della sandbox per impostazione predefinita, insieme alla directory di lavoro. Claude Code imposta `$TMPDIR` su questa directory per i comandi sandboxati, quindi gli strumenti che scrivono file temporanei funzionano senza configurazione aggiuntiva. I comandi non sandboxati ereditano il tuo `$TMPDIR` della shell invariato, il che significa che i comandi sandboxati e non sandboxati risolvono `$TMPDIR` in directory diverse. Per passare file temporanei tra i due, scrivili nella directory di lavoro.137La directory temporanea della sessione è scrivibile all'interno della sandbox per impostazione predefinita, insieme alla directory di lavoro. Claude Code imposta `$TMPDIR` su questa directory per i comandi sandboxati, quindi gli strumenti che scrivono file temporanei funzionano senza configurazione aggiuntiva. I comandi non sandboxati ereditano il tuo `$TMPDIR` della shell invariato, il che significa che i comandi sandboxati e non sandboxati risolvono `$TMPDIR` in directory diverse. Per passare file temporanei tra i due, scrivili nella directory di lavoro.

138 138 

139Alcuni comandi non possono essere eseguiti all'interno della sandbox, come strumenti incompatibili con essa o che necessitano di un host che non hai consentito. Piuttosto che fallire il compito o richiedere di disattivare il sandboxing, Claude Code include un escape hatch: quando un comando fallisce a causa di restrizioni della sandbox, Claude analizza il fallimento e potrebbe riprovare il comando con il parametro `dangerouslyDisableSandbox`. Il comando riprovato viene eseguito al di fuori della sandbox, quindi passa attraverso il flusso di autorizzazione regolare e richiede la tua approvazione.139Alcuni comandi non possono essere eseguiti all'interno della sandbox, come strumenti incompatibili con essa o che necessitano di un host che non hai consentito. Piuttosto che fallire il compito o richiedere di disattivare il sandboxing, Claude Code include un escape hatch: quando un comando fallisce a causa di restrizioni della sandbox, Claude analizza il fallimento e potrebbe riprovare il comando con il parametro `dangerouslyDisableSandbox`. Il comando riprovato viene eseguito al di fuori della sandbox, quindi passa attraverso il flusso di autorizzazione regolare. In [modalità auto](/it/permission-modes#eliminate-prompts-with-auto-mode), il classificatore valuta il comando sottostante invece di richiedere la tua approvazione.

140 140 

141Puoi disabilitare questo escape hatch impostando `"allowUnsandboxedCommands": false` nelle tue [impostazioni sandbox](/it/settings#sandbox-settings). Quando disabilitato, che la scheda Overrides di `/sandbox` mostra come **Modalità sandbox rigorosa**, il parametro `dangerouslyDisableSandbox` viene completamente ignorato e tutti i comandi devono essere eseguiti sandboxati o essere esplicitamente elencati in `excludedCommands`.141Puoi disabilitare questo escape hatch impostando `"allowUnsandboxedCommands": false` nelle tue [impostazioni sandbox](/it/settings#sandbox-settings). Quando disabilitato, che la scheda Overrides di `/sandbox` mostra come **Modalità sandbox rigorosa**, il parametro `dangerouslyDisableSandbox` viene completamente ignorato e tutti i comandi devono essere eseguiti sandboxati o essere esplicitamente elencati in `excludedCommands`.

142 142 

6 6 

7> Utilizzare /loop e gli strumenti di pianificazione cron per eseguire prompt ripetutamente, eseguire il polling dello stato o impostare promemoria una tantum all'interno di una sessione Claude Code.7> Utilizzare /loop e gli strumenti di pianificazione cron per eseguire prompt ripetutamente, eseguire il polling dello stato o impostare promemoria una tantum all'interno di una sessione Claude Code.

8 8 

9<Note>

10 Le attività pianificate richiedono Claude Code v2.1.72 o versione successiva. Controllare la versione con `claude --version`.

11</Note>

12 

13Le attività pianificate consentono a Claude di rieseguire automaticamente un prompt a intervalli regolari. Utilizzarle per eseguire il polling di una distribuzione, monitorare una PR, controllare una compilazione a lunga esecuzione o ricordarsi di fare qualcosa più tardi nella sessione. Per reagire agli eventi man mano che si verificano invece di eseguire il polling, vedere [Channels](/it/channels): il vostro CI può inviare il fallimento direttamente nella sessione. Per mantenere la sessione in funzione turno dopo turno fino al raggiungimento di una condizione piuttosto che a intervalli, vedere [`/goal`](/it/goal).9Le attività pianificate consentono a Claude di rieseguire automaticamente un prompt a intervalli regolari. Utilizzarle per eseguire il polling di una distribuzione, monitorare una PR, controllare una compilazione a lunga esecuzione o ricordarsi di fare qualcosa più tardi nella sessione. Per reagire agli eventi man mano che si verificano invece di eseguire il polling, vedere [Channels](/it/channels): il vostro CI può inviare il fallimento direttamente nella sessione. Per mantenere la sessione in funzione turno dopo turno fino al raggiungimento di una condizione piuttosto che a intervalli, vedere [`/goal`](/it/goal).

14 10 

15Le attività hanno ambito di sessione: vivono nella conversazione corrente e si interrompono quando si avvia una nuova. La ripresa con `--resume` o `--continue` ripristina qualsiasi attività che non sia [scaduta](#seven-day-expiry): un'attività ricorrente creata negli ultimi 7 giorni, oppure una singola la cui ora pianificata non è ancora passata. Per la pianificazione che sopravvive indipendentemente da qualsiasi sessione, utilizzare [Routines](/it/routines) per creare una routine su infrastruttura gestita da Anthropic, configurare un'[Attività pianificata Desktop](/it/desktop-scheduled-tasks) o utilizzare [GitHub Actions](/it/github-actions).11Le attività hanno ambito di sessione: vivono nella conversazione corrente e si interrompono quando si avvia una nuova. La ripresa con `--resume` o `--continue` ripristina qualsiasi attività che non sia [scaduta](#seven-day-expiry): un'attività ricorrente creata negli ultimi 7 giorni, oppure una singola la cui ora pianificata non è ancora passata. Per la pianificazione che sopravvive indipendentemente da qualsiasi sessione, utilizzare [Routines](/it/routines) per creare una routine su infrastruttura gestita da Anthropic, configurare un'[Attività pianificata Desktop](/it/desktop-scheduled-tasks) o utilizzare [GitHub Actions](/it/github-actions).

22 22 

23* Piano Claude for Teams o Claude for Enterprise23* Piano Claude for Teams o Claude for Enterprise

24* Il ruolo di Owner o Primary Owner nella vostra organizzazione Claude, per visualizzare e modificare la configurazione24* Il ruolo di Owner o Primary Owner nella vostra organizzazione Claude, per visualizzare e modificare la configurazione

25* Claude Code versione 2.1.38 o successiva per Claude for Teams, o versione 2.1.30 o successiva per Claude for Enterprise

26* Accesso di rete a `api.anthropic.com`25* Accesso di rete a `api.anthropic.com`

27 26 

28<h2 id="choose-between-server-managed-and-endpoint-managed-settings">27<h2 id="choose-between-server-managed-and-endpoint-managed-settings">

216 216 

217| Chiave | Descrizione | Esempio |217| Chiave | Descrizione | Esempio |

218| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |218| :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

219| `advisorModel` | {/* min-version: 2.1.98 */}Modello per lo [strumento advisor](/it/advisor) lato server. Accetta un alias di modello come `"opus"`, `"sonnet"`, o `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Scritto automaticamente quando esegui `/advisor`. Non impostato per disabilitare l'advisor. Richiede Claude Code v2.1.98 o successivo | `"opus"` |219| `advisorModel` | Modello per lo [strumento advisor](/it/advisor) lato server. Accetta un alias di modello come `"opus"`, `"sonnet"`, o `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Scritto automaticamente quando esegui `/advisor`. Non impostato per disabilitare l'advisor | `"opus"` |

220| `agent` | Esegui il thread principale come un subagent denominato e imposta l'agente predefinito per le sessioni inviate da `claude agents`. Applica il prompt di sistema, le restrizioni degli strumenti e il modello di quel subagent. Vedi [Invoca i subagent esplicitamente](/it/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |220| `agent` | Esegui il thread principale come un subagent denominato e imposta l'agente predefinito per le sessioni inviate da `claude agents`. Applica il prompt di sistema, le restrizioni degli strumenti e il modello di quel subagent. Vedi [Invoca i subagent esplicitamente](/it/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Predefinito**: `false`. Quando il [Controllo remoto](/it/remote-control) è connesso, consenti a Claude di inviare notifiche push proattive al tuo telefono, ad esempio quando un'attività lunga finisce. Appare in `/config` come **Push when Claude decides**. Vedi [Notifiche push mobile](/it/remote-control#mobile-push-notifications). Richiede Claude Code v2.1.119 o successivo | `true` |221| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**Predefinito**: `false`. Quando il [Controllo remoto](/it/remote-control) è connesso, consenti a Claude di inviare notifiche push proattive al tuo telefono, ad esempio quando un'attività lunga finisce. Appare in `/config` come **Push when Claude decides**. Vedi [Notifiche push mobile](/it/remote-control#mobile-push-notifications). Richiede Claude Code v2.1.119 o successivo | `true` |

222| `allowAllClaudeAiMcps` | (Solo impostazioni gestite) Carica i connettori claude.ai insieme a un `managed-mcp.json` distribuito, che altrimenti assume il controllo esclusivo e li sopprime. Vedi [Configurazione MCP gestita](/it/managed-mcp) | `true` |222| `allowAllClaudeAiMcps` | (Solo impostazioni gestite) Carica i connettori claude.ai insieme a un `managed-mcp.json` distribuito, che altrimenti assume il controllo esclusivo e li sopprime. Vedi [Configurazione MCP gestita](/it/managed-mcp) | `true` |

241| `awaySummaryEnabled` | Mostra un riepilogo di una riga della sessione quando torni al terminale dopo alcuni minuti di assenza. Imposta a `false` o disattiva Riepilogo sessione in `/config` per disabilitare. Uguale a [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/it/env-vars) | `true` |241| `awaySummaryEnabled` | Mostra un riepilogo di una riga della sessione quando torni al terminale dopo alcuni minuti di assenza. Imposta a `false` o disattiva Riepilogo sessione in `/config` per disabilitare. Uguale a [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/it/env-vars) | `true` |

242| `awsAuthRefresh` | Script personalizzato che modifica la directory `.aws` (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |242| `awsAuthRefresh` | Script personalizzato che modifica la directory `.aws` (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

243| `awsCredentialExport` | Script personalizzato che restituisce JSON con le credenziali AWS (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |243| `awsCredentialExport` | Script personalizzato che restituisce JSON con le credenziali AWS (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

244| `axScreenReader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lo screen reader: testo piatto senza bordi decorativi o animazioni. La modalità screen reader utilizza sempre il renderer classico, quindi l'impostazione `tui` non ha effetto mentre è attiva. La variabile di ambiente [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e il flag [`--ax-screen-reader`](/it/cli-reference#cli-flags) hanno la precedenza. Richiede Claude Code v2.1.181 o successivo | `true` |244| `axScreenReader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lo screen reader: testo piatto senza bordi decorativi o animazioni. La modalità screen reader utilizza il renderer classico, quindi l'impostazione `tui` non ha effetto mentre è attiva; le [sessioni in background](/it/agent-view) allegate vengono comunque renderizzate a schermo intero. La variabile di ambiente [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e il flag [`--ax-screen-reader`](/it/cli-reference#cli-flags) hanno la precedenza. Richiede Claude Code v2.1.181 o successivo | `true` |

245| `blockedMarketplaces` | (Solo impostazioni gestite) Elenco di negazione delle fonti del marketplace. Applicato all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace aggiunto prima che la politica fosse impostata non può essere utilizzato per recuperare i plugin. Le fonti bloccate vengono controllate prima del download, quindi non toccano mai il filesystem. Vedi [Restrizioni del marketplace gestito](/it/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |245| `blockedMarketplaces` | (Solo impostazioni gestite) Elenco di negazione delle fonti del marketplace. Applicato all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace aggiunto prima che la politica fosse impostata non può essere utilizzato per recuperare i plugin. Le fonti bloccate vengono controllate prima del download, quindi non toccano mai il filesystem. Vedi [Restrizioni del marketplace gestito](/it/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

246| `browserExternalPageTools` | (Solo impostazioni gestite) Imposta a `"disabled"` per prevenire che Claude utilizzi strumenti per leggere o agire su pagine esterne nel riquadro [Browser](/it/desktop#browse-external-sites) dell'app desktop. Gli utenti possono comunque navigare verso siti esterni da soli, e le anteprime del server di sviluppo locale non sono interessate | `"disabled"` |246| `browserExternalPageTools` | (Solo impostazioni gestite) Imposta a `"disabled"` per prevenire che Claude utilizzi strumenti per leggere o agire su pagine esterne nel riquadro [Browser](/it/desktop#browse-external-sites) dell'app desktop. Gli utenti possono comunque navigare verso siti esterni da soli, e le anteprime del server di sviluppo locale non sono interessate | `"disabled"` |

247| `channelsEnabled` | (Solo impostazioni gestite) Consenti [channels](/it/channels) per l'organizzazione. Nei piani Team e Enterprise di claude.ai, i canali vengono bloccati quando questo non è impostato o è `false`. Per gli account [Anthropic Console](/it/authentication#claude-console-authentication) che utilizzano l'autenticazione con chiave API, i canali sono consentiti per impostazione predefinita a meno che la tua organizzazione non distribuisca impostazioni gestite, nel qual caso questa chiave deve essere impostata a `true` | `true` |247| `channelsEnabled` | (Solo impostazioni gestite) Consenti [channels](/it/channels) per l'organizzazione. Nei piani Team e Enterprise di claude.ai, i canali vengono bloccati quando questo non è impostato o è `false`. Per gli account [Anthropic Console](/it/authentication#claude-console-authentication) che utilizzano l'autenticazione con chiave API, i canali sono consentiti per impostazione predefinita a meno che la tua organizzazione non distribuisca impostazioni gestite, nel qual caso questa chiave deve essere impostata a `true` | `true` |

873* `hostPattern`: Modello regex per abbinare gli host del marketplace (utilizza `hostPattern`)873* `hostPattern`: Modello regex per abbinare gli host del marketplace (utilizza `hostPattern`)

874* `settings`: marketplace inline dichiarato direttamente in settings.json senza un repository ospitato separato (utilizza `name` e `plugins`)874* `settings`: marketplace inline dichiarato direttamente in settings.json senza un repository ospitato separato (utilizza `name` e `plugins`)

875 875 

876Il tipo di fonte `git` funziona con qualsiasi servizio di hosting git, inclusi GitLab e Bitbucket self-hosted. Claude Code clona il repository con la stessa autenticazione che `git clone` utilizzerebbe su quella macchina: helper di credenziali configurati, chiavi SSH o una variabile di ambiente token specifica dell'host. Vedi [Repository privati](/it/plugin-marketplaces#private-repositories) per i dettagli di configurazione.876Il tipo di fonte `git` funziona con qualsiasi servizio di hosting git, inclusi GitLab e Bitbucket self-hosted. Claude Code clona il repository con la stessa autenticazione che `git clone` utilizzerebbe su quella macchina: helper di credenziali configurati o chiavi SSH. Un token di provider come `GITHUB_TOKEN` ha effetto solo tramite un helper di credenziali che lo legge. Vedi [Repository privati](/it/plugin-marketplaces#private-repositories) per i dettagli di configurazione.

877 877 

878Per le fonti `github` e `git`, imposta `"skipLfs": true` all'interno dell'oggetto `source` (insieme a `repo` o `url`) per saltare i download di Git LFS quando Claude Code clona o aggiorna il repository del marketplace. I file puntatore LFS rimangono come puntatori invece di scaricare il loro contenuto. Utilizza questa opzione quando il repository contiene grandi oggetti LFS non correlati al contenuto del plugin. {/* min-version: 2.1.153 */}Richiede Claude Code v2.1.153 o successivo.878Per le fonti `github` e `git`, imposta `"skipLfs": true` all'interno dell'oggetto `source` (insieme a `repo` o `url`) per saltare i download di Git LFS quando Claude Code clona o aggiorna il repository del marketplace. I file puntatore LFS rimangono come puntatori invece di scaricare il loro contenuto. Utilizza questa opzione quando il repository contiene grandi oggetti LFS non correlati al contenuto del plugin. {/* min-version: 2.1.153 */}Richiede Claude Code v2.1.153 o successivo.

879 879 

880Ogni voce del marketplace accetta anche un Boolean `autoUpdate` facoltativo. Imposta `"autoUpdate": true` insieme a `source` per fare in modo che Claude Code aggiorni quel marketplace e aggiorni i suoi plugin installati all'avvio. Se omesso, i marketplace ufficiali di Anthropic predefiniti a `true` e tutti gli altri marketplace predefiniti a `false`. Vedi [Configura gli aggiornamenti automatici](/it/discover-plugins#configure-auto-updates).880Ogni voce del marketplace accetta anche un Boolean `autoUpdate` facoltativo. Imposta `"autoUpdate": true` insieme a `source` per fare in modo che Claude Code aggiorni quel marketplace e aggiorni i suoi plugin installati in background dopo l'avvio. Se omesso, i marketplace ufficiali di Anthropic predefiniti a `true` e tutti gli altri marketplace predefiniti a `false`. Vedi [Configura gli aggiornamenti automatici](/it/discover-plugins#configure-auto-updates).

881 881 

882Usa `source: 'settings'` per dichiarare un piccolo set di plugin inline senza configurare un repository marketplace ospitato. I plugin elencati qui devono fare riferimento a fonti esterne come GitHub o npm. Devi comunque abilitare ogni plugin separatamente in `enabledPlugins`.882Usa `source: 'settings'` per dichiarare un piccolo set di plugin inline senza configurare un repository marketplace ospitato. I plugin elencati qui devono fare riferimento a fonti esterne come GitHub o npm. Devi comunque abilitare ogni plugin separatamente in `enabledPlugins`.

883 883 

1160 1160 

1161**Solo impostazioni gestite**: blocca skills, agenti, hooks e MCP servers da fonti utente e di progetto, in modo che possano provenire solo da plugin o impostazioni gestite. Combinalo con `strictKnownMarketplaces` per controllare l'intera catena di approvvigionamento della personalizzazione: l'elenco di autorizzazione del marketplace controlla quali plugin gli utenti possono installare, e questa impostazione blocca tutto ciò che non proviene da un plugin o dalle impostazioni gestite.1161**Solo impostazioni gestite**: blocca skills, agenti, hooks e MCP servers da fonti utente e di progetto, in modo che possano provenire solo da plugin o impostazioni gestite. Combinalo con `strictKnownMarketplaces` per controllare l'intera catena di approvvigionamento della personalizzazione: l'elenco di autorizzazione del marketplace controlla quali plugin gli utenti possono installare, e questa impostazione blocca tutto ciò che non proviene da un plugin o dalle impostazioni gestite.

1162 1162 

1163<Note>

1164 `strictPluginOnlyCustomization` richiede Claude Code v2.1.82 o successivo. Le versioni precedenti ignorano la chiave e continuano a caricare le personalizzazioni utente e di progetto, quindi il blocco non viene applicato fino a quando i client non si aggiornano.

1165</Note>

1166 

1167Il valore è `true` per bloccare tutte e quattro le superfici, oppure un array che nomina le superfici da bloccare:1163Il valore è `true` per bloccare tutte e quattro le superfici, oppure un array che nomina le superfici da bloccare:

1168 1164 

1169```json theme={null}1165```json theme={null}

924[Claude resumes the subagent with full context from previous conversation]924[Claude resumes the subagent with full context from previous conversation]

925```925```

926 926 

927Se un subagent fermato riceve un `SendMessage`, si auto-riprende in background senza richiedere una nuova invocazione `Agent`.927Un subagent completato che riceve un `SendMessage` si auto-riprende in background senza una nuova invocazione `Agent`. Lo stesso vale per un subagent che Claude ha fermato con lo strumento `TaskStop`.

928 

929{/* min-version: 2.1.191 */}A partire da v2.1.191, un subagent che lei ha fermato lei stesso, con `x` in `/tasks` o una richiesta SDK `stop_task`, non si auto-riprende. La chiamata `SendMessage` restituisce un rifiuto dicendo a Claude che l'agente è stato annullato. Digiti nel trascritto di quel subagent nel pannello subagent per riprendere lei stesso, il che cancella lo stop in modo che le successive chiamate `SendMessage` possono auto-riprendere di nuovo.

928 930 

929Riprendere avvia una nuova esecuzione dell'agente con lo stesso ID, quindi un subagent che aveva già fallito o completato si mostra come in esecuzione di nuovo nell'elenco delle attività e negli eventi delle attività dell'Agent SDK. Prima di v2.1.205, continuava a mostrare il suo stato precedente fallito o completato mentre l'esecuzione ripresa stava funzionando.931Riprendere avvia una nuova esecuzione dell'agente con lo stesso ID, quindi un subagent che aveva già fallito o completato si mostra come in esecuzione di nuovo nell'elenco delle attività e negli eventi delle attività dell'Agent SDK. Prima di v2.1.205, continuava a mostrare il suo stato precedente fallito o completato mentre l'esecuzione ripresa stava funzionando.

930 932 

296 296 

297Se lo schermo sfarfalla o la posizione di scorrimento salta mentre Claude sta lavorando, passa alla [modalità di rendering a schermo intero](/it/fullscreen). Disegna su uno schermo separato che il terminale riserva per le app a schermo intero invece di aggiungere al tuo normale scrollback, il che mantiene l'utilizzo della memoria piatto e aggiunge il supporto del mouse per lo scorrimento e la selezione. In questa modalità scorri con il mouse o PageUp dentro Claude Code piuttosto che con lo scrollback nativo del tuo terminale; consulta la [pagina fullscreen](/it/fullscreen#search-and-review-the-conversation) per come cercare e copiare.297Se lo schermo sfarfalla o la posizione di scorrimento salta mentre Claude sta lavorando, passa alla [modalità di rendering a schermo intero](/it/fullscreen). Disegna su uno schermo separato che il terminale riserva per le app a schermo intero invece di aggiungere al tuo normale scrollback, il che mantiene l'utilizzo della memoria piatto e aggiunge il supporto del mouse per lo scorrimento e la selezione. In questa modalità scorri con il mouse o PageUp dentro Claude Code piuttosto che con lo scrollback nativo del tuo terminale; consulta la [pagina fullscreen](/it/fullscreen#search-and-review-the-conversation) per come cercare e copiare.

298 298 

299Esegui `/tui fullscreen` per passare nella sessione corrente con la tua conversazione intatta. Per renderlo predefinito, imposta la variabile di ambiente `CLAUDE_CODE_NO_FLICKER` prima di avviare Claude Code:299Esegui `/tui fullscreen` per passare e salvare la preferenza. La tua conversazione si riavvia intatta e le sessioni future iniziano a schermo intero. Puoi anche impostare la variabile di ambiente `CLAUDE_CODE_NO_FLICKER` prima di avviare Claude Code:

300 300 

301<CodeGroup>301<CodeGroup>

302 ```bash Bash and Zsh theme={null}302 ```bash Bash and Zsh theme={null}

204 Strumento Monitor204 Strumento Monitor

205</h2>205</h2>

206 206 

207<Note>

208 Lo strumento Monitor richiede Claude Code v2.1.98 o successivo.

209</Note>

210 

211Lo strumento Monitor consente a Claude di osservare qualcosa in background e reagire quando cambia, senza mettere in pausa la conversazione. Chiedi a Claude di:207Lo strumento Monitor consente a Claude di osservare qualcosa in background e reagire quando cambia, senza mettere in pausa la conversazione. Chiedi a Claude di:

212 208 

213* Monitorare un file di log e segnalare gli errori man mano che appaiono209* Monitorare un file di log e segnalare gli errori man mano che appaiono

7> Avvia un piano dalla tua CLI, bozzalo su Claude Code sul web, quindi eseguilo in remoto o di nuovo nel tuo terminale7> Avvia un piano dalla tua CLI, bozzalo su Claude Code sul web, quindi eseguilo in remoto o di nuovo nel tuo terminale

8 8 

9<Note>9<Note>

10 Ultraplan è in anteprima di ricerca e richiede Claude Code v2.1.91 o versione successiva. Il comportamento e le capacità possono cambiare in base al feedback.10 Ultraplan è in anteprima di ricerca. Il comportamento e le capacità possono cambiare in base al feedback.

11</Note>11</Note>

12 12 

13Ultraplan trasferisce un'attività di pianificazione dalla tua CLI locale a una sessione di [Claude Code sul web](/it/claude-code-on-the-web) in esecuzione in [plan mode](/it/permission-modes#analyze-before-you-edit-with-plan-mode). Claude bozza il piano nel cloud mentre continui a lavorare nel tuo terminale. Quando il piano è pronto, lo apri nel tuo browser per commentare sezioni specifiche, richiedere revisioni e scegliere dove eseguirlo.13Ultraplan trasferisce un'attività di pianificazione dalla tua CLI locale a una sessione di [Claude Code sul web](/it/claude-code-on-the-web) in esecuzione in [plan mode](/it/permission-modes#analyze-before-you-edit-with-plan-mode). Claude bozza il piano nel cloud mentre continui a lavorare nel tuo terminale. Quando il piano è pronto, lo apri nel tuo browser per commentare sezioni specifiche, richiedere revisioni e scegliere dove eseguirlo.

7> Esegui una revisione del codice profonda e multi-agente nel cloud con /code-review ultra per trovare e verificare i bug prima di eseguire il merge.7> Esegui una revisione del codice profonda e multi-agente nel cloud con /code-review ultra per trovare e verificare i bug prima di eseguire il merge.

8 8 

9<Note>9<Note>

10 Ultrareview è una funzione di anteprima di ricerca disponibile in Claude Code v2.1.86 e versioni successive. La funzione, i prezzi e la disponibilità possono cambiare in base al feedback. Il comando viene ora richiamato come `/code-review ultra`, e `/ultrareview` rimane come alias.10 Ultrareview è una funzione di anteprima di ricerca. La funzione, i prezzi e la disponibilità possono cambiare in base al feedback. Il comando viene ora richiamato come `/code-review ultra`, e `/ultrareview` rimane come alias.

11</Note>11</Note>

12 12 

13Ultrareview è una revisione del codice profonda che viene eseguita su Claude Code nell'infrastruttura web. Quando eseguite `/code-review ultra`, Claude Code avvia una flotta di agenti revisori in una sandbox remota per trovare i bug nel vostro ramo o nella vostra pull request.13Ultrareview è una revisione del codice profonda che viene eseguita su Claude Code nell'infrastruttura web. Quando eseguite `/code-review ultra`, Claude Code avvia una flotta di agenti revisori in una sandbox remota per trovare i bug nel vostro ramo o nella vostra pull request.

9Pronuncia i tuoi prompt invece di digitarli nella CLI di Claude Code. Il tuo discorso viene trascritto in tempo reale nell'input del prompt, quindi puoi mescolare voce e digitazione nello stesso messaggio. Abilita la dettatura con `/voice`, quindi tieni premuto un tasto mentre parli oppure tocca una volta per iniziare e di nuovo per inviare.9Pronuncia i tuoi prompt invece di digitarli nella CLI di Claude Code. Il tuo discorso viene trascritto in tempo reale nell'input del prompt, quindi puoi mescolare voce e digitazione nello stesso messaggio. Abilita la dettatura con `/voice`, quindi tieni premuto un tasto mentre parli oppure tocca una volta per iniziare e di nuovo per inviare.

10 10 

11<Note>11<Note>

12 La dettatura vocale richiede Claude Code v2.1.69 o successivo. La modalità tocco richiede v2.1.116 o successivo. Controlla la tua versione con `claude --version`.12 Tap mode richiede Claude Code v2.1.116 o successivo. Controlla la tua versione con `claude --version`.

13</Note>13</Note>

14 14 

15La dettatura funziona anche nella [visualizzazione agente](/it/agent-view#peek-and-reply). Tieni premuto o tocca il tasto push-to-talk mentre l'input di dispatch o una risposta del pannello peek è focalizzata per dettare a una sessione in background.15La dettatura funziona anche nella [visualizzazione agente](/it/agent-view#peek-and-reply). Tieni premuto o tocca il tasto push-to-talk mentre l'input di dispatch o una risposta del pannello peek è focalizzata per dettare a una sessione in background.

214 214 

215`/web-setup` viene eseguito all'interno della Claude Code CLI, non nel tuo shell. Avvia `claude` prima, quindi digita `/web-setup` al prompt.215`/web-setup` viene eseguito all'interno della Claude Code CLI, non nel tuo shell. Avvia `claude` prima, quindi digita `/web-setup` al prompt.

216 216 

217Se l'hai digitato all'interno di Claude Code e il menu dei comandi mostra `No commands match "/web-setup"`, o l'invio restituisce `Unknown command: /web-setup`, il comando è nascosto perché un requisito non è soddisfatto. La causa è solitamente che la tua CLI è più vecchia della v2.1.80 o sei autenticato con una chiave API o un provider di terze parti invece di un abbonamento claude.ai. Esegui `claude update`, quindi `/login` per accedere con il tuo account claude.ai.217Se l'hai digitato all'interno di Claude Code e il menu dei comandi mostra `No commands match "/web-setup"`, o l'invio restituisce `Unknown command: /web-setup`, il comando è nascosto perché un requisito non è soddisfatto. La causa è solitamente che sei autenticato con una chiave API o un provider di terze parti invece di un abbonamento claude.ai. Esegui `/login` per accedere con il tuo account claude.ai.

218 218 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">

220 "Could not create a cloud environment" o "No cloud environment available" quando si utilizza `--cloud` o ultraplan220 "Could not create a cloud environment" o "No cloud environment available" quando si utilizza `--cloud` o ultraplan

7> Modalità auto per permessi senza intervento, computer use integrato, auto-fix PR nel cloud, ricerca trascrizioni e uno strumento PowerShell per Windows.7> Modalità auto per permessi senza intervento, computer use integrato, auto-fix PR nel cloud, ricerca trascrizioni e uno strumento PowerShell per Windows.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Rilasci <a href="/it/docs/changelog#2-1-83">v2.1.83 → v2.1.85</a></span>10 <span>Rilasci <a href="/docs/en/changelog#2-1-83">v2.1.83 → v2.1.85</a></span>

11 <span>6 funzionalità · 23–27 marzo</span>11 <span>6 funzionalità · 23–27 marzo</span>

12</div>12</div>

13 13 

161 </div>161 </div>

162</div>162</div>

163 163 

164[Changelog completo per v2.1.83–v2.1.85 →](/it/changelog#2-1-83)164[Changelog completo per v2.1.83–v2.1.85 →](/en/changelog#2-1-83)

7> Computer use nella CLI, lezioni interattive nel prodotto, rendering senza sfarfallio, override della dimensione dei risultati MCP per strumento e eseguibili plugin su PATH.7> Computer use nella CLI, lezioni interattive nel prodotto, rendering senza sfarfallio, override della dimensione dei risultati MCP per strumento e eseguibili plugin su PATH.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Rilasci <a href="/docs/it/changelog#2-1-86">v2.1.86 → v2.1.91</a></span>10 <span>Rilasci <a href="/docs/en/changelog#2-1-86">v2.1.86 → v2.1.91</a></span>

11 <span>5 funzionalità · 30 marzo – 3 aprile</span>11 <span>5 funzionalità · 30 marzo – 3 aprile</span>

12</div>12</div>

13 13 

135 </div>135 </div>

136</div>136</div>

137 137 

138[Changelog completo per v2.1.86–v2.1.91 →](/it/changelog#2-1-86)138[Changelog completo per v2.1.86–v2.1.91 →](/en/changelog#2-1-86)

7> Pianificazione cloud Ultraplan, lo strumento Monitor con /loop auto-paced, /team-onboarding per confezionare la vostra configurazione, e /autofix-pr dal vostro terminale.7> Pianificazione cloud Ultraplan, lo strumento Monitor con /loop auto-paced, /team-onboarding per confezionare la vostra configurazione, e /autofix-pr dal vostro terminale.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Releases <a href="/it/docs/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>10 <span>Releases <a href="/docs/en/changelog#2-1-92">v2.1.92 → v2.1.101</a></span>

11 <span>4 funzionalità · 6–10 aprile</span>11 <span>4 funzionalità · 6–10 aprile</span>

12</div>12</div>

13 13 

116 </div>116 </div>

117</div>117</div>

118 118 

119[Changelog completo per v2.1.92–v2.1.101 →](/it/changelog#2-1-92)119[Changelog completo per v2.1.92–v2.1.101 →](/en/changelog#2-1-92)

7> Claude Opus 4.7 con il nuovo livello di sforzo xhigh, Routines su Claude Code sul web, notifiche push mobili che avvisano il vostro telefono quando Claude ha bisogno di voi, un breakdown di /usage che mostra cosa sta guidando i vostri limiti, e binari nativi che sostituiscono il JavaScript raggruppato.7> Claude Opus 4.7 con il nuovo livello di sforzo xhigh, Routines su Claude Code sul web, notifiche push mobili che avvisano il vostro telefono quando Claude ha bisogno di voi, un breakdown di /usage che mostra cosa sta guidando i vostri limiti, e binari nativi che sostituiscono il JavaScript raggruppato.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Releases <a href="/docs/it/changelog#2-1-105">v2.1.105 → v2.1.113</a></span>10 <span>Releases <a href="/docs/en/changelog#2-1-105">v2.1.105 → v2.1.113</a></span>

11 <span>5 funzionalità · 13–17 aprile</span>11 <span>5 funzionalità · 13–17 aprile</span>

12</div>12</div>

13 13 

130 </div>130 </div>

131</div>131</div>

132 132 

133[Changelog completo per v2.1.105–v2.1.113 →](/it/changelog#2-1-105)133[Changelog completo per v2.1.105–v2.1.113 →](/en/changelog#2-1-105)

7> /ultrareview si apre come anteprima di ricerca, riepiloghi automatici della sessione quando tornate a un terminale, temi di colore personalizzati che potete creare e distribuire nei plugin, e un Claude Code riprogettato sul web.7> /ultrareview si apre come anteprima di ricerca, riepiloghi automatici della sessione quando tornate a un terminale, temi di colore personalizzati che potete creare e distribuire nei plugin, e un Claude Code riprogettato sul web.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Rilasci <a href="/docs/it/changelog#2-1-114">v2.1.114 → v2.1.119</a></span>10 <span>Rilasci <a href="/docs/en/changelog#2-1-114">v2.1.114 → v2.1.119</a></span>

11 <span>4 funzionalità · 20–24 aprile</span>11 <span>4 funzionalità · 20–24 aprile</span>

12</div>12</div>

13 13 

110 </div>110 </div>

111</div>111</div>

112 112 

113[Changelog completo per v2.1.114–v2.1.119 →](/it/changelog#2-1-114)113[Changelog completo per v2.1.114–v2.1.119 →](/en/changelog#2-1-114)