Claude Code — это агент командной строки, который работает в вашем терминале, читает ваш репозиторий, редактирует файлы, выполняет команды и запрашивает подтверждение перед выполнением потенциально опасных действий. Он предназначен для помощи на каждом этапе жизненного цикла разработки программного обеспечения — от изучения незнакомой кодовой базы до развёртывания и поддержки production-кода.
В таблице ниже показано, где 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 один раз).
Пример запроса:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /pr-comments
https://github.com/acme/api/pull/4471<br /> > is the error handling
solid?</td> </tr> </tbody> </table>
Ожидаемый результат: 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. Превратите повторяющуюся задачу в команду с косой чертой
Когда использовать: Вы регулярно повторяете один и тот же многошаговый запрос (проверки перед коммитом, резюме стендапа, описания PR, примечания к выпуску) и хотите сделать его повторно используемым для всей команды.
Пример запроса:
> make me a /ship command 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 создаёт файл markdown в .claude/commands/. Команда /ship доступна немедленно, без перезагрузки, и общая для всех, кто клонирует репозиторий.
Справка: Команды с косой чертой
Приложение: Краткая справка
# | Вариант использования | Пример запроса |
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 перед внутренним распространением.