Материалы

Всё что нужно для работы с AI-агентом — от первых шагов до продвинутых техник.

Как начать

Подготовка важнее реализации. Здесь не про кнопки — а про то, как думать и работать с AI-агентом.

Настройка за 5 минут

setup_01.exe
_x
1 Скачай среду для работы (на выбор)
Warp (рекомендуем) — современный терминал с AI. Mac/Windows. Можно открыть несколько вкладок — каждая вкладка это отдельный проект. Удобно работать над несколькими задачами параллельно.
Wave — ещё один современный терминал. Mac/Windows/Linux.
Cursor — редактор кода со встроенным AI и терминалом.
VS Code — бесплатный редактор кода с терминалом.
Windsurf — редактор с AI, альтернатива Cursor.

Достаточно одной программы. Для начала рекомендуем Warp или Cursor.
setup_02.exe
_x
2 Создай аккаунт Anthropic
Зайди на claude.ai и зарегистрируйся. Нужна подписка Claude Pro ($20/мес) или Max ($100/мес). Для начала хватит Pro. Если упрёшься в лимиты — всегда можно сделать апгрейд до Max.
setup_03.exe
_x
3 Установи Claude Code
Открой терминал и напиши агенту:

"Установи Claude Code и всё что нужно для его работы."

Агент сам определит что установить и сделает это за тебя.
Если что-то не получается — спроси у самого агента. Это его работа — помогать тебе.

Принципы работы

Не список функций, а практические правила из реального опыта. Это то, что реально влияет на результат.

rule_01 - Одна задача
_x
Одна задача — одна сессия
Не пытайся в одном разговоре сделать всё. Завершил задачу — новая сессия. Иначе контекст превращается в кашу, и агент начинает путаться и ломать то что уже работало.
rule_02 - Контекст
_x
Контекст решает всё
Чем больше агент знает о задаче, тем лучше результат. Не "сделай бота", а "сделай Telegram-бота для отслеживания цен на авиабилеты, который раз в час проверяет Aviasales API и присылает уведомление если цена упала ниже заданного порога."
rule_03 - Проверка
_x
Проверяй результат
Агент ошибается. Это нормально. Твоя задача — проверить что получилось и сказать "это не то, давай по-другому" если нужно. Не верь на слово "готово" — запусти, посмотри, потыкай.
rule_04 - Правила
_x
Правила — твоя суперсила
Создай файл CLAUDE.md с правилами проекта. Агент читает его в начале каждой сессии. Чем подробнее правила — тем меньше ты повторяешь одно и то же. Шаблон — в разделе "Шаблоны" ниже.
rule_05 - Планирование
_x
Планируй ДО начала
Не начинай с "сделай мне X". Начни с "давай обсудим что я хочу получить". Пусть агент задаст вопросы, предложит план, и только потом — код. Планирование экономит часы переделок.
rule_06 - Продуктовый подход
_x
Говори ЧТО, не КАК
Описывай проблему, а не решение. "Хочу видеть аномалии на рынке" — а не "сделай таблицу с фильтрами и сортировкой по трём колонкам". Агент лучше тебя знает КАК — твоя задача объяснить ЧТО и ЗАЧЕМ.
rule_07 - Ошибки
_x
Ошибки — часть процесса
Агент ошибётся. Код не запустится с первого раза. Это нормально. Агент увидит ошибку и исправит. Не паникуй, не бросай. Два-три круга правок — и работает.

Когда освоишь базу

7 ошибок которые я сделал

Чтобы вы не делали. Личный опыт за 300+ сессий работы с AI-агентом.

