reymer.ai
Claude Code Best Practices

50 Лучших Практикдля Claude Code

От первых шагов до мастерства

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

1-10: Первые шаги11-20: Базовые навыки21-30: Средний уровень31-40: Продвинутый41-50: Мастер
50советов
5уровней
30терминов
~15мин чтения
50 Лучших Практик для Claude Code

“Самое важное, что вы должны знать с первой секунды: ESC останавливает Claude.”

— Совет №1 этого гайда

TL;DR: 50 Лучших Практик для Claude Code

Этот гайд содержит 50 проверенных практик для эффективной работы с Claude Code — CLI-инструментом от Anthropic. Советы организованы по 5 уровням сложности: от первых шагов (ESC, /help, /init) до мастерского уровня (мультиагентность, Hooks, MCP).

5 уровней сложности

  • Первые шаги (1-10): ESC, /help, /model, /init, CLAUDE.md, /clear, @file, /cost, ESC ESC
  • Базовые навыки (11-20): структура промптов, front loading, context bleed, правило двух исправлений
  • Средний уровень (21-30): верификация работы, Memory, rollback, Skills, версионирование
  • Продвинутый (31-40): Explore→Plan→Code, Tasks, Background Tasks, субагенты, /agents
  • Мастер (41-50): Model Stacking, Git Worktrees, Autonomous Mode, Hooks, MCP, плагины

Ключевые команды Claude Code

  • ESC — остановить Claude (самое важное!)
  • /init — создание CLAUDE.md
  • /clear — очистка контекста
  • /rewind или ESC ESC — откат к checkpoint
  • /cost — показать использование токенов
  • /agents — управление субагентами
  • Ctrl+B — фоновое выполнение задачи

Для опытных пользователей

Если вы уже используете Claude Code, начните с советов 21-30 (средний уровень) или сразу переходите к продвинутым техникам 31-40 (субагенты и мультиагентность).

Официальные ресурсы

  • Best Practices: code.claude.com/docs/en/best-practices
  • Features: code.claude.com/docs/en/features-overview
  • Costs: code.claude.com/docs/en/costs
  • Subagents: code.claude.com/docs/en/sub-agents
  • Academy: anthropic.com/learn

Уже используете Claude Code?

Если вы опытный пользователь, начните с советов 21-30 (средний уровень) или сразу переходите к продвинутым техникам 31-40. Советы 1-20 покрывают базовые команды и промптинг.

1-10
Советы 1-10

Первые шаги

Установка и базовые команды

1

Научитесь останавливать Claude — ESC

ESC

Самое важное, что вы должны знать с первой секунды: ESC останавливает Claude. Если видите, что он пошёл не туда, делает что-то странное или просто хотите прервать — жмите ESC. Это ваш главный инструмент контроля. Привыкните держать палец готовым.

См. также:#17#38
2

/help — изучите доступные команды

/help

Прежде чем что-то делать, посмотрите какие команды доступны. /help покажет полный список: /init, /clear, /cost, /model и другие. Потратьте 2 минуты на изучение — это сэкономит часы в будущем.

3

/model — проверьте какую модель используете

/model

Claude Code может работать с разными моделями: Sonnet (быстрый, дешёвый), Opus (умный, дорогой), Haiku (ультрабыстрый). Проверьте текущую модель командой /model. Для большинства задач Sonnet — оптимальный выбор.

См. также:#32
4

/init — создайте CLAUDE.md для проекта

/init

Это первое, что нужно сделать в любом проекте. Команда /init создаёт файл CLAUDE.md с базовой структурой. Без него Claude не знает контекст вашего проекта: стек технологий, структуру папок, правила кодирования.

5

Заполните CLAUDE.md — опишите проект

После /init откройте созданный CLAUDE.md и заполните его: опишите чем занимается проект, какие инструменты используете, как организованы файлы. Чем точнее описание — тем лучше Claude понимает контекст. См. совет 4 о создании файла.

# Мой проект

Это база знаний нашей компании.

