Перейти к содержимому
TelegramGitHub

Claude AI Bible, глава 8: Artifacts и длинные тексты

Главная мысль: artifact — это отдельное окно рядом с чатом, где лежит сам результат: документ, код, страница или график. Вы правите его на месте и не собираете ответы из чата вручную. Чтобы это работало, нужно уметь вызывать artifact, точно описывать правки и знать пределы песочницы.

Глава отвечает на вопрос, как превратить чат с Claude в работу над одним готовым объектом. Она продолжает главу 7 о Projects: там Claude получил постоянный контекст, а здесь появляется место для сборки результата. Темы: виды artifact, правки на месте, цикл «собрать, проверить, исправить» для кода, длинные тексты по шагам, ограничения и экспорт.

Запрос попадает к Claude, он решает: ответ в чат или результат в отдельное окно. Ваше явное слово меняет решение. Artifact правят на месте и затем экспортируют

Короткий ответ остаётся в чате, а готовый результат уходит в окно, где его правят и откуда его забирают. Но если вы прямо скажете, где нужен ответ, Claude сделает так, как сказали вы.

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

Ценность artifact автор сводит к двум свойствам: он не пропадает и его можно дорабатывать. В обычном чате длинный ответ уходит вверх, и каждый новый ответ уносит его дальше. Artifact остаётся на месте, а правки из новых сообщений меняют тот же объект, а не создают копию.

Раньше работа с AI шла так: спросили, скопировали хорошие куски в свой документ, спросили ещё. С artifact результат и разговор о нём стоят рядом, и накапливается именно результат. Вы перестаёте носить текст из чата в документ и становитесь редактором одного объекта.

Есть и ещё одна причина: некоторые artifact можно запустить. Веб-страницу Claude показывает вживую: вы нажимаете настоящие кнопки, и на этом строится цикл «собрать, проверить, исправить».

Когда Claude делает artifact сам и как этим управлять

Заголовок раздела «Когда Claude делает artifact сам и как этим управлять»

Claude решает по запросу. Большой самостоятельный результат, который понадобится снова, становится artifact. Короткий ответ или объяснение остаются в чате. Обычно модель решает верно, но решение можно задать самим:

Сделай это в artifact, чтобы я мог править: краткое описание проекта
на одну страницу для заявки на грант общественного сада. Разделы:
проблема, план, бюджет, сроки.
Ответь просто в чате, без artifact: в двух фразах, годится ли
«Riverside Roots» как название для общественного сада?

Ответ можно перенести и потом: из artifact в чат или обратно. Решаете вы, а не модель.

Совет автора: если впереди много правок, просите artifact в первом же сообщении. Иначе при переносе из чата часть деталей потеряется.

Виды различаются возможностями и рисками, поэтому их стоит знать.

ВидЧто внутриЧто может пойти не так
ДокументОтчёт, письмо, планПочти ничего: текст не «ломается»
КодСкрипт, функция, конфигКод надо проверить в проекте
HTML и веб-компонентыЖивая страница, виджет, прототипЗапускается, поэтому может сломаться
ДиаграммаБлок-схема, схема системыНеверная структура
Визуализация данныхСтолбчатый или линейный графикНе те данные или тип графика

Тип почти никогда не нужно называть: «график этих продаж» даст визуализацию, а «блок-схема процесса» даст диаграмму. Но по виду вы заранее знаете, каких проблем ждать.

Именно правки на месте отличают artifact от простого окна с ответом. Вы описываете изменение, и Claude обновляет тот же объект. Главное здесь — точно сказать, что и где менять:

В описании проекта раздел «Бюджет» слишком размытый. Замени его
на четыре строки: материалы, инструменты, вывески и резерв 10%.
Все остальные разделы оставь без изменений.

Такая просьба называет цель и защищает остальное. Просьба «сделай лучше» даёт размытые правки и иногда портит удачные разделы. К тому же точечная правка быстрее полного переписывания.

Автор предупреждает о ловушке: просили одну правку, а заодно изменилась любимая фраза. Так бывает, когда просьба звучит широко, и модель улучшает всё подряд. Если правка должна быть узкой, так и скажите: «меняй только X, остальное оставь дословно». Если нужен новый проход по всему тексту, просите его явно.

