Суть урока
Первый запуск любого воркфлоу (воркфлоу — рабочий процесс) — как первый пробный полёт самолёта-прототипа: почти всегда находят что-то что надо подправить. Разница между Claude Code и Zapier в том, что Claude Code в большинстве случаев сам залезает в кабину и чинит — тебе не нужно разбираться в том, какой провод отошёл.
Ключевые концепции
- Ошибки при первом запуске — норма, не провал
- Claude Code находит и исправляет ошибки автономно
- Делегирование исправления: ты описываешь симптом, агент (агент — автономный AI-исполнитель) ставит диагноз и лечит
- После первого успешного теста воркфлоу становится надёжным
Теория
Почему первый запуск почти всегда ломается
Это не баг системы — это особенность любой автоматизации. Когда ты строишь воркфлоу, ты работаешь с теоретическими предположениями: "API (эй-пи-ай — интерфейс программирования приложений) должен принять вот такой запрос", "в этой таблице будут данные в таком формате", "эндпоинт находится по такому адресу". Реальность всегда вносит коррективы.
В традиционных инструментах (Zapier, Make, n8n) это означает: ты видишь красный крест в логах, копируешь ошибку, идёшь в Google, читаешь документацию, возвращаешься, пробуешь исправить — и так по кругу. Особенно болезненно если ты не разбираешься в коде.
С Claude Code схема другая: ты просто описываешь что видишь, агент сам разбирается в причинах.
Три реальных сценария самоисправления
Сценарий 1: Unicode encoding error
Ты запустил воркфлоу который собирает новости и форматирует их. В консоли видишь что-то вроде:
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 14
Ты не знаешь что такое UTF-8 codec и почему он что-то не декодирует. Ты пишешь в Claude Code: "запустил воркфлоу, получил вот такую ошибку". Агент:
- Читает лог ошибки
- Находит файл где произошла ошибка
- Видит что при работе с текстом не указана кодировка
- Добавляет
encoding='utf-8'в нужное место - Перезапускает — ошибка исчезает
Ты не написал ни строчки кода.
Сценарий 2: API endpoint изменился
Сервис который ты используешь обновился — старый URL API больше не работает. Воркфлоу возвращает 404 Not Found. Claude Code:
- Видит 404 ошибку
- Обращается к актуальной документации сервиса (через Context7 MCP — протокол для подключения инструментов к AI — или поиском)
- Находит новый endpoint
- Обновляет инструмент в твоём проекте
- Тестирует — теперь работает
Это буквально то что раньше занимало час разбирательств с документацией.
Сценарий 3: Неправильный ID Google Sheet
Ты подключил воркфлоу к Google Sheets, но скопировал ID таблицы неправильно (взял из URL, но не ту часть). Агент пытается обратиться к таблице и получает ошибку доступа. Он сообщает: "Не могу найти таблицу с этим ID, проверь правильность ID". Ты открываешь таблицу в браузере, копируешь правильный ID из URL, отправляешь агенту — он обновляет конфиг и продолжает.
Это пример когда агент не может исправить сам (нужна твоя информация из внешней системы), но он чётко говорит что нужно — не просто "ошибка".
Как правильно сообщать об ошибках
Когда видишь ошибку, твоя задача — описать что происходит. Не нужно анализировать или пытаться объяснить причину. Просто:
Хорошо:
- "Запустил воркфлоу newsletter, вижу вот такой текст в консоли: [вставляешь ошибку]"
- "Воркфлоу остановился, вот что написано: [скриншот или текст ошибки]"
- "Кажется что-то пошло не так на шаге с Google Sheets, агент написал что не может подключиться"
Не нужно:
- Анализировать код самому
- Пытаться понять техническую причину
- Искать решение в Google (кроме случаев когда тебе это интересно)
Ты делегируешь. Делегирование — это "вот симптом", не "вот моя теория и мой план лечения".
Первый успешный тест — переломный момент
Когда воркфлоу впервые проходит от начала до конца без ошибок — это момент который стоит запомнить. После него:
- Ты знаешь что воркфлоу работает в реальных условиях
- У тебя есть уверенность что его можно задеплоить
- Все найденные ошибки уже исправлены
Профессиональные разработчики называют это "прошёл smoke test". Ты к этому пришёл не через разбирательство с кодом, а через диалог с агентом.
Claude Code vs Zapier/n8n: ключевое отличие
| Ситуация | Zapier/n8n | Claude Code |
|---|---|---|
| Ошибка в логах | Идёшь разбираться сам | Описываешь агенту |
| API изменился | Ищешь новую документацию | Агент находит сам |
| Нужна корректировка логики | Перетаскиваешь блоки | Говоришь словами |
| Непонятная ошибка | Копируешь в Google | Вставляешь агенту |
Главное: Zapier/n8n в привычном режиме — инструменты для тех кто знает как их настраивать. Claude Code — инструмент для тех кто знает что хочет получить. Сами конструкторы тоже получают AI-помощников, поэтому сравнение описывает привычный способ работы, а не жёсткую границу.
Практика
Задание: намеренная ошибка
Возьми воркфлоу из урока Первый воркфлоу LIVE (newsletter automation). Сделай в нём намеренную ошибку — например, измени API endpoint на несуществующий (добавь лишний символ в URL инструмента). Запусти воркфлоу. Получи ошибку. Теперь скажи агенту: "воркфлоу упал, вот ошибка, найди и исправь". Наблюдай за процессом: агент читает лог, находит проблему, исправляет, перезапускает.
Цель: убедиться что ты умеешь делегировать исправление ошибок, а не решать их самостоятельно.
Дополнительно: попробуй дать агенту только скриншот ошибки без объяснений — посмотри насколько он сам разберётся в ситуации.
Инструменты и ресурсы
- Claude Code terminal (терминал — программа для ввода команд) — основное место где видны ошибки (консоль)
/context— помогает понять в каком состоянии находится агент при дебаггинге/compact— если дебаг затянулся и контекст (контекст — текст который AI «видит» в данный момент) переполнен, сожми историю перед продолжением- Лог файл воркфлоу — агент читает его автоматически при анализе ошибок
/doctor— проверка установки и настроек самого Claude Code, если ошибка не в твоём воркфлоу, а в окружении- Claude Code CLI Reference — CLI (си-эл-ай — интерфейс командной строки), полный список команд
- Context7 MCP (когда подключён) — агент ищет актуальную документацию при ошибках типа "endpoint not found"
- Stack Overflow / GitHub Issues — агент может искать решения через WebSearch если ошибка нетривиальная
Частые ошибки
Ошибка 1: Пытаться чинить самому вместо делегирования
Видишь ошибку, лезешь в Google, тратишь час на чтение Stack Overflow. Вместо этого — копируешь ошибку агенту: "вот что в консоли, разберись". Экономия 30-60 минут.
Ошибка 2: Не сохранять лог ошибок
Агент починил, всё заработало — но ты не знаешь что было не так. Попроси агента: "объясни коротко что было сломано и как починил". Это полезно для понимания системы.
Ошибка 3: Игнорировать warning'и
Воркфлоу работает, но в консоли жёлтые предупреждения. Они могут стать ошибками позже. Скажи агенту: "вот warnings, стоит ли их исправить?"
Перекрёстные ссылки
- Первый воркфлоу LIVE — воркфлоу который мы дебажим в этом уроке
- Context Rot и техники борьбы с деградацией — если дебаг-сессия затянулась и контекст переполнен
- Headless Mode и CI/CD (CI/CD — Continuous Integration/Delivery, автоматическая сборка и доставка) — автоматический дебаггинг в пайплайне (пайплайн — цепочка последовательных шагов) без участия человека
Ключевые выводы
Первая ошибка в воркфлоу — это не провал, это часть процесса. Ожидай её.
Твоя роль при дебаггинге — описать симптом, не ставить диагноз. Агент разберётся в причинах сам.
После первого успешного прогона у тебя есть доказательство что воркфлоу работает в реальных условиях. Это и есть готовый продукт.
Следующий урок
→ Токены и управление контекстом (токен — единица текста для AI, ~4 символа английского текста) — что едят ресурсы и как это контролировать
Отметка хранится только в этом браузере и никуда не отправляется. Мой прогресс