Вайбкодинг на Claude Code

Fable думает, агенты делают

Зачем. Anthropic это померила: 96% качества за 46% денег. Работает лучше, стоит вдвое дешевле.

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

Какую модель на что

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

И создай файл — он перекроет встроенный поисковый агент, который иначе жрёт по премиум-тарифу:

---
name: Explore
description: Поиск по репозиторию.
model: haiku
effort: low
---

Ищи и докладывай факты. Решений не принимай.

Что отдавать агенту, а что нет

Правило: задача меньше 5 минут — делай сам. Гонять агента ради одной строчки дороже, чем написать её.

Не хочешь настраивать — включи /model opusplan, он делает примерно то же из коробки.

Настройка проекта

CLAUDE.md — держи коротким

Максимум 200 строк. Чем длиннее файл, тем хуже его слушают: важное тонет.

Проверка каждой строки: «если убрать — он ошибётся?» Нет — удаляй.

Почему он забывает правила к концу сессии

CLAUDE.md грузится один раз в начале, а не каждый ход. Чем дольше разговор, тем дальше правила уезжают назад — и тем слабее работают.

Вывод: что важно соблюдать всегда — вешай хуком, а не пиши текстом. Текст можно проигнорировать, хук — нет.

4 правила, которые реально работают

.claudeignore

node_modules/
.next/
dist/
build/
coverage/
*.log
*.lock
.env*

Дизайн

Почему AI-интерфейсы узнаются сразу: модель не имеет вкуса, у неё есть статистика. Не задал шрифт — получишь Inter. Не задал цвет — фиолетовый градиент. Не задал разделение — серую рамку вокруг всего.

Просить «сделай красивее» бесполезно. «Красивее» для модели = среднее по интернету. Лечится не уговорами, а записанными ограничениями.

Заведи DESIGN.md

Шесть секций, зафиксировать до первой строчки стилей:

1. Шрифты — точные названия и шкала
2. Цвета — hex + для чего каждый
3. Отступы — базовая единица
4. Компоненты — радиусы, тени
5. Сетка и ширины
6. Характер — прилагательные и анти-примеры

Запретный список работает лучше всего

Запиши дословно в DESIGN.md:

Числа, которые отличают дизайн от слопа

Не описывай дизайн — вытащи его

Вместо того чтобы объяснять словами, забери готовую дизайн-систему с любого сайта:

npx designlang https://stripe.com

Получишь точные цвета, шрифты, отступы и конфиг Tailwind. Дальше: «свёрстай по этой системе». Попадание совсем другое.

Дай Клоду глаза

Главный приём для фронтенда. Ставишь Playwright — и он сам смотрит на результат:

claude mcp add playwright -- npx -y @playwright/mcp@latest
npx playwright install

Обычно хватает 2–3 итераций. Он крутит цикл сам, обновлять страницу руками не надо.

Экономия токенов

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

Модели по цене

Разгон рутины на младшую модель — до 5× экономии.

/compact или /clear

Что ещё режет расходы

• JSON жрёт вдвое больше токенов, чем тот же смысл текстом. Отдавай контекст текстом или таблицей.
• Выход дороже входа в 5 раз. Проси вернуть ID или номера — разворачивай их своим кодом. Люди срезают так до 60%.
• Динамическую часть промпта — в конец. Кэш работает по началу: поменял начало — обнулил весь кэш.
• Отключи лишние MCP-серверы. Их описания грузятся в каждый запрос. Проверить: /context.

Перед /clear — сохрани состояние

Запиши в .claude/session-handoff.md: цель, изменённые файлы,
решения, падающие тесты, следующий шаг.

# потом /clear, и в новой сессии:
Прочитай .claude/session-handoff.md и продолжай.

Как раздавать работу агентам

Границы — по папкам, а не по идеям

Агент 1: src/api/auth/**
Агент 2: src/session/**
Агент 3: tests/**

Максимум три агента. Общие файлы (package.json, миграции, конфиг) не трогает никто, кроме назначенного.

Всегда ограничивай агента

Пиши код одной сессией, ревьють другой

Сессия A пишет. Сессия B — свежая, ничего не знает — проверяет. Так она непредвзята.

Сверь код с PLAN.md. Всё ли требование реализовано,
есть ли тесты на крайние случаи, не изменилось ли
лишнее.

Пиши про пробелы, а не про вкусовщину.

Параллельно — только в worktree

claude --worktree backend-auth

Каждому агенту — свою ветку и свой порт (3000, 3001, 3002), иначе подерутся.

Автоматизация

Запуск без человека

claude -p "Проверь диф на баги." \
  --allowedTools "Read,Grep,Glob" \
  --permission-mode dontAsk

for file in $(cat files.txt); do
  claude -p "Мигрируй $file. Верни OK или FAIL." \
    --max-turns 10 --model sonnet
done

Сначала обкатай на 2–3 файлах, потом запускай на всех.

Хуки — единственный способ заставить наверняка

CLAUDE.md можно проигнорировать. Хук — нет, это код. Хочешь, чтобы типы проверялись после каждой правки — не проси, повесь хук, который падает и блокирует ход.

Как строить сервис

80% времени — план, 20% — код. Звучит как потеря темпа, но так быстрее: хороший план делает кодинг механическим.

Шаг 1. Пусть он тебя допросит

Хочу построить [X]. Задай мне вопросы, чтобы всё понять.
Спрашивай про реализацию, UI, крайние случаи, риски.
Очевидное не спрашивай — копай в сложное.

Потом запиши всё в SPEC.md.

Дальше /clear и в новой сессии: «прочитай SPEC.md и делай». Контекст чистый, план готов.

Шаг 2. Порядок

1. План-режим — Shift+Tab дважды. Файлы не тронет, пока не утвердишь.
2. Сначала контракты — типы, схема БД, API. Отдельным коммитом. Потом можно параллелить.
3. Раздай по папкам — максимум три агента.
4. Фронтенд — циклом со скриншотом.
5. Ревью свежей сессией — не той, что писала.
6. Перед деплоем — хук с тестами, а не надежда.

Чего не делать

Шпаргалка

export CLAUDE_CODE_SUBAGENT_MODEL=haiku
export MAX_THINKING_TOKENS=8000

Чеклист

• CLAUDE.md короче 200 строк
• CLAUDE_CODE_SUBAGENT_MODEL=haiku выставлен
• Свой Explore.md с model: haiku создан
• Есть .claudeignore
• Есть DESIGN.md с запретным списком
• Записано «говори, чего не сделал»
• Записано «не трогай лишние файлы»
• Закоммичено перед запуском агента
• --max-turns на всех автозапусках
• Есть проверка, которую агент запустит сам