Skip to main content
На этой странице собраны короткие рецепты для повседневной разработки. Для получения более высокоуровневого руководства по подсказкам и управлению контекстом см. Лучшие практики. На этой странице рассматриваются:

Рецепты подсказок

Это паттерны подсказок для повседневных задач, таких как изучение незнакомого кода, отладка, рефакторинг, написание тестов и создание PR. Каждый работает на любой поверхности Claude Code; адаптируйте формулировку к вашему проекту.

Понимание новых кодовых баз

Для настройки Claude Code в монорепозитории или большой кодовой базе см. Монорепозитории и большие репозитории.

Получение быстрого обзора кодовой базы

Предположим, вы только что присоединились к новому проекту и вам нужно быстро понять его структуру.
1

Перейдите в корневой каталог проекта

2

Запустите Claude Code

3

Попросите высокоуровневый обзор

4

Углубитесь в конкретные компоненты

Советы:
  • Начните с широких вопросов, затем сужайте до конкретных областей
  • Спросите о соглашениях кодирования и паттернах, используемых в проекте
  • Запросите глоссарий терминов, специфичных для проекта

Поиск релевантного кода

Предположим, вам нужно найти код, связанный с конкретной функцией или функциональностью.
1

Попросите Claude найти релевантные файлы

2

Получите контекст о том, как компоненты взаимодействуют

3

Поймите поток выполнения

Советы:
  • Будьте конкретны в том, что вы ищете
  • Используйте предметный язык из проекта
  • Установите плагин анализа кода для вашего языка, чтобы дать Claude точную навигацию “перейти к определению” и “найти ссылки”

Эффективное исправление ошибок

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

Поделитесь ошибкой с Claude

2

Попросите рекомендации по исправлению

3

Примените исправление

Советы:
  • Скажите Claude команду для воспроизведения проблемы и получите трассировку стека
  • Упомяните любые шаги для воспроизведения ошибки
  • Дайте Claude знать, является ли ошибка прерывистой или постоянной

Рефакторинг кода

Предположим, вам нужно обновить старый код для использования современных паттернов и практик.
1

Определите устаревший код для рефакторинга

2

Получите рекомендации по рефакторингу

3

Примените изменения безопасно

4

Проверьте рефакторинг

Советы:
  • Попросите Claude объяснить преимущества современного подхода
  • Запросите, чтобы изменения сохраняли обратную совместимость при необходимости
  • Выполняйте рефакторинг небольшими, тестируемыми шагами

Работа с тестами

Предположим, вам нужно добавить тесты для непокрытого кода.
1

Определите непротестированный код

2

Создайте каркас тестов

3

Добавьте значимые тестовые случаи

4

Запустите и проверьте тесты

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

Создание pull requests

Вы можете создавать pull requests, попросив Claude напрямую (“create a pr for my changes”), или направить Claude пошагово:
1

Суммируйте ваши изменения

2

Создайте pull request

3

Просмотрите и уточните

Когда вы создаёте PR с помощью gh pr create, сеанс автоматически связывается с этим PR. Чтобы вернуться к нему позже, запустите claude --from-pr 123, заменив 123 номером PR, или вставьте URL PR в средство выбора /resume.
Просмотрите PR, созданный Claude, перед отправкой и попросите Claude выделить потенциальные риски или соображения.

Работа с документацией

Предположим, вам нужно добавить или обновить документацию для вашего кода.
1

Определите недокументированный код

2

Создайте документацию

3

Просмотрите и улучшите

4

Проверьте документацию

Советы:
  • Укажите стиль документации, который вы хотите (JSDoc, docstrings и т.д.)
  • Попросите примеры в документации
  • Запросите документацию для публичных API, интерфейсов и сложной логики

Работа с заметками и папками, не содержащими код

Claude Code работает в любом каталоге. Запустите его внутри хранилища заметок, папки документации или любой коллекции файлов markdown для поиска, редактирования и переорганизации содержимого так же, как вы работаете с кодом. Каталог .claude/ и CLAUDE.md находятся рядом с каталогами конфигурации других инструментов без конфликтов. Claude читает файлы заново при каждом вызове инструмента, поэтому он видит изменения, которые вы вносите в другом приложении при следующем чтении этого файла.

Работа с изображениями

Предположим, вам нужно работать с изображениями в вашей кодовой базе, и вы хотите помощь Claude в анализе содержимого изображения.
1

Добавьте изображение в разговор

Вы можете использовать любой из этих методов:
  1. Перетащите изображение в окно Claude Code
  2. Скопируйте изображение и вставьте его в CLI с помощью Ctrl+V. На macOS, Cmd+V также работает в iTerm2.
  3. Предоставьте Claude путь к изображению. Например, “Analyze this image: /path/to/your/image.png”
2

