Рецепты Claude Code

памятка к докладу «Навайбкодил на стартап: 7 способов уговорить ИИ собирать ваши проекты»
Каждая карточка: что сделать → команда или промпт → чего ждать в ответ. Команды вводятся внутри сессии claude, если не сказано иное. Всё проверено на живом проекте.
⭐ минимум — обязательная база новичка 🔧 из PMS — используется в моём production-проекте
Подготовка окружения (один вечер): установите Git, Homebrew (Mac) / winget (Windows), Node.js — а лучше просто попросите ИИ по рецепту 1.2. Установка Claude Code: официальный quickstart.

01Первые шаги

Установить и запустить ⭐ минимум

Одна команда в терминале — и у вас агент в текущей папке проекта.

$ npm install -g @anthropic-ai/claude-code $ cd my-project && claude ╭─ Welcome to Claude Code! ────────────╮
docs: quickstart →

Первый промпт: настроить окружение ⭐ минимум

Не ставьте инструменты вручную — попросите. Терминал не страшный: команды пишет ИИ, вы жмёте Enter.

> Помоги настроить окружение для разработки. Спрашивай по одному шагу, объясняй зачем. Шаг 1/6: проверим, установлен ли Git…

Пройти встроенную школу: /powerup ⭐ минимум

Интерактивные уроки с анимированными примерами прямо в терминале. Бесплатно, по одному в вечер.

> /powerup 18 уроков: от основ до продвинутых воркфлоу ▸ Урок 1: Ваш первый запрос

Конституция проекта: /init ⭐ минимум

ИИ сам проанализирует проект и напишет первый CLAUDE.md. Ваша работа — прочитать и поправить.

> /init Анализирую структуру проекта… ✓ Создан CLAUDE.md
docs: memory →

Выбрать модель под задачу: /model

Мощная модель — на план и архитектуру, быстрая — на рутину. opusplan переключает автоматически.

> /model opusplan Opus — в режиме плана, Sonnet — на исполнении

Понять, что происходит: /status и /doctor

Что за сессия, какие настройки подхватились, где ошибка в конфиге.

> /status Model: sonnet · MCP: 2 · CLAUDE.md: loaded > /doctor ✓ Конфигурация в порядке

02Память проекта: чтобы ИИ не «забывал»

CLAUDE.md: что писать ⭐ минимум🔧 из PMS

Нерушимые правила, стек, стиль — и обязательно секцию «чего НЕ делаем»: она спасает от расползания проекта.

## Non-negotiable rules Do not regress these without explicit approval. ## Things deliberately NOT in scope - Multi-tenant / mobile app / analytics
docs: memory →

Иерархия памяти: личная и проектная

~/.claude/CLAUDE.md — ваши правила для всех проектов («отвечай по-русски, объясняй термины»). ./CLAUDE.md — правила конкретного проекта.

~/.claude/CLAUDE.md → везде ./CLAUDE.md → этот проект

Запомнить между сессиями

Просто скажите — авто-память сохранит. Решения, договорённости, предпочтения переживут любую новую сессию.

> запомни: всегда pnpm, не npm ✓ Сохранено в память проекта

Управлять памятью: /memory

Посмотреть все файлы памяти, включить/выключить авто-память, открыть на редактирование.

> /memory CLAUDE.md (проект) · auto-memory: on

Держать CLAUDE.md в форме 🔧 из PMS

Скилл claude-md-management ревьюит и чистит файл по мере роста проекта — CLAUDE.md тоже стареет.

> проверь CLAUDE.md: что устарело, что дублируется 3 правила устарели после ADR-034, предлагаю…

Вынести знания в docs/ 🔧 из PMS

Карта для ИИ: обзор, решения, план. В CLAUDE.md — только оглавление, читать по требованию.

docs/ 00-overview.md что за продукт 09-decisions.md что решили и почему (ADR) 08-roadmap.md план по шагам

03Планирование и процесс

План-режим: исследовать, не трогая файлы ⭐ минимум

Shift+Tab — ИИ читает код и предлагает план, но ничего не меняет, пока вы не одобрите.

⏸ plan mode — файлы не изменяются > как устроена оплата? предложи план для скидок
docs: best practices →

Промпт «сначала план» ⭐ минимум