## Структура
- /docs — статьи и документы
- /templates — шаблоны писем
- /reports — отчёты

## Правила
- Все даты в формате ДД.ММ.ГГГГ
- Имена файлов на русском
См. также:#4#11#15
6

Сделайте первый тест — создание файла

Прежде чем давать сложные задачи, проверьте что всё работает. Попросите Claude создать файл на диске — это покажет, что Claude Code работает правильно и имеет доступ к файловой системе.

// Примеры для проверки работы Claude Code:

"Создай файл test.txt с текстом 'Привет, Claude Code работает!'"

"Создай папку /notes и внутри файл ideas.md со списком из 5 пунктов"

"Прочитай файл README.md и выведи его первые 10 строк"
7

/clear — начинайте каждую новую задачу с чистого листа

/clear

Закончили одну задачу, начинаете другую? Используйте /clear. Это очищает контекст сессии, и Claude начинает «с чистого листа». Предотвращает путаницу между несвязанными задачами.

См. также:#16#18
8

@file — прикрепите файл к запросу

@file

Хотите чтобы Claude работал с конкретным файлом? Напишите @ и имя файла — Claude получит его содержимое. Это точнее, чем копировать текст вручную.

// Примеры работы с файлами:

"Прочитай @report.pdf и создай файл summary.md с ключевыми тезисами"

"Найди все email-адреса в @contacts.txt и сохрани в emails.csv"

"Проанализируй @sales.csv и создай отчёт с графиками в report.md"
9

/cost — следите за использованием токенов

/cost

Команда /cost показывает сколько токенов потрачено в сессии. Помогает понять когда контекст становится слишком большим. Если видите большие числа — возможно пора /clear.

10

ESC ESC — откатитесь назад

ESC ESC или /rewind

Двойное нажатие ESC открывает меню точек сохранения (или используйте /rewind). Вы можете вернуться к любому предыдущему состоянию сессии, если Claude пошёл не в том направлении. Это как отмена действия, но для целых блоков работы.

См. также:#1#23
11-20
Советы 11-20

Базовые навыки

Промптинг и настройка проекта

11

Структура CLAUDE.md — что включать

Хороший CLAUDE.md содержит: 1) О чём проект (1-2 предложения), 2) Какие инструменты используете, 3) Как организованы папки и файлы, 4) Важные правила (формат дат, стиль текста). Не перегружайте — только то, что Claude должен знать всегда.

12

Чёткая формулировка — начинайте с действия

Вместо расплывчатых запросов типа «помоги с файлами» пишите конкретно что создать, где сохранить, какой формат. Claude работает лучше, когда понимает точную цель с первых слов.

// Плохо:
"Помоги с документами"

// Хорошо:
"Прочитай все .txt файлы в папке /inbox, объедини их в один файл combined.md, добавь оглавление в начало, и сохрани в /processed"
13

Структура запроса: Роль + Задача + Контекст

Хороший запрос состоит из трёх частей: кем должен быть Claude (роль), что нужно сделать (задача), и какая дополнительная информация нужна (контекст). Это помогает Claude точнее понять ваши ожидания.

[Роль] Ты — архивариус, который организует документы

[Задача] Проанализируй все файлы в /documents, создай структуру папок по годам и темам, перемести файлы

[Контекст] Файлы названы хаотично, но внутри есть даты. Создай index.md со списком всех документов.
14

Важное — в начало запроса

Claude уделяет больше внимания началу вашего сообщения. Ставьте главные требования и ограничения в первые строки. Детали и примеры можно добавить позже.

// Хороший порядок:

"ВАЖНО: не удаляй оригиналы файлов, только копируй.

Собери все .pdf файлы из подпапок /projects, создай папку /archive/2024, скопируй туда всё и создай manifest.csv со списком."
15

Не перегружайте CLAUDE.md

Если Claude уже делает что-то правильно без явной инструкции — не добавляйте это в CLAUDE.md. Перегруженный файл конфигурации приводит к тому, что важные правила теряются в шуме. Добавляйте только то, что Claude забывает.

