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

​
Содержание

​
Возобновление предыдущих разговоров

​
Продолжайте работу без перерывов

Когда использовать: Вы работали над задачей с Claude Code и вам нужно продолжить с того места, где вы остановились, в более поздней сессии. Claude Code предоставляет два варианта для возобновления предыдущих разговоров:
  • --continue для автоматического продолжения самого последнего разговора
  • --resume для отображения средства выбора разговора
1

Продолжить самый последний разговор

claude --continue
Это немедленно возобновляет ваш самый последний разговор без каких-либо запросов.
2

Продолжить в неинтерактивном режиме

claude --continue --print "Continue with my task"
Используйте --print с --continue для возобновления самого последнего разговора в неинтерактивном режиме, что идеально подходит для скриптов или автоматизации.
3

Показать средство выбора разговора

claude --resume
Это отображает интерактивный селектор разговоров, показывающий:
  • Время начала разговора
  • Начальный запрос или сводку разговора
  • Количество сообщений
Используйте клавиши со стрелками для навигации и нажмите Enter для выбора разговора.
Как это работает:
  1. Хранение разговоров: Все разговоры автоматически сохраняются локально с полной историей сообщений
  2. Десериализация сообщений: При возобновлении восстанавливается вся история сообщений для сохранения контекста
  3. Состояние инструментов: Использование инструментов и результаты из предыдущего разговора сохраняются
  4. Восстановление контекста: Разговор возобновляется со всем предыдущим контекстом
Советы:
  • История разговоров хранится локально на вашем компьютере
  • Используйте --continue для быстрого доступа к вашему самому последнему разговору
  • Используйте --resume, когда вам нужно выбрать определенный прошлый разговор
  • При возобновлении вы увидите всю историю разговора перед продолжением
  • Возобновленный разговор начинается с той же модели и конфигурации, что и оригинальный
Примеры: 
# Продолжить самый последний разговор
claude --continue

# Продолжить самый последний разговор с определенным запросом
claude --continue --print "Show me our progress"

# Показать средство выбора разговора
claude --resume

# Продолжить самый последний разговор в неинтерактивном режиме
claude --continue --print "Run the tests again"

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

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

Когда использовать: Вы только что присоединились к новому проекту и вам нужно быстро понять его структуру.
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 с помощью cmd+v (на Mac)
  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?
Советы:
  • Используйте изображения, когда текстовые описания были бы неясными или громоздкими
  • Включайте скриншоты ошибок, дизайн-макеты или диаграммы для лучшего контекста
  • Вы можете работать с несколькими изображениями в разговоре
  • Анализ изображений работает с диаграммами, скриншотами, макетами и многим другим

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

​
Используйте расширенное мышление 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.

​
Настройка протокола контекста модели (MCP)

Протокол контекста модели (MCP) — это открытый протокол, который позволяет LLM получать доступ к внешним инструментам и источникам данных. Для получения дополнительной информации см. документацию MCP.
Используйте сторонние серверы MCP на свой страх и риск. Убедитесь, что вы доверяете серверам MCP, и будьте особенно осторожны при использовании серверов MCP, которые взаимодействуют с интернетом, так как они могут подвергнуть вас риску внедрения промптов.

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

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

Добавьте сервер MCP Stdio

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

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

Добавьте сервер MCP SSE

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

# Пример: Добавление сервера SSE
claude mcp add --transport sse sse-server https://example.com/sse-endpoint
3

Управляйте вашими серверами 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

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

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

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

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
Советы:
  • Сервер MCP Postgres предоставляет доступ только для чтения в целях безопасности
  • 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 user для добавления сервера в вашу пользовательскую конфигурацию вместо конфигурации, специфичной для проекта

​
Импорт серверов 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 user для добавления серверов в вашу пользовательскую конфигурацию
  • Импортированные серверы будут иметь те же имена, что и в 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 в определенном формате, особенно при интеграции Claude Code в скрипты или другие инструменты.
1

Использование текстового формата (по умолчанию)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
Это выводит только обычный текстовый ответ Claude (поведение по умолчанию).
2

Использование формата JSON

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
Это выводит массив JSON сообщений с метаданными, включая стоимость и продолжительность.
3

Использование потокового формата JSON

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
Это выводит серию объектов JSON в реальном времени, когда Claude обрабатывает запрос. Каждое сообщение является допустимым объектом JSON, но весь вывод не является допустимым JSON, если его объединить.
Советы:
  • Используйте --output-format text для простых интеграций, где вам нужен только ответ Claude
  • Используйте --output-format json, когда вам нужен полный журнал разговора
  • Используйте --output-format stream-json для вывода в реальном времени каждого хода разговора

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

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 с Git worktrees

​
Использование worktrees для изолированных сред кодирования

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

Понимание Git worktrees

Git worktrees позволяют вам извлекать несколько веток из одного репозитория в отдельные каталоги. Каждый worktree имеет свой собственный рабочий каталог с изолированными файлами, при этом разделяя одну и ту же историю Git. Узнайте больше в официальной документации Git worktree.
2

Создайте новый worktree

# Создайте новый worktree с новой веткой 
git worktree add ../project-feature-a -b feature-a

# Или создайте worktree с существующей веткой
git worktree add ../project-bugfix bugfix-123
Это создает новый каталог с отдельной рабочей копией вашего репозитория.
3

Запустите Claude Code в каждом worktree

# Перейдите в ваш worktree 
cd ../project-feature-a

# Запустите Claude Code в этой изолированной среде
claude
4

В другом терминале:
cd ../project-bugfix
claude
5

Управляйте вашими worktrees

# Список всех worktrees
git worktree list

# Удалите worktree, когда закончите
git worktree remove ../project-feature-a
Советы:
  • Каждый worktree имеет свое собственное независимое состояние файлов, что делает его идеальным для параллельных сессий Claude Code
  • Изменения, сделанные в одном worktree, не повлияют на другие, предотвращая взаимное влияние экземпляров Claude
  • Все worktrees разделяют одну и ту же историю Git и удаленные подключения
  • Для долгосрочных задач вы можете иметь Claude, работающего в одном worktree, в то время как вы продолжаете разработку в другом
  • Используйте описательные имена каталогов, чтобы легко определить, для какой задачи предназначен каждый worktree
  • Не забудьте инициализировать вашу среду разработки в каждом новом worktree в соответствии с настройкой вашего проекта. В зависимости от вашего стека, это может включать:
    • JavaScript проекты: Запуск установки зависимостей (npm install, yarn)
    • Python проекты: Настройка виртуальных сред или установка с помощью менеджеров пакетов
    • Другие языки: Следование стандартному процессу настройки вашего проекта

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

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

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