Цикл «собрать, проверить, исправить» для кода

Заголовок раздела «Цикл «собрать, проверить, исправить» для кода»

Для кода artifact даёт рабочий цикл даже тем, кто не программирует. Если код можно показать (HTML-страница, компонент), вы видите, как он работает, и сразу описываете Claude, что сломалось. Круг быстрый, потому что artifact сразу перерисовывается.

Цикл: описать, собрать, проверить; при сбое точно описать его, Claude правит, проверка снова; если не выходит три раза, попросить объяснить причину

Автор показывает цикл на калькуляторе чаевых. Три запроса ниже пересказаны своими словами:

1. Собери калькулятор чаевых одной самостоятельной HTML-страницей.
Ввод: сумма счёта, процент чаевых с кнопками 15/18/20%, число
людей. Покажи чаевые, итог и сумму на человека, пересчёт на лету.
Должно удобно читаться на телефоне.
2. Две проблемы: сумма на человека показывает NaN, пока не введено
число людей, и не видно, какая кнопка процента выбрана. Пусть
при пустом поле будет $0.00, а выбранная кнопка получит заливку.
3. Работает. Ещё одно: округляй сумму на человека вверх до цента,
чтобы собранного всегда хватало на счёт, и добавь под ней
пометку об этом.

Во втором запросе сказано не «всё сломалось», а что именно сломалось и как должно быть. Поэтому правка попадает с первого раза.

Автор даёт ещё несколько привычек:

  • Проверяйте одно изменение за раз. Тогда при сбое ясно, какая правка его вызвала.
  • Несколько проблем нумеруйте.
  • Описывайте нужное поведение, а не код: Claude лучше вас переведёт «округляй вверх до цента» в арифметику.

Если вы трижды описали одну проблему, а правка не работает, смените тактику. Попросите Claude сначала объяснить причину бага или пройти по нужному куску кода. Обычно вы просите одно, а модель понимает другое, и рассуждение вслух это вскрывает.

Автор предлагает упражнение: соберите так маленький инструмент, которого вам не хватает, например конвертер или калькулятор.

Отчёт или большую статью тоже пишут в документе-artifact. Автор советует идти по шагам, а не просить весь текст разом: сначала структура, потом разделы, потом правки.

1. Сделай документ-artifact: план гайда на 2000 слов «Как маленькому
ресторану думать об отзывах в интернете». Только заголовки
разделов и строка о каждом. Писать будем, когда я одобрю план.
2. Хорошо. Напиши первый раздел примерно на 350 слов, простым языком,
для владельца, который не верит советам маркетологов. Остальной
план не трогай.
3. Раздел хороший, но начало вялое. Перепиши только первый абзац,
чтобы он начинался с конкретного числа. Остальное оставь.

Так вы сохраняете контроль и ловите ошибки, пока их дёшево исправить.

Длинный текст по шагам: каркас, раздел за разделом, правки на месте, проходы с одной задачей, экспорт. Один запрос на весь текст ведёт к проседанию середины

Есть и вторая причина. Когда модель пишет 2000 слов за раз, её внимание делится на весь текст, и середина может провиснуть. Раздел за разделом каждая часть получает полное внимание.

Правка тоже идёт проходами с одной задачей: сжать текст, выровнять голос, проверить, что у каждого утверждения есть опора. Так правят профессионалы. Новичок же читает текст один раз и пытается исправить всё сразу.

Artifact работает внутри границ, и о них лучше знать заранее.

  • Размер. Artifact может быть большим, но не бесконечным. Огромный документ или целую кодовую базу делите на несколько artifact.
  • Песочница. Живые страницы работают в изолированном окне (песочнице) и умеют не всё, что обычный сайт. Главное: им недоступны localStorage и sessionStorage. Данные можно держать только в памяти страницы, а она сбрасывается при перезагрузке.
  • Библиотеки. Популярные библиотеки для графиков и интерфейса есть, редкие не загрузятся. Спросите Claude, какие доступны.
  • Изоляция. Artifact не ходит во внешние сервисы и ваши системы. Вход в систему, свой API и живые данные — это работа для Claude Code, API и MCP (главы 13, 16 и 17).

