SpyBara
Go Premium

Documentation 2026-09-20 23:59 UTC to 2026-09-21 22:59 UTC

8 files changed +127 −73. View all changes and history on the product overview
2026
Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sun 13 21:00 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02

artifacts.md +90 −60

Details

10 Gli artifact sono disponibili sui piani Pro, Max, Team ed Enterprise e richiedono una sessione autenticata con [`/login`](/docs/it/setup#authenticate). Consulta [Disponibilità](#availability) per l'insieme completo dei requisiti.10 Gli artifact sono disponibili sui piani Pro, Max, Team ed Enterprise e richiedono una sessione autenticata con [`/login`](/docs/it/setup#authenticate). Consulta [Disponibilità](#availability) per l'insieme completo dei requisiti.

11</Note>11</Note>

12 12 

13Un artifact è una pagina web live e interattiva che Claude Code pubblica dalla tua sessione a un URL privato su claude.ai. La apri in un browser e si aggiorna sul posto mentre la sessione continua. Condividila dall'intestazione della pagina quando vuoi che qualcun altro la veda.13Un [artifact](https://claude.com/features/artifacts) è una pagina web live e interattiva che Claude Code pubblica dalla tua sessione a un URL privato su claude.ai. La apri in un browser e si aggiorna sul posto mentre la sessione continua. Condividila dall'intestazione della pagina quando vuoi che qualcun altro la veda.

14 14 

15<Frame>15<Frame>

16 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="Un artifact aperto in un browser su claude.ai/code/artifact. L'intestazione del visualizzatore mostra il titolo dell'artifact acme-funnel-fix, un pulsante Condividi e l'avatar dell'autore. Il menu Condividi è aperto con l'interruttore Condividi sempre la versione più recente, un selettore di versione che legge Condivisione versione 2, un selettore di pubblico Everyone at Acme e un pulsante Copia link. Sotto l'intestazione, la pagina dell'artifact mostra due mockup mobili affiancati, un grafico a imbuto e una riga di schede metriche." width="2511" height="1890" data-path="images/artifacts-viewer.png" />16 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="Un artifact aperto in un browser su claude.ai/code/artifact. L'intestazione del visualizzatore mostra il titolo dell'artifact acme-funnel-fix, un pulsante Condividi e l'avatar dell'autore. Il menu Condividi è aperto con l'interruttore Condividi sempre la versione più recente, un selettore di versione che legge Condivisione versione 2, un selettore di pubblico Everyone at Acme e un pulsante Copia link. Sotto l'intestazione, la pagina dell'artifact mostra due mockup mobili affiancati, un grafico a imbuto e una riga di schede metriche." width="2511" height="1890" data-path="images/artifacts-viewer.png" />


35 Cosa un artifact non è35 Cosa un artifact non è

36</h3>36</h3>

37 37 

38Un artifact è una cattura del lavoro: una singola pagina autonoma senza backend, quindi non può memorizzare l'input del modulo o servire più route, e il suo unico percorso verso dati esterni quando qualcuno la visualizza è [chiamare connettori MCP](#pull-live-data-with-mcp-connectors). Per uno strumento interno ospitato con un backend, distribuiscilo sulla tua infrastruttura. Vedi [Vincoli della pagina](#page-constraints) per l'insieme completo dei limiti.38Un artifact è una cattura del lavoro: una singola pagina autonoma senza backend, quindi non può servire più route. Per uno strumento interno ospitato con un backend, distribuiscilo sulla tua infrastruttura. Vedi [Vincoli della pagina](#page-constraints) per l'insieme completo dei limiti.

39 39 

40<h2 id="create-an-artifact">40<h2 id="create-an-artifact">

41 Creare un artifact41 Creare un artifact


58 58 

59Dopo aver approvato un artifact una volta, Claude Code lo ripubblica senza chiedere, e chiede di nuovo in alcuni casi, inclusi quando:59Dopo aver approvato un artifact una volta, Claude Code lo ripubblica senza chiedere, e chiede di nuovo in alcuni casi, inclusi quando:

60 60 

61* Claude dichiara una capacità di runtime per la pagina, come [connector calls](#pull-live-data-with-mcp-connectors)61* Claude dichiara una capacità di runtime per la pagina, come [connector calls](#pull-live-data-with-mcp-connectors) o [file downloads](#offer-a-file-download)

62* Da allora hai [condiviso pubblicamente](#share-an-artifact)62* Da allora hai [condiviso pubblicamente](#share-an-artifact)

63* Da allora hai condiviso con persone specifiche o la tua organizzazione con l'ultima versione scelta come versione che i visualizzatori vedono63* Da allora hai condiviso con persone specifiche o la tua organizzazione con l'ultima versione scelta come versione che i visualizzatori vedono

64 64 

65Dopo la prima pubblicazione, Claude stampa l'URL e il tuo browser si apre sulla nuova pagina. Se hai inviato il prompt tramite [Remote Control](/docs/it/remote-control) da claude.ai, Claude Desktop o l'app mobile Claude, nessuna scheda si apre sulla macchina che esegue la sessione. Il browser si apre lì la prossima volta che Claude pubblica l'artifact da un prompt che digiti al terminale. Premi `Ctrl+]` in qualsiasi momento per riaprire l'artifact più recente della sessione.65Dopo la prima pubblicazione, Claude stampa l'URL e il tuo browser si apre sulla nuova pagina. Se hai inviato il prompt tramite [Remote Control](/docs/it/remote-control) da claude.ai, Claude Desktop o l'app mobile Claude, nessuna scheda si apre sulla macchina che esegue la sessione. Il browser si apre lì la prossima volta che Claude pubblica l'artifact da un prompt che digiti al terminale. Premi `Ctrl+]` in qualsiasi momento per riaprire l'artifact più recente della sessione.

66 66 

67Claude sceglie il titolo dell'artifact e un emoji per l'icona della scheda del browser. Entrambi appaiono nella tua [galleria di artifact](#share-an-artifact) su claude.ai e nei link condivisi, quindi chiedi a Claude di usare un titolo o un'icona specifici se ne desideri uno.67Claude sceglie il titolo dell'artifact e un emoji, e entrambi appaiono nella tua [galleria di artifact](#share-an-artifact) su claude.ai e nei link condivisi. Claude può anche scegliere un'icona della scheda del browser che corrisponda a ciò che la pagina è, come un grafico o un calendario. Chiedi a Claude per un titolo, un emoji o un'icona della scheda specifici se ne desideri uno.

68 68 

69Per impedire al browser di aprirsi automaticamente quando viene pubblicato un nuovo artifact, imposta `CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0` nel tuo ambiente.69Per impedire al browser di aprirsi automaticamente quando viene pubblicato un nuovo artifact, imposta `CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0` nel tuo ambiente.

70 70 


115 115 

116Un editor pubblica nuove versioni nello stesso modo in cui voi [aggiornate l'artifact da un'altra sessione](#update-an-artifact): forniscono a Claude l'URL dell'artifact, o lo allegano da [`/artifacts`](#find-an-artifact-again), e Claude estrae il contenuto corrente e ripubblica con le loro modifiche. Tutti coloro che hanno la pagina aperta vedono ogni aggiornamento in tempo reale.116Un editor pubblica nuove versioni nello stesso modo in cui voi [aggiornate l'artifact da un'altra sessione](#update-an-artifact): forniscono a Claude l'URL dell'artifact, o lo allegano da [`/artifacts`](#find-an-artifact-again), e Claude estrae il contenuto corrente e ripubblica con le loro modifiche. Tutti coloro che hanno la pagina aperta vedono ogni aggiornamento in tempo reale.

117 117 

118<h2 id="read-an-artifact-shared-with-you">

119 Leggere un artefatto condiviso con voi

120</h2>

121 

122Quando qualcuno condivide un artefatto con voi, potete chiedere a Claude di leggerlo: fornite a Claude il suo URL, oppure allegate lo dal [`/artifacts`](#find-an-artifact-again).

123 

124Claude legge una pagina scritta da qualcun altro nello stesso modo in cui legge una pagina web con [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior): ottiene un riepilogo di ciò che ha chiesto piuttosto che la pagina grezza, e il riepilogo riporta le istruzioni scritte nella pagina invece di trasmetterle. Claude Code salva anche il codice sorgente completo della pagina in un file locale, che Claude può aprire quando ha bisogno del contenuto esatto, ad esempio per ripublicare l'artefatto come [editor](#let-someone-edit-with-you).

125 

118<h2 id="collect-comments-on-an-artifact">126<h2 id="collect-comments-on-an-artifact">

119 Raccogliere commenti su un artefatto127 Raccogliere commenti su un artefatto

120</h2>128</h2>

121 129 

122Quando condividi un artefatto all'interno della tua organizzazione, le persone con cui lo condividi possono lasciare commenti sulla pagina, e tu puoi chiedere a Claude di leggere quei commenti e rispondere ad essi. Hai bisogno di Claude Code v2.1.221 o successivo e di un piano Team o Enterprise, perché solo un artefatto che [condividi all'interno della tua organizzazione](#share-an-artifact) riceve commenti. Claude legge i commenti in due casi:130Quando condividi un artefatto all'interno della tua organizzazione, le persone con cui lo condividi possono lasciare commenti sulla pagina, e tu puoi chiedere a Claude di leggere quei commenti e rispondere. Hai bisogno di Claude Code v2.1.221 o successivo e di un piano Team o Enterprise, perché solo un artefatto che [condividi all'interno della tua organizzazione](#share-an-artifact) riceve commenti. Claude legge i commenti in due casi:

123 131 

124* **Tu chiedi a Claude di leggerli**: fornisci a Claude l'URL dell'artefatto e chiedi i commenti. Claude elenca ogni thread e contrassegna i commenti che qualcuno che può modificare l'artefatto ha inviato ad esso.132* **Tu chiedi a Claude di leggerli**: fornisci a Claude l'URL dell'artefatto e chiedi i commenti. Claude elenca ogni thread e contrassegna i commenti che qualcuno che può modificare l'artefatto ha inviato.

125* **Qualcuno che può modificare l'artefatto invia un commento a Claude**: in un thread sulla pagina, invia un commento con **Send to Claude**, o menziona `@claude` in uno. In entrambi i casi, attivano il thread.133* **Qualcuno che può modificare l'artefatto invia un commento a Claude**: in un thread sulla pagina, invia un commento con **Send to Claude**, o menziona `@claude` in uno. In entrambi i casi, attivano il thread.

126 134 

127Claude può rispondere o risolvere solo un thread attivato. Gli altri thread rimangono aperti fino a quando una persona non li risolve sulla pagina. I visualizzatori vedono ogni risposta attribuita a Claude, tramite te.135Claude può rispondere o risolvere solo un thread attivato. Gli altri thread rimangono aperti finché una persona non li risolve sulla pagina. I visualizzatori vedono ogni risposta attribuita a Claude, tramite te.

128 136 

129Se condividi un artefatto pubblicamente, i visualizzatori non possono commentarlo: la pagina dice `Comments aren't available while this Artifact is shared publicly.` Per passare un artefatto che ha già thread di commenti a un link pubblico, elimina prima i thread.137Se condividi un artefatto pubblicamente, i visualizzatori non possono commentare: la pagina dice `Comments aren't available while this Artifact is shared publicly.` Per passare un artefatto che ha già thread di commenti a un link pubblico, elimina prima i thread.

130 138 

131Per chiedere i commenti tu stesso, fornisci a Claude l'URL:139Per chiedere i commenti tu stesso, fornisci a Claude l'URL:

132 140 


134Read the comments on https://claude.ai/code/artifact/5fbea6f3-... and make the changes the commenters ask for.142Read the comments on https://claude.ai/code/artifact/5fbea6f3-... and make the changes the commenters ask for.

135```143```

136 144 

137Se Claude ti dice che non riesce a leggere i commenti, controlla tre cose:145Se Claude ti dice che non riesce a leggere i commenti, conferma la tua versione, la tua sessione e l'impostazione del tuo feature flag:

138 146 

139* Stai eseguendo Claude Code v2.1.221 o successivo.147* Stai eseguendo Claude Code v2.1.221 o successivo.

140* Non sei nella tua prima sessione da quando hai installato Claude Code o aggiornato da una versione precedente a v2.1.221. In quella [prima sessione dopo un'installazione o un aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade), Claude potrebbe non essere ancora in grado di leggere i commenti; avvia una nuova sessione e chiedi di nuovo.148* Non sei nella tua prima sessione da quando hai installato Claude Code o aggiornato da una versione precedente a v2.1.221. In quella [prima sessione dopo un'installazione o un aggiornamento](/docs/it/env-vars#first-session-after-an-install-or-upgrade), Claude potrebbe non essere ancora in grado di leggere i commenti; avvia una nuova sessione e chiedi di nuovo.

141* Non hai disattivato il recupero dei flag di funzionalità.149* Non hai disattivato il recupero dei feature flag.

142 150 

143<h3 id="let-claude-reply-to-comments-on-its-own">151<h3 id="let-claude-reply-to-comments-on-its-own">

144 Lascia che Claude risponda ai commenti da solo152 Lascia che Claude risponda ai commenti da solo


146 154 

147Dopo che la tua sessione pubblica un artefatto, Claude Code osserva quell'artefatto per i commenti finché la sessione è in esecuzione. Quando qualcuno che può modificare l'artefatto invia un commento a Claude, raggiunge la tua sessione subito, e Claude può leggere il thread e rispondere senza che tu lo chieda.155Dopo che la tua sessione pubblica un artefatto, Claude Code osserva quell'artefatto per i commenti finché la sessione è in esecuzione. Quando qualcuno che può modificare l'artefatto invia un commento a Claude, raggiunge la tua sessione subito, e Claude può leggere il thread e rispondere senza che tu lo chieda.

148 156 

149Hai bisogno di Claude Code v2.1.228 o successivo. Se hai disattivato il [recupero dei flag di funzionalità](/docs/it/env-vars#features-that-need-feature-flag-fetching), Claude Code non osserva i commenti.157Hai bisogno di Claude Code v2.1.228 o successivo. Se hai disattivato il [recupero dei feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching), Claude Code non osserva i commenti.

150 158 

151La tua [modalità di autorizzazione](/docs/it/permission-modes) decide cosa fa Claude quando arriva un commento inviato:159La tua [modalità di autorizzazione](/docs/it/permission-modes) decide cosa fa Claude quando arriva un commento inviato:

152 160 

153* **Claude risponde da solo**: quando la tua modalità di autorizzazione consente a Claude di pubblicare la risposta senza chiederti, Claude legge il thread e risponde, e modifica l'artefatto quando il commento chiede una modifica. Vedi `Auto-replied to comment thread on Artifact: <name>` o `Auto-edited Artifact: <name> in response to a comment thread`.161* **Claude risponde da solo**: quando la tua modalità di autorizzazione consente a Claude di pubblicare la risposta senza chiederti, Claude legge il thread e risponde, e modifica l'artefatto quando il commento chiede una modifica. Vedi `Auto-replied to comment thread on Artifact: <name>` o `Auto-edited Artifact: <name> in response to a comment thread`.

154* **Claude aspetta te**: al di fuori della modalità piano, quando la pubblicazione della risposta avrebbe bisogno della tua approvazione, vedi `Comments are waiting on Artifact: <name>`. Claude quindi ti chiede l'approvazione per leggere il thread, e di nuovo per pubblicare la risposta.162* **Claude aspetta te**: al di fuori della plan mode, quando la pubblicazione della risposta avrebbe bisogno della tua approvazione, vedi `Comments are waiting on Artifact: <name>`. Claude quindi ti chiede l'approvazione per leggere il thread, e di nuovo per pubblicare la risposta.

155* **Claude si mette in pausa in modalità piano**: vedi `Comments are waiting on Artifact: <name>`, e Claude non risponde fino a quando non esci dalla modalità piano e gli chiedi di leggere e rispondere.163* **Claude si mette in pausa in plan mode**: vedi `Comments are waiting on Artifact: <name>`, e Claude non risponde finché non esci dalla plan mode e non gli chiedi di leggere e rispondere.

156 164 

157Claude smette anche di rispondere da solo a un artefatto dopo aver gestito 60 commenti inviati o attivazioni di thread su quell'artefatto entro un'ora. Vedi `Comments are waiting on Artifact: <name>` una volta, e Claude riprende mentre i commenti di quell'ora invecchiano.165Claude smette anche di rispondere da solo a un artefatto dopo aver gestito 60 commenti inviati o attivazioni di thread su quell'artefatto entro un'ora. Vedi `Comments are waiting on Artifact: <name>` una volta, e Claude riprende mentre i commenti di quell'ora invecchiano.

158 166 

159Esegui `/tasks` per vedere ogni artefatto che la tua sessione sta osservando, elencato come un task di aggiornamenti in tempo reale. Puoi impedire a Claude di rispondere da solo in uno di questi modi:167Esegui `/tasks` per vedere ogni artefatto che la tua sessione sta osservando, elencato come un task con aggiornamenti in tempo reale. Puoi impedire a Claude di rispondere da solo in uno qualsiasi di questi modi:

160 168 

161* **Premi Ctrl+C una volta a un prompt inattivo**: Claude mette in pausa la risposta su ogni artefatto che la tua sessione sta osservando. Le risposte ricominceranno dopo che invii il tuo prossimo messaggio.169* **Premi Ctrl+C una volta al prompt inattivo**: Claude mette in pausa la risposta su ogni artefatto che la tua sessione sta osservando. Le risposte ricominceranno dopo che invii il tuo prossimo messaggio.

162* **Arresta il task in `/tasks`**: Claude smette di rispondere su quell'artefatto fino a quando non gli chiedi di riprendere le risposte lì. Pubblicare di nuovo l'artefatto non avvia di nuovo le risposte, e l'arresto si applica ancora quando riprendi la sessione in seguito.170* **Ferma il task in `/tasks`**: Claude smette di rispondere su quell'artefatto finché non gli chiedi di riprendere le risposte lì. Pubblicare di nuovo l'artefatto non avvia di nuovo le risposte, e l'arresto si applica ancora quando riprendi la sessione in seguito.

163* **Premi `Ctrl+X Ctrl+K` due volte entro 3 secondi**: l'accordo che [arresta ogni subagente di background in esecuzione](/docs/it/interactive-mode#general-controls) arresta anche Claude dal rispondere su ogni artefatto per il resto della sessione. Chiedere a Claude di riprendere le risposte non annulla questo arresto.171* **Premi `Ctrl+X Ctrl+K` due volte entro 3 secondi**: l'accordo che [ferma ogni subagent di background in esecuzione](/docs/it/interactive-mode#general-controls) ferma anche Claude dal rispondere su ogni artefatto per il resto della sessione. Chiedere a Claude di riprendere le risposte non annulla questo arresto.

164 172 

165Se il servizio che fornisce i commenti diventa non disponibile o smette di rispondere, Claude Code continua a provare a riconnettersi per un po', quindi smette di osservare ogni artefatto che la tua sessione stava osservando.173Se il servizio che fornisce i commenti diventa non disponibile o smette di rispondere, Claude Code continua a provare a riconnettersi per un po', quindi smette di osservare ogni artefatto che la tua sessione stava osservando.

166 174 


168 Estrarre dati live con i connettori MCP176 Estrarre dati live con i connettori MCP

169</h2>177</h2>

170 178 

171Un artifact può chiamare i [connettori MCP](/docs/it/mcp#use-mcp-servers-from-claude-ai) ogni volta che qualcuno lo visualizza, in modo che la pagina mostri dati attuali anziché uno snapshot della sessione che l'ha creato. Le chiamate ai connettori dagli artifact sono disponibili nei piani Pro, Max, Team ed Enterprise e richiedono Claude Code v2.1.209 o versioni successive. Nelle versioni precedenti, Claude pubblica la pagina con i dati che la sessione ha raccolto durante la creazione.179Un artifact può chiamare i [connettori MCP](/docs/it/mcp#use-mcp-servers-from-claude-ai) ogni volta che qualcuno lo visualizza, in modo che la pagina mostri dati attuali anziché uno snapshot dalla sessione che l'ha creato. Le chiamate ai connettori dagli artifact sono disponibili nei piani Pro, Max, Team ed Enterprise e richiedono Claude Code v2.1.209 o versioni successive. Nelle versioni precedenti, Claude pubblica la pagina con i dati che la sessione ha raccolto durante la creazione.

172 180 

173Per creare una pagina supportata da un connettore, nominate il connettore e i dati desiderati nel vostro prompt:181Per creare una pagina supportata da un connettore, nomina il connettore e i dati che desideri nel tuo prompt:

174 182 

175```text wrap theme={null}183```text wrap theme={null}

176Build a dashboard artifact of our open pull requests that pulls the live list through my GitHub connector when the page loads.184Build a dashboard artifact of our open pull requests that pulls the live list through my GitHub connector when the page loads.

177```185```

178 186 

179Claude dichiara quali connettori la pagina può chiamare come parte della pubblicazione, e la pagina non può chiamare connettori al di fuori di tale dichiarazione. Solo i connettori dal vostro account claude.ai si qualificano: Claude li nomina nella dichiarazione, e quando qualcuno visualizza la pagina, ogni chiamata [viene eseguita attraverso la connessione dell'account che visualizza](#how-connector-calls-work-for-viewers) a quel connettore. I server MCP locali che configurate in Claude Code, come i server da `.mcp.json`, possono fornire dati mentre Claude crea la pagina, ma la pagina pubblicata non può chiamarli.187Claude dichiara quali connettori la pagina può chiamare come parte della pubblicazione, e la pagina non può chiamare connettori al di fuori di quella dichiarazione. Solo i connettori dal tuo account claude.ai si qualificano: Claude li nomina nella dichiarazione, e quando qualcuno visualizza la pagina, ogni chiamata [viene eseguita attraverso la connessione dell'account che visualizza al connettore](#how-connector-calls-work-for-viewers). I server MCP locali che configuri in Claude Code, come i server da `.mcp.json`, possono fornire dati mentre Claude crea la pagina, ma la pagina pubblicata non può chiamarli.

180 188 

181La pagina recupera i dati quando si carica e può aggiornarsi a intervalli regolari o quando un visualizzatore utilizza un controllo di aggiornamento sulla pagina. Le risposte vengono memorizzate nella cache del browser del visualizzatore, quindi una pagina riaperta viene renderizzata dalle risposte memorizzate immediatamente, quindi si aggiorna con risultati freschi.189La pagina recupera i dati quando si carica e può aggiornarsi a intervalli o quando un visualizzatore utilizza un controllo di aggiornamento sulla pagina. Le risposte vengono memorizzate nella cache del browser del visualizzatore, quindi una pagina riaperta viene renderizzata dalle risposte memorizzate nella cache immediatamente, quindi si aggiorna con risultati freschi.

182 190 

183<h3 id="how-connector-calls-work-for-viewers">191<h3 id="how-connector-calls-work-for-viewers">

184 Come funzionano le chiamate ai connettori per i visualizzatori192 Come funzionano le chiamate ai connettori per i visualizzatori


190* **I visualizzatori approvano l'accesso per primo**: claude.ai chiede a ogni visualizzatore il permesso prima della prima chiamata al connettore della pagina. Un visualizzatore che rifiuta, o che non ha connesso un connettore che la pagina utilizza, vede comunque la pagina senza le sue sezioni live.198* **I visualizzatori approvano l'accesso per primo**: claude.ai chiede a ogni visualizzatore il permesso prima della prima chiamata al connettore della pagina. Un visualizzatore che rifiuta, o che non ha connesso un connettore che la pagina utilizza, vede comunque la pagina senza le sue sezioni live.

191* **Le azioni utilizzano anche l'account del visualizzatore**: una pagina può offrire controlli che invocano strumenti connettore con effetti collaterali, come pubblicare un messaggio o aggiornare un problema. L'azione viene eseguita attraverso l'account di chiunque selezioni il controllo.199* **Le azioni utilizzano anche l'account del visualizzatore**: una pagina può offrire controlli che invocano strumenti connettore con effetti collaterali, come pubblicare un messaggio o aggiornare un problema. L'azione viene eseguita attraverso l'account di chiunque selezioni il controllo.

192 200 

193Quando pianificate di condividere una pagina supportata da un connettore, chiedete a Claude di includere un messaggio di fallback in ogni sezione live che nomini il connettore di cui ha bisogno. Un visualizzatore che manca della connessione vede quindi cosa connettere invece di una sezione vuota.201Quando pianifichi di condividere una pagina supportata da un connettore, chiedi a Claude di includere un messaggio di fallback in ogni sezione live che nomini il connettore di cui ha bisogno. Un visualizzatore che manca della connessione vede quindi cosa connettere invece di una sezione vuota.

194 202 

195Un artifact che chiama connettori non può essere condiviso a un link pubblico su nessun piano. Nei piani Team ed Enterprise, potete mantenerlo privato o [condividerlo all'interno della vostra organizzazione](#share-an-artifact). Nei piani Pro e Max, dove un link pubblico è l'unico modo per condividere, un artifact supportato da connettore rimane privato per voi.203Un artifact che chiama connettori non può essere condiviso a un link pubblico su nessun piano. Nei piani Team ed Enterprise, puoi mantenerlo privato o [condividerlo all'interno della tua organizzazione](#share-an-artifact). Nei piani Pro e Max, dove un link pubblico è l'unico modo per condividere, un artifact supportato da un connettore rimane privato per te.

196 204 

197<h3 id="the-page-shows-no-live-data-for-a-viewer">205<h3 id="the-page-shows-no-live-data-for-a-viewer">

198 La pagina non mostra dati live per un visualizzatore206 La pagina non mostra dati live per un visualizzatore

199</h3>207</h3>

200 208 

201Quando una pagina supportata da un connettore viene renderizzata ma le sue sezioni live rimangono vuote per qualcuno con cui l'avete condivisa, esaminate queste cause:209Quando una pagina supportata da un connettore viene renderizzata ma le sue sezioni live rimangono vuote per qualcuno con cui l'hai condivisa, esamina queste cause:

210 

211* **Il visualizzatore non ha connesso il connettore**: i connettori sono per account, quindi ogni visualizzatore ha bisogno della propria connessione a ogni connettore che la pagina chiama. Possono aggiungerne uno in **Settings > Connectors** su claude.ai, quindi ricaricare la pagina.

212* **Il visualizzatore ha rifiutato la richiesta di permesso**: un rifiuto dura per il resto di quel caricamento di pagina. Ricaricare la pagina riporta la richiesta di permesso.

213* **Le chiamate ai connettori sono disattivate per l'organizzazione**: un Proprietario controlla l'interruttore [**Enable artifact connectors**](#control-connector-calls-from-artifacts) nelle impostazioni di amministrazione.

214* **La pagina chiama nomi di strumenti che il connettore non espone**: le sezioni interessate rimangono vuote per tutti, incluso te. Questo può accadere quando una pagina nomina i singoli strumenti dietro un connettore di tipo gateway che espone solo alcuni dei suoi strumenti. Chiedi a Claude di correggere i nomi degli strumenti che la pagina chiama e di pubblicarla di nuovo.

215 

216 Quando Claude pubblica la pagina e gli strumenti di quel connettore sono disponibili nella tua sessione, Claude Code controlla i nomi degli strumenti che la pagina dichiara rispetto ad essi, avverte Claude sui nomi che non corrispondono, e rifiuta la pubblicazione quando nessuno corrisponde. Prima della v2.1.265, pubblicava la pagina senza controllarli.

217 

218<h2 id="offer-a-file-download">

219 Offrire un download di file

220</h2>

202 221 

203* **Il visualizzatore non ha connesso il connettore**: i connettori sono per account, quindi ogni visualizzatore ha bisogno della propria connessione a ogni connettore che la pagina chiama. Possono aggiungerne uno in **Impostazioni > Connettori** su claude.ai, quindi ricaricare la pagina.222Un artifact può offrire ai visualizzatori un file generato dalla pagina, come un'esportazione CSV di una tabella o un PNG di un grafico. Il visualizzatore lo salva attraverso un controllo di download sulla pagina, come un pulsante. I download di file sono una capacità di runtime che claude.ai abilita per account, quindi Claude verifica se il vostro account la possiede prima di costruire il controllo.

204* **Il visualizzatore ha rifiutato la richiesta di permesso**: un rifiuto dura per il resto di quel caricamento della pagina. Ricaricare la pagina riporta la richiesta di permesso.223 

205* **Le chiamate ai connettori sono disattivate per l'organizzazione**: un Proprietario controlla l'interruttore [**Abilita connettori artifact**](#control-connector-calls-from-artifacts) nelle impostazioni di amministrazione.224I visualizzatori non possono salvare un file da un ordinario link di download o da uno script sulla pagina, perché il visualizzatore di artifact su claude.ai blocca qualsiasi download che la pagina avvia da sola, inclusi i link agli URL `data:` o `blob:`. Se una pagina ha pulsanti di download costruiti in questo modo, chiedete a Claude di ricostruirli con la capacità di download.

225 

226Per offrire un file, chiedete il controllo e il formato del file nel vostro prompt:

227 

228```text wrap theme={null}

229Add a button that downloads this table as a CSV file.

230```

231 

232Claude dichiara la capacità di download come parte della pubblicazione, nello stesso modo in cui [dichiara i connettori](#pull-live-data-with-mcp-connectors).

206 233 

207<h2 id="what-you-can-build">234<h2 id="what-you-can-build">

208 What you can build235 Cosa puoi costruire

209</h2>236</h2>

210 237 

211Un artifact è una singola pagina HTML, quindi qualsiasi cosa tu possa esprimere in HTML, CSS e JavaScript inline è nell'ambito. I pattern di seguito si presentano più spesso.238Un artifact è una singola pagina HTML, quindi tutto ciò che puoi esprimere in HTML, CSS e JavaScript inline rientra nell'ambito. I modelli seguenti sono i più comuni.

212 239 

213<h3 id="walk-through-a-change">240<h3 id="walk-through-a-change">

214 Walk through a change241 Analizzare una modifica

215</h3>242</h3>

216 243 

217Chiedi una pagina che renderizzi un diff o un cambiamento di design con annotazioni accanto alle righe rilevanti, in modo che i revisori possano leggere il tuo ragionamento accanto al codice invece di ricostruirlo da una descrizione.244Chiedi una pagina che renderizzi un diff o una modifica di design con annotazioni accanto alle righe rilevanti, in modo che i revisori possano leggere il tuo ragionamento accanto al codice invece di ricostruirlo da una descrizione.

218 245 

219```text wrap theme={null}246```text wrap theme={null}

220Make an artifact that walks through this PR. Render the diff with margin annotations and color-code findings by severity.247Crea un artifact che analizzi questo PR. Renderizza il diff con annotazioni a margine e codifica per colore i risultati in base alla gravità.

221```248```

222 249 

223<h3 id="compare-alternatives">250<h3 id="compare-alternatives">

224 Compare alternatives251 Confrontare alternative

225</h3>252</h3>

226 253 

227Chiedi diverse varianti su una pagina in modo da poter valutarle l'una contro l'altra. Questo funziona per layout, copy, forme API o piani di implementazione.254Chiedi diverse varianti su una pagina in modo da poter valutarle l'una rispetto all'altra. Questo funziona per layout, copy, forme API o piani di implementazione.

228 255 

229```text wrap theme={null}256```text wrap theme={null}

230Make an artifact with four distinctly different layouts for the settings panel. Vary density and grouping, and lay them out as a grid with a one-line tradeoff under each.257Crea un artifact con quattro layout distintamente diversi per il pannello delle impostazioni. Varia la densità e il raggruppamento, e disponili come una griglia con un compromesso su una riga sotto ciascuno.

231```258```

232 259 

233<h3 id="tune-with-interactive-controls">260<h3 id="tune-with-interactive-controls">

234 Tune with interactive controls261 Regolare con controlli interattivi

235</h3>262</h3>

236 263 

237Chiedi slider, interruttori o campi di input associati a quello che stai regolando, in modo da poter esplorare i valori direttamente invece di descriverli.264Chiedi cursori, interruttori o campi di input associati a tutto ciò che stai regolando, in modo da poter esplorare i valori direttamente invece di descriverli.

238 265 

239```text wrap theme={null}266```text wrap theme={null}

240Build an artifact with sliders for the easing curve, duration, and delay so I can try values on this transition. Show the animation live as I move them.267Costruisci un artifact con cursori per la curva di easing, la durata e il ritardo in modo da poter provare i valori su questa transizione. Mostra l'animazione dal vivo mentre li sposti.

241```268```

242 269 

243<h3 id="bring-the-result-back-to-your-session">270<h3 id="bring-the-result-back-to-your-session">

244 Bring the result back to your session271 Riportare il risultato nella tua sessione

245</h3>272</h3>

246 273 

247Un artifact può agire come un editor leggero per una decisione che poi restituisci a Claude. Chiedi un controllo di esportazione che produca testo che puoi incollare nel terminale, in modo che il risultato dell'interazione con la pagina fluisca di nuovo nella sessione invece di rimanere sulla pagina.274Un artifact può fungere da editor leggero per una decisione che poi invii di nuovo a Claude. Chiedi un controllo di esportazione che produca testo che puoi incollare nel terminale, in modo che il risultato dell'interazione con la pagina torni nella sessione invece di rimanere sulla pagina.

248 275 

249```text wrap theme={null}276```text wrap theme={null}

250Make a triage board artifact with each open issue as a draggable card across Now, Next, Later, and Cut columns. Add a "Copy as prompt" button that gives me the final ordering to paste back here.277Crea un artifact della bacheca di triage con ogni problema aperto come una scheda trascinabile tra le colonne Now, Next, Later e Cut. Aggiungi un pulsante "Copy as prompt" che mi dia l'ordinamento finale da incollare di nuovo qui.

251```278```

252 279 

253<h3 id="track-work-in-progress">280<h3 id="track-work-in-progress">

254 Track work in progress281 Tracciare il lavoro in corso

255</h3>282</h3>

256 283 

257Chiedi a Claude di mantenere un artifact aggiornato mentre un'attività lunga viene eseguita, in modo che chiunque abbia il link possa seguire senza leggere il terminale.284Chiedi a Claude di mantenere un artifact aggiornato mentre un'attività lunga è in esecuzione, in modo che chiunque abbia il link possa seguire senza leggere il terminale.

258 285 

259```text wrap theme={null}286```text wrap theme={null}

260Turn this migration plan into a checklist artifact. Check items off as you complete them and add a note for anything you skip.287Trasforma questo piano di migrazione in un artifact di checklist. Spunta gli elementi mentre li completi e aggiungi una nota per qualsiasi cosa tu salti.

261```288```

262 289 

263<h2 id="improve-the-visual-design">290<h2 id="improve-the-visual-design">

264 Migliorare il design visivo291 Migliorare il design visivo

265</h2>292</h2>

266 293 

267Claude applica una skill di design integrata quando crea un artifact, quindi le pagine ottengono una palette deliberata, tipografia e layout senza necessità di prompt aggiuntivi. Richiede Claude Code v2.1.182 o versione successiva. Quella skill cerca anche un sistema di design esistente nel vostro progetto prima di scegliere il proprio. I design token sono i valori denominati di colore, tipografia e spaziatura che il vostro sistema di design riutilizza. Per mantenere gli artifact coerenti con il branding del vostro prodotto, registrateli dove Claude può trovarli, come il [CLAUDE.md](/docs/it/memory) del progetto o un file di tema nel vostro repository:294Claude applica una skill di design integrata quando crea un artifact, quindi le pagine ottengono una palette deliberata, tipografia e layout senza necessità di prompt aggiuntivi. Quella skill cerca anche un sistema di design esistente nel vostro progetto prima di scegliere il proprio. I design token sono i valori denominati di colore, tipografia e spaziatura che il vostro sistema di design riutilizza. Per mantenere gli artifact coerenti con il branding del vostro prodotto, registrateli dove Claude può trovarli, come il [CLAUDE.md](/docs/it/memory) del progetto o un file di tema nel vostro repository:

268 295 

269```markdown theme={null}296```markdown theme={null}

270## Design system297## Design system


274- Spacing: 8px scale, 6px border radius301- Spacing: 8px scale, 6px border radius

275```302```

276 303 

277Claude tratta il vostro sistema di design con precedenza più alta rispetto alle proprie scelte, e il vostro prompt con precedenza più alta rispetto a entrambi. L'intestazione e il formato sopra sono un esempio; qualsiasi elenco chiaro di colori, font e spaziatura funziona.304Claude tratta il vostro sistema di design come priorità più alta rispetto alle sue scelte, e il vostro prompt come priorità più alta rispetto a entrambi. L'intestazione e il formato sopra sono un esempio; qualsiasi elenco chiaro di colori, font e spaziatura funziona.

278 305 

279Per la tipografia, Claude può caricare un carattere da Google Fonts, l'unica fonte di font esterno che una pagina artifact può caricare. Claude incorpora qualsiasi altro carattere come `@font-face` data URI e assegna a ogni carattere uno stack di fallback, quindi la pagina viene comunque visualizzata se un font non si carica. Per utilizzare un carattere specifico, nominate lo nel vostro prompt o nel vostro sistema di design.306Per la tipografia, Claude può caricare un carattere da Google Fonts, l'unica fonte di font esterno che una pagina artifact può caricare. Claude incorpora qualsiasi altro carattere come data URI `@font-face` e assegna a ogni carattere uno stack di fallback, quindi la pagina viene comunque visualizzata se un font non si carica. Per utilizzare un carattere specifico, nominate lo nel vostro prompt o nel vostro sistema di design.

280 307 

281<h2 id="draft-a-design-canvas">308<h2 id="draft-a-design-canvas">

282 Bozza di una tela di design309 Bozza di una tela di progettazione

283</h2>310</h2>

284 311 

285Per creare un mockup di un'interfaccia utente, un flusso di schermata, una pagina di destinazione o un poster piuttosto che costruire una pagina, eseguire `/design` con un breve. Claude bozza il design come tavole da disegno su una tela e pubblica la tela come un artefatto che esegue un'anteprima di ricerca dell'editor di Claude Design. Il breve nomina ciò che desideri disegnare:312Per creare un mockup di un'interfaccia utente, un flusso di schermata, una pagina di destinazione o un poster piuttosto che costruire una pagina, eseguire `/design` con un breve. Claude bozza il progetto come tavole da disegno su una tela e pubblica la tela come un artefatto Design. Il breve nomina ciò che desiderate disegnare:

286 313 

287```text wrap theme={null}314```text wrap theme={null}

288/design a settings screen for a mobile banking app315/design a settings screen for a mobile banking app

289```316```

290 317 

291Aprire l'artefatto pubblicato per rivedere le tavole da disegno. Dove il salvataggio è abilitato per il tuo account, selezionare un elemento su una tavola da disegno, modificarlo e salvare per pubblicare una nuova versione; altrimenti visualizzare la bozza ed esportarla come PNG o PDF.318Apri l'artefatto pubblicato in un browser desktop per rivedere le tavole da disegno. Seleziona un elemento su una tavola da disegno e modificalo, e le tue modifiche vengono salvate automaticamente. Puoi esportare ogni tavola da disegno come PNG o PDF.

292 319 

293`/design` richiede una sessione in cui [gli artefatti sono disponibili](#availability) e Claude Code v2.1.234 o versione successiva.320`/design` richiede una sessione in cui [gli artefatti sono disponibili](#availability) e Claude Code v2.1.265 o versioni successive.

294 321 

295<h2 id="page-constraints">322<h2 id="page-constraints">

296 Vincoli della pagina323 Vincoli della pagina

297</h2>324</h2>

298 325 

299Ogni artefatto è una pagina autonoma e indipendente. Claude Code racchiude il file che pubblicate in una shell di documento HTML e lo serve secondo una rigorosa Content Security Policy (CSP), che determina ciò che la pagina può fare.326Ogni artefatto è una pagina autonoma e indipendente. Claude Code avvolge il file che pubblicate in una shell di documento HTML e lo serve secondo una rigorosa Content Security Policy (CSP), che determina ciò che la pagina può fare.

300 327 

301| Vincolo | Effetto |328| Vincolo | Effetto |

302| :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |329| :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

303| Richieste esterne | La pagina può caricare caratteri tipografici da Google Fonts e script da [quattro host CDN pubblici](#allowlist-the-viewer-domain): cdnjs, i CDN di Tailwind e jQuery, e percorsi selezionati su jsDelivr come `/npm/`. La CSP blocca ogni immagine esterna e tutti gli altri script, fogli di stile e caratteri tipografici esterni, e consente alle chiamate `fetch`, XHR e WebSocket di raggiungere solo l'origine della pagina stessa e gli host di Google Fonts. Claude quindi carica qualsiasi libreria di cui la pagina ha bisogno da uno di questi CDN, incorpora inline tutto il resto del CSS e JavaScript, e incorpora le immagini come data URI. Le [chiamate Connector](#pull-live-data-with-mcp-connectors) passano attraverso claude.ai, che effettua la chiamata di rete stessa. |330| Richieste esterne | La pagina può caricare caratteri tipografici da Google Fonts e script da [cinque host CDN pubblici](#allowlist-the-viewer-domain): cdnjs, unpkg, i CDN Tailwind e jQuery, e percorsi selezionati su jsDelivr come `/npm/`. La CSP blocca ogni immagine esterna e tutti gli altri script, fogli di stile e caratteri tipografici esterni, e consente alle chiamate `fetch`, XHR e WebSocket di raggiungere solo l'origine della pagina stessa e gli host di Google Fonts. Claude quindi carica qualsiasi libreria di cui la pagina ha bisogno da uno di questi CDN, incorpora inline tutto il resto del CSS e JavaScript, e incorpora le immagini come data URI. Le [chiamate Connector](#pull-live-data-with-mcp-connectors) passano attraverso claude.ai, che effettua la chiamata di rete stessa. |

304| Nessun backend | Un artefatto è una pagina statica. Non può archiviare i dati inviati tramite un modulo né autenticare i visualizzatori da solo. L'unico modo per recuperare i dati quando qualcuno la visualizza è [chiamare i connector MCP](#pull-live-data-with-mcp-connectors), non un'API propria. |331| Nessun backend | Un artefatto è una pagina statica. Non può autenticare i visualizzatori da solo. |

332| Download | La pagina non può avviare un download da sola. Per consentire ai visualizzatori di salvare un file generato dalla pagina, Claude dichiara la capacità di download. Vedere [Offrire un download di file](#offer-a-file-download). |

305| Pagina singola | I link relativi non si risolvono, perché nulla viene distribuito insieme alla pagina. Per contenuti multi-sezione, Claude utilizza ancore in-page piuttosto che file separati. |333| Pagina singola | I link relativi non si risolvono, perché nulla viene distribuito insieme alla pagina. Per contenuti multi-sezione, Claude utilizza ancore in-page piuttosto che file separati. |

306| Tipi di file di origine | Il file pubblicato deve essere `.html`, `.htm` o `.md`. I file Markdown vengono renderizzati come HTML stilizzato. |334| Tipi di file di origine | Il file pubblicato deve essere `.html`, `.htm` o `.md`, e deve decodificarsi come UTF-8, o come UTF-16 little-endian dal suo byte-order mark. I file Markdown vengono renderizzati come pagine di documento stilizzate con codice evidenziato dalla sintassi. Un file che non si decodifica, o che contiene il carattere di sostituzione `U+FFFD`, viene [rifiutato con la riga e la colonna da correggere](/docs/it/errors#the-source-file-is-not-valid-utf-8-text). |

307| Dimensione renderizzata | La pagina renderizzata deve essere di 16 MiB o inferiore. Le immagini incorporate di grandi dimensioni sono la causa più comune quando la pubblicazione non riesce per dimensioni. |335| Dimensione renderizzata | La pagina renderizzata deve essere di 16 MiB o inferiore. Le immagini incorporate di grandi dimensioni sono la causa usuale quando una pubblicazione non riesce per dimensione. |

308 336 

309La generazione di un artefatto utilizza token di output come qualsiasi altra risposta, e una pagina stilizzata è più intensiva in termini di token rispetto allo stesso contenuto come testo di terminale. Il CSS inline, il JavaScript per i controlli interattivi e soprattutto le immagini incorporate come data URI sono i principali contributori. Per ridurre il costo in token di un artefatto:337La generazione di un artefatto utilizza token di output come qualsiasi altra risposta, e una pagina stilizzata è più intensiva in termini di token rispetto allo stesso contenuto come testo di terminale. CSS inline, JavaScript per controlli interattivi, e soprattutto immagini incorporate come data URI sono i principali contributori. Per ridurre il costo in token di un artefatto:

310 338 

311* Preferire SVG, o HTML e CSS, per i diagrammi rispetto alle immagini raster incorporate339* Preferire SVG, o HTML e CSS, per i diagrammi rispetto alle immagini raster incorporate

312* Omettere l'interattività di cui non avete bisogno340* Omettere l'interattività di cui non avete bisogno

313* Fare in modo che la pagina riassuma i grandi set di dati piuttosto che incorporarli completamente341* Fare in modo che la pagina riassuma grandi set di dati piuttosto che incorporarli completamente

314 342 

315<h2 id="availability">343<h2 id="availability">

316 Availability344 Availability


343 371 

344Puoi anche impostare `"enableArtifact": false` nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto per disattivare gli artifact per le sessioni in quel progetto. Un `"enableArtifact": true` in uno dei due file non li riattiva. L'onorare la chiave nelle impostazioni di progetto e locali richiede Claude Code v2.1.242 o successivo.372Puoi anche impostare `"enableArtifact": false` nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto per disattivare gli artifact per le sessioni in quel progetto. Un `"enableArtifact": true` in uno dei due file non li riattiva. L'onorare la chiave nelle impostazioni di progetto e locali richiede Claude Code v2.1.242 o successivo.

345 373 

374Se aggiungi una regola di negazione o richiesta `WebFetch` senza una parte `domain:`, non disattiva gli artifact né blocca le letture degli artifact. Una [regola `WebFetch(domain:claude.ai)` in `deny` o `ask` si applica alle letture degli artifact](/docs/it/permissions#allow-or-deny-every-fetch).

375 

346<h2 id="manage-artifacts-for-your-organization">376<h2 id="manage-artifacts-for-your-organization">

347 Manage artifacts for your organization377 Manage artifacts for your organization

348</h2>378</h2>


387 417 

388Un artifact che carica un carattere tipografico da [Google Fonts](#improve-the-visual-design) richiede anche `fonts.googleapis.com` e `fonts.gstatic.com`. Entrambi gli host sono facoltativi. Se li blocchi, gli artifact vengono renderizzati in caratteri tipografici di fallback. Blocca con un rifiuto veloce piuttosto che con un drop silenzioso in modo che la richiesta del carattere tipografico fallisca immediatamente invece di ritardare il primo rendering della pagina.418Un artifact che carica un carattere tipografico da [Google Fonts](#improve-the-visual-design) richiede anche `fonts.googleapis.com` e `fonts.gstatic.com`. Entrambi gli host sono facoltativi. Se li blocchi, gli artifact vengono renderizzati in caratteri tipografici di fallback. Blocca con un rifiuto veloce piuttosto che con un drop silenzioso in modo che la richiesta del carattere tipografico fallisca immediatamente invece di ritardare il primo rendering della pagina.

389 419 

390Gli artifact possono anche caricare librerie JavaScript, come React o un pacchetto di grafici, da `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com` e `code.jquery.com`, e da nessun altro host esterno. Se blocchi questi host, le parti di un artifact che dipendono da una libreria non funzionano, e a differenza di un carattere tipografico bloccato, una libreria bloccata non ha fallback. Blocca con un rifiuto veloce anche qui, in modo che una richiesta di libreria bloccata fallisca immediatamente piuttosto che rimanere in sospeso fino al timeout.420Gli artifact possono anche caricare librerie JavaScript, come React o un pacchetto di grafici, da `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` e `unpkg.com`, e da nessun altro host esterno. Se blocchi questi host, le parti di un artifact che dipendono da una libreria non funzionano, e a differenza di un carattere tipografico bloccato, una libreria bloccata non ha fallback. Blocca con un rifiuto veloce anche qui, in modo che una richiesta di libreria bloccata fallisca immediatamente piuttosto che rimanere in sospeso fino al timeout.

391 421 

392<h3 id="list-and-delete-artifacts-with-the-compliance-api">422<h3 id="list-and-delete-artifacts-with-the-compliance-api">

393 List and delete artifacts with the Compliance API423 List and delete artifacts with the Compliance API

Details

172 volumes: { pgdata: }172 volumes: { pgdata: }

173 ```173 ```

174 174 

175 Il gateway è un singolo binario Linux che legge la configurazione, si connette a Postgres e applica le migrazioni dello schema, esegue il discovery OIDC rispetto al tuo IdP, costruisce client upstream e inizia ad ascoltare. L'avvio è fail-closed per la configurazione, la connessione Postgres con un timeout di 5 secondi, il discovery OIDC e la costruzione del client upstream. Se uno di questi è irraggiungibile o non configurato correttamente, il gateway esce con un errore piuttosto che servire il traffico in uno stato degradato.175 Il gateway è un singolo binario Linux che legge la configurazione, si connette a Postgres e applica le migrazioni dello schema, esegue il discovery OIDC rispetto al tuo IdP, costruisce client upstream e inizia ad ascoltare.

176 

177 L'avvio è fail-closed per la configurazione, la connessione Postgres, il discovery OIDC e la costruzione del client upstream. Se uno di questi è irraggiungibile o non configurato correttamente, il gateway esce con un errore piuttosto che servire il traffico in uno stato degradato.

176 178 

177 Un avvio riuscito non convalida il percorso di inferenza, perché le credenziali dell'istanza Bedrock e Agent Platform si risolvono sulla prima richiesta, non all'avvio.179 Un avvio riuscito non convalida il percorso di inferenza, perché le credenziali dell'istanza Bedrock e Agent Platform si risolvono sulla prima richiesta, non all'avvio.

178 180 


273 275 

274Quando il certificato ruota, ogni sviluppatore vede di nuovo il prompt di fiducia, quindi tratta le rotazioni come un evento pianificato e ripubblica l'impronta digitale. Se la politica del gateway include [impostazioni che necessitano di approvazione](/docs/it/server-managed-settings#security-approval-dialogs), lo sviluppatore vede anche di nuovo quel dialogo di approvazione dopo aver accettato il nuovo certificato, perché Claude Code [memoria di approvazione](/docs/it/server-managed-settings#approval-memory) delle chiavi al certificato bloccato.276Quando il certificato ruota, ogni sviluppatore vede di nuovo il prompt di fiducia, quindi tratta le rotazioni come un evento pianificato e ripubblica l'impronta digitale. Se la politica del gateway include [impostazioni che necessitano di approvazione](/docs/it/server-managed-settings#security-approval-dialogs), lo sviluppatore vede anche di nuovo quel dialogo di approvazione dopo aver accettato il nuovo certificato, perché Claude Code [memoria di approvazione](/docs/it/server-managed-settings#approval-memory) delle chiavi al certificato bloccato.

275 277 

278Un gateway può restituire il campo facoltativo `email` nella sua risposta di token per nominare l'account che un accesso ha utilizzato. Quando lo fa, lo sviluppatore conferma l'account prima che Claude Code salvi la credenziale. Dopo un accesso confermato, `/status` mostra l'account.

279 

280La conferma richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore; un client al di sotto di quella versione ignora il campo. Il server del gateway nel binario `claude` non restituisce il campo, quindi i suoi accessi si completano senza la conferma.

281 

276Una volta che lo sviluppatore accede, il [selettore di modelli](/docs/it/model-config) mostra i modelli nell'elenco di autorizzazione `availableModels` dello sviluppatore. Le impostazioni gestite si applicano all'avvio e si aggiornano ogni ora, e la telemetria si instrada al tuo raccoglitore.282Una volta che lo sviluppatore accede, il [selettore di modelli](/docs/it/model-config) mostra i modelli nell'elenco di autorizzazione `availableModels` dello sviluppatore. Le impostazioni gestite si applicano all'avvio e si aggiornano ogni ora, e la telemetria si instrada al tuo raccoglitore.

277 283 

278Le sessioni si aggiornano silenziosamente prima della scadenza di `ttl_hours`. Quando un aggiornamento non riesce dopo il deprovision IdP, Claude Code richiede allo sviluppatore di accedere di nuovo.284Le sessioni si aggiornano silenziosamente prima della scadenza di `ttl_hours`. Quando un aggiornamento non riesce dopo il deprovision IdP, Claude Code richiede allo sviluppatore di accedere di nuovo.


489* **Avvio con il gateway irraggiungibile**: le sessioni connesse escono all'avvio con un errore dopo circa 10 secondi piuttosto che iniziare senza le loro impostazioni.495* **Avvio con il gateway irraggiungibile**: le sessioni connesse escono all'avvio con un errore dopo circa 10 secondi piuttosto che iniziare senza le loro impostazioni.

490* **Avvio dopo che il gateway termina la sessione**: vedi [Applica fail-closed startup](/docs/it/server-managed-settings#enforce-fail-closed-startup) per i lanci che si aprono disconnessi dal gateway e quelli che escono quando il gateway risponde con un `401`.496* **Avvio dopo che il gateway termina la sessione**: vedi [Applica fail-closed startup](/docs/it/server-managed-settings#enforce-fail-closed-startup) per i lanci che si aprono disconnessi dal gateway e quelli che escono quando il gateway risponde con un `401`.

491* **Deprovision**: una sessione il cui utente è disabilitato nell'IdP scade entro `ttl_hours` quando il prossimo aggiornamento fallisce.497* **Deprovision**: una sessione il cui utente è disabilitato nell'IdP scade entro `ttl_hours` quando il prossimo aggiornamento fallisce.

498* **Sign-out**: `/logout` elimina la credenziale del gateway dalla macchina dello sviluppatore.

499 * Quando il documento di scoperta del gateway pubblicizza un `revocation_endpoint` sullo schema, host e porta dell'URL del gateway, `/logout` invia anche i token archiviati a quell'endpoint in modo che il gateway possa terminare la sessione dal suo lato. La richiesta è best effort, quindi il sign-out si completa sulla macchina dello sviluppatore indipendentemente dal fatto che l'endpoint risponda. La revoca richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore.

500 * Il server del gateway nel binario `claude` non ne pubblicizza nessuno, quindi un sign-out da esso termina la sessione sulla macchina dello sviluppatore solo. Per forzare le sessioni fuori lato server, vedi [Rotazione della chiave JWT](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation).

492 501 

493<h3 id="what-the-organization-can-see">502<h3 id="what-the-organization-can-see">

494 Cosa può vedere l'organizzazione503 Cosa può vedere l'organizzazione

desktop.md +1 −1

Details

926 926 

927Un [artifact](/docs/it/artifacts) che carica un carattere da [Google Fonts](/docs/it/artifacts#improve-the-visual-design) richiede anche `fonts.googleapis.com` e `fonts.gstatic.com`. Entrambi gli host sono facoltativi. Se li blocchi, gli artifact vengono renderizzati in caratteri di fallback. Blocca con un rifiuto veloce piuttosto che un drop silenzioso in modo che la richiesta di carattere fallisca immediatamente invece di ritardare il primo rendering della pagina.927Un [artifact](/docs/it/artifacts) che carica un carattere da [Google Fonts](/docs/it/artifacts#improve-the-visual-design) richiede anche `fonts.googleapis.com` e `fonts.gstatic.com`. Entrambi gli host sono facoltativi. Se li blocchi, gli artifact vengono renderizzati in caratteri di fallback. Blocca con un rifiuto veloce piuttosto che un drop silenzioso in modo che la richiesta di carattere fallisca immediatamente invece di ritardare il primo rendering della pagina.

928 928 

929Gli artifact possono anche caricare librerie JavaScript, come React o un pacchetto di grafici, da `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com` e `code.jquery.com`, e da nessun altro host esterno. Se blocchi quegli host, le parti di un artifact che dipendono da una libreria non funzionano, e a differenza di un carattere bloccato, una libreria bloccata non ha fallback. Blocca con un rifiuto veloce anche qui, in modo che una richiesta di libreria bloccata fallisca subito piuttosto che rimanere in sospeso fino al timeout.929Gli artifact possono anche caricare librerie JavaScript, come React o un pacchetto di grafici, da `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` e `unpkg.com`, e da nessun altro host esterno. Se blocchi quegli host, le parti di un artifact che dipendono da una libreria non funzionano, e a differenza di un carattere bloccato, una libreria bloccata non ha fallback. Blocca con un rifiuto veloce anche qui, in modo che una richiesta di libreria bloccata fallisca subito piuttosto che rimanere in sospeso fino al timeout.

930 930 

931<h3 id="authentication-and-sso">931<h3 id="authentication-and-sso">

932 Autenticazione e SSO932 Autenticazione e SSO

Details

39| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Su` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |39| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Su` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |

40| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) |40| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) |

41| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Su` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](/docs/it/checkpointing) per ripristinare o riassumere il codice e la conversazione da un punto precedente |41| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Su` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](/docs/it/checkpointing) per ripristinare o riassumere il codice e la conversazione da un punto precedente |

42| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Interrompe il turno corrente in modo che i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, escano subito invece di quando il turno termina. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando senza interrompere. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |

42| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](/docs/it/permission-modes). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |43| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](/docs/it/permission-modes). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |

43| `Option+P` (macOS) o `Alt+P` (Windows/Linux) | Cambia modello | Cambia modelli senza cancellare il tuo prompt |44| `Option+P` (macOS) o `Alt+P` (Windows/Linux) | Cambia modello | Cambia modelli senza cancellare il tuo prompt |

44| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il pensiero esteso | Abilita o disabilita la modalità di pensiero esteso. Non ha effetto su Fable 5.1 o Fable 5, che utilizzano sempre il pensiero esteso. Funziona su macOS senza configurare Option come Meta |45| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il pensiero esteso | Abilita o disabilita la modalità di pensiero esteso. Non ha effetto su Fable 5.1 o Fable 5, che utilizzano sempre il pensiero esteso. Funziona su macOS senza configurare Option come Meta |


348* Le attività in background vengono pulite automaticamente quando Claude Code esce. Su macOS e Linux, quando interrompete un'attività in background da [`/tasks`](/docs/it/commands) o Claude Code la interrompe all'uscita, i processi che si sono staccati dalla shell dell'attività, come quelli avviati con `setsid` o `timeout`, si fermano anche loro349* Le attività in background vengono pulite automaticamente quando Claude Code esce. Su macOS e Linux, quando interrompete un'attività in background da [`/tasks`](/docs/it/commands) o Claude Code la interrompe all'uscita, i processi che si sono staccati dalla shell dell'attività, come quelli avviati con `setsid` o `timeout`, si fermano anche loro

349* Se mettete in background la sessione invece di uscire, le vostre attività in background continuano a essere eseguite nella sessione in background. Vedere [mettere in background una sessione in esecuzione](/docs/it/agent-view#from-inside-a-session)350* Se mettete in background la sessione invece di uscire, le vostre attività in background continuano a essere eseguite nella sessione in background. Vedere [mettere in background una sessione in esecuzione](/docs/it/agent-view#from-inside-a-session)

350* Le attività in background vengono terminate automaticamente se l'output supera 5GB, con una nota in stderr che spiega il motivo351* Le attività in background vengono terminate automaticamente se l'output supera 5GB, con una nota in stderr che spiega il motivo

351* Su macOS e Linux, Claude Code termina le attività in background in esecuzione quando il sistema operativo segnala pressione della memoria, a condizione che la sessione sia stata inattiva per almeno 30 minuti e nessun turno o subagent sia in esecuzione. Impostare [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/it/env-vars) a `1` per disattivare questa funzione. Richiede Claude Code v2.1.193 o successivo352* Su macOS e Linux, Claude Code termina le attività in background in esecuzione quando il sistema operativo segnala pressione della memoria, a condizione che la sessione sia stata inattiva per almeno 30 minuti e nessun turno o subagent sia in esecuzione. Richiede Claude Code v2.1.193 o successivo

353 * Il [log di debug](/docs/it/debug-your-config) spiega perché le attività sono state interrotte, o perché un evento di pressione le ha lasciate in esecuzione

354 * Impostare [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/it/env-vars) a `1` per disattivare gli arresti dovuti alla pressione della memoria

352* I comandi in background di proprietà di un [subagent](/docs/it/sub-agents) non hanno limite di tempo, tranne che un comando di proprietà di un subagent in esecuzione in foreground termina quando quel subagent fornisce la sua risposta finale; vedere [Comandi in background](/docs/it/tools-reference#background-commands) nel riferimento degli strumenti. Prima della v2.1.218, né il reap della pressione della memoria né il precedente limite di 60 minuti sui comandi del subagent coprivano i comandi spostati in background con `Ctrl+B`355* I comandi in background di proprietà di un [subagent](/docs/it/sub-agents) non hanno limite di tempo, tranne che un comando di proprietà di un subagent in esecuzione in foreground termina quando quel subagent fornisce la sua risposta finale; vedere [Comandi in background](/docs/it/tools-reference#background-commands) nel riferimento degli strumenti. Prima della v2.1.218, né il reap della pressione della memoria né il precedente limite di 60 minuti sui comandi del subagent coprivano i comandi spostati in background con `Ctrl+B`

353 356 

354Per disabilitare tutta la funzionalità di attività in background, impostare la variabile di ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` a `1`. Vedere [Variabili di ambiente](/docs/it/env-vars) per i dettagli.357Per disabilitare tutta la funzionalità di attività in background, impostare la variabile di ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` a `1`. Vedere [Variabili di ambiente](/docs/it/env-vars) per i dettagli.


394 397 

395Digitate un messaggio e premete `Enter` mentre Claude sta lavorando. Claude Code accoda il messaggio invece di interrompere il turno, e elenca le voci in coda sopra la casella di input finché non le invia. Potete accodare i comandi `!` [shell](#shell-mode-with-prefix) e la maggior parte dei [comandi](/docs/it/commands) allo stesso modo, ad eccezione dei comandi, come `/status`, che Claude Code esegue non appena li inviate.398Digitate un messaggio e premete `Enter` mentre Claude sta lavorando. Claude Code accoda il messaggio invece di interrompere il turno, e elenca le voci in coda sopra la casella di input finché non le invia. Potete accodare i comandi `!` [shell](#shell-mode-with-prefix) e la maggior parte dei [comandi](/docs/it/commands) allo stesso modo, ad eccezione dei comandi, come `/status`, che Claude Code esegue non appena li inviate.

396 399 

400I messaggi inviati e accodati vengono visualizzati in grigio finché Claude non inizia a rispondere, quindi potete capire quali messaggi Claude non ha ancora iniziato.

401 

397<h3 id="when-claude-code-sends-what-you-queued">402<h3 id="when-claude-code-sends-what-you-queued">

398 Quando Claude Code invia ciò che avete accodato403 Quando Claude Code invia ciò che avete accodato

399</h3>404</h3>

400 405 

401Quando una voce in coda raggiunge Claude dipende da ciò che avete accodato.406Quando una voce in coda raggiunge Claude dipende da ciò che avete accodato.

402 407 

403* Messaggi: se accodate un messaggio mentre Claude sta eseguendo chiamate di strumenti, Claude Code lo passa a Claude non appena quelle chiamate di strumenti terminano, all'interno dello stesso turno. Quando il turno termina con messaggi ancora in coda, Claude Code invia solo il più vecchio come turno successivo. Il resto rimane in coda e segue la stessa regola: Claude Code lo passa a Claude quando le chiamate di strumenti di quel turno terminano, o invia il più vecchio successivo come turno successivo408* Messaggi: se accodate un messaggio mentre Claude sta eseguendo chiamate di strumenti, Claude Code lo passa a Claude non appena quelle chiamate di strumenti terminano, all'interno dello stesso turno. Quando il turno termina con messaggi ancora in coda, vengono inviati senza un altro pressione di tasto, nell'ordine in cui li avete digitati

404* Comandi e comandi shell: Claude Code li mantiene finché il turno non termina, quindi li esegue uno alla volta409* Comandi e comandi shell: Claude Code li mantiene finché il turno non termina, quindi li esegue uno alla volta, mantenendo l'ordine in cui li avete accodati

410 

411Per inviare ciò che avete accodato senza aspettare che il turno termini, premete `Ctrl+Enter`. Claude Code interrompe il turno, e i vostri messaggi in coda vengono inviati subito, con la vostra bozza accodata dietro di essi se ne avevate digitata una. In [modalità shell](#shell-mode-with-prefix), il tasto accoda il vostro comando senza interrompere il turno. Richiede Claude Code v2.1.275 o successivo.

412 

413Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter` e accoda la bozza invece; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Entrambi i tasti sono associazioni dell'[azione `chat:sendNow`](/docs/it/keybindings#chat-actions).

405 414 

406Premete `Esc` per interrompere il turno invece. Claude Code mantiene ciò che avete accodato e lo invia subito.415Premete `Esc` per interrompere il turno senza inviare la vostra bozza. Claude Code mantiene ciò che avete accodato e lo invia subito.

407 416 

408Claude Code esegue alcuni comandi non appena li inviate invece di accodarli, tra cui `/model`, `/effort` e `/fast`. Ognuno dei tre cambia un'impostazione: il modello, il livello di sforzo o la modalità veloce. Se Claude Code applica la nuova impostazione al turno su cui Claude sta già lavorando, o solo dal vostro turno successivo, differisce per comando:417Claude Code esegue alcuni comandi non appena li inviate invece di accodarli, tra cui `/model`, `/effort` e `/fast`. Ognuno dei tre cambia un'impostazione: il modello, il livello di sforzo o la modalità veloce. Se Claude Code applica la nuova impostazione al turno su cui Claude sta già lavorando, o solo dal vostro turno successivo, differisce per comando:

409 418 

keybindings.md +6 −2

Details

112Azioni disponibili nel contesto `Chat`:112Azioni disponibili nel contesto `Chat`:

113 113 

114| Azione | Predefinito | Descrizione |114| Azione | Predefinito | Descrizione |

115| :-------------------- | :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |115| :-------------------- | :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

116| `chat:cancel` | Escape | Annulla l'input corrente |116| `chat:cancel` | Escape | Annulla l'input corrente |

117| `chat:clearInput` | Ctrl+L | Forza un ridisegno a schermo intero, preservando l'input e la conversazione. Nel [rendering a schermo intero](/docs/it/fullscreen#clear-the-conversation), cancella anche lo schermo |117| `chat:clearInput` | Ctrl+L | Forza un ridisegno a schermo intero, preservando l'input e la conversazione. Nel [rendering a schermo intero](/docs/it/fullscreen#clear-the-conversation), cancella anche lo schermo |

118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |


123| `chat:thinkingToggle` | Meta+T | Attiva/disattiva il pensiero esteso |123| `chat:thinkingToggle` | Meta+T | Attiva/disattiva il pensiero esteso |

124| `chat:submit` | Invio | Invia il messaggio |124| `chat:submit` | Invio | Invia il messaggio |

125| `chat:queueSubmit` | Ctrl+X Invio | Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo [mette in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche mentre i suggerimenti di autocompletamento sono aperti. Richiede v2.1.247 o successiva |125| `chat:queueSubmit` | Ctrl+X Invio | Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo [mette in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche mentre i suggerimenti di autocompletamento sono aperti. Richiede v2.1.247 o successiva |

126| `chat:sendNow` | Ctrl+Invio, Ctrl+X Ctrl+S | Interrompi il turno in esecuzione in modo che i tuoi [messaggi in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e la tua bozza con essi vengano inviati subito. Quando non è in esecuzione nulla, invia la bozza, e nella [modalità shell](/docs/it/interactive-mode#shell-mode-with-prefix) mette in coda il comando senza interrompere. I terminali che non segnalano tasti estesi consegnano `Ctrl+Invio` come semplice `Invio`, quindi `Ctrl+X Ctrl+S` è il binding che funziona in qualsiasi terminale. Richiede v2.1.275 o successiva |

126| `chat:newline` | Ctrl+J | Inserisci una nuova riga senza inviare |127| `chat:newline` | Ctrl+J | Inserisci una nuova riga senza inviare |

127| `chat:undo` | Ctrl+\_, Ctrl+Shift+- | Annulla l'ultima azione |128| `chat:undo` | Ctrl+\_, Ctrl+Shift+- | Annulla l'ultima azione |

128| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Apri nell'editor esterno. Il [dispatch input della visualizzazione dell'agente](/docs/it/agent-view#keyboard-shortcuts) segue anche i binding a singola pressione di tasto di questa azione |129| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Apri nell'editor esterno. Il [dispatch input della visualizzazione dell'agente](/docs/it/agent-view#keyboard-shortcuts) segue anche i binding a singola pressione di tasto di questa azione |


542 543 

543Questo funziona anche per i binding degli accordi. Annullare l'associazione di ogni accordo che condivide un prefisso libera quel prefisso per l'uso come binding a tasto singolo. Un accordo in qualsiasi contesto attivo mantiene il suo prefisso riservato, quindi è necessario annullare l'associazione di ogni accordo nel contesto che lo definisce.544Questo funziona anche per i binding degli accordi. Annullare l'associazione di ogni accordo che condivide un prefisso libera quel prefisso per l'uso come binding a tasto singolo. Un accordo in qualsiasi contesto attivo mantiene il suo prefisso riservato, quindi è necessario annullare l'associazione di ogni accordo nel contesto che lo definisce.

544 545 

545Claude Code associa questi accordi predefiniti sul prefisso `ctrl+x`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, e `ctrl+x tab` in `Chat`, `ctrl+x ctrl+b` in `Task`, e `ctrl+x b` in `DiffPanel`. L'accordo `ctrl+x enter` richiede v2.1.247 o successivo, e `ctrl+x b`, `ctrl+x ctrl+a`, e `ctrl+x tab` richiedono v2.1.260 o successivo. Per reclamare `ctrl+x` stesso come binding a tasto singolo, annullare l'associazione di tutti loro:546Claude Code associa questi accordi predefiniti sul prefisso `ctrl+x`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s`, e `ctrl+x tab` in `Chat`, `ctrl+x ctrl+b` in `Task`, e `ctrl+x b` in `DiffPanel`. L'accordo `ctrl+x enter` richiede v2.1.247 o successivo, `ctrl+x b`, `ctrl+x ctrl+a`, e `ctrl+x tab` richiedono v2.1.260 o successivo, e `ctrl+x ctrl+s` richiede v2.1.275 o successivo.

547 

548Per reclamare `ctrl+x` stesso come binding a tasto singolo, annullare l'associazione di tutti loro:

546 549 

547```json theme={null}550```json theme={null}

548{551{


566 "ctrl+x ctrl+e": null,569 "ctrl+x ctrl+e": null,

567 "ctrl+x enter": null,570 "ctrl+x enter": null,

568 "ctrl+x ctrl+a": null,571 "ctrl+x ctrl+a": null,

572 "ctrl+x ctrl+s": null,

569 "ctrl+x tab": null,573 "ctrl+x tab": null,

570 "ctrl+x": "chat:newline"574 "ctrl+x": "chat:newline"

571 }575 }

model-config.md +4 −4

Details

467 467 

468Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.468Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.

469 469 

470La fase Opus in modalità piano utilizza la stessa finestra di contesto dell'impostazione del modello `opus`. Sui livelli di abbonamento in cui Opus viene [aggiornato automaticamente a 1M di contesto](#extended-context), `opusplan` riceve l'aggiornamento anche in modalità piano. Per forzare il contesto 1M per entrambe le fasi quando non sei su un livello di aggiornamento automatico, [imposta il modello](#setting-your-model) su `opusplan[1m]`, ad esempio con `/model opusplan[1m]`. Impostarlo con `/model` richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag `--model` o l'impostazione `model`.470La fase Opus in modalità piano utilizza la stessa finestra di contesto dell'impostazione del modello `opus`, e la fase di esecuzione utilizza la stessa finestra di `sonnet`. Quando `opus` e `sonnet` si risolvono in modelli che vengono eseguiti con la [finestra di contesto 1M](#extended-context) per impostazione predefinita, come i modelli attuali su Anthropic API, entrambe le fasi vengono eseguite con essa. Per richiedere il contesto 1M per entrambe le fasi dove non lo fanno, [imposta il modello](#setting-your-model) su `opusplan[1m]`, ad esempio con `/model opusplan[1m]`. Impostarlo con `/model` richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag `--model` o l'impostazione `model`.

471 471 

472Quando [`availableModels`](#restrict-model-selection) esclude l'Opus più recente ma consente una versione precedente, ad esempio `["sonnet", "claude-opus-4-6"]`, `opusplan` utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente si aggiornerebbe a Sonnet in modalità piano utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, la modalità piano rimase sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'elenco consentito ne consentiva una precedente.472Quando [`availableModels`](#restrict-model-selection) esclude l'Opus più recente ma consente una versione precedente, ad esempio `["sonnet", "claude-opus-4-6"]`, `opusplan` utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente si aggiornerebbe a Sonnet in modalità piano utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, la modalità piano rimase sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'elenco consentito ne consentiva una precedente.

473 473 


710 710 

711Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 e successivi e Sonnet 4.6 supportano una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe con basi di codice di grandi dimensioni.711Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 e successivi e Sonnet 4.6 supportano una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe con basi di codice di grandi dimensioni.

712 712 

713La disponibilità varia in base al modello e al piano. Su Anthropic API, Fable 5.1, Fable 5, Sonnet 5 e Opus 4.7 e successivi vengono eseguiti con la finestra 1M per impostazione predefinita.713Su Anthropic API, Fable 5.1, Fable 5, Sonnet 5 e Opus 4.7 e successivi vengono eseguiti con la finestra 1M su ogni piano, incluso Pro. Non selezioni una variante `[1m]` o attivi crediti di utilizzo per la finestra 1M su questi modelli. L'utilizzo di Fable stesso può fatturare ai crediti di utilizzo su alcuni piani; vedere [Fable e crediti di utilizzo](#fable-and-usage-credits).

714 714 

715Su piani Max, Team e Enterprise, inclusi sia i posti Team Standard che Team Premium, Opus viene aggiornato automaticamente a contesto 1M senza configurazione aggiuntiva. Sonnet 4.6 con contesto 1M non fa parte dell'aggiornamento automatico e richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) su ogni piano di abbonamento, incluso Max.715Opus 4.6 e Sonnet 4.6 raggiungono 1M solo attraverso la loro variante `[1m]`, e l'accesso a quella variante dipende dal tuo piano. Su piani Max, Team ed Enterprise, inclusi sia i posti Team Standard che Team Premium, Opus 4.6 con contesto 1M è incluso nel tuo abbonamento. Sonnet 4.6 con contesto 1M richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) su ogni piano di abbonamento, incluso Max.

716 716 

717| Piano | Opus con contesto 1M | Sonnet 4.6 con contesto 1M |717| Piano | Opus 4.6 con contesto 1M | Sonnet 4.6 con contesto 1M |

718| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |718| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |

719| Max, Team e Enterprise | Incluso nell'abbonamento | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |719| Max, Team e Enterprise | Incluso nell'abbonamento | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

720| Pro | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |720| Pro | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

Details

286 286 

287Un [artifact](/docs/it/artifacts) che carica un carattere da [Google Fonts](/docs/it/artifacts#improve-the-visual-design) richiede anche `fonts.googleapis.com` e `fonts.gstatic.com`. Entrambi gli host sono facoltativi. Se li bloccate, gli artifact vengono renderizzati in caratteri di fallback. Bloccate con un rifiuto veloce piuttosto che un drop silenzioso in modo che la richiesta di carattere fallisca immediatamente invece di ritardare il primo rendering della pagina.287Un [artifact](/docs/it/artifacts) che carica un carattere da [Google Fonts](/docs/it/artifacts#improve-the-visual-design) richiede anche `fonts.googleapis.com` e `fonts.gstatic.com`. Entrambi gli host sono facoltativi. Se li bloccate, gli artifact vengono renderizzati in caratteri di fallback. Bloccate con un rifiuto veloce piuttosto che un drop silenzioso in modo che la richiesta di carattere fallisca immediatamente invece di ritardare il primo rendering della pagina.

288 288 

289Gli artifact possono anche caricare librerie JavaScript, come React o un pacchetto di grafici, da `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com` e `code.jquery.com`, e da nessun altro host esterno. Se bloccate quegli host, le parti di un artifact che dipendono da una libreria non funzionano, e a differenza di un carattere bloccato, una libreria bloccata non ha fallback. Bloccate con un rifiuto veloce anche qui, in modo che una richiesta di libreria bloccata fallisca immediatamente piuttosto che rimanere in sospeso fino al timeout.289Gli artifact possono anche caricare librerie JavaScript, come React o un pacchetto di grafici, da `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` e `unpkg.com`, e da nessun altro host esterno. Se bloccate quegli host, le parti di un artifact che dipendono da una libreria non funzionano, e a differenza di un carattere bloccato, una libreria bloccata non ha fallback. Bloccate con un rifiuto veloce anche qui, in modo che una richiesta di libreria bloccata fallisca immediatamente piuttosto che rimanere in sospeso fino al timeout.

290 290 

291<h2 id="additional-resources">291<h2 id="additional-resources">

292 Risorse aggiuntive292 Risorse aggiuntive

Details

3170 3170 

3171Scegli se Claude Code registra i file che un comando Bash modifica in un repository Git. Quando li registra, vedi il loro diff nel terminale dopo il comando, e i tuoi [hook Bash PostToolUse](/docs/it/hooks#bash) ricevono l'elenco dei file modificati.3171Scegli se Claude Code registra i file che un comando Bash modifica in un repository Git. Quando li registra, vedi il loro diff nel terminale dopo il comando, e i tuoi [hook Bash PostToolUse](/docs/it/hooks#bash) ricevono l'elenco dei file modificati.

3172 3172 

3173Un file elencato non è sempre uno che il comando ha modificato. Una modifica che un altro programma o un'altra chiamata Bash ha fatto mentre il comando era in esecuzione può apparire lì anche.

3174 

3173Imposta la chiave su `true` per registrarli in ogni modalità di autorizzazione. Richiede Claude Code v2.1.269 o successivo.3175Imposta la chiave su `true` per registrarli in ogni modalità di autorizzazione. Richiede Claude Code v2.1.269 o successivo.

3174 3176 

3175* **Scope**: [`User or managed`](#scopes). Un `true` conta solo dalle tue impostazioni utente, JSON passato con `--settings`, o [impostazioni gestite](/docs/it/managed-settings), quindi un `true` nel `.claude/settings.json` o `.claude/settings.local.json` di un repository non può attivare la registrazione. Un `false` in uno qualsiasi dei file del repository disattiva comunque la registrazione a meno che un file con [precedenza più alta](/docs/it/settings#settings-precedence) non imposti `true`.3177* **Scope**: [`User or managed`](#scopes). Un `true` conta solo dalle tue impostazioni utente, JSON passato con `--settings`, o [impostazioni gestite](/docs/it/managed-settings), quindi un `true` nel `.claude/settings.json` o `.claude/settings.local.json` di un repository non può attivare la registrazione. Un `false` in uno qualsiasi dei file del repository disattiva comunque la registrazione a meno che un file con [precedenza più alta](/docs/it/settings#settings-precedence) non imposti `true`.