Артефакты находятся в бета-версии. Они требуют план Team или Enterprise и сеанс, вошедший с помощью
/login. Полный набор требований см. в разделе Доступность.
- Решить, когда использовать артефакт
- Создать, обновить и поделиться артефактом
- Применить шаблоны подсказок для более богатых страниц
- Применить вашу собственную систему дизайна, чтобы артефакты соответствовали брендингу вашего продукта
- Понять ограничения страницы и требования доступности
- Отключить или управлять артефактами для вашей организации
When to use an artifact
Используйте артефакт, когда текст терминала — неправильный способ для того, что создал Claude: вывод, который легче смотреть и с которым взаимодействовать, чем читать строка за строкой. Claude создаёт страницу из всего, что может достичь ваш сеанс, включая вашу кодовую базу и данные, которые он получает через ваши подключённые инструменты, поэтому страница может показывать вещи, которые потребовали бы абзацев для описания. Например, попросите Claude:- Провести рецензента через pull request с аннотированными diff’ами
- Отобразить панель управления из данных, которые сеанс уже получил
- Расположить несколько вариантов дизайна или реализации рядом
- Вести временную шкалу расследования, которая заполняется во время выполнения длительной задачи
- Отправить коллеге ссылку вместо вставки вывода в Slack
What an artifact is not
Артефакт — это снимок работы, а не приложение. Это одна самодостаточная страница без бэкенда, поэтому она не может сохранять ввод формы, вызывать API во время просмотра или обслуживать несколько маршрутов. Для размещённого внутреннего инструмента с бэкендом разверните его на вашей собственной инфраструктуре. Полный набор ограничений см. в разделе Ограничения страницы.Create an artifact
Claude может опубликовать артефакт самостоятельно, когда вывод подходит для страницы, или вы можете попросить его напрямую. Чтобы попросить, назовите функцию или опишите визуальный вывод, который вы хотите, простым языком. Хорошим кандидатом является всё, что легче увидеть, чем прочитать как текст, например аннотированный diff, диаграмма или набор вариантов для сравнения. Приведённые ниже подсказки — два примера; см. Что вы можете создать для дополнительных шаблонов.Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai. Повторная публикация артефакта, который вы уже одобрили, не вызывает запрос снова.
Выберите Yes для публикации. Claude выводит URL, и ваш браузер открывает новую страницу. Нажмите Ctrl+] в любой момент, чтобы повторно открыть самый последний артефакт из терминала.
Claude выбирает название артефакта и эмодзи для значка вкладки браузера. Оба появляются в вашей галерее артефактов на claude.ai и в общих ссылках, поэтому попросите Claude использовать конкретное название или значок, если вы хотите.
Чтобы остановить автоматическое открытие браузера при публикации нового артефакта, установите CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 в вашей среде.
Если Claude ответит, что не может опубликовать, или напишет локальный файл HTML без ссылки, инструмент не включён для вашего сеанса. Проверьте требования Доступности.
Update an artifact
Попросите Claude пересмотреть страницу или позвольте длительной задаче повторно опубликовать по мере прогресса. Claude редактирует базовый файл и публикует снова на тот же URL.Share an artifact
Новый артефакт видим только вам. Откройте его в браузере и используйте элемент управления Share в заголовке страницы, чтобы предоставить доступ определённым людям в вашей организации или всем в ней. Заголовок называет вас автором артефакта, поэтому любой, с кем вы поделитесь, может увидеть, кто опубликовал страницу. Он также ссылается на вашу галерею на claude.ai/code/artifacts, которая перечисляет каждый артефакт, который вы создали. Совместное использование останавливается на вашей организации. Зрители должны войти на claude.ai как члены той же организации, которая опубликовала артефакт, и нет возможности сделать артефакт видимым вне её. Чтобы отправить базовое содержимое кому-то вне вашей организации, попросите Claude файл HTML и поделитесь этим файлом напрямую. Артефакты доступны для просмотра, а не для совместного редактирования. Люди, с которыми вы поделитесь, видят каждую версию, которую вы публикуете, но не могут изменять страницу; вы остаётесь единственным автором.What you can build
Артефакт — это одна страница HTML, поэтому всё, что вы можете выразить в HTML, CSS и встроенном JavaScript, находится в области действия. Приведённые ниже шаблоны встречаются чаще всего.Walk through a change
Попросите страницу, которая отображает diff или изменение дизайна с аннотациями рядом с соответствующими строками, чтобы рецензенты могли прочитать ваше обоснование рядом с кодом вместо того, чтобы восстанавливать его из описания.Compare alternatives
Попросите несколько вариантов на одной странице, чтобы вы могли оценить их друг против друга. Это работает для макетов, копии, форм API или планов реализации.Tune with interactive controls
Попросите ползунки, переключатели или поля ввода, привязанные к тому, что вы настраиваете, чтобы вы могли исследовать значения напрямую вместо их описания.Bring the result back to your session
Артефакт может действовать как лёгкий редактор для решения, которое вы затем передаёте Claude. Попросите элемент управления экспортом, который производит текст, который вы можете вставить в терминал, чтобы результат взаимодействия со страницей вернулся в сеанс вместо того, чтобы остаться на странице.Track work in progress
Попросите Claude держать артефакт в актуальном состоянии во время выполнения длительной задачи, чтобы любой, у кого есть ссылка, мог следить без чтения терминала.Improve the visual design
Claude применяет встроенный навык дизайна при создании артефакта, поэтому страницы получают намеренную палитру, типографику и макет без дополнительных подсказок. Этот навык также ищет существующую систему дизайна в вашем проекте перед выбором своей собственной. Чтобы сохранить артефакты согласованными с брендингом вашего продукта, запишите ваши токены дизайна там, где Claude может их найти, например в CLAUDE.md проекта или в файле темы в вашем репозитории:Page constraints
Каждый артефакт — это одна самодостаточная страница. Claude Code оборачивает файл, который вы публикуете, в оболочку HTML-документа и обслуживает его в соответствии со строгой политикой безопасности контента (CSP), которая формирует то, что может делать страница.| Constraint | Effect |
|---|---|
| No external requests | CSP блокирует скрипты, таблицы стилей, шрифты и изображения, загруженные с любого другого хоста, а также вызовы fetch, XHR и WebSocket. Claude встраивает CSS и JavaScript и встраивает изображения как data URI, чтобы страница отображалась без каких-либо внешних запросов. |
| No backend | Артефакт — это статическая страница. Она не может сохранять данные, отправленные через форму, аутентифицировать зрителей самостоятельно или вызывать API во время просмотра. |
| Single page | Относительные ссылки не разрешаются, потому что ничего не развёрнуто рядом со страницей. Для многосекционного содержимого Claude использует якоря на странице вместо отдельных файлов. |
| Source file types | Опубликованный файл должен быть .html, .htm или .md. Файлы Markdown отображаются как стилизованный HTML. |
| Rendered size | Отображаемая страница должна быть размером 16 МиБ или меньше. Большие встроенные изображения — обычная причина, когда публикация не удаётся из-за размера. |
- Предпочитайте SVG или HTML и CSS для диаграмм вместо встроенных растровых изображений
- Опустите интерактивность, которая вам не нужна
- Пусть страница суммирует большие наборы данных вместо встраивания их полностью
Availability
Артефакты требуют каждого условия ниже. Когда одно из них не выполнено, Claude записывает локальный файл HTML или говорит, что не может опубликовать.| Requirement | Available when |
|---|---|
| Plan | Team или Enterprise. На планах Team артефакты включены по умолчанию. На планах Enterprise администратор включает их в параметрах администратора claude.ai. |
| Authentication | Вошли на claude.ai с помощью /login. Сеансы, использующие ключ API, токен шлюза или учётные данные поставщика облачных услуг, не могут публиковать. |
| Model provider | Anthropic API. Недоступно на Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. |
| Organization policy | Ключи шифрования, управляемые клиентом (CMEK), HIPAA и Zero Data Retention не включены для организации. |
| Surface | Claude Code CLI или приложение Claude для рабочего стола версии 1.13576.0 или позже. По умолчанию отключено в контекстах Agent SDK, GitHub Action и MCP-server, а также когда установлен CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. |
Отключение артефактов
Чтобы отключить артефакты для своих сеансов независимо от параметра вашей организации, используйте любой из следующих способов:| Метод | Параметр |
|---|---|
| Файл параметров | "disableArtifact": true |
| Переменная окружения | CLAUDE_CODE_DISABLE_ARTIFACT=1 |
| Правило разрешений | Добавьте Artifact в permissions.deny |
Управление артефактами для вашей организации
Администраторы планов Team и Enterprise управляют артефактами из параметров администратора claude.ai. Содержимое артефактов хранится на инфраструктуре, управляемой Anthropic, и видно только аутентифицированным членам организации-издателя.Включение или отключение артефактов
Чтобы включить или отключить артефакты для всей организации, перейдите в Параметры > Claude Code > Возможности и используйте переключатель Артефакты. На планах Enterprise с управлением доступом на основе ролей вы можете дополнительно ограничить артефакты определёнными ролями: перейдите в Параметры > Роли, отредактируйте роль и установите разрешение Артефакты в группе Claude Code.Установка политики хранения
Чтобы установить, как долго артефакты хранятся перед автоматическим удалением, перейдите в Параметры > Элементы управления данными и конфиденциальностью. Вы можете установить отдельные периоды хранения для артефактов, которые остаются приватными для их автора, и артефактов, которые были общими.Проверка журнала аудита
Публикация, совместное использование и удаление артефакта каждый раз отображаются в журнале аудита вашей организации под типами событийclaude_artifact_*, семейством, используемым для артефактов, созданных в беседах claude.ai.
Добавление домена средства просмотра в список разрешений
Средство просмотра на claude.ai загружает каждый артефакт из изолированного источника*.claudeusercontent.com. Если ваша организация ограничивает исходящий сетевой доступ, добавьте этот домен в список разрешений вместе с claude.ai. Полный список см. в разделе Требования к сетевому доступу.
Список и удаление артефактов с помощью API соответствия
API соответствия предоставляет конечные точки для списка артефактов организации, получения содержимого определённой версии и удаления артефакта:| Метод | Конечная точка |
|---|---|
GET | /v1/compliance/code/artifacts |
GET | /v1/compliance/code/artifacts/{artifact_id}/versions/{version_id} |
DELETE | /v1/compliance/code/artifacts/{artifact_id} |
Related resources
- Просмотрите шаблоны подсказок и рабочие процессы, которые сочетаются с артефактами
- Превратите подсказку артефакта, которую вы повторно используете, в skill, чтобы вы могли вызвать её как команду
- Подключите серверы MCP, чтобы Claude мог получить живые данные в артефакт