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

Содержание

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

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

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

1

Перейдите в корневую директорию проекта

cd /path/to/project
2

Запустите Claude Code

claude
3

Запросите общий обзор

> give me an overview of this codebase
4

Углубитесь в конкретные компоненты

> explain the main architecture patterns used here
> what are the key data models?
> how is authentication handled?

Советы:

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

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

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

1

Попросите Claude найти релевантные файлы

> find the files that handle user authentication
2

Получите контекст о взаимодействии компонентов

> how do these authentication files work together?
3

Поймите поток выполнения

> trace the login process from front-end to database

Советы:

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

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

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

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

1

Поделитесь ошибкой с Claude

> I'm seeing an error when I run npm test
2

Запросите рекомендации по исправлению

> suggest a few ways to fix the @ts-ignore in user.ts
3

Примените исправление

> update user.ts to add the null check you suggested

Советы:

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

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

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

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

1

Определите устаревший код для рефакторинга

> find deprecated API usage in our codebase
2

Получите рекомендации по рефакторингу

> suggest how to refactor utils.js to use modern JavaScript features
3

Безопасно примените изменения

> refactor utils.js to use ES2024 features while maintaining the same behavior
4

Проверьте рефакторинг

> run tests for the refactored code

Советы:

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

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

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

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

1

Определите непротестированный код

> find functions in NotificationsService.swift that are not covered by tests
2

Сгенерируйте каркас тестов

> add tests for the notification service
3

Добавьте значимые тестовые случаи

> add test cases for edge conditions in the notification service
4

Запустите и проверьте тесты

> run the new tests and fix any failures

Советы:

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

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

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

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

1

Подведите итог вашим изменениям

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

Сгенерируйте PR с помощью Claude

> create a pr
3

Просмотрите и улучшите

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

Добавьте детали тестирования

> add information about how these changes were tested

Советы:

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

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

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

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

1

Определите недокументированный код

> find functions without proper JSDoc comments in the auth module
2

Сгенерируйте документацию

> add JSDoc comments to the undocumented functions in auth.js
3

Просмотрите и улучшите

> improve the generated documentation with more context and examples
4

Проверьте документацию

> check if the documentation follows our project standards

Советы:

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

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

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

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

1

Добавьте изображение в разговор

Вы можете использовать любой из этих методов:

# 1. Перетащите изображение в окно Claude Code
# 2. Скопируйте изображение и вставьте его в CLI с помощью ctrl+v
# 3. Укажите путь к изображению
claude "Analyze this image: /path/to/your/image.png"
2

Попросите Claude проанализировать изображение

> What does this image show?
> Describe the UI elements in this screenshot
> Are there any problematic elements in this diagram?
3

Используйте изображения для контекста

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

Получите предложения по коду из визуального контента

> Generate CSS to match this design mockup
> What HTML structure would recreate this component?

Советы:

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

Использование расширенного мышления

Используйте расширенное мышление Claude для сложных задач

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

1

Предоставьте контекст и попросите 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.

Claude соберет релевантную информацию из вашей кодовой базы и использует расширенное мышление, которое будет видно в интерфейсе.

2

Уточните мышление с помощью дополнительных запросов

> 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 будет отображать свой процесс мышления курсивным серым текстом над ответом.


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

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

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

1

Создайте CLAUDE.md для вашей кодовой базы

> /init

Советы:

  • Включите часто используемые команды (сборка, тестирование, линтинг), чтобы избежать повторных поисков
  • Документируйте предпочтения по стилю кода и соглашения по именованию
  • Добавьте важные архитектурные паттерны, специфичные для вашего проекта
  • Вы можете добавить файлы 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.

1

Добавьте MCP Stdio Server

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

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

Управляйте вашими MCP-серверами

# Список всех настроенных серверов
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 и как делиться серверами с вашей командой.

1

MCP-серверы с локальной областью видимости

Область видимости по умолчанию (local) хранит конфигурации MCP-серверов в ваших пользовательских настройках проекта. Эти серверы доступны только вам при работе в текущем проекте.

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

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

MCP-серверы с областью видимости проекта (.mcp.json)

Серверы с областью видимости проекта хранятся в файле .mcp.json в корне вашего проекта. Этот файл должен быть добавлен в систему контроля версий для совместного использования серверов с вашей командой.

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

Это создает или обновляет файл .mcp.json со следующей структурой:

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

MCP-серверы с пользовательской областью видимости

Серверы с пользовательской областью видимости доступны вам во всех проектах на вашей машине и являются приватными для вас.

# Добавить пользовательский сервер
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 для запросов и проверки схемы.

1

Добавьте Postgres MCP-сервер

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

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

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

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

1

Добавьте MCP-сервер из JSON

# Базовый синтаксис
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"}}'
2

Проверьте, что сервер был добавлен

claude mcp get weather-api

Советы:

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

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

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

1

Импортируйте серверы из Claude Desktop

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

Выберите, какие серверы импортировать

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

3

Проверьте, что серверы были импортированы

claude mcp list

Советы:

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

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

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

1

Запустите Claude как MCP-сервер

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

Подключитесь из другого приложения

Вы можете подключиться к MCP-серверу Claude Code из любого MCP-клиента, например Claude Desktop. Если вы используете Claude Desktop, вы можете добавить MCP-сервер Claude Code, используя эту конфигурацию:

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

Советы:

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

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

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

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

Шаги:

1

Добавьте Claude в ваш скрипт сборки

// 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 и получить обратно данные в структурированном формате.

1

Передайте данные через Claude

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

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

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

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

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

1

Создайте директорию команд в вашем проекте

mkdir -p .claude/commands
2

Создайте Markdown-файл для каждой команды

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

Используйте вашу пользовательскую команду в Claude Code

claude
> /project:optimize

Советы:

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

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

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

1

Создайте файл команды с плейсхолдером $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
2

Используйте команду с номером проблемы

claude
> /project:fix-issue 123

Это заменит $ARGUMENTS на “123” в промпте.

Советы:

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

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

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

1

Создайте директорию команд в вашей домашней папке

mkdir -p ~/.claude/commands
2

Создайте Markdown-файл для каждой команды

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

Используйте вашу персональную пользовательскую команду

claude
> /user:security-review

Советы:

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

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

Эталонная реализация Claude Code

Клонируйте нашу эталонную реализацию контейнера разработки.