Песочница живого artifact: память страницы и популярные библиотеки работают; localStorage, внешние сервисы и редкие библиотеки недоступны; для хранения данных и доступа к системам нужны Claude Code, API или MCP

Эти рамки — цена безопасности: та же песочница позволяет запустить в браузере сгенерированный код, не задев ничего лишнего. Поэтому целиться стоит в то, что artifact делает отлично: инструменты, прототипы, документы, графики.

Чаще всего на этом попадаются так: просят «трекер привычек, который помнит отметки», закрывают окно, а данных нет. Инструмент не сломан, просто песочница их не хранит. Если данные должны сохраняться после закрытия окна, нужно настоящее приложение.

Документ и код можно скопировать или скачать: код в редактор, HTML-страницу на сервер. Дорабатывайте в artifact, где правки быстрые, а готовое выгружайте, потому что жить код будет в вашем проекте.

Перед рискованной правкой сохраните удачную версию. Если переделка уйдёт не туда, вы вернётесь к копии, а не будете просить Claude «отменить».

Project даёт постоянный контекст: голос, правила, справочные файлы. Artifact даёт место для сборки результата, поэтому документ в проекте, где лежат голос и правила клиента, сразу пишется в стиле этого клиента:

Сделай документ-artifact: анонс на 500 слов о новом утреннем
занятии по вторникам в нашей студии. Используй наш голос и правила.

Запрос короткий, но результат выходит в нужном стиле: голос и правила, например «никаких восклицательных знаков», пришли из проекта, а не из этого запроса.

В примере автора составительница грантовых заявок из НКО в Глазго вдвое сократила время на черновики. В её проекте лежат миссия, три выигравшие заявки и инструкция о стиле. Раньше она перегенерировала черновик целиком и теряла хорошие фразы, а теперь правит раздел за разделом.

  • Artifact — это большой результат в отдельном окне, который не пропадает и правится на месте.
  • Вы сами решаете, нужен ли artifact: просите его явно или просите ответить в чате.
  • Точная правка называет цель и говорит, что оставить без изменений.
  • Цикл «собрать, проверить, исправить» работает, когда сбой описан точно: что сломалось и как должно быть.
  • Длинный текст лучше строить по шагам: план, раздел за разделом, проходы с одной задачей.
  • Песочница не даёт localStorage, внешних вызовов и редких библиотек, зато делает запуск чужого кода безопасным.
  • Готовое выгружают в свои инструменты, удачную версию сохраняют заранее.
  • Projects дают контекст, а artifact даёт место для сборки, поэтому короткий запрос даёт результат в нужном стиле.
ТерминЗначение
artifactОтдельный результат в окне рядом с чатом: документ, код, страница, диаграмма, график. Его правят на месте
Правка на местеИзменение того же artifact, без новой копии
Цикл «собрать, проверить, исправить»Просим код, запускаем в окне, возвращаем точное описание сбоя, получаем правку
ПесочницаИзолированное окно, где запускается живой artifact, без хранения данных и внешних вызовов
  • Просите SQL-запрос или Python-скрипт сразу в artifact и правьте его на месте, а в репозиторий кладите готовую версию.
  • Описание pipeline или документацию к витрине пишите по шагам: сначала план разделов, затем раздел за разделом.
  • Не стройте в artifact трекер инцидентов или журнал запусков: данные пропадут после перезагрузки. Для этого нужно приложение или база.
  • Artifact не подключится к вашему хранилищу данных. Для живых данных нужны Claude Code, API или MCP.
  1. Почему работа в artifact удобнее, чем копирование ответов из чата в свой документ?
  2. Когда стоит просить artifact в первом сообщении и что можно потерять, если сделать это позже?
  3. Почему просьба «сделай лучше» опасна для документа, который вам в целом нравится?
  4. Что нужно написать в отчёте о сбое, чтобы правка сработала с первого раза? Что делать, если не выходит три раза подряд?
  5. Почему длинный текст лучше строить раздел за разделом, а не одним запросом?
  6. Почему трекер привычек в artifact теряет данные и когда задача уже переросла artifact?

Предыдущая: Проекты, память и база знаний. Следующая: Приложения — web, desktop, телефон и голос.