Самый дешёвый приём из всех: ноль инструментов, чистая дисциплина — и самый окупаемый.

> Не пиши код. Сначала план: какие файлы, какие шаги, что может сломаться. …читаете план, задаёте вопросы → «поехали»

Spec-driven за руку: superpowers 🔧 из PMS

Плагин ведёт весь цикл brainstorm → спека → план → код, ревью встроено на каждом шаге.

> /plugin marketplace add obra/superpowers-marketplace > /plugin install superpowers@superpowers-marketplace ✓ Installed. Скажите «brainstorm …» — и понеслась

Альтернативы процесса

Идея одна — обёртки разные. Выбирайте по вкусу:

spec-kit github.com/github/spec-kit OpenSpec спеки как контракт BMAD agile-роли агентов

Роадмап + скилл старта сессии 🔧 из PMS

Мой ритуал: каждая сессия начинается со скилла, который парсит роадмап и git — ИИ просыпается уже в контексте плана.

> /phase-check ✓ Фаза 1м: 6/8 шагов · в работе: slice 7 следующий незаблокированный: cutover runbook

Ревью плана в браузере: ultraplan

Большой план удобнее читать и править не в терминале — Ctrl+G открывает редактор.

План готов (14 шагов) · Ctrl+G — открыть в редакторе
docs: ultraplan →

04Ревью и качество

Попросить тесты ⭐ минимум🔧 из PMS

Многие не знают: это одна фраза. Тесты — ваши глаза: код не прочитаете, а «проверяем: без оплаты нет подтверждения» — прочитаете. Лучше до кода, по спеке. В PMS 420 тест-файлов — написал не я.

> напиши тесты на это по спеке, до реализации ✓ 12 тестов: happy path, пустая форма, двойная оплата…

Независимое ревью субагентом 🔧 из PMS

Автор-агент «влюблён» в своё решение, как человек. Свежий контекст находит то, что автор в упор не видит.

> отдай этот код субагенту на ревью: проверь как строгий сеньор, ищи edge cases ⚠ найдено: гонка при двойном сабмите формы
docs: subagents →

Второе мнение: /advisor

Назначаете «старшего консультанта» (мощную или независимую модель) один раз — дальше агент сам к нему ходит при сложных решениях. Если реальность разошлась с советом — скажет.

> /advisor ✓ Советник: Opus. Вызывается автоматически

Проверка на уязвимости: /security-review

Отдельный проход только по безопасности текущих изменений. Помните про 1,5 млн утёкших ключей.

> /security-review ⚠ 2 находки: секрет в коде, нет rate-limit на /login

Ревью PR на GitHub

Прямо в pull request: тегните — получите построчные комментарии.

# в комментарии к PR: @claude review this ✓ 5 inline-комментариев добавлено
docs: code review →

Свои агенты-ревьюеры под свою боль 🔧 из PMS

Файл в .claude/agents/ — и у вас штатный ревьюер. У меня три: миграции БД, документация, инварианты внешнего API.

# .claude/agents/migration-auditor.md description: Проверяет каждую миграцию БД на обратимость и соответствие схеме

05Гардрейлы: заставлять, а не просить

Хук: автопроверка после каждой правки ⭐ минимум🔧 из PMS

Правило в CLAUDE.md ИИ может учесть. Хук срабатывает всегда. Формат + линт после каждого изменения: упало — ИИ обязан чинить до зелёного.

# .claude/settings.json "PostToolUse": [{ "matcher": "Edit|Write", "hooks": [{ "command": "./format-and-lint.sh" }] }]
docs: hooks →

Хук-запрет: не трогай эти файлы ⭐ минимум🔧 из PMS

PreToolUse блокирует действие до выполнения. У меня: нельзя править уже выпущенные миграции БД и генерённый код.

"PreToolUse": [{ "matcher": "Edit", "hooks": [{ "command": "./block-shipped-migration.sh" }] }] ✗ blocked: миграция 0042 уже выпущена

Хук на коммит: роадмап или ничего 🔧 из PMS

Самый любимый: коммит не проходит, пока не обновлён план. ИИ больше не «забывает» отметить сделанное.

$ git commit -m "add booking form" ✗ blocked: docs/08-roadmap.md not updated

Формула выбора