См. также:#5#11
16

Путаница контекста — почему важен /clear

Иногда Claude путает задачи: вы попросили написать письмо клиенту, а он использует информацию из прошлого разговора о другом клиенте. Это происходит когда контекст «загрязнён». Если Claude делает странные предположения — используйте /clear и начните заново.

См. также:#7#18
17

Корректируйте рано — ESC при первом отклонении

Момент когда Claude начинает идти не туда — жмите ESC чтобы остановить. Лучше скорректировать рано чем позволить накопиться ошибкам. Частые небольшие коррекции эффективнее редких больших. См. совет 1 о ESC.

См. также:#1#38
18

Правило двух исправлений

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

См. также:#7#16
19

Конкретика вместо общих фраз

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

// Плохо:
"Обработай эти документы"

// Хорошо:
"Найди все .md файлы в /notes, извлеки из каждого заголовки (строки с #), создай файл toc.md с оглавлением всех заметок, добавь ссылки на оригиналы."
20

/compact — сжимайте контекст вместо очистки

/compact

Когда контекст заполняется, но задача не закончена — используйте /compact вместо /clear. Claude сожмёт контекст, сохранив важную информацию и удалив избыточную. Важно: Claude делает это и автоматически при достижении лимита контекста. Риск авто-компактирования: если Claude сжимает контекст в неудачный момент, он может потерять важные детали задачи. Рекомендация: вызывайте /compact вручную между логическими этапами работы, чтобы контролировать что сохраняется.

См. также:#7#9
21-30
Советы 21-30

Средний уровень

Контекст, отладка, Skills

21

Дайте Claude способ проверить себя

Это один из самых действенных приёмов. Скажите Claude как проверить результат — и он сделает это сам. Укажите критерии успеха: количество файлов, формат, структуру.

"Создай структуру проекта для блога в папке /blog.

Проверь себя:
- Есть папки: /posts, /drafts, /images, /templates
- В /templates есть post-template.md с полями: title, date, tags, content
- Создан README.md с описанием структуры
- Все папки созданы и пустые файлы на месте

Если что-то не соответствует — исправь."
См. также:#36
22

Memory — редактируйте вкладку для контроля памяти

Вкладка Memory в Projects позволяет контролировать что Claude запоминает между сессиями. Добавляйте важные решения, удаляйте устаревшую информацию. Регулярно просматривайте и чистите.

23

Откатитесь к рабочему состоянию

Если после нескольких правок всё стало хуже — не пытайтесь чинить поверх. Откатитесь к последнему хорошему варианту через ESC ESC (см. совет 10) и вносите изменения по одному, чтобы понять где именно пошло не так.

См. также:#10
24

Исправляйте только проблемное место

Не нужно переделывать всё если ошибка в одном файле. Укажите на конкретный файл и строки, попросите Claude исправить только их. Это экономит время и токены.

"В файле config.json в строках 15-20 неправильный формат дат. Исправь на ISO формат YYYY-MM-DD, остальное не трогай."
25

Попросите Claude объяснить проблему

Если файлы созданы не так как ожидали или структура странная — попросите Claude объяснить почему. Часто это помогает найти ошибку в постановке задачи.

"Ты создал файлы в корне проекта, хотя я просил в /output. Объясни почему и перемести их в правильную папку."
26

Попросите объяснить пошагово

Не понимаете почему Claude организовал файлы именно так? Попросите объяснить шаг за шагом. Это помогает найти ошибки в логике и научиться новому.

"Объясни почему ты создал такую структуру папок. Пройди по каждой папке и файлу, объясни зачем они нужны."
27

Skills — сохраняйте удачные промпты для повторного использования

Skill — это сохранённый промпт в виде файла SKILL.md. Если вы нашли промпт, который отлично работает — создайте для него Skill. Больше не придётся вспоминать формулировку каждый раз.

// Создайте файл:
// ~/.claude/skills/summarize-pdfs/SKILL.md

