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

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

​

Содержание

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

​

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

​

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

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

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

​

Создание пул-реквестов

​

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

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

> 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 для сложных задач

Когда использовать: При работе над сложными архитектурными решениями, сложными ошибками или планированием многоэтапных реализаций, требующих глубокого рассуждения.

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase.

> think about potential security vulnerabilities in this approach
> think harder about edge cases we should handle

Советы для получения максимальной пользы от расширенного мышления:

Расширенное мышление наиболее ценно для сложных задач, таких как:

• Планирование сложных архитектурных изменений
• Отладка сложных проблем
• Создание планов реализации новых функций
• Понимание сложных кодовых баз
• Оценка компромиссов между различными подходами

Способ запроса мышления приводит к различным уровням глубины мышления:

• “think” запускает базовое расширенное мышление
• усиливающие фразы, такие как “think more”, “think a lot”, “think harder” или “think longer” запускают более глубокое мышление

Для получения дополнительных советов по запросу расширенного мышления см. Советы по расширенному мышлению.

​

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

​

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

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

> /init

Советы:

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

​

Настройка 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 для указания места хранения конфигурации:
  • 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 и как делиться серверами с вашей командой.

# Добавить сервер с локальной областью видимости (по умолчанию)
claude mcp add my-private-server /path/to/server

# Явно указать локальную область видимости
claude mcp add my-private-server -s local /path/to/server

# Добавить сервер с областью видимости проекта
claude mcp add shared-server -s project /path/to/server

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

# Добавить пользовательский сервер
claude mcp add my-user-server -s user /path/to/server

Советы:

• Серверы с локальной областью видимости имеют приоритет над серверами с областью видимости проекта и пользователя с тем же именем
• Серверы с областью видимости проекта (в .mcp.json) имеют приоритет над серверами с пользовательской областью видимости с тем же именем
• Перед использованием серверов с областью видимости проекта из .mcp.json Claude Code попросит вас одобрить их для безопасности
• Файл .mcp.json предназначен для добавления в систему контроля версий для совместного использования MCP-серверов с вашей командой
• Серверы с областью видимости проекта облегчают обеспечение доступа всех членов команды к одним и тем же инструментам MCP
• Если вам нужно сбросить ваш выбор включенных или отключенных серверов с областью видимости проекта, используйте команду claude mcp reset-project-choices

​

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

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

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

# В вашей сессии 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 может помочь вам исследовать структуру базы данных и выполнять аналитические запросы
• Вы можете использовать это для быстрого понимания схем баз данных в незнакомых проектах
• Убедитесь, что ваша строка подключения использует соответствующие учетные данные с минимально необходимыми разрешениями

​

Добавление MCP-серверов из JSON-конфигурации

Когда использовать: У вас есть JSON-конфигурация для одного MCP-сервера, который вы хотите добавить в Claude Code.

# Базовый синтаксис
claude mcp add-json <name> '<json>'

# Пример: Добавление stdio сервера с JSON-конфигурацией
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

Советы:

• Убедитесь, что JSON правильно экранирован в вашей оболочке
• JSON должен соответствовать схеме конфигурации MCP-сервера
• Вы можете использовать -s global для добавления сервера в вашу глобальную конфигурацию вместо конфигурации, специфичной для проекта

​

Импорт MCP-серверов из Claude Desktop

Когда использовать: Вы уже настроили MCP-серверы в Claude Desktop и хотите использовать те же серверы в Claude Code без ручной перенастройки.

# Базовый синтаксис
claude mcp add-from-claude-desktop

claude mcp list

Советы:

• Эта функция работает только на macOS и Windows Subsystem for Linux (WSL)
• Она читает файл конфигурации Claude Desktop из его стандартного расположения на этих платформах
• Используйте флаг -s global для добавления серверов в вашу глобальную конфигурацию
• Импортированные серверы будут иметь те же имена, что и в Claude Desktop
• Если серверы с теми же именами уже существуют, они получат числовой суффикс (например, server_1)

​

Использование Claude Code как MCP-сервера

Когда использовать: Вы хотите использовать сам Claude Code как MCP-сервер, к которому могут подключаться другие приложения, предоставляя им инструменты и возможности Claude.

# Базовый синтаксис
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Советы:

• Сервер предоставляет доступ к инструментам Claude, таким как View, Edit, LS и др.
• В Claude Desktop попробуйте попросить Claude читать файлы в директории, делать правки и многое другое
• Обратите внимание, что этот MCP-сервер просто предоставляет инструменты Claude Code вашему MCP-клиенту, поэтому ваш собственный клиент отвечает за реализацию подтверждения пользователем для отдельных вызовов инструментов

​

Использование 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

​

Создание пользовательских слэш-команд

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

​

Создание команд, специфичных для проекта

Когда использовать: Вы хотите создать многоразовые слэш-команды для вашего проекта, которые могут использовать все члены команды.

mkdir -p .claude/commands

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md

claude
> /project:optimize

Советы:

• Имена команд получаются из имени файла (например, optimize.md становится /project:optimize)
• Вы можете организовывать команды в поддиректориях (например, .claude/commands/frontend/component.md становится /project:frontend:component)
• Команды проекта доступны всем, кто клонирует репозиторий
• Содержимое Markdown-файла становится промптом, отправляемым Claude при вызове команды

​

Добавление аргументов команды с $ARGUMENTS

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

echo "Find and fix issue #$ARGUMENTS. Follow these steps:
1. Understand the issue described in the ticket
2. Locate the relevant code in our codebase
3. Implement a solution that addresses the root cause
4. Add appropriate tests
5. Prepare a concise PR description" > .claude/commands/fix-issue.md

claude
> /project:fix-issue 123

Советы:

• Плейсхолдер $ARGUMENTS заменяется любым текстом, который следует за командой
• Вы можете разместить $ARGUMENTS в любом месте вашего шаблона команды
• Другие полезные применения: генерация тестовых случаев для определенных функций, создание документации для компонентов, проверка кода в определенных файлах или перевод контента на указанные языки

​

Создание персональных слэш-команд

Когда использовать: Вы хотите создать персональные слэш-команды, которые работают во всех ваших проектах.

mkdir -p ~/.claude/commands

echo "Review this code for security vulnerabilities, focusing on:" > ~/.claude/commands/security-review.md

claude
> /user:security-review

Советы:

• Персональные команды имеют префикс /user: вместо /project:
• Персональные команды доступны только вам и не разделяются с вашей командой
• Персональные команды работают во всех ваших проектах
• Вы можете использовать их для согласованных рабочих процессов в разных кодовых базах

​

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