Руководства по Claude Code

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

​

Содержание

• Понимание новых кодовых баз
• Эффективное исправление ошибок
• Рефакторинг кода
• Работа с тестами
• Создание pull request’ов
• Работа с документацией
• Использование продвинутых git-процессов
• Работа с изображениями
• Настройка памяти проекта
• Использование Claude как unix-утилиты
• Настройка Model Context Protocol (MCP)

​

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

​

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

Когда использовать: Вы только что присоединились к новому проекту и нуждаетесь в быстром понимании его структуры.

$ cd /path/to/project

$ 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?

Советы:

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

​

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

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

> find the files that handle user authentication

> how do these authentication files work together?

> trace the login process from front-end to database

Советы:

• Будьте конкретны в том, что ищете
• Используйте доменный язык проекта

​

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

​

Диагностика сообщений об ошибках

Когда использовать: Вы столкнулись с сообщением об ошибке и нужно найти и исправить её источник.

> 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

Советы:

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

​

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

​

Модернизация устаревшего кода

Когда использовать: Вам нужно обновить старый код для использования современных паттернов и практик.

> 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

Советы:

• Попросите Claude объяснить преимущества современного подхода
• При необходимости запросите сохранение обратной совместимости
• Выполняйте рефакторинг небольшими, тестируемыми частями

​

Работа с тестами

​

Добавление тестового покрытия

Когда использовать: Вам нужно добавить тесты для непокрытого кода.

> 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 объяснить стратегию тестирования

​

Создание pull request’ов

​

Создание комплексных PR

Когда использовать: Вам нужно создать хорошо документированный pull request для ваших изменений.

> summarize the changes I've made to the authentication module

> create a pr

> enhance the PR description with more context about the security improvements

> add information about how these changes were tested

Советы:

• Попросите Claude напрямую создать PR для вас
• Просмотрите сгенерированный Claude PR перед отправкой
• Попросите Claude выделить потенциальные риски или соображения

​

Работа с документацией

​

Генерация документации кода

Когда использовать: Вам нужно добавить или обновить документацию для вашего кода.

> 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

Советы:

• Укажите желаемый стиль документации (JSDoc, docstrings и т.д.)
• Запросите примеры в документации
• Запросите документацию для публичных API, интерфейсов и сложной логики

​

Работа с изображениями

​

Анализ изображений и скриншотов

Когда использовать: Вам нужно работать с изображениями в вашей кодовой базе или получить помощь Claude в анализе содержимого изображений.

# 1. Перетащите изображение в окно Claude Code

# 2. Скопируйте изображение и вставьте его в CLI с помощью ctrl+v

# 3. Укажите путь к изображению
$ claude
> Analyze this image: /path/to/your/image.png

> 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?

Советы:

• Используйте изображения, когда текстовые описания были бы неясными или громоздкими
• Включайте скриншоты ошибок, UI-дизайнов или диаграмм для лучшего контекста
• Вы можете работать с несколькими изображениями в разговоре
• Анализ изображений работает с диаграммами, скриншотами, макетами и многим другим

​

Настройка памяти проекта

​

Создание эффективного файла CLAUDE.md

Когда использовать: Вы хотите настроить файл CLAUDE.md для хранения важной информации о проекте, соглашений и часто используемых команд.

> /init

Советы:

• Включите часто используемые команды (сборка, тестирование, линтинг) чтобы избежать повторных поисков
• Документируйте предпочтения по стилю кода и соглашения по именованию
• Добавьте важные архитектурные паттерны, специфичные для вашего проекта
• Вы можете добавлять файлы CLAUDE.md в папку, где запускаете Claude, родительские директории (Claude читает их автоматически) или дочерние директории (Claude подтягивает их по запросу)

​

Использование Claude как unix-утилиты

​

Добавление Claude в процесс верификации

Когда использовать: Вы хотите использовать Claude Code как линтер или код-ревьюер.

Шаги:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

​

Передача данных через пайпы

Когда использовать: Вы хотите передать данные в Claude и получить обратно данные в структурированном формате.

$ cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

​

Настройка Model Context Protocol (MCP)

Model Context Protocol (MCP) - это открытый протокол, который позволяет LLM получать доступ к внешним инструментам и источникам данных. Для более подробной информации см. документацию MCP.

​

Настройка MCP-серверов

Когда использовать: Вы хотите расширить возможности Claude, подключив его к специализированным инструментам и внешним серверам с помощью Model Context Protocol.

# Базовый синтаксис
$ claude mcp add <name> <command> [args...]

# Пример: Добавление локального сервера
$ claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

# Список всех настроенных серверов
$ claude mcp list

# Получение деталей для конкретного сервера
$ claude mcp get my-server

# Удаление сервера
$ claude mcp remove my-server

Советы:

• Используйте флаг -s или --scope с project (по умолчанию) или global для указания места хранения конфигурации
• Устанавливайте переменные окружения с помощью флагов -e или --env (например, -e KEY=value)
• MCP следует клиент-серверной архитектуре, где Claude Code (клиент) может подключаться к нескольким специализированным серверам

​

Подключение к Postgres MCP серверу

Когда использовать: Вы хотите дать Claude доступ только для чтения к базе данных PostgreSQL для запросов и проверки схемы.

$ claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# В вашей сессии Claude вы можете спрашивать о вашей базе данных
$ claude
> describe the schema of our users table
> what are the most recent orders in the system?
> show me the relationship between customers and invoices

Советы:

• Postgres MCP сервер предоставляет доступ только для чтения в целях безопасности
• Claude может помочь вам исследовать структуру базы данных и выполнять аналитические запросы
• Вы можете использовать это для быстрого понимания схем баз данных в незнакомых проектах
• Убедитесь, что ваша строка подключения использует соответствующие учетные данные с минимально необходимыми разрешениями

​

Следующие шаги