Los artefactos están disponibles en los planes Pro, Max, Team y Enterprise y requieren una sesión iniciada con
/login. Consulte Disponibilidad para ver el conjunto completo de requisitos.
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
- Publique un tablero de estado que extrae datos frescos a través de conectores MCP cada vez que alguien lo abre
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 o servir múltiples rutas, y su única ruta a datos externos cuando alguien lo visualiza es llamar a conectores MCP. 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. Para compartirlo, abra el artefacto en su navegador y use el control Compartir en el encabezado de la página. El encabezado lo identifica como el autor del artefacto, por lo que cualquier persona con la que lo comparta puede ver quién publicó la página. También vincula a su galería en claude.ai/code/artifacts, que enumera todos los artefactos que ha creado. Con quién puede compartir depende de su plan:- Dentro de su organización: en los planes Team y Enterprise, otorgue acceso a personas específicas en su organización, o a todos en ella. Los espectadores inician sesión en claude.ai como miembros de su organización para ver la página.
- Públicamente: comparta un enlace que cualquier persona en Internet pueda abrir, sin necesidad de iniciar sesión en claude.ai. En los planes Pro y Max, un enlace público es la única forma de compartir un artefacto. En los planes Team y Enterprise, el uso compartido público está desactivado hasta que un Propietario lo habilite para la organización.
Permitir que alguien edite con usted
Las personas con las que comparte son espectadores de forma predeterminada: ven cada versión que publica pero no pueden cambiar la página. En los planes Team y Enterprise, también puede convertir a alguien en editor. En el diálogo de uso compartido, agregue una persona y cambie su rol de espectador a editor. Un editor publica nuevas versiones de la misma manera que usted actualiza el artefacto desde otra sesión: le proporciona a Claude la URL del artefacto en su propia sesión, y Claude extrae el contenido actual y lo republica con sus cambios. Todos los que tengan la página abierta ven cada actualización en vivo.Extraer datos en vivo con conectores MCP
Un artefacto puede llamar a conectores MCP cada vez que alguien lo visualiza, de modo que la página muestre datos actuales en lugar de una instantánea de la sesión que la construyó. Las llamadas de conectores desde artefactos están disponibles en los planes Pro, Max, Team y Enterprise y requieren Claude Code v2.1.209 o posterior. En versiones anteriores, Claude publica la página con los datos que la sesión recopiló mientras la construía. Para crear una página respaldada por un conector, nombre el conector y los datos que desea en su indicación:.mcp.json, pueden proporcionar datos mientras Claude construye la página, pero la página publicada no puede llamarlos.
La página obtiene datos cuando se carga y puede actualizarse en un intervalo o cuando un visualizador utiliza un control de actualización en la página. Las respuestas se almacenan en caché en el navegador del visualizador, por lo que una página reabierta se renderiza desde las respuestas en caché inmediatamente, luego se actualiza con resultados frescos.
Cómo funcionan las llamadas de conectores para los visualizadores
Cuando una página publicada llama a un conector, la llamada utiliza la cuenta de la persona que visualiza la página, no la cuenta de la persona que la publicó:- Cada visualizador utiliza sus propios conectores: las llamadas se ejecutan a través de las herramientas conectadas de la cuenta que visualiza, por lo que dos personas que abran el mismo panel pueden ver datos diferentes según lo que sus cuentas puedan acceder. La página nunca ve las credenciales de nadie; claude.ai realiza las llamadas en nombre de la página.
- Los visualizadores aprueban el acceso primero: claude.ai solicita permiso a cada visualizador antes de la primera llamada de conector de la página. Un visualizador que rechace, o que no haya conectado un conector que la página utiliza, aún ve la página sin sus secciones en vivo.
- Las acciones también utilizan la cuenta del visualizador: una página puede ofrecer controles que invoquen herramientas de conectores con efectos secundarios, como publicar un mensaje o actualizar un problema. La acción se ejecuta a través de la cuenta de quien selecciona el control.
La página no muestra datos en vivo para un visualizador
Cuando una página respaldada por un conector se renderiza pero sus secciones en vivo permanecen vacías para alguien con quien la compartió, trabaje a través de estas causas:- El visualizador no ha conectado el conector: los conectores son por cuenta, por lo que cada visualizador necesita su propia conexión a cada conector que la página llama. Pueden agregar uno en Configuración > Conectores en claude.ai, luego recargar la página.
- El visualizador rechazó la solicitud de permiso: un rechazo dura el resto de esa carga de página. Recargar la página trae de vuelta la solicitud de permiso.
- Las llamadas de conectores están desactivadas para la organización: un Propietario controla el alternar Habilitar conectores de artefactos en la configuración de administración.
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
A partir de Claude Code v2.1.183, 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.
Generar un artefacto usa tokens de salida como cualquier otra respuesta, y una página con estilo es más intensiva en tokens que el mismo contenido como texto de terminal. CSS en línea, JavaScript para controles interactivos e imágenes incrustadas como URIs de datos son los principales contribuyentes. Para reducir el costo de tokens de un artefacto:
- 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.Deshabilitar artefactos
Para desactivar los artefactos en sus propias sesiones independientemente de la configuración de su organización, use cualquiera de: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, a menos que el artefacto sea compartido públicamente.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.Controlar llamadas de conectores desde artefactos
Las llamadas de conectores desde artefactos tienen su propio botón de alternancia, separado del botón de alternancia Artefactos que activa o desactiva los artefactos. Vaya a Configuración > Capacidades y use el botón de alternancia Habilitar conectores de artefactos. El mismo botón de alternancia rige las llamadas de conectores desde artefactos creados en conversaciones de claude.ai, por lo que se encuentra bajo Configuración > Capacidades en lugar de Configuración > Claude Code.Controlar el compartir público
El compartir público está desactivado de forma predeterminada en planes de Team y Enterprise, por lo que los miembros pueden compartir artefactos solo dentro de la organización hasta que un administrador lo active. Para permitir que los miembros publiquen artefactos en enlaces públicos que cualquiera pueda ver sin iniciar sesión, vaya a Configuración > Claude Code > Capacidades y active Compartir externo bajo el botón de alternancia Artefactos. Desactivarlo bloquea el acceso a través de enlaces públicos existentes sin cambiar la audiencia de cada artefacto; el acceso se reanuda si lo vuelve a habilitar.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:
Para los esquemas de solicitud y respuesta, consulte la referencia de la API de Cumplimiento.
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 un artefacto mientras lo construye