Gli artifact sono disponibili sui piani Pro, Max, Team ed Enterprise e richiedono una sessione autenticata con
/login. Consulta Disponibilità per l’insieme completo dei requisiti.
Quando utilizzare un artifact
Utilizza un artifact quando il testo del terminale non è il mezzo appropriato per ciò che Claude ha prodotto: output che è più facile da visualizzare e con cui interagire rispetto a leggere riga per riga. Claude costruisce la pagina da qualsiasi cosa la tua sessione possa raggiungere, incluso il tuo codebase e i dati che estrae attraverso i tuoi strumenti connessi, quindi la pagina può mostrare cose che richiederebbero paragrafi per descrivere. Ad esempio, chiedi a Claude di:- Guidare un revisore attraverso una pull request con diff annotati
- Renderizzare una dashboard dai dati che la sessione ha già estratto
- Disporre diverse opzioni di design o implementazione affiancate
- Mantenere una timeline di investigazione che si riempie mentre un’attività lunga è in esecuzione
- Inviare a un collega un link invece di incollare l’output in Slack
- Pubblicare una bacheca di stato che estrae dati freschi attraverso connettori MCP ogni volta che qualcuno la apre
Cosa un artifact non è
Un 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. Per uno strumento interno ospitato con un backend, distribuiscilo sulla tua infrastruttura. Vedi Vincoli della pagina per l’insieme completo dei limiti.Creare un artifact
Claude può pubblicare un artifact autonomamente quando l’output è adatto a una pagina, oppure puoi richiederne uno direttamente. Per richiederne uno, nomina la funzionalità o descrivi l’output visivo che desideri in linguaggio naturale. Un buon candidato è qualsiasi cosa più facile da vedere che da leggere come testo, come un diff annotato, un grafico o un insieme di opzioni da confrontare. I prompt seguenti sono due esempi; consulta Cosa puoi creare per altri modelli.- Modalità Auto: il classificatore esamina la pubblicazione invece di chiederti, quindi Claude può pubblicare una pagina senza che tu veda un prompt. La modalità in cui le tue sessioni iniziano dipende dal tuo piano; consulta la modalità di autorizzazione iniziale.
- Modalità Manuale e Accetta modifiche: Claude Code chiede l’autorizzazione; potrebbe dire qualcosa come
Claude wants to publish deploy-failures.html, uploading it to claude.ai (Anthropic's servers) to host as the page "Deploy failures by service", private to you until you share it. Seleziona Sì per pubblicare.
- Claude dichiara una capacità di runtime per la pagina, come connector calls
- Da allora hai condiviso pubblicamente
- Da allora hai condiviso con persone specifiche o la tua organizzazione con l’ultima versione scelta come versione che i visualizzatori vedono
Ctrl+] in qualsiasi momento per riaprire l’artifact più recente della sessione.
Claude sceglie il titolo dell’artifact e un emoji per l’icona della scheda del browser. Entrambi appaiono nella tua galleria di artifact su claude.ai e nei link condivisi, quindi chiedi a Claude di usare un titolo o un’icona specifici se ne desideri uno.
Per impedire al browser di aprirsi automaticamente quando viene pubblicato un nuovo artifact, imposta CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 nel tuo ambiente.
Se Claude risponde che non può pubblicare, o scrive un file HTML locale senza un link, lo strumento non è abilitato per la tua sessione. Controlla i requisiti di Disponibilità.
Aggiornare un artifact
Chiedete a Claude di revisionare la pagina, oppure lasciate che un’attività a lunga esecuzione ripubblichi man mano che fa progressi. Claude modifica il file sottostante e ripubblica allo stesso URL./artifacts. Senza uno dei due, una nuova sessione crea un nuovo artifact invece di aggiornarne uno.
Trovare di nuovo un artifact
Esegui/artifacts in Claude Code per elencare ogni artifact che possiedi e ogni artifact condiviso con te. Selezionane uno e premi o per aprirlo nel tuo browser o c per copiare il suo link. Premi Invio per allegarlo alla sessione corrente; prima della v2.1.216, Invio lo apriva nel tuo browser. Claude Code legge l’elenco dal tuo account claude.ai, quindi funziona in una nuova sessione e dopo /clear, quando il link è scomparso dal terminale. Richiede Claude Code v2.1.208 o versione successiva.
Condividere un artifact
Un nuovo artifact è visibile solo a voi. Per condividerlo, aprite l’artifact nel vostro browser e utilizzate il controllo Share nell’intestazione della pagina. L’intestazione contiene anche un collegamento alla vostra galleria su claude.ai/code/artifacts, che elenca ogni artifact che avete creato. I visualizzatori della vostra organizzazione possono vedere chi ha pubblicato la pagina: su un artifact condiviso all’interno della vostra organizzazione, il vostro nome è nel menu del titolo, e su un artifact pubblico è nell’intestazione della pagina per i visualizzatori che hanno effettuato l’accesso nella vostra organizzazione. Un visualizzatore che apre un collegamento pubblico senza effettuare l’accesso, o da fuori della vostra organizzazione, vede l’etichettaContent is user-generated and unverified. al posto del vostro nome.
Chi potete condividere dipende dal vostro piano:
- All’interno della vostra organizzazione: nei piani Team e Enterprise, concedete l’accesso a persone specifiche della vostra organizzazione, o a tutti. I visualizzatori effettuano l’accesso a claude.ai come membri della vostra organizzazione per vedere la pagina.
- Pubblicamente: condividete un collegamento che chiunque su internet può aprire, senza richiedere l’accesso a claude.ai. Nei piani Pro e Max, un collegamento pubblico è l’unico modo per condividere un artifact. Nei piani Team e Enterprise, la condivisione pubblica è disattivata finché un Owner non la abilita per l’organizzazione.
Permettere a qualcuno di modificare con voi
Le persone con cui condividete sono visualizzatori per impostazione predefinita: vedono ogni versione che pubblicate ma non possono modificare la pagina. Nei piani Team e Enterprise, potete anche rendere qualcuno un editor. Nella finestra di dialogo di condivisione, aggiungete una persona e cambiate il suo ruolo da viewer a editor. Un editor pubblica nuove versioni nello stesso modo in cui voi aggiornate l’artifact da un’altra sessione: forniscono a Claude l’URL dell’artifact, o lo allegano da/artifacts, 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.
Raccogliere commenti su un artefatto
Quando 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 riceve commenti. Claude legge i commenti in due casi:- 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.
- 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
@claudein uno. In entrambi i casi, attivano il thread.
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.
Per chiedere i commenti tu stesso, fornisci a Claude l’URL:
- Stai eseguendo Claude Code v2.1.221 o successivo.
- 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, Claude potrebbe non essere ancora in grado di leggere i commenti; avvia una nuova sessione e chiedi di nuovo.
- Non hai disattivato il recupero dei flag di funzionalità.
Lascia che Claude risponda ai commenti da solo
Dopo 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. Hai bisogno di Claude Code v2.1.228 o successivo. Se hai disattivato il recupero dei flag di funzionalità, Claude Code non osserva i commenti. La tua modalità di autorizzazione decide cosa fa Claude quando arriva un commento inviato:- 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>oAuto-edited Artifact: <name> in response to a comment thread. - 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. - 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.
Comments are waiting on Artifact: <name> una volta, e Claude riprende mentre i commenti di quell’ora invecchiano.
Esegui /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:
- 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.
- 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. - Premi
Ctrl+X Ctrl+Kdue volte entro 3 secondi: l’accordo che arresta ogni subagente di background in esecuzione arresta anche Claude dal rispondere su ogni artefatto per il resto della sessione. Chiedere a Claude di riprendere le risposte non annulla questo arresto.
Estrarre dati live con i connettori MCP
Un artifact può chiamare i connettori MCP 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. Per creare una pagina supportata da un connettore, nominate il connettore e i dati desiderati nel vostro prompt:.mcp.json, possono fornire dati mentre Claude crea la pagina, ma la pagina pubblicata non può chiamarli.
La 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.
Come funzionano le chiamate ai connettori per i visualizzatori
Quando una pagina pubblicata chiama un connettore, la chiamata utilizza l’account della persona che visualizza la pagina, non l’account della persona che l’ha pubblicata:- Ogni visualizzatore utilizza i propri connettori: le chiamate passano attraverso gli strumenti connessi dell’account che visualizza, quindi due persone che aprono lo stesso dashboard possono vedere dati diversi a seconda di ciò a cui i loro account possono accedere. La pagina non vede mai le credenziali di nessuno; claude.ai effettua le chiamate per conto della pagina.
- 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.
- 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.
La pagina non mostra dati live per un visualizzatore
Quando 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:- 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.
- 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.
- Le chiamate ai connettori sono disattivate per l’organizzazione: un Proprietario controlla l’interruttore Abilita connettori artifact nelle impostazioni di amministrazione.
What you can build
Un 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.Walk through a change
Chiedi 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.Compare alternatives
Chiedi 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.Tune with interactive controls
Chiedi slider, interruttori o campi di input associati a quello che stai regolando, in modo da poter esplorare i valori direttamente invece di descriverli.Bring the result back to your session
Un 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.Track work in progress
Chiedi 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.Migliorare il design visivo
Claude 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 del progetto o un file di tema nel vostro repository:@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.
Bozza di una tela di design
Per 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:
/design richiede una sessione in cui gli artefatti sono disponibili e Claude Code v2.1.234 o versione successiva.
Vincoli della pagina
Ogni 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.
La 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:
- Preferire SVG, o HTML e CSS, per i diagrammi rispetto alle immagini raster incorporate
- Omettere l’interattività di cui non avete bisogno
- Fare in modo che la pagina riassuma i grandi set di dati piuttosto che incorporarli completamente
Availability
Gli artifact richiedono ogni condizione di seguito. Quando una non è soddisfatta, Claude scrive un file HTML locale o dice che non può pubblicare.Disattivare gli artifact
Per disattivare gli artifact per le tue sessioni indipendentemente dall’impostazione della tua organizzazione, usa uno qualsiasi di:
Una volta che disattivi gli artifact in un file
--settings o con CLAUDE_CODE_DISABLE_ARTIFACT, o il tuo amministratore li disattiva nelle impostazioni gestite, nessun file di impostazioni li riattiva. Prima della v2.1.242, un file più in alto nella stack di precedenza potrebbe riattivare gli artifact anche quando un file con precedenza inferiore impostava "enableArtifact": false.
Puoi 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.
Manage artifacts for your organization
I proprietari sui piani Team e Enterprise controllano gli artifact dalle impostazioni admin di claude.ai. Il contenuto dell’artifact è archiviato su infrastruttura gestita da Anthropic ed è visibile solo ai membri autenticati dell’organizzazione che pubblica, a meno che l’artifact non sia condiviso pubblicamente.Enable or disable artifacts
Per abilitare o disabilitare gli artifact per l’intera organizzazione, vai a Settings > Claude Code > Capabilities e usa l’interruttore Artifacts. Sui piani Enterprise con controllo dell’accesso basato su ruoli, puoi inoltre limitare gli artifact a ruoli specifici: vai a Settings > Roles, modifica un ruolo e imposta l’autorizzazione Artifacts nel gruppo Claude Code.Control connector calls from artifacts
Le chiamate ai connettori dagli artifact hanno il loro interruttore dedicato, separato dall’interruttore Artifacts che attiva o disattiva gli artifact. Vai a Settings > Capabilities e usa l’interruttore Enable artifact connectors. Lo stesso interruttore governa le chiamate ai connettori dagli artifact creati nelle conversazioni di claude.ai, motivo per cui si trova sotto Settings > Capabilities piuttosto che sotto Settings > Claude Code.Control public sharing
La condivisione pubblica è disattivata per impostazione predefinita sui piani Team e Enterprise, quindi i membri possono condividere gli artifact solo all’interno dell’organizzazione finché un proprietario non la attiva. Per consentire ai membri di pubblicare artifact su link pubblici che chiunque può visualizzare senza accedere, vai a Settings > Claude Code > Capabilities e attiva External sharing sotto l’interruttore Artifacts. Disattivarla di nuovo blocca l’accesso tramite link pubblici esistenti senza modificare il pubblico di ogni artifact; l’accesso riprende se lo riabiliti.Set a retention policy
Per impostare quanto tempo gli artifact vengono conservati prima dell’eliminazione automatica, vai a Settings > Data & privacy controls. Puoi impostare periodi di conservazione separati per gli artifact che sono ancora privati al loro autore e gli artifact che sono stati condivisi.Review the audit log
La pubblicazione, la condivisione e l’eliminazione di un artifact appaiono ciascuna nel registro di audit della tua organizzazione sotto i tipi di eventoclaude_artifact_*, la stessa famiglia utilizzata per gli artifact creati nelle conversazioni di claude.ai.
Allowlist the viewer domain
Il visualizzatore su claude.ai carica ogni artifact da un’origine sandbox*.claudeusercontent.com. Se la tua organizzazione limita l’accesso alla rete in uscita, aggiungi quel dominio alla tua allowlist insieme a claude.ai. Vedi Requisiti di accesso alla rete per l’elenco completo.
Un artifact che carica un carattere tipografico da Google Fonts 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.
Gli 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.
List and delete artifacts with the Compliance API
La Compliance API fornisce endpoint per elencare gli artifact di un’organizzazione, recuperare il contenuto di una versione specifica e eliminare un artifact:
Per gli schemi di richiesta e risposta, vedi il riferimento della Compliance API.
Risorse correlate
- Sfoglia pattern di prompting e workflow che si abbinano agli artifact
- Trasforma un prompt di artifact che riutilizzi in una skill in modo da poterlo invocare come comando
- Connetti server MCP in modo che Claude possa estrarre dati in un artifact mentre lo crea