error_01 - Короткие промпты
_x
1. Короткие промпты
Было: "Сделай бота"
Стало: "Создай Telegram-бота который отслеживает цены на авиабилеты, проверяет API раз в час и шлёт уведомление когда цена упала ниже порога"
error_02 - Слепое доверие
_x
2. Не проверял результат
Было: Агент сказал "готово" — я верил на слово
Стало: Каждый раз проверяю: запускаю, тестирую, смотрю что реально получилось
error_03 - Хаос в процессе
_x
3. Менял видение по ходу сессии
Было: Начал с одного, в процессе захотел другое — контекст в каше, агент путается
Стало: Сначала обсуждаю план, потом делаю. Новая идея — новая сессия.
error_04 - Монстр-сессии
_x
4. Один огромный ком
Было: 300 сообщений в одной сессии, 6 часов работы, контекст сломан, агент ходит по кругу
Стало: Одна задача = одна сессия. Закончил — закоммитил — новая сессия.
error_05 - Без правил
_x
5. Не писал правила
Было: Каждый раз объяснял агенту одно и то же с нуля
Стало: Написал CLAUDE.md — агент помнит всё между сессиями, не переспрашивает
error_06 - Ручная работа
_x
6. Не знал про автоматизацию
Было: Вручную проверял каждый шаг, повторял типовые операции
Стало: Хуки, скиллы, автоматические проверки — агент сам следит за качеством
error_07 - Каша в файлах
_x
7. Смешивал правила и скиллы
Было: Всё в одном файле — непонятно что где, агент путается
Стало: Правила = КТО ты и КАК работать. Скиллы = КОНКРЕТНЫЕ команды для конкретных задач. Отдельные файлы.

Шаблоны

Готовый CLAUDE.md и развёрнутые промпты. Скопируй, адаптируй, используй.

CLAUDE.md — файл правил проекта

Положи в корень папки проекта. Агент прочитает его автоматически в начале каждой сессии. Комментарии объясняют каждую секцию — замени их на свои данные.

# Правила проекта

## Кто я
# Опиши себя: роль, уровень, чего ожидаешь от агента.
# Пример:
Я не программист. Я предприниматель / трейдер / [твоя роль].
Объясняй простым языком. Показывай примеры.
Если что-то неясно — спроси, не додумывай.

## Язык
Общаемся на русском. Код и коммиты — на английском.

## Стиль общения
- Коротко и по делу
- Не повторяй мою задачу обратно
- Если задача неясная — задай 2-3 уточняющих вопроса
- После кода — 2-3 предложения: что сделано, почему так, на что обратить внимание

## Как работать
- Перед началом — спроси что неясно
- Одна задача за раз
- Не начинай кодить пока не обсудили план
- После каждого изменения — проверь что работает
- Если ошибка — покажи что произошло и исправь сам
- Не делай больше чем просят

## Ограничения
- НЕ меняй то что работает без моего подтверждения
- НЕ добавляй фичи которые я не просил
- НЕ коммить без моего подтверждения
- НЕ вставляй ключи и пароли в код — только через .env

## Коммиты
Формат: тип: описание
Типы: feat (новое), fix (исправление), docs (документация), chore (обслуживание)
Только после моего подтверждения.

## Проект
# Опиши свой проект:
Название: [название]
Описание: [что это, для кого, какую проблему решает]
Стек: [если знаешь, или оставь пустым — агент разберётся]

## Что сейчас в работе
# Обновляй после каждой крупной задачи:
Последняя задача: [описание]
Следующий шаг: [что планируешь]
Известные проблемы: [что сломано или не доделано]

Промпты-процессы

Не однострочники, а полноценные промпты которые показывают ПРАВИЛЬНЫЙ способ общения с агентом. Скопируй, подставь свои данные.