---
name: summarize-pdfs
description: Создаёт summary для всех PDF
---

Прочитай все .pdf файлы в текущей папке,
извлеки текст, создай summary.md
с кратким содержанием каждого файла.

// Теперь вызывайте:
/summarize-pdfs
28

Skills из примеров — покажите что хотите получить

Самый простой способ создать Skill: покажите Claude пример результата и попросите создать SKILL.md файл с инструкциями для воспроизведения такого результата.

// Покажите пример:
"Вот пример хорошего отчёта @report-template.md.
Создай SKILL.md для генерации отчётов
в таком же формате."

// Claude создаст файл:
// .claude/skills/generate-report/SKILL.md
// с инструкциями на основе вашего примера
См. также:#27
29

Skills от скриншотов — покажите картинку вместо слов

Не можете объяснить словами структуру или формат? Сделайте скриншот. Claude понимает изображения и может создать Skill для воспроизведения структуры, формата таблиц, организации данных.

// Как использовать:
1. Сделайте скриншот структуры папок
2. Вставьте в Claude (Ctrl+V или перетащите)
3. Скажите: "Создай Skill, который создаёт
   такую же структуру папок"

// Работает для:
- Структуры проектов
- Форматов документов
- Шаблонов конфигов
См. также:#27#28
30

Сохраняйте старые версии навыков

Прежде чем улучшать работающий навык — сделайте его копию. Так вы не сломаете то, что уже работает. Называйте версии понятно: «ответ-клиенту-v1», «ответ-клиенту-v2».

См. также:#27
31-40
Советы 31-40

Продвинутый

Субагенты и мультиагентность

31

Изучи → Спланируй → Сделай

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

"Изучи все файлы в папке /data — какие там форматы, какая структура?

Составь план: как лучше организовать эти данные? Какую структуру папок создать?

После моего одобрения — реорганизуй файлы по плану."
32

Режим планирования — для сложных задач

Для больших задач используйте режим планирования. Claude сначала изучит файлы, составит план, и только после вашего «да» начнёт работу. Так вы не потратите время на неверное направление.

"Мне нужно реорганизовать проект: 50+ файлов в хаотичной структуре.

Войди в режим планирования:
1. Изучи все файлы и их содержимое
2. Предложи новую структуру папок
3. Покажи какие файлы куда переместятся

После моего одобрения — выполни реорганизацию."
См. также:#31
33

Задачи сохраняются между сессиями

Ваши задачи не исчезнут когда вы закроете Claude Code. Откройте через день — всё на месте. Удобно для долгих проектов: «написать книгу», «подготовить отчёт за квартал», «разобрать архив документов».

См. также:#34
34

Фоновые задачи — работайте параллельно

Ctrl+B

Нажмите Ctrl+B чтобы отправить задачу в фон. Claude будет работать над ней, а вы можете заняться другим. Получите уведомление когда готово. Удобно для долгих задач: анализ большого документа, генерация отчёта, обработка данных.

См. также:#33
35

/agents — помощники для отдельных задач

/agents

Субагенты — это как отдельные помощники. Каждый работает над своей задачей независимо. Главный Claude получает только краткий отчёт о результате. Команда /agents показывает всех помощников и позволяет создавать новых.

// Откройте интерфейс управления помощниками:
/agents

// Выберите "Create new agent" и опишите:
"Помощник для обработки PDF файлов.
Извлекает текст, создаёт краткое содержание,
сохраняет в .md формат"

// Claude сгенерирует конфигурацию помощника
// и сохранит в .claude/agents/
36

Помощники не засоряют основной разговор

Когда помощник работает над задачей, все его черновики и промежуточные мысли остаются у него. Вам возвращается только чистый результат. Это экономит место в основном разговоре. См. совет 35 о помощниках.

См. также:#35
37

Несколько помощников работают одновременно

Можно запустить 5 и больше помощников параллельно. Это полезно для обработки большого количества файлов: один помощник обрабатывает одну папку, другой — другую. Каждый работает независимо.