Куда класть правило — простая эвристика:

важное правило → хук (срабатывает всегда) пожелание → CLAUDE.md (ИИ постарается) повторяемое действие → скилл

Настроить хук промптом

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

> настрой хук: перед коммитом гоняй тесты, красные — не коммить ✓ Добавлен PreToolUse-хук в settings.json

Права доступа: что можно без спроса

Режимы разрешений: от «спрашивай про всё» до «работай сам в песочнице». Опасные команды — всегда под запретом.

> /permissions allow: npm test · deny: rm -rf · ask: git push
docs: permissions →

06Откаты и anti-doom-loop

Чекпоинты: /rewind ⭐ минимум

Esc-Esc — и вы выбираете точку, куда откатить код и/или разговор. Встроенная машина времени поверх git.

> /rewind ▸ 14:02 «добавь форму брони» ← restore code
docs: checkpointing →

Правило 5 попыток ⭐ минимум

Баг не чинится с пятого раза → стоп. Откат почти всегда быстрее уговоров: свежая формулировка вместо тонущего контекста.

> стоп. откатись к последнему коммиту. формулирую задачу заново: …

Диагноз отдельно от лечения

Не «почини» — ИИ начнёт менять код наугад. Сначала причина, потом фикс.

> найди причину и объясни мне, ничего не меняя Причина: состояние формы сбрасывается при… > ок, теперь чини именно это

Коммит после каждого шага

Шаг = проверяется за 10 минут. Проверили — «сохранились», как в игре. Это и есть точки для отката.

$ git add -A && git commit -m "step: форма брони" …или просто: «закоммить этот шаг»

Начать заново без потери правил: /clear

Контекст сессии выбрасывается, CLAUDE.md и память проекта остаются. Новая большая задача = новая сессия.

> /clear ✓ Чистый контекст · правила проекта на месте

07MCP: подключаем внешние инструменты

Подключить MCP-сервер ⭐ минимум

MCP — «розетка», через которую ИИ получает доступ к внешним сервисам: базе, облаку, докам, браузеру.

$ claude mcp add --transport http context7 \ https://mcp.context7.com/mcp ✓ Added MCP server: context7
docs: MCP →

Context7: чтобы не галлюцинировал API ⭐ минимум

Свежие доки любых библиотек по запросу. Первый MCP, который стоит поставить.

> подключи Stripe Checkout. используй context7 Читаю актуальные доки stripe-node v14…

MCP вашего облака и базы

Supabase, Cloudflare, GitHub, PostgreSQL — ИИ сам смотрит логи, таблицы, деплой.

$ claude mcp add --transport http supabase \ https://mcp.supabase.com/mcp > почему упал последний деплой? глянь логи

Что подключено: /mcp

Список серверов, их инструменты, статус подключения. Отсюда же можно отключать.

> /mcp context7 ✓ · supabase ✓ · chrome ✓ (12 tools)

Скоупы: где действует сервер

Личное — для всех проектов, проектное — только здесь (и попадает в git для команды).

--scope user все ваши проекты --scope project только этот, через .mcp.json

⚠ Гигиена: каждый MCP ест контекст

5–10 серверов съедают до ⅓ «памяти» ИИ до первого слова. Меньше памяти → глупее ответы → дороже. Подключайте под задачу, отключайте после.

правило: Context7 + MCP вашего облака. Всё. остальное — по мере реальной боли

08Плагины, маркетплейсы, скиллы

Каталог плагинов: /plugin ⭐ минимум

Плагин = готовый набор скиллов, агентов, хуков и MCP. Вкладка Discover — витрина.

> /plugin Discover · Installed · Marketplaces
docs: plugins →

Подключить маркетплейс

Каталоги плагинов: официальный подключён из коробки, комьюнити и любые git-репозитории — одной командой.

> /plugin marketplace add anthropics/claude-plugins-community ✓ Marketplace added · 120+ plugins

Установить плагин

Имя + маркетплейс. После установки скиллы плагина доступны сразу.

> /plugin install superpowers@superpowers-marketplace ✓ Installed: 12 skills, 3 agents

Донастроить проект: claude-code-setup 🔧 из PMS

Скилл-аудитор: смотрит проект и предлагает, каких хуков, агентов и скиллов не хватает под ваш стек.