Исследование
prompt_research.txt
_x
Проведи исследование на тему [тема]. Что мне нужно: - Обзор текущего рынка: кто основные игроки, какой объём - 3-5 возможностей которые я могу использовать - Для каждой возможности: сложность входа, примерные затраты, потенциал - Какие данные доступны (API, открытые источники) Формат: структурированный отчёт с выводами. Не пиши код — только исследование.
Планирование проекта
prompt_plan.txt
_x
Я хочу создать [описание продукта]. Целевая аудитория: [кто будет пользоваться] Проблема: [что решаем] Результат: [что должно работать в итоге] Прежде чем писать код: 1. Задай мне уточняющие вопросы (максимум 5) 2. Предложи план из 3-5 шагов 3. Для каждого шага: что делаем, какой результат, сколько примерно займёт 4. Дождись моего подтверждения плана
Code Review
prompt_review.txt
_x
Проверь код в этом проекте. Что искать: - Баги и логические ошибки - Проблемы безопасности (ключи в коде, инъекции, XSS) - Дублирование кода - Файлы больше 300 строк (предложи как разбить) Формат: список проблем по приоритету (критично / важно / мелочь). Для каждой проблемы: что не так, где именно, как исправить.
Создание Telegram-бота (конкретный пример)
prompt_bot.txt
_x
Создай Telegram-бота для [опиши что он должен делать]. Что он должен уметь: - [функция 1 — опиши своими словами] - [функция 2] Бот должен работать бесплатно или максимально дёшево. Используй бесплатную модель через OpenRouter если нужен AI. Покажи как запустить и как задеплоить.

Что использовать

Инструменты, которые пригодятся. Для каждого — конкретный сценарий использования.

AI-агенты и IDE
Claude Code
Агент-разработчик в терминале. Полная автономность — сам пишет, запускает, исправляет.
Используй когда: нужен полный контроль и максимальная мощность.
Cursor
IDE с встроенным AI. Код прямо в редакторе, видишь изменения в реальном времени.
Используй когда: хочешь начать проще, без терминала.
VS Code
Бесплатный редактор кода. Работает с расширениями, включая Claude.
Используй когда: уже пользуешься VS Code, хочешь добавить AI.
Windsurf
IDE с AI. Альтернатива Cursor с другим подходом к взаимодействию.
Используй когда: Cursor не подошёл, хочешь попробовать другое.
Терминалы
Warp
Современный терминал с AI-подсказками. Mac/Windows.
Используй когда: хочешь умный терминал с AI-фичами.
Wave
Терминал с AI. Mac, Linux, Windows.
Используй когда: нужен кроссплатформенный терминал с AI.
AI-билдеры (без кода)
v0.dev
Описываешь интерфейс словами — получаешь готовый UI. От Vercel.
Используй когда: нужен быстрый UI-прототип из описания.
Bolt.new
Полноценное приложение из описания прямо в браузере.
Используй когда: хочешь MVP за час без установки чего-либо.
Lovable
Описал — получил MVP. Быстрый прототип с деплоем.
Используй когда: нужно быстро показать идею инвестору или команде.
Деплой
Vercel
Деплой фронтенда одной командой. Бесплатный тариф для старта.
Используй когда: нужно выложить сайт или лендинг в интернет.
Railway
Деплой бэкенда и ботов. Бесплатный тариф.
Используй когда: нужно запустить бота или серверное приложение.
API и модели
OpenRouter
Один API для всех моделей (Claude, GPT, Llama, Gemini). Есть бесплатные модели.
Используй когда: строишь продукт с AI и хочешь гибкость в выборе модели.
Исследование и анализ
Perplexity
AI-поисковик. Отвечает на вопросы со ссылками на источники.
Используй когда: фаза исследования — изучаешь рынок, API, конкурентов.
NotebookLM
Загружаешь документы — AI анализирует, отвечает на вопросы по ним.
Используй когда: нужно разобраться в большом объёме документов.
Автоматизация
n8n
Визуальный конструктор автоматизаций. Self-hosted, бесплатный.
Используй когда: нужно связать несколько сервисов без кода.
Make
Облачный конструктор автоматизаций. Проще n8n, но платный.
Используй когда: не хочешь разворачивать сервер, нужно быстро.

Куда копать дальше

Только то, что реально полезно. Без воды.

Prompt Engineering Guide

Как формулировать задачи для AI. Основы и продвинутые техники. На английском.

MCP (Model Context Protocol)

Стандарт подключения инструментов к AI. GitHub, Sentry, базы данных — через единый протокол.

Правила и скиллы ведущего

Набор правил и скиллов ведущего — скоро будет доступен.