Распространённые рабочие процессы
Пошаговые руководства по изучению кодовых баз, исправлению ошибок, рефакторингу, тестированию и другим повседневным задачам с Claude Code.
На этой странице собраны короткие рецепты для повседневной разработки. Для получения более высокоуровневого руководства по подсказкам и управлению контекстом см. Лучшие практики.
На этой странице рассматриваются:
- Рецепты подсказок для изучения кода, исправления ошибок, рефакторинга, тестирования, PR и документации
- Возобновление предыдущих разговоров для того, чтобы задача могла охватывать несколько сеансов
- Запуск параллельных сеансов с worktrees для того, чтобы одновременные редактирования не конфликтовали
- Планирование перед редактированием для проверки изменений перед их записью на диск
- Делегирование исследований subagents для сохранения чистоты вашего основного контекста
- Передача Claude в скрипты для CI и пакетной обработки
Рецепты подсказок
Это паттерны подсказок для повседневных задач, таких как изучение незнакомого кода, отладка, рефакторинг, написание тестов и создание PR. Каждый работает на любой поверхности Claude Code; адаптируйте формулировку к вашему проекту.
Понимание новых кодовых баз
Для настройки Claude Code в монорепозитории или большой кодовой базе см. Монорепозитории и большие репозитории.
Получение быстрого обзора кодовой базы
Предположим, вы только что присоединились к новому проекту и вам нужно быстро понять его структуру.
Перейдите в корневой каталог проекта
cd /path/to/project
Запустите Claude Code
claude
Попросите высокоуровневый обзор
give me an overview of this codebase
Углубитесь в конкретные компоненты
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
Поиск релевантного кода
Предположим, вам нужно найти код, связанный с конкретной функцией или функциональностью.
Попросите Claude найти релевантные файлы
find the files that handle user authentication
Получите контекст о том, как компоненты взаимодействуют
how do these authentication files work together?
Поймите поток выполнения
trace the login process from front-end to database
Эффективное исправление ошибок
Предположим, вы столкнулись с сообщением об ошибке и вам нужно найти и исправить его источник.
Поделитесь ошибкой с Claude
I'm seeing an error when I run npm test
Попросите рекомендации по исправлению
suggest a few ways to fix the @ts-ignore in user.ts
Примените исправление
update user.ts to add the null check you suggested
Рефакторинг кода
Предположим, вам нужно обновить старый код для использования современных паттернов и практик.
Определите устаревший код для рефакторинга
find deprecated API usage in our codebase
Получите рекомендации по рефакторингу
suggest how to refactor utils.js to use modern JavaScript features
Примените изменения безопасно
refactor utils.js to use ES2024 features while maintaining the same behavior
Проверьте рефакторинг
run tests for the refactored code
Работа с тестами
Предположим, вам нужно добавить тесты для непокрытого кода.
Определите непротестированный код
find functions in NotificationsService.swift that are not covered by tests
Создайте каркас тестов
add tests for the notification service
Добавьте значимые тестовые случаи
add test cases for edge conditions in the notification service
Запустите и проверьте тесты
run the new tests and fix any failures
Claude может создавать тесты, которые следуют существующим паттернам и соглашениям вашего проекта. При запросе тестов будьте конкретны в отношении поведения, которое вы хотите проверить. Claude изучает ваши существующие файлы тестов, чтобы соответствовать стилю, фреймворкам и паттернам утверждений, уже используемым в проекте.
Для полного покрытия попросите Claude определить граничные случаи, которые вы могли пропустить. Claude может анализировать пути вашего кода и предлагать тесты для условий ошибок, граничных значений и неожиданных входных данных, которые легко упустить.
Создание pull requests
Вы можете создавать pull requests, попросив Claude напрямую ("create a pr for my changes"), или направить Claude пошагово:
Суммируйте ваши изменения
summarize the changes I've made to the authentication module
Создайте pull request
create a pr
Просмотрите и уточните
enhance the PR description with more context about the security improvements
Когда вы создаёте PR с помощью gh pr create, сеанс автоматически связывается с этим PR. Чтобы вернуться к нему позже, запустите claude --from-pr <number> или вставьте URL PR в средство выбора /resume.
Работа с документацией
Предположим, вам нужно добавить или обновить документацию для вашего кода.
Определите недокументированный код
find functions without proper JSDoc comments in the auth module
Создайте документацию
add JSDoc comments to the undocumented functions in auth.js
Просмотрите и улучшите
improve the generated documentation with more context and examples
Проверьте документацию
check if the documentation follows our project standards
Работа с заметками и папками, не содержащими код
Claude Code работает в любом каталоге. Запустите его внутри хранилища заметок, папки документации или любой коллекции файлов markdown для поиска, редактирования и переорганизации содержимого так же, как вы работаете с кодом.
Каталог .claude/ и CLAUDE.md находятся рядом с каталогами конфигурации других инструментов без конфликтов. Claude читает файлы заново при каждом вызове инструмента, поэтому он видит изменения, которые вы вносите в другом приложении при следующем чтении этого файла.
Работа с изображениями
Предположим, вам нужно работать с изображениями в вашей кодовой базе, и вы хотите помощь Claude в анализе содержимого изображения.
Добавьте изображение в разговор
Вы можете использовать любой из этих методов:
- Перетащите изображение в окно Claude Code
- Скопируйте изображение и вставьте его в CLI с помощью ctrl+v (не используйте cmd+v)
- Предоставьте Claude путь к изображению. Например, "Analyze this image: /path/to/your/image.png"
Попросите Claude проанализировать изображение
What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
Используйте изображения для контекста
Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
Получите предложения кода из визуального содержимого
Generate CSS to match this design mockup
What HTML structure would recreate this component?
Ссылка на файлы и каталоги
Используйте @ для быстрого включения файлов или каталогов без ожидания, пока Claude их прочитает.
Ссылка на один файл
Explain the logic in @src/utils/auth.js
Это включает полное содержимое файла в разговор.
Ссылка на каталог
What's the structure of @src/components?
Это предоставляет список каталогов с информацией о файлах.
Ссылка на MCP ресурсы
Show me the data from @github:repos/owner/repo/issues
Это получает данные из подключённых MCP серверов, используя формат @server:resource. См. MCP ресурсы для подробностей.
Запуск Claude по расписанию
Предположим, вы хотите, чтобы Claude автоматически выполнял задачу на повторяющейся основе, например просматривая открытые PR каждое утро, проверяя зависимости еженедельно или проверяя сбои CI в течение ночи.
Выберите вариант планирования на основе того, где вы хотите, чтобы задача выполнялась:
| Вариант | Где выполняется | Лучше всего для |
|---|---|---|
| Routines | Инфраструктура, управляемая Anthropic | Задачи, которые должны выполняться даже когда ваш компьютер выключен. Также может срабатывать на вызовы API или события GitHub в дополнение к расписанию. Настройте на claude.ai/code/routines. |
| Запланированные задачи рабочего стола | Ваша машина, через настольное приложение | Задачи, которым нужен прямой доступ к локальным файлам, инструментам или незафиксированным изменениям. |
| GitHub Actions | Ваш конвейер CI | Задачи, связанные с событиями репозитория, такими как открытые PR, или расписания cron, которые должны находиться рядом с конфигурацией рабочего процесса. |
/loop |
Текущий сеанс CLI | Быстрый опрос во время открытого сеанса. Задачи отменяются при начале нового разговора; --resume и --continue восстанавливают неистекшие. |
Спросите Claude о его возможностях
Claude имеет встроенный доступ к своей документации и может ответить на вопросы о своих собственных функциях и ограничениях.
Примеры вопросов
can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?
Возобновление предыдущих разговоров
Когда задача охватывает несколько сеансов, продолжайте с того места, где вы остановились, вместо того чтобы переобъяснять контекст. Claude Code сохраняет каждый разговор локально.
claude --continue
Это возобновляет самый последний сеанс в текущем каталоге; если его ещё нет, выводится No conversation found to continue и программа выходит. Используйте claude --resume для выбора из списка, или /resume из активного сеанса. См. Управление сеансами для именования, ветвления и полного справочника средства выбора.
Запуск параллельных сеансов с worktrees
Работайте над функцией в одном терминале, пока Claude исправляет ошибку в другом, без конфликтов редактирования. Каждый worktree — это отдельный checkout на своей собственной ветке.
claude --worktree feature-auth
Запустите ту же команду с другим именем во втором терминале для запуска изолированного параллельного сеанса. См. Worktrees для очистки, .worktreeinclude и поддержки VCS, не основанной на git. Для мониторинга параллельных сеансов с одного экрана вместо отдельных терминалов см. фоновые агенты.
Планирование перед редактированием
Для изменений, которые вы хотите просмотреть перед их записью на диск, переключитесь в режим плана. Claude читает файлы и предлагает план, но не вносит изменения, пока вы не одобрите.
claude --permission-mode plan
Вы также можете нажать Shift+Tab во время сеанса для переключения в режим плана. См. Plan Mode для потока одобрения и редактирования плана в вашем текстовом редакторе.
Делегирование исследований subagents
Изучение большой кодовой базы заполняет ваш контекст чтением файлов. Делегируйте исследование, чтобы только результаты вернулись.
use a subagent to investigate how our auth system handles token refresh
Subagent читает файлы в своём собственном контекстном окне и сообщает сводку. См. Subagents для определения пользовательских агентов с их собственными инструментами и подсказками.
Передача Claude в скрипты
Запустите Claude неинтерактивно для CI, pre-commit hooks или пакетной обработки. Stdin и stdout работают как любой Unix инструмент.
git log --oneline -20 | claude -p "summarize these recent commits"
См. Неинтерактивный режим для форматов вывода, флагов разрешений и паттернов fan-out.