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

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

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

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

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

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

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

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

Замените /path/to/project на путь к вашему проекту.
2

Запустите Claude Code

3

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

4

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

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

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

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

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

2

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

3

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

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

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

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

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

2

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

3

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

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

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

Предположим, вам нужно обновить старый код для использования современных паттернов и практик. Для переноса всей кодовой базы на новый язык см. как Anthropic проводит крупномасштабные миграции кода с помощью Claude Code в блоге.
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

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

Чтобы найти сеанс позже, запустите claude --from-pr 1234 с номером вашего PR, который открывает средство выбора сеанса, отфильтрованное по сеансам, связанным с этим PR, или вставьте URL PR в средство выбора /resume. Claude Code связывает сеанс с PR, когда Claude создает его с помощью gh pr create или glab mr create, и когда Claude работает над существующим PR.
Просмотрите 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, или с помощью Alt+V на Windows и WSL
  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

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

Это включает содержимое файла в диалог, если оно укладывается в лимит токенов инструмента Read, по умолчанию 25 000 токенов. Текстовый файл размером более 256 КБ не включается.
2

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

3

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

Это получает данные из подключённых MCP серверов, используя формат @server:resource. См. MCP ресурсы для подробностей.
Советы:
  • Пути к файлам могут быть относительными или абсолютными
  • Введите @ для открытия меню предложений пути, затем нажмите Enter или Tab для принятия выделенного пути и снова Enter для отправки сообщения
  • Ссылки на файлы @ добавляют CLAUDE.md в каталог файла и родительские каталоги в контекст
  • Ссылки на каталоги показывают списки файлов, а не содержимое
  • Вы можете ссылаться на несколько файлов в одном сообщении (например, “@file1.js and @file2.js”)
Чтобы ссылки @ не включали содержимое файлов и списки каталогов, задайте для CLAUDE_CODE_DISABLE_FILE_MENTIONS значение 1 в вашей оболочке или в блоке env пользовательских настроек или управляемых настроек. Тогда Claude получает указанные вами пути с пометкой прочитать их с помощью своих файловых инструментов. Для этой переменной требуется Claude Code v2.1.299 или новее, и Claude Code игнорирует её в настройках проекта и локальных настройках. Ваши хуки PreToolUse не запускаются, когда Claude Code включает файл, на который вы ссылаетесь с помощью @, поскольку при этом не выполняется вызов инструмента. Если вы полагаетесь на эти хуки, чтобы контролировать, что читает Claude, заблокируйте определённые пути или запретите ссылкам @ включать файлы:
  • Заблокируйте определённые пути: добавьте для них правило запрета Read. Claude Code не включает файл, которому соответствует это правило.
  • Запретите ссылкам @ включать файлы: задайте CLAUDE_CODE_DISABLE_FILE_MENTIONS=1, что не позволяет ссылкам @ на файлы и каталоги в ваших сообщениях включать содержимое, даже для путей, которые ваши хуки не проверяют. Тогда соответствующие хуки запускаются до того, как Claude откроет указанный путь с помощью инструмента, такого как Read.

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

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

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

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

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

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

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

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

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

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

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

Для изменений, которые вы хотите просмотреть перед их записью на диск, переключитесь в режим плана. Claude читает файлы и предлагает план, но не вносит изменения, пока вы не одобрите. Строка состояния показывает ⏸ plan mode on во время активного режима плана.
Вы также можете нажать Shift+Tab во время сеанса до тех пор, пока строка состояния не покажет ⏸ plan mode on. См. 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