Руководства

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

​

Содержание

• Возобновление предыдущих разговоров
• Понимание новых кодовых баз
• Эффективное исправление ошибок
• Рефакторинг кода
• Работа с тестами
• Создание запросов на включение изменений
• Работа с документацией
• Работа с изображениями
• Использование расширенного мышления
• Настройка памяти проекта
• Настройка протокола контекста модели (MCP)
• Использование Claude как утилиты в стиле unix
• Создание пользовательских слэш-команд
• Запуск параллельных сессий Claude Code с Git worktrees

​

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

​

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

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

Claude Code предоставляет два варианта для возобновления предыдущих разговоров:

• --continue для автоматического продолжения самого последнего разговора
• --resume для отображения средства выбора разговора

claude --continue

claude --continue --print "Continue with my task"

claude --resume

Как это работает:

1. Хранение разговоров: Все разговоры автоматически сохраняются локально с полной историей сообщений
2. Десериализация сообщений: При возобновлении восстанавливается вся история сообщений для сохранения контекста
3. Состояние инструментов: Использование инструментов и результаты из предыдущего разговора сохраняются
4. Восстановление контекста: Разговор возобновляется со всем предыдущим контекстом

Советы:

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

Примеры:

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

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

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

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

​

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

​

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

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

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 в анализе содержимого изображений.

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

Советы:

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

​

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

​

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

​

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

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

​

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

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

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

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

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

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

# Список всех настроенных серверов
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

​

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

Когда использовать: Вы хотите предоставить 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

Советы:

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

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

Советы:

• Используйте --output-format text для простых интеграций, где вам нужен только ответ Claude
• Используйте --output-format json, когда вам нужен полный журнал разговора
• Используйте --output-format stream-json для вывода в реальном времени каждого хода разговора

​

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

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

​

Запуск параллельных сессий Claude Code с Git worktrees

​

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

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

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

# Или создайте worktree с существующей веткой
git worktree add ../project-bugfix bugfix-123

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

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

cd ../project-bugfix
claude

# Список всех 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 проекты: Настройка виртуальных сред или установка с помощью менеджеров пакетов
  • Другие языки: Следование стандартному процессу настройки вашего проекта

​

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