Claude Code — это агент кодирования, который читает ваш репозиторий, редактирует файлы, выполняет команды и запрашивает подтверждение перед выполнением потенциально деструктивных действий. Он встроен в Claude Desktop и также работает в вашем терминале и поддерживаемых IDE. Он предназначен для помощи на каждом этапе жизненного цикла разработки программного обеспечения, от изучения незнакомой кодовой базы до развертывания и поддержки производственного кода.
В таблице ниже показано, где Claude Code вписывается в жизненный цикл разработки. В остальной части этой статьи рассматриваются десять задач, для которых разработчики чаще всего его используют, с примером запроса и ожидаемым результатом для каждой.
1. Исследование | 2. Проектирование | 3. Разработка | 4. Развертывание | 5. Поддержка и масштабирование |
Изучение кодовой базы и истории | Планирование проекта | Реализация кода | Автоматизация CI/CD | Отладка ошибок |
Поиск в документации | Разработка технических спецификаций | Написание и выполнение тестов | Настройка окружений | Крупномасштабный рефакторинг |
Адаптация и обучение | Определение архитектуры | Создание коммитов и PR | Управление развертываниями | Мониторинг использования и производительности |
Как использовать это руководство
Каждый случай использования ниже включает когда его использовать, пример запроса и ожидаемый результат. Никакая конфигурация не требуется ни для одного из них, кроме §9 (интеграция с трекером проблем), которая требует одноразовой настройки MCP коннектора.
Случаи использования упорядочены примерно по тому, как рано большинство разработчиков с ними сталкиваются. Выберите тот, который соответствует вашей текущей задаче.
Случаи использования
1. Исправление неудачного теста
Когда использовать: Тест не проходит, и причина не очевидна. Используйте это, чтобы Claude Code нашел корневую причину и предложил исправление, не требуя от вас предварительного определения исходного файла.
Пример запроса:
> the tests in tests/auth.test.ts are failing, can you figure out why and fix them
Ожидаемый результат: Claude Code читает файл теста, отслеживает путь кода через тестируемые модули, определяет несоответствие и предлагает редактирование. После вашего одобрения он повторно запускает набор тестов, чтобы подтвердить исправление.
2. Понимание незнакомого кода
Когда использовать: Вам нужно понять, как работает модуль, функция или подсистема, прежде чем вносить изменения — например, при наследовании кода или проверке незнакомой области.
Пример запроса:
> walk me through how the payment retry logic works
Ожидаемый результат: Claude Code находит соответствующие файлы, читает реализацию и объясняет поток управления простым языком: точки входа, ветвления решений, граничные случаи и то, как код связан с остальной системой. Задавайте уточняющие вопросы (например, «где устанавливается X»), чтобы углубиться дальше.
3. Поиск места возникновения события
Когда использовать: Вы знаете, что поведение существует в кодовой базе, но не можете найти его по имени файла или простому поиску текста.
Пример запроса:
> where do we validate email addresses in this codebase? I want to add a new rule
Ожидаемый результат: Claude Code ищет в репозитории, открывает файлы-кандидаты и возвращает пути файлов и номера строк с достаточным контекстом для определения правильного совпадения. Если существует несколько мест, он указывает, какое из них является источником истины.
4. Анализ ошибки или трассировки стека
Когда использовать: У вас есть ошибка выполнения, трассировка стека или вывод журнала, и вам нужно сопоставить его с ответственным кодом.
Пример запроса:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>
Ожидаемый результат: Claude Code читает файлы, указанные в трассировке, объясняет, что не определено и почему, и предлагает исправление. Для ошибок без чистой трассировки стека вставьте любой доступный вывод журнала, и Claude Code восстановит сбой из контекста.
5. Рефакторинг с планом
Когда использовать: Изменение охватывает несколько файлов, и вы хотите просмотреть полный объем перед внесением каких-либо изменений.
Предварительное условие: Нажимайте Shift+Tab до тех пор, пока индикатор режима не покажет «plan.»
Пример запроса:
> refactor the auth module to use the new session store instead of SessionCache
Ожидаемый результат: Claude Code анализирует код и создает нумерованный план, в котором перечислены все файлы, которые он будет изменять, и изменения в каждом. Вы можете одобрить план как есть или изменить его (например, «не трогайте маршрут выхода»). Никакие файлы не редактируются до вашего одобрения.
Справка: Разрешения
6. Написание тестов для существующего кода
Когда использовать: Исходный файл имеет недостаточное покрытие, или вам нужны дополнительные тесты граничных случаев, соответствующие соглашениям тестирования вашего проекта.
Пример запроса:
> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/
Ожидаемый результат: Claude Code читает исходный файл и справочный каталог тестов, генерирует новый файл тестов в существующем стиле и запускает его для проверки. Если остаются очевидные пробелы в покрытии, он их отмечает и спрашивает, нужно ли их устранить.
7. Проверка pull request
Когда использовать: Вам нужно проверить или суммировать PR, особенно в части кодовой базы, которую вы плохо знаете.
Предварительное условие: GitHub CLI аутентифицирован (запустите gh auth login один раз).
Пример запроса:
> /pr https://github.com/example/api/pull/4471
> is the error handling solid?
Ожидаемый результат: Claude Code получает diff, комментарии проверки и статус CI, затем читает изменённые файлы в полном контексте репозитория. Он может создать сфокусированную проверку, подготовить комментарии проверки, проверить конкретную проблему или суммировать PR.
8. Адаптация к новому репозиторию
Когда использовать: Вы работаете в репозитории впервые и вам нужен структурированный обзор его архитектуры, команд сборки и соглашений.
Пример запроса:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /init<br /> > give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>
Ожидаемый результат: /init сканирует проект и создаёт файл CLAUDE.md с описанием команд сборки, архитектуры и соглашений. Последующий запрос тура создаёт управляемый обход структуры проекта. Контекст проекта остаётся загруженным на протяжении всей сессии.
Справка: Память и CLAUDE.md
9. Решение задачи от начала до конца
Когда использовать: Вы хотите прочитать задачу, реализовать исправление и проверить его в одном разговоре без переключения инструментов.
Предварительное условие: Трекер задач подключен через MCP (одноразовая конфигурация .mcp.json).
Пример запроса:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> what's the top-priority issue assigned
to me?<br /> > go ahead and fix it</td> </tr> </tbody> </table>
Ожидаемый результат: Claude Code запрашивает трекер задач, читает задачу, находит соответствующий код, предлагает исправление и запускает тесты. Сессия завершается проверяемым diff и контекстом для закрытия задачи.
Справка: MCP
10. Превращение повторяющейся задачи в Skill
Когда использовать: Вы регулярно повторяете один и тот же многошаговый запрос (проверки перед коммитом, сводки стендапа, описания PR, заметки о выпуске) и хотите сделать его переиспользуемым для всей команды.
Пример запроса:
> make me a /ship skill that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing
Ожидаемый результат: Claude Code создаёт файл SKILL.md в .claude/skills/ship/. Команда /ship доступна сразу же, без перезагрузки, и доступна всем, кто клонирует репозиторий. (Устаревший путь .claude/commands/ по-прежнему поддерживается, но skills — рекомендуемая форма.)
Справка: Skills
Приложение: Краткая справка
# | Вариант использования | Пример запроса |
1 | Исправление неудачного теста |
|
2 | Понимание незнакомого кода |
|
3 | Поиск места выполнения действия |
|
4 | Анализ ошибки | Вставьте трассировку стека, затем спросите: |
5 | Рефакторинг с планом | Shift+Tab → режим плана → опишите рефакторинг |
6 | Написание тестов |
|
7 | Проверка PR |
|
8 | Подключиться к репозиторию |
|
9 | Решить задачу от начала до конца |
|
10 | Создать навык |
|
Приложение: Справочник ресурсов
Ресурс | Ссылка |
Быстрый старт | |
Типичные рабочие процессы | |
Разрешения | |
Память и | |
Коннекторы MCP | |
Навыки | |
Встроенные команды |
Подробнее о /init, @-ссылках, режимах разрешений, навыках, MCP и хуках см. code.claude.com/docs. Claude Code обновляется часто — проверьте детали версии на code.claude.com/docs перед внутренним распространением.
