Лучшие практики работы с Claude Code

Зачем: Эти простые правила помогут работать с Claude эффективнее и избежать типичных проблем.

1. Один чат = одна задача

Закончили делать одну фичу — напишите /clear и начните новый чат для следующей.

Почему:

• Длинные чаты тратят больше токенов

• Claude может "запутаться" в контексте разных задач

• Чистый чат = свежий взгляд на новую задачу

2. Упоминайте файлы через @

Когда хотите чтобы Claude прочитал конкретный файл — упомяните его через @:

Посмотри @src/components/Button.tsx и исправь стили

Как быстро получить путь к файлу:

1. В VS Code или Cursor найдите файл в левом сайдбаре

1. Кликните правой кнопкой мыши

1. Выберите "Copy Relative Path"

1. Вставьте в чат с @ перед путём

3. Сохраняйте прогресс в файлах

Важные решения, структуру проекта, что уже сделано — сохраняйте в файлах проекта.

Почему: Когда начнёте новый чат, Claude сможет прочитать эти файлы и продолжить с того места, где остановились.

Пример: Попросите Claude создать файл [PROGRESS.md](http://PROGRESS.md) с чекбоксами и описанием что уже сделано.

4. Описывайте проблему через ожидание и реальность

Когда что-то не работает, опишите:

• Что вы ожидаете

• Что происходит на самом деле

Плохо:

Кнопка не работает

Хорошо:

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

Сейчас при клике ничего не происходит.

5. Показывайте ошибки и скриншоты

Claude понимает ошибки лучше, когда видит их целиком.

Ошибки в терминале:

• Скопируйте весь текст ошибки и вставьте в чат

Ошибки на веб-сайте:

• Откройте консоль браузера: нажмите F12 (или Cmd+Option+I на Mac)

• Перейдите на вкладку "Console"

• Скопируйте красные сообщения об ошибках

Скриншоты:

• Можно просто вставить скриншот в чат — Claude его увидит и поймёт

6. Просите Claude исследовать

Claude умеет искать информацию в интернете. Используйте это:

Погугли как сделать анимацию появления в CSS

Исследуй лучшие практики авторизации через Google

Найди лучшие практики для структуры React-проекта в 2026

7. Описывайте результат, а не действия

Claude лучше работает с декларативными запросами — когда вы описываете желаемый результат, а не конкретные шаги.

Принцип: Говорите ЧТО хотите получить, а не КАК это делать.

Примеры:

Императивно (хуже)

Создай файл bot.py, напиши там класс TelegramBot, добавь метод parse_channel...

Декларативно (лучше) Мне нужен телеграм-бот, который собирает посты из списка каналов и сохраняет их в базу

Почему это работает:

• Claude сам выберет лучший способ реализации

• Вы не ограничиваете его своими представлениями о решении

• Меньше шансов получить не то, что нужно

Можно давать референсы:

• Ссылки на сайты: "Сделай как на stripe.com"

• Скриншоты: вставьте картинку с примером

• Описание поведения: "Как в Instagram когда лайкаешь пост"