Руководства по Claude Code
Практические примеры и шаблоны для эффективного использования Claude Code в вашем процессе разработки.
Это руководство предоставляет пошаговые инструкции для типовых рабочих процессов с Claude Code. Каждое руководство включает четкие инструкции, примеры команд и лучшие практики, которые помогут вам максимально эффективно использовать Claude Code.
Содержание
- Понимание новых кодовых баз
- Эффективное исправление ошибок
- Рефакторинг кода
- Работа с тестами
- Создание пул-реквестов
- Работа с документацией
- Работа с изображениями
- Использование расширенного мышления
- Настройка памяти проекта
- Настройка Model Context Protocol (MCP)
- Использование Claude как unix-утилиты
- Создание пользовательских слэш-команд
Понимание новых кодовых баз
Получение быстрого обзора кодовой базы
Когда использовать: Вы только что присоединились к новому проекту и нуждаетесь в быстром понимании его структуры.
Перейдите в корневую директорию проекта
Запустите Claude Code
Запросите общий обзор
Углубитесь в конкретные компоненты
Советы:
- Начинайте с общих вопросов, затем переходите к конкретным областям
- Спрашивайте о соглашениях по кодированию и шаблонах, используемых в проекте
- Запросите глоссарий специфических для проекта терминов
Поиск релевантного кода
Когда использовать: Вам нужно найти код, связанный с определенной функциональностью или возможностью.
Попросите Claude найти релевантные файлы
Получите контекст о взаимодействии компонентов
Поймите поток выполнения
Советы:
- Будьте конкретны в том, что ищете
- Используйте предметную терминологию проекта
Эффективное исправление ошибок
Диагностика сообщений об ошибках
Когда использовать: Вы столкнулись с сообщением об ошибке и нужно найти и исправить её источник.
Поделитесь ошибкой с Claude
Запросите рекомендации по исправлению
Примените исправление
Советы:
- Сообщите Claude команду для воспроизведения проблемы и получения стека вызовов
- Упомяните шаги для воспроизведения ошибки
- Дайте Claude знать, является ли ошибка периодической или постоянной
Рефакторинг кода
Модернизация устаревшего кода
Когда использовать: Вам нужно обновить старый код для использования современных паттернов и практик.
Определите устаревший код для рефакторинга
Получите рекомендации по рефакторингу
Безопасно примените изменения
Проверьте рефакторинг
Советы:
- Попросите Claude объяснить преимущества современного подхода
- При необходимости запросите сохранение обратной совместимости
- Выполняйте рефакторинг небольшими, тестируемыми частями
Работа с тестами
Добавление тестового покрытия
Когда использовать: Вам нужно добавить тесты для непокрытого кода.
Определите непротестированный код
Сгенерируйте каркас тестов
Добавьте значимые тестовые случаи
Запустите и проверьте тесты
Советы:
- Запросите тесты, охватывающие граничные случаи и условия ошибок
- При необходимости запросите как модульные, так и интеграционные тесты
- Попросите Claude объяснить стратегию тестирования
Создание пул-реквестов
Создание комплексных PR
Когда использовать: Вам нужно создать хорошо документированный пул-реквест для ваших изменений.
Подведите итог вашим изменениям
Сгенерируйте PR с помощью Claude
Просмотрите и улучшите
Добавьте детали тестирования
Советы:
- Попросите Claude напрямую создать PR для вас
- Просмотрите сгенерированный Claude PR перед отправкой
- Попросите Claude выделить потенциальные риски или соображения
Работа с документацией
Генерация документации кода
Когда использовать: Вам нужно добавить или обновить документацию для вашего кода.
Определите недокументированный код
Сгенерируйте документацию
Просмотрите и улучшите
Проверьте документацию
Советы:
- Укажите желаемый стиль документации (JSDoc, docstrings и т.д.)
- Запросите примеры в документации
- Запросите документацию для публичных API, интерфейсов и сложной логики
Работа с изображениями
Анализ изображений и скриншотов
Когда использовать: Вам нужно работать с изображениями в вашей кодовой базе или получить помощь Claude в анализе содержимого изображений.
Добавьте изображение в разговор
Вы можете использовать любой из этих методов:
Попросите Claude проанализировать изображение
Используйте изображения для контекста
Получите предложения по коду из визуального контента
Советы:
- Используйте изображения, когда текстовые описания были бы неясными или громоздкими
- Включайте скриншоты ошибок, UI-дизайнов или диаграмм для лучшего контекста
- Вы можете работать с несколькими изображениями в разговоре
- Анализ изображений работает с диаграммами, скриншотами, макетами и многим другим
Использование расширенного мышления
Используйте расширенное мышление Claude для сложных задач
Когда использовать: При работе над сложными архитектурными решениями, сложными ошибками или планированием многоэтапных реализаций, требующих глубокого рассуждения.
Предоставьте контекст и попросите Claude подумать
Claude соберет релевантную информацию из вашей кодовой базы и использует расширенное мышление, которое будет видно в интерфейсе.
Уточните мышление с помощью дополнительных запросов
Советы для получения максимальной пользы от расширенного мышления:
Расширенное мышление наиболее ценно для сложных задач, таких как:
- Планирование сложных архитектурных изменений
- Отладка сложных проблем
- Создание планов реализации новых функций
- Понимание сложных кодовых баз
- Оценка компромиссов между различными подходами
Способ запроса мышления приводит к различным уровням глубины мышления:
- “think” запускает базовое расширенное мышление
- усиливающие фразы, такие как “think more”, “think a lot”, “think harder” или “think longer” запускают более глубокое мышление
Для получения дополнительных советов по запросу расширенного мышления см. Советы по расширенному мышлению.
Claude будет отображать свой процесс мышления курсивным серым текстом над ответом.
Настройка памяти проекта
Создание эффективного файла CLAUDE.md
Когда использовать: Вы хотите настроить файл CLAUDE.md для хранения важной информации о проекте, соглашений и часто используемых команд.
Создайте CLAUDE.md для вашей кодовой базы
Советы:
- Включите часто используемые команды (сборка, тестирование, линтинг), чтобы избежать повторных поисков
- Документируйте предпочтения по стилю кода и соглашения по именованию
- Добавьте важные архитектурные паттерны, специфичные для вашего проекта
- Вы можете добавить файлы CLAUDE.md в любое из:
- Папка, в которой вы запускаете Claude: Автоматически добавляется к разговорам, которые вы начинаете в этой папке
- Дочерние директории: Claude подтягивает их по требованию
- ~/.claude/CLAUDE.md: Пользовательские предпочтения, которые вы не хотите включать в систему контроля версий
Настройка Model Context Protocol (MCP)
Model Context Protocol (MCP) - это открытый протокол, который позволяет LLM получать доступ к внешним инструментам и источникам данных. Для получения дополнительной информации см. документацию MCP.
Используйте сторонние MCP-серверы на свой страх и риск. Убедитесь, что вы доверяете MCP-серверам, и будьте особенно осторожны при использовании MCP-серверов, которые общаются с интернетом, так как они могут подвергнуть вас риску внедрения промптов.
Настройка MCP-серверов
Когда использовать: Вы хотите расширить возможности Claude, подключив его к специализированным инструментам и внешним серверам с помощью Model Context Protocol.
Добавьте MCP Stdio Server
Управляйте вашими MCP-серверами
Советы:
- Используйте флаг
-s
или--scope
для указания места хранения конфигурации:local
(по умолчанию): Доступно только вам в текущем проекте (раньше называлосьproject
)project
: Доступно всем в проекте через файл.mcp.json
user
: Доступно вам во всех проектах (раньше называлосьglobal
)
- Установите переменные окружения с помощью флагов
-e
или--env
(например,-e KEY=value
) - Настройте таймаут запуска MCP-сервера с помощью переменной окружения MCP_TIMEOUT (например,
MCP_TIMEOUT=10000 claude
устанавливает 10-секундный таймаут) - Проверяйте статус MCP-сервера в любое время с помощью команды
/mcp
в Claude Code - MCP следует клиент-серверной архитектуре, где Claude Code (клиент) может подключаться к нескольким специализированным серверам
Понимание областей видимости MCP-серверов
Когда использовать: Вы хотите понять, как работают различные области видимости MCP и как делиться серверами с вашей командой.
MCP-серверы с локальной областью видимости
Область видимости по умолчанию (local
) хранит конфигурации MCP-серверов в ваших пользовательских настройках проекта. Эти серверы доступны только вам при работе в текущем проекте.
MCP-серверы с областью видимости проекта (.mcp.json)
Серверы с областью видимости проекта хранятся в файле .mcp.json
в корне вашего проекта. Этот файл должен быть добавлен в систему контроля версий для совместного использования серверов с вашей командой.
Это создает или обновляет файл .mcp.json
со следующей структурой:
MCP-серверы с пользовательской областью видимости
Серверы с пользовательской областью видимости доступны вам во всех проектах на вашей машине и являются приватными для вас.
Советы:
- Серверы с локальной областью видимости имеют приоритет над серверами с областью видимости проекта и пользователя с тем же именем
- Серверы с областью видимости проекта (в
.mcp.json
) имеют приоритет над серверами с пользовательской областью видимости с тем же именем - Перед использованием серверов с областью видимости проекта из
.mcp.json
Claude Code попросит вас одобрить их для безопасности - Файл
.mcp.json
предназначен для добавления в систему контроля версий для совместного использования MCP-серверов с вашей командой - Серверы с областью видимости проекта облегчают обеспечение доступа всех членов команды к одним и тем же инструментам MCP
- Если вам нужно сбросить ваш выбор включенных или отключенных серверов с областью видимости проекта, используйте команду
claude mcp reset-project-choices
Подключение к Postgres MCP-серверу
Когда использовать: Вы хотите предоставить Claude доступ только для чтения к базе данных PostgreSQL для запросов и проверки схемы.
Добавьте Postgres MCP-сервер
Запрашивайте вашу базу данных с помощью Claude
Советы:
- Postgres MCP-сервер предоставляет доступ только для чтения в целях безопасности
- Claude может помочь вам исследовать структуру базы данных и выполнять аналитические запросы
- Вы можете использовать это для быстрого понимания схем баз данных в незнакомых проектах
- Убедитесь, что ваша строка подключения использует соответствующие учетные данные с минимально необходимыми разрешениями
Добавление MCP-серверов из JSON-конфигурации
Когда использовать: У вас есть JSON-конфигурация для одного MCP-сервера, который вы хотите добавить в Claude Code.
Добавьте MCP-сервер из JSON
Проверьте, что сервер был добавлен
Советы:
- Убедитесь, что JSON правильно экранирован в вашей оболочке
- JSON должен соответствовать схеме конфигурации MCP-сервера
- Вы можете использовать
-s global
для добавления сервера в вашу глобальную конфигурацию вместо конфигурации, специфичной для проекта
Импорт MCP-серверов из Claude Desktop
Когда использовать: Вы уже настроили MCP-серверы в Claude Desktop и хотите использовать те же серверы в Claude Code без ручной перенастройки.
Импортируйте серверы из Claude Desktop
Выберите, какие серверы импортировать
После выполнения команды вы увидите интерактивный диалог, который позволит вам выбрать, какие серверы вы хотите импортировать.
Проверьте, что серверы были импортированы
Советы:
- Эта функция работает только на macOS и Windows Subsystem for Linux (WSL)
- Она читает файл конфигурации Claude Desktop из его стандартного расположения на этих платформах
- Используйте флаг
-s global
для добавления серверов в вашу глобальную конфигурацию - Импортированные серверы будут иметь те же имена, что и в Claude Desktop
- Если серверы с теми же именами уже существуют, они получат числовой суффикс (например,
server_1
)
Использование Claude Code как MCP-сервера
Когда использовать: Вы хотите использовать сам Claude Code как MCP-сервер, к которому могут подключаться другие приложения, предоставляя им инструменты и возможности Claude.
Запустите Claude как MCP-сервер
Подключитесь из другого приложения
Вы можете подключиться к MCP-серверу Claude Code из любого MCP-клиента, например Claude Desktop. Если вы используете Claude Desktop, вы можете добавить MCP-сервер Claude Code, используя эту конфигурацию:
Советы:
- Сервер предоставляет доступ к инструментам Claude, таким как View, Edit, LS и др.
- В Claude Desktop попробуйте попросить Claude читать файлы в директории, делать правки и многое другое
- Обратите внимание, что этот MCP-сервер просто предоставляет инструменты Claude Code вашему MCP-клиенту, поэтому ваш собственный клиент отвечает за реализацию подтверждения пользователем для отдельных вызовов инструментов
Использование Claude как unix-утилиты
Добавление Claude в процесс верификации
Когда использовать: Вы хотите использовать Claude Code как линтер или код-ревьюер.
Шаги:
Добавьте Claude в ваш скрипт сборки
Передача данных через пайпы
Когда использовать: Вы хотите передать данные в Claude и получить обратно данные в структурированном формате.
Передайте данные через Claude
Создание пользовательских слэш-команд
Claude Code поддерживает пользовательские слэш-команды, которые вы можете создавать для быстрого выполнения определенных промптов или задач.
Создание команд, специфичных для проекта
Когда использовать: Вы хотите создать многоразовые слэш-команды для вашего проекта, которые могут использовать все члены команды.
Создайте директорию команд в вашем проекте
Создайте Markdown-файл для каждой команды
Используйте вашу пользовательскую команду в Claude Code
Советы:
- Имена команд получаются из имени файла (например,
optimize.md
становится/project:optimize
) - Вы можете организовывать команды в поддиректориях (например,
.claude/commands/frontend/component.md
становится/project:frontend:component
) - Команды проекта доступны всем, кто клонирует репозиторий
- Содержимое Markdown-файла становится промптом, отправляемым Claude при вызове команды
Добавление аргументов команды с $ARGUMENTS
Когда использовать: Вы хотите создать гибкие слэш-команды, которые могут принимать дополнительный ввод от пользователей.
Создайте файл команды с плейсхолдером $ARGUMENTS
Используйте команду с номером проблемы
Это заменит $ARGUMENTS на “123” в промпте.
Советы:
- Плейсхолдер $ARGUMENTS заменяется любым текстом, который следует за командой
- Вы можете разместить $ARGUMENTS в любом месте вашего шаблона команды
- Другие полезные применения: генерация тестовых случаев для определенных функций, создание документации для компонентов, проверка кода в определенных файлах или перевод контента на указанные языки
Создание персональных слэш-команд
Когда использовать: Вы хотите создать персональные слэш-команды, которые работают во всех ваших проектах.
Создайте директорию команд в вашей домашней папке
Создайте Markdown-файл для каждой команды
Используйте вашу персональную пользовательскую команду
Советы:
- Персональные команды имеют префикс
/user:
вместо/project:
- Персональные команды доступны только вам и не разделяются с вашей командой
- Персональные команды работают во всех ваших проектах
- Вы можете использовать их для согласованных рабочих процессов в разных кодовых базах
Следующие шаги
Эталонная реализация Claude Code
Клонируйте нашу эталонную реализацию контейнера разработки.
Was this page helpful?