Мастер Claude · Блок 8. Артефакты

Урок 66 из 93 · ~12 мин чтения

Артефакты — когда терминал плохой формат

Урок пока закрыт

Курс проходится последовательно.

К текущему уроку

Почему это важно именно вам

Знакомая сцена: Claude полчаса разбирал выгрузку, нашёл семь проблем, посчитал цифры — и всё это лежит простынёй текста в терминале. Вам нужно показать это коллеге. Вы копируете в мессенджер, форматирование рассыпается, таблица превращается в кашу, и вы тратите ещё двадцать минут, перекладывая результат в презентацию.

Проблема не в качестве работы. Проблема в том, что терминал — плохой формат для того, на что нужно смотреть, а не читать построчно.

Артефакты решают ровно это. Claude публикует результат как страницу в браузере, даёт ссылку — и вы отправляете ссылку вместо простыни. Страница обновляется сама, пока сессия продолжает работать.

Что это такое

Артефакт — это живая веб-страница, которую Claude Code публикует из вашей сессии по приватному адресу на claude.ai. Открывается в браузере, обновляется на месте по мере работы, делится по ссылке — если вы этого захотите.

Ключевые свойства, которые определяют, как этим пользоваться:

Приватность по умолчанию. Новый артефакт видите только вы. Делиться — отдельное осознанное действие через кнопку Share на самой странице.

Живость. Пока сессия работает, страница обновляется. Долгий аудит может публиковать промежуточные результаты: вы открыли ссылку и наблюдаете, как заполняется таблица находок.

Где это работает. Артефакты доступны на тарифах Pro, Max, Team и Enterprise, и сессия должна быть залогинена в claude.ai (/login). Сессия, работающая по API-ключу, через шлюз или на стороннем провайдере (Bedrock, Google Cloud, Microsoft Foundry), публиковать не может: Claude просто запишет локальный HTML-файл без ссылки. На Enterprise возможность дополнительно включает владелец организации.

Одна страница без сервера. Артефакт — это снимок работы, а не приложение. Внутри нет базы данных, нет форм, которые что-то сохраняют, нет нескольких разделов с отдельными адресами. Всё, что должно быть на странице, — на одной странице.

Как отличить задачу для артефакта

Спросите себя: «Это надо прочитать или на это надо посмотреть?» Список из пяти пунктов — читать, терминал справится. Сравнение четырёх вариантов, динамика по месяцам, разбор с выделенными местами, таблица на сорок строк, дашборд — смотреть. Второе — задача для артефакта.

Как работает на практике

Попросить артефакт

Прямо словами, в обычном запросе:

Сделай артефакт: дашборд по расхождениям в выгрузке за август — по проектам,
с суммами и долей от общего, и выдели три худших.

Claude соберёт HTML-страницу, опубликует её и напечатает ссылку. При первой публикации браузер откроется сам — повторные публикации того же артефакта вкладку уже не открывают. Автооткрытие отключается переменной CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0.

Иногда Claude публикует артефакт по своей инициативе — когда результат явно просится на страницу.

Дать разрешение

Публикация проходит через ваш режим разрешений — и это важно. По умолчанию на Pro, Max и Team сессия стартует в авторежиме, где публикацию проверяет классификатор: страница может уехать на серверы Anthropic без вопроса вам. В ручном режиме и в режиме приёма правок Claude спросит, и в вопросе будет прямо сказано: файл загружается на серверы Anthropic и размещается как страница, приватная для вас, пока вы её не расшарили. После первого разрешения повторные публикации того же артефакта проходят без вопросов — но Claude спросит снова, если, например, страница начнёт обращаться к живым данным или если вы уже поделились ею публично.

Обновить

Просто попросите изменить:

Добавь под сводкой разбивку по регионам и опубликуй заново.

Claude правит исходный файл и публикует по тому же адресу. Каждая публикация становится версией — в панели Share можно выбрать, какую версию видят зрители.

Найти артефакт потом

/artifacts

Список всех ваших артефактов и тех, которыми поделились с вами. o — открыть в браузере, c — скопировать ссылку, Enter — прикрепить к текущей сессии, чтобы обновлять именно его.

Быстрая клавиша: Ctrl+] открывает последний артефакт этой сессии.

Из новой сессии — только по ссылке

Если вы начали новую сессию и просите «обнови тот дашборд», Claude создаст новый артефакт, а не обновит старый. Чтобы обновить существующий, дайте его URL или прикрепите через /artifacts.

Что имеет смысл делать артефактом

Из практики — пять устойчивых сценариев:

  1. Разбор изменений. «Проведи меня по этим правкам: что изменилось, зачем, где риск».
  2. Сравнение вариантов. Три подхода к задаче рядом, с плюсами, минусами и ценой.
  3. Дашборд из данных, которые сессия уже собрала. Не нужно строить BI — нужно посмотреть один раз.
  4. Хроника длинной работы. Аудит идёт час, страница заполняется по ходу.
  5. Отчёт для человека, у которого нет терминала. Ссылка вместо вложения.

Частые ошибки

Пытаться сделать из артефакта приложение. Нет бэкенда — значит, форма ничего не сохранит, а «личный кабинет» не построится. Для внутреннего инструмента с данными нужен обычный сервер.

Забывать про приватность в обе стороны. Артефакт приватен по умолчанию — коллега по ссылке ничего не увидит, пока вы не поделились явно. И наоборот: поделившись, вы отдаёте содержимое страницы всем, у кого есть ссылка (в зависимости от выбранного режима доступа). Перед шерингом посмотрите, что на странице: не уехали ли туда телефоны клиентов или внутренние цифры.

Публиковать гигантские данные. Рендер страницы ограничен 16 МиБ, и генерация страницы тратит выходные токены. Тяжёлые таблицы лучше сворачивать в сводку, а картинки — рисовать как SVG, а не вставлять растр.

Ждать, что артефакт заменит отчётность. Это снимок работы. Регулярный отчёт по расписанию — это скорее задача для routines из блока 10, где страница будет пересобираться сама.

Когда нужно / когда нет

Стоит делать артефакт:

Не стоит:

Связь с другими уроками

День 67 — практика: соберём отчёт, который живёт по ссылке.

День 68 — живые данные: страница, которая при открытии подтягивает актуальные цифры через коннекторы.

День 6 — форматы вывода. Раньше выбор был между текстом и JSON. Теперь появился третий формат — страница.

Задание на сегодня

  1. Возьмите последнюю задачу, результат которой вы копировали кому-то в мессенджер. Повторите её и попросите артефакт.
  2. Откройте ссылку, посмотрите на страницу. Попросите одно изменение («добавь колонку», «выдели красным») и убедитесь, что страница обновилась по тому же адресу.
  3. Выполните /artifacts и найдите артефакт в списке. Скопируйте ссылку клавишей c.
  4. Начните новую сессию и обновите тот же артефакт, передав его URL. Убедитесь, что новый не создался.
  5. Решите, что из вашей регулярной работы просится в этот формат.

Критерий «выполнено»: у вас есть ссылка на страницу с реальным рабочим результатом, которую вы обновили минимум дважды, в том числе из другой сессии.

Резюме

Следующий урок откроется после отметки.