"У меня 100 PDF файлов в 5 папках.

Запусти 5 помощников параллельно:
- Первый обрабатывает /folder-1
- Второй обрабатывает /folder-2
- И так далее...

Каждый создаёт summary.md для своей папки.
Когда все закончат — объедини в общий index.md."
См. также:#35#36
38

Создайте своего помощника вручную

Можно создать помощника вручную через файл .md с YAML frontmatter. Укажите имя, описание, доступные инструменты и системный промпт — помощник будет всегда доступен.

// Создайте файл:
// .claude/agents/pdf-processor.md

---
name: pdf-processor
description: Обрабатывает PDF документы
tools: Read, Bash, Write
model: sonnet
---

Ты — помощник для обработки PDF файлов.

1. Извлекай текст из PDF
2. Создавай краткое содержание
3. Сохраняй в /processed/*.md
См. также:#35
39

Пусть Claude задаст вопросы

Для больших проектов по организации файлов начните с вопросов. Claude спросит про структуру, формат, исключения — и сделает работу точнее.

"Мне нужно организовать архив из 500 файлов.

Прежде чем начать — задай мне вопросы:
- По каким критериям сортировать?
- Какие форматы файлов есть?
- Нужны ли подпапки по годам/темам?
- Что делать с дубликатами?
- Куда складывать непонятные файлы?"
40

Настройте уровень доверия к помощникам

Помощники могут работать с разной степенью самостоятельности: спрашивать перед каждым действием с файлами, автоматически создавать/перемещать, или работать полностью автономно. Выбирайте в зависимости от рисков.

// Для безопасных операций (создание файлов):
"Создавай файлы без вопросов"

// Для рискованных операций (удаление, перемещение):
"Перед удалением или перемещением — покажи список и жди моего OK"
См. также:#35
41-50
Советы 41-50

Мастер

Автоматизация и масштабирование

41

Разные модели для разных задач

Используйте разные модели Claude для разных этапов. Быстрый Haiku — для простых операций (переименование, форматирование). Умный Opus — для сложных (анализ структуры, планирование). Это экономит деньги.

// Haiku (быстрый, дешёвый):
"Переименуй все файлы по шаблону: YYYY-MM-DD_название.ext"

// Sonnet (сбалансированный):
"Создай структуру папок и распредели файлы"

// Opus (умный, дорогой):
"Проанализируй содержимое всех документов и предложи систему классификации"
См. также:#3
42

Параллельные рабочие папки

Можно работать над несколькими версиями проекта одновременно. Создайте копию рабочей папки, запустите Claude в каждой — получите независимые сессии. Удобно когда хотите сравнить два разных подхода к организации.

// Пример: две версии структуры проекта

/project-v1/ — Claude организует по датам
/project-v2/ — Claude организует по категориям

Сравниваете результаты и выбираете лучшую структуру.
43

Автономный режим — для рутины

claude --dangerously-skip-permissions

Специальный режим когда Claude работает без вопросов и подтверждений. Используйте для простых повторяющихся операций с файлами. Будьте осторожны — Claude сделает всё сам без запроса подтверждения.

// Когда использовать автономный режим:

✓ Переименовать 100 файлов по шаблону
✓ Добавить header во все .md файлы
✓ Конвертировать формат дат в файлах

✗ Удалять файлы
✗ Перемещать важные данные
✗ Работать с конфигами
44

Hooks — автоматические действия

Hooks — это скрипты, которые запускаются автоматически при определённых событиях: перед/после использования инструмента, при запуске/остановке субагента. Настраиваются в settings.json.

// В settings.json:
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": [{
        "type": "command",
        "command": "./scripts/validate.sh"
      }]
    }]
  }
}

// Скрипт запустится после каждой записи файла
45

/plugin — готовые расширения

/plugin

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

46

Подключение внешних инструментов

/mcp

Claude можно подключить к вашим инструментам: базам данных, внутренним системам, специализированным сервисам. Команда /mcp показывает подключённые инструменты. Это для тех, кто хочет глубокую интеграцию.

47

Попросите оценить результат

После реорганизации файлов попросите Claude оценить результат по критериям. Это помогает найти слабые места в структуре.

"Ты создал структуру папок. Теперь оцени её:

1. Логичность иерархии (понятно ли где что искать?)
2. Глубина вложенности (не слишком ли глубоко?)
3. Названия папок (понятны ли они?)
4. Масштабируемость (можно ли добавлять новое?)

Что можно улучшить?"
48

Отдельная папка для экспериментов

Для рискованных экспериментов с файлами создайте отдельную папку-песочницу. Так вы не испортите основные данные и можете пробовать смело. Получилось хорошо — скопируйте в основной проект.

// Структура:

/data/             — основные файлы (не трогаем)
/data-sandbox/     — копия для экспериментов

В sandbox пробуете новую структуру папок.
Работает — применяете к /data.
Не работает — удаляете sandbox и пробуете иначе.
49

Официальные рекомендации от создателей

На сайте code.claude.com есть раздел с официальными рекомендациями от команды Anthropic. Периодически проверяйте — там появляются новые возможности и советы.

50

Бесплатные курсы от создателей Claude

На сайте anthropic.com/learn есть бесплатные курсы: основы работы с Claude, продвинутые техники, примеры использования. Когда освоите всё из этого гайда — там найдёте следующий уровень.

Глоссарий

30 терминов и команд

/init

Создать файл настроек CLAUDE.md для проекта

/clear

Очистить контекст — начать с чистого листа

/rewind

Откатиться к предыдущему состоянию (также ESC ESC)

/cost

Показать сколько потрачено в сессии

/plugin

Установить расширение из магазина

/help

Справка по командам Claude Code

/model

Переключить модель (Sonnet, Opus, Haiku)

/agents

Управление помощниками (субагентами)

/compact

Сжать контекст, сохранив важное

/context

Показать сколько места занято в контексте

/mcp

Управление подключёнными инструментами

@файл

Прикрепить файл к запросу

ESC

Остановить Claude

ESC ESC

Открыть меню отката (/rewind)

Ctrl+B

Отправить задачу в фоновое выполнение

CLAUDE.md

Файл с настройками и правилами для вашего проекта

Навыки (Skills)

SKILL.md файлы с сохранёнными промптами

Автодействия (Hooks)

Скрипты, запускаемые при событиях (PreToolUse, PostToolUse, SubagentStart)

Задачи (Tasks)

Список дел, который сохраняется между сессиями

Фоновые задачи

Задачи, которые выполняются пока вы занимаетесь другим

Помощники (субагенты)

Отдельные агенты для разных задач

Путаница контекста

Когда Claude смешивает разные задачи

Режим планирования

Claude сначала планирует, потом делает

Автономный режим

Claude работает без подтверждений

Уровни доверия

Насколько самостоятельно могут работать помощники

Важное в начало

Главные требования ставьте в начало запроса

Разные модели

Использование Haiku/Sonnet/Opus для разных задач

Точка сохранения

Состояние сессии, к которому можно вернуться

Параллельные папки

Несколько рабочих папок для разных версий

Изучи → Спланируй → Сделай

Правильный порядок работы над сложными задачами

Официальные ресурсы

Документация от Anthropic

Чеклист быстрого старта

7 шагов, которые нужно выполнить при первом запуске Claude Code

Прогресс настройки0 из 7

Совет: Этот чеклист — минимум для старта. Для глубокого изучения пройдите все 50 советов выше — от базовых команд до продвинутых техник мультиагентности.

«Привет, Мир!» для Claude Code

Ваш первый эксперимент — за 2 минуты

После прохождения чеклиста выше — попробуйте этот простой пример. Он покажет базовый цикл работы с Claude Code: дать задачу → подтвердить действие → проверить результат.

0 / 6

Что дальше? Попробуйте более сложные задачи: «Создай план на неделю», «Напиши письмо клиенту с благодарностью», «Проверь орфографию в документе». Claude Code справится!