> проведи аудит настройки проекта Рекомендую: hook go-format, агент-ревьюер миграций…

Свой скилл за 10 минут 🔧 из PMS

Markdown-файл с инструкцией — и у ИИ новый навык. Повторили действие трижды → превращайте в скилл. Мои: новая миграция, новый ADR, закрытие шага роадмапа.

# .claude/skills/adr-new/SKILL.md name: adr-new description: Оформить архитектурное решение в docs/09-decisions.md по шаблону проекта
docs: skills →

Шпаргалка: скилл, память или хук?

Три механизма расширения — три разных случая.

факт/правило → CLAUDE.md / память процедура «как» → скилл запрет/автопроверка → хук

09GitHub и автоматизация

Подключить GitHub

Одна команда ставит GitHub-приложение и (по желанию) workflow для Actions.

> /install-github-app ✓ App installed · workflow: claude-code.yml
docs: GitHub Actions →

@claude в PR и issue

Ревью, правки и ответы на вопросы — прямо в интерфейсе GitHub, без терминала.

# в комментарии: @claude почини падающий тест в этом PR ✓ Пуш в ветку: fix flaky booking test

Claude Code в скриптах: headless

Флаг -p — запуск без интерактива: для CI, кронов и пайплайнов.

$ claude -p "проверь миграции на обратимость" \ --output-format json | jq '.result'
docs: headless →

Параллельные сессии: worktrees

Каждая сессия — в своей изолированной копии репозитория: правки не конфликтуют. Обзор всех агентов — /agents.

> /agents ▸ booking-fix (running) · ui-polish (done)
docs: worktrees →

Агенты по расписанию: routines

Шаблонные агенты в облаке: по крону, по событию GitHub или по API. «Каждое утро проверяй issues и предлагай план».

claude.ai/code → Routines → New trigger: daily 07:00 · repo: my-project

10Браузер и дизайн

ИИ сам прокликивает интерфейс ⭐ минимум🔧 из PMS

Расширение Claude in Chrome: ИИ открывает приложение, которое написал, тыкает формы, видит ошибки, чинит. Так проверялась моя админка.

> открой localhost:3000 и проверь форму брони как придирчивый пользователь ⚠ дата выезда позволяет выбрать день раньше заезда
docs: Chrome →

Дебаг фронта без копипасты ошибок

ИИ сам читает console и network — не нужно пересказывать ему, что сломалось.

> страница белая. глянь консоль и почини console: TypeError: cannot read 'price'… чиню

Claude Design → handoff → код 🔧 из PMS

Мой пайплайн: дизайн в Claude Design → handoff превращает его в артефакты и первый промпт для сессии кода. Claude Code подключается к Claude Design напрямую.

design → handoff → FIRST-SESSION.md «Read CLAUDE.md… Your goal is Phase 0 only…»

Альтернативы для дизайна

Не дизайнер — не изобретайте: генератор + готовая дизайн-система.

v0.dev интерфейсы кодом (shadcn/ui) Figma Make перебор вариантов Lovable приложение целиком

Figma по MCP

Если макеты уже в Figma — ИИ читает их напрямую и обновляет код по макету.

> обнови карточку товара по новому макету из Figma (страница Catalog v2)

11Токены и деньги

Сколько потратил: /usage ⭐ минимум

Токены и оценка стоимости текущей сессии, по моделям.

> /usage session: 84k tokens · ~$0.9 · sonnet 92%, opus 8%
docs: costs →

Сжать контекст: /compact

Длинная сессия забила «память» — сжимаем историю. Трейдофф: детали теряются, поэтому важное — в файлах, а не «в голове» ИИ.

> /compact ✓ Контекст сжат: 92k → 18k токенов

Новая задача — новая сессия

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

> /clear — или просто закрыть и открыть claude

Думать дорого, делать дёшево

План и архитектура — на мощной модели, рутина — на быстрой. Ошибка в плане стоит дороже всех токенов планирования.

> /model opusplan план: opus · исполнение: sonnet

Не подключать всё подряд

Каждый MCP и плагин ест контекст ещё до начала работы (см. группу 07). Раз в месяц: /mcp и /plugin — что реально используется?

аудит: 6 MCP подключено, использую 2 → отключаю 4