Попросите Claude проанализировать изображение

3

Используйте изображения для контекста

4

Получите предложения кода из визуального содержимого

Советы:
  • Используйте изображения, когда текстовые описания были бы неясными или громоздкими
  • Включайте скриншоты ошибок, дизайны пользовательского интерфейса или диаграммы для лучшего контекста
  • Вы можете работать с несколькими изображениями в разговоре
  • Анализ изображений работает с диаграммами, скриншотами, макетами и многим другим
  • Когда Claude ссылается на изображения (например, [Image #1]), Cmd+Click (Mac) или Ctrl+Click (Windows/Linux) ссылку для открытия изображения в вашем средстве просмотра по умолчанию

Ссылка на файлы и каталоги

Используйте @ для быстрого включения файлов или каталогов без ожидания, пока Claude их прочитает.
1

Ссылка на один файл

Это включает полное содержимое файла в разговор.
2

Ссылка на каталог

Это предоставляет список каталогов с информацией о файлах.
3

Ссылка на MCP ресурсы

Это получает данные из подключённых MCP серверов, используя формат @server:resource. См. MCP ресурсы для подробностей.
Советы:
  • Пути к файлам могут быть относительными или абсолютными
  • Ссылки на файлы @ добавляют CLAUDE.md в каталог файла и родительские каталоги в контекст
  • Ссылки на каталоги показывают списки файлов, а не содержимое
  • Вы можете ссылаться на несколько файлов в одном сообщении (например, “@file1.js and @file2.js”)

Запуск Claude по расписанию

Предположим, вы хотите, чтобы Claude автоматически выполнял задачу на повторяющейся основе, например просматривая открытые PR каждое утро, проверяя зависимости еженедельно или проверяя сбои CI в течение ночи. Выберите вариант планирования на основе того, где вы хотите, чтобы задача выполнялась:
При написании подсказок для запланированных задач будьте явны в отношении того, что означает успех и что делать с результатами. Задача выполняется автономно, поэтому она не может задавать уточняющие вопросы. Например: “Просмотрите открытые PR с меткой needs-review, оставьте встроенные комментарии по любым проблемам и опубликуйте сводку в канале #eng-reviews Slack.”

Спросите Claude о его возможностях

Claude имеет встроенный доступ к своей документации и может ответить на вопросы о своих собственных функциях и ограничениях.

Примеры вопросов

Claude предоставляет ответы на основе документации на эти вопросы. Для исполняемых примеров запустите /powerup для интерактивных уроков с анимированными демонстрациями, или обратитесь к конкретным разделам рабочих процессов выше.
Советы:
  • Claude всегда имеет доступ к последней документации Claude Code, независимо от версии, которую вы используете
  • Задавайте конкретные вопросы для получения подробных ответов
  • Claude может объяснить сложные функции, такие как интеграция MCP, конфигурации предприятия и продвинутые рабочие процессы

Возобновление предыдущих разговоров

Когда задача охватывает несколько сеансов, продолжайте с того места, где вы остановились, вместо того чтобы переобъяснять контекст. Claude Code сохраняет каждый разговор локально.
Это возобновляет самый последний сеанс в текущем каталоге; если его ещё нет, выводится No conversation found to continue и программа выходит. Используйте claude --resume для выбора из списка, или /resume из активного сеанса. См. Управление сеансами для именования, ветвления и полного справочника средства выбора.

Запуск параллельных сеансов с worktrees

Работайте над функцией в одном терминале, пока Claude исправляет ошибку в другом, без конфликтов редактирования. Каждый worktree — это отдельный checkout на своей собственной ветке.
Запустите ту же команду с другим именем во втором терминале для запуска изолированного параллельного сеанса. См. Worktrees для очистки, .worktreeinclude и поддержки VCS, не основанной на git. Для мониторинга параллельных сеансов с одного экрана вместо отдельных терминалов см. фоновые агенты.

Планирование перед редактированием

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

Делегирование исследований subagents

Изучение большой кодовой базы заполняет ваш контекст чтением файлов. Делегируйте исследование, чтобы только результаты вернулись.
Subagent читает файлы в своём собственном контекстном окне и сообщает сводку. См. Subagents для определения пользовательских агентов с их собственными инструментами и подсказками.

Передача Claude в скрипты

Запустите Claude неинтерактивно для CI, pre-commit hooks или пакетной обработки. Stdin и stdout работают как любой Unix инструмент.
См. Неинтерактивный режим для форматов вывода, флагов разрешений и паттернов fan-out.

Следующие шаги

Лучшие практики

Паттерны для получения максимума от Claude Code

Управление сеансами

Возобновление, именование и ветвление разговоров

Worktrees

Запуск изолированных параллельных сеансов

Расширение Claude Code

Добавление skills, hooks, MCP, subagents и plugins