Los artefactos están en versión beta. Requieren un plan de Team o Enterprise y una sesión iniciada con
/login. Consulte Disponibilidad para ver el conjunto completo de requisitos.
- Decidir cuándo usar un artefacto
- Crear, actualizar y compartir un artefacto
- Aplicar patrones de indicaciones para páginas más ricas
- Aplicar su propio sistema de diseño para que los artefactos coincidan con la marca de su producto
- Comprender las restricciones de página y requisitos de disponibilidad
- Deshabilitar o gestionar artefactos para su organización
Cuándo usar un artefacto
Use un artefacto cuando el texto de terminal sea el medio incorrecto para lo que Claude produjo: salida que es más fácil de ver e interactuar que de leer línea por línea. Claude construye la página a partir de cualquier cosa a la que su sesión pueda acceder, incluida su base de código y los datos que extrae a través de sus herramientas conectadas, por lo que la página puede mostrar cosas que tomaría párrafos describir. Por ejemplo, pida a Claude que:- Guíe a un revisor a través de una solicitud de extracción con diffs anotados
- Represente un panel de control a partir de datos que la sesión ya extrajo
- Distribuya varias opciones de diseño o implementación una al lado de la otra
- Mantenga una línea de tiempo de investigación que se complete mientras se ejecuta una tarea larga
- Envíe a un compañero de equipo un enlace en lugar de pegar la salida en Slack
Qué no es un artefacto
Un artefacto es una captura del trabajo, no una aplicación. Es una página única y autónoma sin backend, por lo que no puede almacenar entrada de formulario, llamar a una API en el momento de la visualización o servir múltiples rutas. Para una herramienta interna alojada con un backend, impleméntela en su propia infraestructura. Consulte Restricciones de página para ver el conjunto completo de límites.Crear un artefacto
Claude puede publicar un artefacto por su cuenta cuando la salida se adapta a una página, o puede solicitar uno directamente. Para solicitar uno, nombre la característica o describa la salida visual que desea en lenguaje natural. Un buen candidato es cualquier cosa más fácil de ver que de leer como texto, como un diff anotado, un gráfico o un conjunto de opciones para comparar. Los indicadores a continuación son dos ejemplos; consulte Qué puede construir para más patrones.Claude quiere publicar "Fallos de implementación por servicio" (deploy-failures.html) en una página privada en claude.ai. Volver a publicar un artefacto que ya ha aprobado no solicita permiso nuevamente.
Seleccione Sí para publicar. Claude imprime la URL y su navegador se abre a la nueva página. Presione Ctrl+] en cualquier momento para volver a abrir el artefacto más reciente desde la terminal.
Claude elige el título del artefacto y un emoji para su icono de pestaña del navegador. Ambos aparecen en su galería de artefactos en claude.ai y en enlaces compartidos, así que pida a Claude que use un título o icono específico si desea uno.
Para evitar que el navegador se abra automáticamente cuando se publica un nuevo artefacto, establezca CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 en su entorno.
Si Claude responde que no puede publicar, o escribe un archivo HTML local sin un enlace, la herramienta no está habilitada para su sesión. Verifique los requisitos de Disponibilidad.
Actualizar un artefacto
Pida a Claude que revise la página, o deje que una tarea de larga duración se vuelva a publicar mientras hace progreso. Claude edita el archivo subyacente y publica nuevamente en la misma URL.Compartir un artefacto
Un nuevo artefacto es visible solo para usted. Ábralo en su navegador y use el control Compartir en el encabezado de la página para otorgar acceso a personas específicas en su organización, o a todos en ella. El encabezado lo nombra como el autor del artefacto, por lo que cualquiera con quien lo comparta puede ver quién publicó la página. También se vincula a su galería en claude.ai/code/artifacts, que enumera todos los artefactos que ha creado. El intercambio se detiene en su organización. Los espectadores deben iniciar sesión en claude.ai como miembro de la misma organización que publicó el artefacto, y no hay opción para hacer que un artefacto sea visible fuera de ella. Para enviar el contenido subyacente a alguien fuera de su organización, pida a Claude el archivo HTML y comparta ese archivo directamente. Los artefactos son visibles, no coeditados. Las personas con las que comparte ven cada versión que publica pero no pueden cambiar la página; usted sigue siendo el único escritor.Qué puede construir
Un artefacto es una única página HTML, por lo que cualquier cosa que pueda expresar en HTML, CSS y JavaScript en línea está dentro del alcance. Los patrones a continuación son los más comunes.Recorrer un cambio
Solicite una página que represente un diff o un cambio de diseño con anotaciones al lado de las líneas relevantes, para que los revisores puedan leer su razonamiento junto al código en lugar de reconstruirlo a partir de una descripción.Comparar alternativas
Solicite varias variantes en una página para que pueda evaluarlas entre sí. Esto funciona para diseños, copias, formas de API o planes de implementación.Ajustar con controles interactivos
Solicite controles deslizantes, alternancias o campos de entrada vinculados a lo que está ajustando, para que pueda explorar valores directamente en lugar de describirlos.Traer el resultado de vuelta a su sesión
Un artefacto puede actuar como un editor ligero para una decisión que luego devuelve a Claude. Solicite un control de exportación que produzca texto que pueda pegar en la terminal, para que el resultado de interactuar con la página fluya de vuelta a la sesión en lugar de permanecer en la página.Rastrear el trabajo en progreso
Pida a Claude que mantenga un artefacto actualizado mientras se ejecuta una tarea larga, para que cualquiera con el enlace pueda seguir sin leer la terminal.Mejorar el diseño visual
Claude aplica una skill de diseño integrada cuando construye un artefacto, por lo que las páginas obtienen una paleta deliberada, tipografía y diseño sin indicaciones adicionales. Esa skill también busca un sistema de diseño existente en su proyecto antes de elegir el suyo. Para mantener los artefactos consistentes con la marca de su producto, registre sus tokens de diseño donde Claude pueda encontrarlos, como el CLAUDE.md del proyecto o un archivo de tema en su repositorio:Restricciones de página
Cada artefacto es una página única y autónoma. Claude Code envuelve el archivo que publica en un shell de documento HTML y lo sirve bajo una Política de Seguridad de Contenido (CSP) estricta, que da forma a lo que la página puede hacer.| Restricción | Efecto |
|---|---|
| Sin solicitudes externas | El CSP bloquea scripts, hojas de estilo, fuentes e imágenes cargadas desde cualquier otro host, junto con llamadas fetch, XHR y WebSocket. Claude inserta CSS y JavaScript e incrusta imágenes como URIs de datos para que la página se represente sin ninguna solicitud externa. |
| Sin backend | Un artefacto es una página estática. No puede almacenar datos enviados a través de un formulario, autenticar espectadores por sí mismo o llamar a una API en el momento de la visualización. |
| Página única | Los enlaces relativos no se resuelven, porque nada se implementa junto a la página. Para contenido de múltiples secciones, Claude usa anclajes en la página en lugar de archivos separados. |
| Tipos de archivo de origen | El archivo publicado debe ser .html, .htm o .md. Los archivos Markdown se representan como HTML con estilo. |
| Tamaño representado | La página representada debe ser de 16 MiB o menor. Las imágenes incrustadas grandes son la causa habitual cuando una publicación falla por tamaño. |
- Prefiera SVG, o HTML y CSS, para diagramas sobre imágenes rasterizadas incrustadas
- Omita la interactividad que no necesita
- Haga que la página resuma grandes conjuntos de datos en lugar de incrustarlos en su totalidad
Disponibilidad
Los artefactos requieren todas las condiciones a continuación. Cuando una no se cumple, Claude escribe un archivo HTML local o dice que no puede publicar.| Requisito | Disponible cuando |
|---|---|
| Plan | Team o Enterprise. En planes de Team, los artefactos están habilitados de forma predeterminada. En planes de Enterprise, un administrador los habilita en la configuración de administrador de claude.ai. |
| Autenticación | Iniciado sesión en claude.ai con /login. Las sesiones que usan una clave API, token de puerta de enlace o credencial de proveedor de nube no pueden publicar. |
| Proveedor de modelo | API de Anthropic. No disponible en Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry. |
| Política de organización | Las claves de cifrado administradas por el cliente (CMEK), HIPAA y Retención de datos cero no están habilitadas para la organización. |
| Superficie | CLI de Claude Code, o la aplicación de escritorio Claude versión 1.13576.0 o posterior. Deshabilitado de forma predeterminada en contextos de Agent SDK, GitHub Action y MCP-server, y cuando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está establecido. |
Deshabilitar artefactos
Para desactivar los artefactos en sus propias sesiones independientemente de la configuración de su organización, use cualquiera de:| Método | Configuración |
|---|---|
| Archivo de configuración | "disableArtifact": true |
| Variable de entorno | CLAUDE_CODE_DISABLE_ARTIFACT=1 |
| Regla de permiso | Agregue Artifact a permissions.deny |
Gestionar artefactos para su organización
Los administradores en planes de Team y Enterprise controlan los artefactos desde la configuración de administrador de claude.ai. El contenido del artefacto se almacena en la infraestructura operada por Anthropic y es visible solo para miembros autenticados de la organización publicadora.Habilitar o deshabilitar artefactos
Para habilitar o deshabilitar artefactos para toda la organización, vaya a Configuración > Claude Code > Capacidades y use el botón de alternancia Artefactos. En planes de Enterprise con control de acceso basado en roles, también puede limitar los artefactos a roles específicos: vaya a Configuración > Roles, edite un rol y establezca el permiso Artefactos bajo el grupo Claude Code.Establecer una política de retención
Para establecer cuánto tiempo se conservan los artefactos antes de la eliminación automática, vaya a Configuración > Controles de datos y privacidad. Puede establecer períodos de retención separados para artefactos que aún son privados para su autor y artefactos que han sido compartidos.Revisar el registro de auditoría
Publicar, compartir y eliminar un artefacto aparecen en el registro de auditoría de su organización bajo los tipos de eventoclaude_artifact_*, la misma familia utilizada para artefactos creados en conversaciones de claude.ai.
Permitir el dominio del visor
El visor en claude.ai carga cada artefacto desde un origen*.claudeusercontent.com aislado. Si su organización restringe el acceso a la red saliente, agregue ese dominio a su lista de permitidos junto con claude.ai. Consulte Requisitos de acceso a la red para la lista completa.
Enumerar y eliminar artefactos con la API de Cumplimiento
La API de Cumplimiento proporciona puntos finales para enumerar los artefactos de una organización, recuperar el contenido de una versión específica y eliminar un artefacto:| Método | Punto final |
|---|---|
GET | /v1/compliance/code/artifacts |
GET | /v1/compliance/code/artifacts/{artifact_id}/versions/{version_id} |
DELETE | /v1/compliance/code/artifacts/{artifact_id} |
Recursos relacionados
- Explore patrones de indicaciones y flujos de trabajo que se emparejan con artefactos
- Convierta un indicador de artefacto que reutiliza en una skill para que pueda invocarlo como un comando
- Conecte servidores MCP para que Claude pueda extraer datos en vivo en un artefacto