Gli artifact sono in beta. Richiedono un piano Team o Enterprise e una sessione autenticata con
/login. Vedi Disponibilità per l’insieme completo dei requisiti.
- Decidere quando usare un artifact
- Creare, aggiornare e condividere un artifact
- Applicare pattern di prompting per pagine più ricche
- Applicare il tuo sistema di design in modo che gli artifact corrispondano al branding del tuo prodotto
- Comprendere i vincoli della pagina e i requisiti di disponibilità
- Disabilitare o gestire gli artifact per la tua organizzazione
When to use an artifact
Usa un artifact quando il testo del terminale è il mezzo sbagliato per quello che Claude ha prodotto: output che è più facile da guardare e con cui interagire rispetto a leggere riga per riga. Claude costruisce la pagina da qualsiasi cosa la tua sessione possa raggiungere, inclusa la tua 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 viene eseguita
- Inviare a un collega un link invece di incollare l’output in Slack
What an artifact is not
Un artifact è una cattura del lavoro, non un’applicazione. È una singola pagina autonoma senza backend, quindi non può archiviare l’input del modulo, chiamare un’API al momento della visualizzazione o servire più route. Per uno strumento interno ospitato con un backend, distribuiscilo sulla tua infrastruttura. Vedi Vincoli della pagina per l’insieme completo dei limiti.Create an artifact
Claude può pubblicare un artifact da solo quando l’output si adatta a una pagina, oppure puoi chiederne uno direttamente. Per chiedere, nomina la funzione o descrivi l’output visivo che desideri in linguaggio semplice. 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 di seguito sono due esempi; vedi Cosa puoi costruire per altri pattern.Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai. Ripubblicare un artifact che hai già approvato non richiede di nuovo il prompt.
Seleziona Yes per pubblicare. Claude stampa l’URL e il tuo browser si apre sulla nuova pagina. Premi Ctrl+] in qualsiasi momento per riaprire l’artifact più recente dal terminale.
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 specifica se ne vuoi 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à.
Update an artifact
Chiedi a Claude di revisionare la pagina, o lascia che un’attività di lunga durata ripubblichi mentre fa progressi. Claude modifica il file sottostante e pubblica di nuovo allo stesso URL.Share an artifact
Un nuovo artifact è visibile solo a te. Aprilo nel tuo browser e usa il controllo Share nell’intestazione della pagina per concedere l’accesso a persone specifiche nella tua organizzazione, o a tutti. L’intestazione ti nomina come autore dell’artifact, quindi chiunque tu lo condivida con può vedere chi ha pubblicato la pagina. Si collega anche alla tua galleria su claude.ai/code/artifacts, che elenca ogni artifact che hai creato. La condivisione si ferma alla tua organizzazione. I visualizzatori devono accedere a claude.ai come membro della stessa organizzazione che ha pubblicato l’artifact, e non c’è opzione per rendere un artifact visibile al di fuori di essa. Per inviare il contenuto sottostante a qualcuno al di fuori della tua organizzazione, chiedi a Claude il file HTML e condividi quel file direttamente. Gli artifact sono visualizzabili, non co-modificabili. Le persone con cui lo condividi vedono ogni versione che pubblichi ma non possono modificare la pagina; rimani l’unico scrittore.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.Improve the visual design
Claude applica una skill di design integrata quando costruisce un artifact, quindi le pagine ottengono una tavolozza deliberata, tipografia e layout senza prompt extra. Quella skill cerca anche un sistema di design esistente nel tuo progetto prima di scegliere il suo. Per mantenere gli artifact coerenti con il branding del tuo prodotto, registra i tuoi token di design dove Claude può trovarli, come il CLAUDE.md del progetto o un file di tema nel tuo repository:Page constraints
Ogni artifact è una singola pagina autonoma. Claude Code avvolge il file che pubblichi in una shell di documento HTML e lo serve secondo una rigorosa Content Security Policy (CSP), che modella quello che la pagina può fare.| Constraint | Effect |
|---|---|
| No external requests | La CSP blocca script, fogli di stile, font e immagini caricate da qualsiasi altro host, insieme a fetch, XHR e chiamate WebSocket. Claude incorpora CSS e JavaScript e incorpora immagini come data URI in modo che la pagina si renderizzi senza alcuna richiesta esterna. |
| No backend | Un artifact è una pagina statica. Non può archiviare dati inviati tramite un modulo, autenticare i visualizzatori stesso, o chiamare un’API al momento della visualizzazione. |
| Single page | 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. |
| Source file types | Il file pubblicato deve essere .html, .htm o .md. I file Markdown si renderizzano come HTML stilizzato. |
| Rendered size | La pagina renderizzata deve essere 16 MiB o più piccola. Le immagini incorporate di grandi dimensioni sono la causa usuale quando una pubblicazione fallisce per dimensione. |
- Preferisci SVG, o HTML e CSS, per i diagrammi rispetto alle immagini raster incorporate
- Ometti l’interattività che non ti serve
- Fai in modo che la pagina riassuma 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.| Requirement | Available when |
|---|---|
| Plan | Team o Enterprise. Sui piani Team, gli artifact sono abilitati per impostazione predefinita. Sui piani Enterprise, un admin li abilita nelle impostazioni admin di claude.ai. |
| Authentication | Accesso a claude.ai con /login. Le sessioni che utilizzano una chiave API, gateway token o credenziale del provider cloud non possono pubblicare. |
| Model provider | Anthropic API. Non disponibile su Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry. |
| Organization policy | Le chiavi di crittografia gestite dal cliente (CMEK), HIPAA e Zero Data Retention non sono abilitate per l’organizzazione. |
| Surface | Claude Code CLI, o l’app desktop Claude versione 1.13576.0 o successiva. Disabilitato per impostazione predefinita in contesti Agent SDK, GitHub Action e MCP-server, e quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC è impostato. |
Disable artifacts
Per disattivare gli artifact per le tue sessioni indipendentemente dall’impostazione della tua organizzazione, usa uno qualsiasi di:| Method | Setting |
|---|---|
| Settings file | "disableArtifact": true |
| Environment variable | CLAUDE_CODE_DISABLE_ARTIFACT=1 |
| Permission rule | Aggiungi Artifact a permissions.deny |
Manage artifacts for your organization
Gli admin 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.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.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.
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:| Method | Endpoint |
|---|---|
GET | /v1/compliance/code/artifacts |
GET | /v1/compliance/code/artifacts/{artifact_id}/versions/{version_id} |
DELETE | /v1/compliance/code/artifacts/{artifact_id} |
Related resources
- 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 live in un artifact