15 советов по Claude Code, которые я рекомендую каждой команде разработчиков

Claude Code — один из мощнейших AI-инструментов для разработчиков. Но большинство людей используют едва 10% его возможностей. На своих тренингах я раз за разом вижу одни и те же паттерны — команда устанавливает инструмент, пробует пару промптов, и либо это работает «как-то так», либо сдаются.

Из десятков советов, собранных за год ежедневного использования, я выбрал 15 с наибольшим импактом. Эти рекомендую на каждом воркшопе.

Основы, дающие наибольший эффект

1. Дайте Claude обратную связь — тесты, линтер, ожидаемый вывод

Это совет номер один не случайно. Когда вы говорите Claude «Рефактори auth middleware на JWT. Запусти существующие тесты после изменений. Исправь все ошибки, прежде чем считать задачу выполненной» — Claude запускает тесты, видит ошибки и сам их исправляет. Борис Черный (создатель Claude Code) говорит, что одно это улучшает качество в 2-3 раза.

# Prompt WITHOUT feedback loop (bad):
Refactor auth middleware to JWT.

# Prompt WITH feedback loop (good):
Refactor auth middleware to JWT.
Run the existing test suite after.
Fix any failures before calling
it done.

2. Установите LSP-плагин для вашего языка

LSP-плагины дают Claude автоматическую диагностику после каждой правки — ошибки типов, неиспользуемые импорты, пропущенные возвращаемые типы. Claude видит и исправляет проблемы раньше, чем вы их заметите. Это плагин с наибольшим импактом. TypeScript, Python, Rust, Go — все основные языки поддерживаются.

3. Используйте Plan Mode для сложных изменений

Shift+Tab переключает между Normal, Auto-Accept и Plan Mode. Для мульти-файловых изменений, незнакомого кода или архитектурных решений несколько минут планирования окупаются — они не дадут Claude потратить 20 минут на уверенное решение неправильной проблемы. Для мелких, ясных задач — пропускайте.

Продуктивность и воркфлоу

4. Esc останавливает, Esc+Esc откатывает

Esc останавливает Claude посреди действия без потери контекста. Esc+Esc (или /rewind) открывает прокручиваемое меню всех чекпоинтов. Можно восстановить код, разговор или и то и другое. Это значит, что можно попробовать подход, в котором уверены лишь на 40%. Если не сработает — rewind. Никакого ущерба.

5. /clear между несвязанными задачами

Чистая сессия с чётким промптом побеждает хаотичную трёхчасовую сессию каждый раз. Другая задача? Сначала /clear. Знаю, кажется, что выбрасываешь прогресс, но накопленный контекст от предыдущей работы заглушает ваши текущие инструкции. 5 секунд на /clear экономят 30 минут убывающей отдачи.

6. Не описывайте баги. Вставляйте сырые данные.

Описывать баг словами медленно. Claude гадает, вы поправляете, повторяете. Вместо этого: вставьте лог ошибки, вывод CI или Slack-тред и скажите «fix». Ваша интерпретация добавляет абстракцию, которая часто теряет деталь, нужную Claude для определения корневой причины. Дайте сырые данные и отойдите.

# Bad:
"I have an auth problem in tests."

# Good — paste raw output:
$ npm test -- --run auth.test.ts
FAILED: auth.test.ts:42
  Expected: 200
  Received: 401
  at Object.<anonymous> (auth.test.ts:42)

Fix this. The test passes locally but
fails in CI (Docker container).

Контекст и масштабирование

7. «Ultrathink» для сложного reasoning

Ключевое слово, включающее высокий уровень усилий и адаптивный reasoning на Opus. Используйте для архитектурных решений, сложной отладки и многошагового reasoning. Для переименования переменной не нужно — но для «спроектируй, как разделить этот монолит на сервисы» да.

8. Субагенты сохраняют основной контекст чистым

«Используй субагента, чтобы разобраться, как payment flow обрабатывает неудачные транзакции». Создаётся отдельный экземпляр Claude с собственным контекстным окном. Он исследует файлы, делает выводы и возвращает краткое резюме. Ваша основная сессия остаётся чистой.

Глубокое исследование может съесть половину контекстного окна — субагенты переносят эту стоимость в другое место. Используйте для: анализа незнакомого кода, выяснения как что-то работает, ревью больших changesets.

9. --worktree для изолированных параллельных веток

claude --worktree feature-auth создаёт изолированную рабочую копию с новой веткой. Запустите 2-3 worktree, каждый со своей сессией Claude. Команда Claude Code называет это одним из крупнейших продуктивных unlock-ов.

# Parallel work with worktrees:

# Terminal 1: feature
claude --worktree feature-user-profile

# Terminal 2: bug fix
claude --worktree fix-payment-timeout

# Terminal 3: refactoring
claude --worktree refactor-auth

# Each has its own branch, own files,
# own Claude session. Zero conflicts.

CLAUDE.md и конфигурация

10. Запустите /init, потом сократите результат вдвое

CLAUDE.md — markdown-файл в корне проекта с постоянными инструкциями. /init генерирует стартовую версию. Вывод обычно раздут. Если не можете объяснить, зачем строка нужна — удалите. Бюджет примерно 150-200 инструкций, после чего compliance начинает падать.

# CLAUDE.md — concise, effective version

## Stack
Next.js 16, TypeScript, Tailwind

## Commands
npm run dev    # dev server
npm run build  # production build
npm run lint   # ESLint
npm run test   # vitest

## Conventions
- Components: PascalCase
- Utilities: camelCase
- Tests: *.test.ts alongside source

## Important
- ALWAYS select_related in Django queries
- Auth: JWT + httpOnly cookies
- All APIs: { data, error, meta }

11. Когда Claude ошибается — скажите: «Обнови CLAUDE.md»

«Обнови CLAUDE.md, чтобы это не повторилось». Claude сам напишет правило. Следующая сессия будет автоматически ему следовать. Со временем ваш CLAUDE.md станет живым документом, сформированным реальными ошибками — не теоретическими правилами.

12. Hooks для того, что должно работать всегда

CLAUDE.md — рекомендательный: Claude следует ему примерно в 80% случаев. Hooks детерминистичны, 100%. Форматирование, линтинг, проверки безопасности — это в hooks. Советы и guidance — в CLAUDE.md.

• CLAUDE.md (рекомендательный, ~80% compliance): конвенции, советы, рекомендации, архитектурные решения
• Hooks (детерминистичные, 100%): форматирование, линтинг, детекция секретов, запуск тестов
• Rules (.claude/rules/): контекстные правила для специфических типов файлов

Сотрудничество и ревью

13. Пусть Claude вас расспросит

Вы знаете, что хотите построить, но не все детали. Скажите Claude: «Я хочу построить [описание]. Расспроси меня о технической реализации, пограничных случаях и компромиссах. Спрашивай, пока не покроем всё, потом напиши спецификацию в SPEC.md». Затем начните чистую сессию с готовой спецификацией.

14. Один Claude пишет, другой ревьюит

Первый Claude реализует фичу, второй ревьюит из чистого контекста как staff engineer. Ревьюер не знает о shortcuts реализации и оспорит каждый из них. Тот же принцип работает для TDD — сессия A пишет тесты, сессия B пишет код.

# Two-session workflow:

# Session 1 — implementation:
"Implement JWT auth middleware. Use
jsonwebtoken, httpOnly cookies, refresh
token rotation. Run tests."

# Session 2 — review (clean context):
"Review src/middleware/auth.ts as a staff
engineer. Focus on: security, edge
cases, error handling, maintainability.
Be critical."

15. После 2 исправлений одного и того же — начинайте заново

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

Заключение

Не нужны все 15 сразу. Выберите один совет, решающий то, что больше всего раздражало в последней сессии, и попробуйте завтра. Один усвоенный совет стоит больше, чем пятьдесят в закладках.

Хотите, чтобы ваша команда освоила эти советы на практике? Именно этому я учу на воркшопах — практическая работа с AI-инструментами на вашем собственном коде.