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

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

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

Предположим, вы только что присоединились к новому проекту и вам нужно быстро понять его структуру.
1

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

cd /path/to/project
2

Запустите Claude Code

claude
3

Попросите общий обзор

> дай мне обзор этой кодовой базы
4

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

> объясни основные архитектурные паттерны, используемые здесь 

> какие ключевые модели данных?

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

​
Поиск соответствующего кода

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

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

> найди файлы, которые обрабатывают аутентификацию пользователей
2

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

> как эти файлы аутентификации работают вместе?
3

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

> проследи процесс входа от фронтенда до базы данных
Советы:
  • Будьте конкретны в том, что вы ищете
  • Используйте доменный язык из проекта

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

Предположим, вы столкнулись с сообщением об ошибке и вам нужно найти и исправить её источник.
1

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

> я вижу ошибку, когда запускаю npm test
2

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

> предложи несколько способов исправить @ts-ignore в user.ts
3

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

> обнови user.ts, чтобы добавить проверку на null, которую ты предложил
Советы:
  • Скажите Claude команду для воспроизведения проблемы и получения трассировки стека
  • Упомяните любые шаги для воспроизведения ошибки
  • Дайте Claude знать, является ли ошибка периодической или постоянной

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

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

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

> найди использование устаревших API в нашей кодовой базе
2

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

> предложи, как рефакторить utils.js для использования современных возможностей JavaScript
3

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

> рефактори utils.js для использования возможностей ES2024, сохраняя то же поведение
4

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

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

​
Использование специализированных субагентов

Предположим, вы хотите использовать специализированных AI субагентов для более эффективного выполнения конкретных задач.
1

Просмотрите доступных субагентов

> /agents
Это показывает всех доступных субагентов и позволяет создавать новых.
2

Используйте субагентов автоматически

Claude Code автоматически делегирует подходящие задачи специализированным субагентам:
> проверь мои недавние изменения кода на предмет проблем безопасности

> запусти все тесты и исправь любые сбои
3

Явно запросите конкретных субагентов

> используй субагента code-reviewer для проверки модуля auth

> пусть субагент debugger исследует, почему пользователи не могут войти в систему
4

Создайте пользовательских субагентов для вашего рабочего процесса

> /agents
Затем выберите “Create New subagent” и следуйте подсказкам для определения:
  • Типа субагента (например, api-designer, performance-optimizer)
  • Когда его использовать
  • К каким инструментам он может получить доступ
  • Его специализированный системный промпт
Советы:
  • Создавайте специфичных для проекта субагентов в .claude/agents/ для совместного использования командой
  • Используйте описательные поля description для включения автоматического делегирования
  • Ограничьте доступ к инструментам тем, что каждому субагенту действительно нужно
  • Проверьте документацию по субагентам для подробных примеров

​
Использование режима планирования для безопасного анализа кода

Режим планирования инструктирует Claude создать план, анализируя кодовую базу с операциями только для чтения, идеально подходящий для исследования кодовых баз, планирования сложных изменений или безопасного просмотра кода.

​
Когда использовать режим планирования

  • Многоэтапная реализация: Когда ваша функция требует внесения изменений во множество файлов
  • Исследование кода: Когда вы хотите тщательно исследовать кодовую базу перед внесением изменений
  • Интерактивная разработка: Когда вы хотите итерировать направление с Claude

​
Как использовать режим планирования

Включите режим планирования во время сессии Вы можете переключиться в режим планирования во время сессии, используя Shift+Tab для переключения между режимами разрешений. Если вы находитесь в обычном режиме, Shift+Tab сначала переключит в режим автоматического принятия, обозначенный ⏵⏵ accept edits on внизу терминала. Последующий Shift+Tab переключит в режим планирования, обозначенный ⏸ plan mode on. Начните новую сессию в режиме планирования Чтобы начать новую сессию в режиме планирования, используйте флаг --permission-mode plan: 
claude --permission-mode plan
Запустите “безголовые” запросы в режиме планирования Вы также можете запустить запрос в режиме планирования напрямую с -p (то есть в “безголовом режиме”): 
claude --permission-mode plan -p "Проанализируй систему аутентификации и предложи улучшения"

​
Пример: Планирование сложного рефакторинга

claude --permission-mode plan

> Мне нужно рефакторить нашу систему аутентификации для использования OAuth2. Создай детальный план миграции.
Claude проанализирует текущую реализацию и создаст всеобъемлющий план. Уточните с помощью дополнительных вопросов: 
> А как насчет обратной совместимости?
> Как нам следует обрабатывать миграцию базы данных?

​
Настройте режим планирования по умолчанию

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
Смотрите документацию по настройкам для дополнительных опций конфигурации.

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

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

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

> найди функции в NotificationsService.swift, которые не покрыты тестами
2

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

> добавь тесты для сервиса уведомлений
3

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

> добавь тестовые случаи для граничных условий в сервисе уведомлений
4

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

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

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

Предположим, вам нужно создать хорошо документированный pull request для ваших изменений.
1

Суммируйте ваши изменения

> суммируй изменения, которые я внес в модуль аутентификации
2

Сгенерируйте PR с Claude

> создай pr
3

Просмотрите и доработайте

> улучши описание PR с большим контекстом об улучшениях безопасности
4

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

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

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

Предположим, вам нужно добавить или обновить документацию для вашего кода.
1

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

> найди функции без правильных JSDoc комментариев в модуле auth
2

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

> добавь JSDoc комментарии к недокументированным функциям в auth.js
3

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

> улучши сгенерированную документацию с большим контекстом и примерами
4

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

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

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

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

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

Вы можете использовать любой из этих методов:
  1. Перетащите изображение в окно Claude Code
  2. Скопируйте изображение и вставьте его в CLI с помощью ctrl+v (Не используйте cmd+v)
  3. Предоставьте путь к изображению Claude. Например, “Проанализируй это изображение: /path/to/your/image.png”
2

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

> Что показывает это изображение?

> Опиши элементы UI на этом скриншоте

> Есть ли проблемные элементы на этой диаграмме?
3

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

> Вот скриншот ошибки. Что её вызывает?

> Это наша текущая схема базы данных. Как нам следует её изменить для новой функции?
4

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

> Сгенерируй CSS, чтобы соответствовать этому макету дизайна

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

​
Ссылки на файлы и директории

Используйте @ для быстрого включения файлов или директорий без ожидания, пока Claude их прочитает.
1

Ссылка на один файл

> Объясни логику в @src/utils/auth.js
Это включает полное содержимое файла в разговор.
2

Ссылка на директорию

> Какова структура @src/components?
Это предоставляет список директории с информацией о файлах.
3

Ссылка на MCP ресурсы

> Покажи мне данные из @github:repos/owner/repo/issues
Это получает данные с подключенных MCP серверов, используя формат @server:resource. Смотрите MCP ресурсы для деталей.
Советы:
  • Пути к файлам могут быть относительными или абсолютными
  • @ ссылки на файлы добавляют CLAUDE.md в директории файла и родительских директориях в контекст
  • Ссылки на директории показывают списки файлов, а не содержимое
  • Вы можете ссылаться на несколько файлов в одном сообщении (например, “@file1.js и @file2.js”)

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

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

Предоставьте контекст и попросите Claude подумать

> Мне нужно реализовать новую систему аутентификации, используя OAuth2 для нашего API. Глубоко подумай о лучшем подходе для реализации этого в нашей кодовой базе.
Claude соберет соответствующую информацию из вашей кодовой базы и использует расширенное мышление, которое будет видно в интерфейсе.
2

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

> подумай о потенциальных уязвимостях безопасности в этом подходе 

> продолжай думать о граничных случаях, которые мы должны обработать
Советы для получения максимальной пользы от расширенного мышления:Расширенное мышление наиболее ценно для сложных задач, таких как:
  • Планирование сложных архитектурных изменений
  • Отладка сложных проблем
  • Создание планов реализации для новых функций
  • Понимание сложных кодовых баз
  • Оценка компромиссов между различными подходами
Способ, которым вы промптите для мышления, приводит к различным уровням глубины мышления:
  • “подумай” запускает базовое расширенное мышление
  • усиливающие фразы, такие как “продолжай думать”, “думай больше”, “думай много” или “думай дольше”, запускают более глубокое мышление
Для дополнительных советов по промптингу расширенного мышления смотрите Советы по расширенному мышлению.
Claude будет отображать свой процесс мышления как курсивный серый текст над ответом.

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

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

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

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

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

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

Покажите выбор разговора

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

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

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

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

​
Запуск параллельных сессий Claude Code с Git 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

Запустите Claude в другом worktree

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 как unix-утилиты

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

Предположим, вы хотите использовать Claude Code как линтер или ревьюер кода. Добавьте Claude в ваш скрипт сборки: 
// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'ты линтер. пожалуйста, посмотри на изменения по сравнению с main и сообщи о любых проблемах, связанных с опечатками. сообщи имя файла и номер строки на одной строке, и описание проблемы на второй строке. не возвращай никакого другого текста.'"
    }
}
Советы:
  • Используйте Claude для автоматизированного ревью кода в вашем CI/CD пайплайне
  • Настройте промпт для проверки конкретных проблем, релевантных для вашего проекта
  • Рассмотрите создание нескольких скриптов для различных типов верификации

​
Pipe in, pipe out

Предположим, вы хотите передать данные в Claude и получить обратно данные в структурированном формате. Передайте данные через Claude: 
cat build-error.txt | claude -p 'кратко объясни основную причину этой ошибки сборки' > output.txt
Советы:
  • Используйте pipes для интеграции Claude в существующие shell скрипты
  • Комбинируйте с другими Unix инструментами для мощных рабочих процессов
  • Рассмотрите использование —output-format для структурированного вывода

​
Контроль формата вывода

Предположим, вам нужен вывод Claude в конкретном формате, особенно при интеграции Claude Code в скрипты или другие инструменты.
1

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

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

Используйте JSON формат

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

Используйте потоковый JSON формат

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

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

Claude Code поддерживает пользовательские slash команды, которые вы можете создать для быстрого выполнения конкретных промптов или задач. Для более подробной информации смотрите справочную страницу Slash команды.

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

Предположим, вы хотите создать многоразовые slash команды для вашего проекта, которые могут использовать все члены команды.
1

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

mkdir -p .claude/commands
2

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

echo "Проанализируй производительность этого кода и предложи три конкретные оптимизации:" > .claude/commands/optimize.md
3

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

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

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

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

Создайте файл команды с заполнителем $ARGUMENTS

echo 'Найди и исправь проблему #$ARGUMENTS. Следуй этим шагам: 1.
Пойми проблему, описанную в тикете 2. Найди соответствующий код в
нашей кодовой базе 3. Реализуй решение, которое устраняет основную причину 4. Добавь
соответствующие тесты 5. Подготовь краткое описание PR' >
.claude/commands/fix-issue.md
2

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

В вашей сессии Claude используйте команду с аргументами.
> /fix-issue 123
Это заменит $ARGUMENTS на “123” в промпте.
Советы:
  • Заполнитель $ARGUMENTS заменяется любым текстом, который следует за командой
  • Вы можете расположить $ARGUMENTS в любом месте вашего шаблона команды
  • Другие полезные применения: генерация тестовых случаев для конкретных функций, создание документации для компонентов, ревью кода в конкретных файлах или перевод контента на указанные языки

​
Создание персональных slash команд

Предположим, вы хотите создать персональные slash команды, которые работают во всех ваших проектах.
1

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

mkdir -p ~/.claude/commands
2

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

echo "Проверь этот код на уязвимости безопасности, сосредоточившись на:" >
~/.claude/commands/security-review.md
3

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

> /security-review
Советы:
  • Персональные команды показывают “(user)” в их описании при перечислении с /help
  • Персональные команды доступны только вам и не разделяются с вашей командой
  • Персональные команды работают во всех ваших проектах
  • Вы можете использовать их для последовательных рабочих процессов в различных кодовых базах

​
Спросите Claude о его возможностях

Claude имеет встроенный доступ к своей документации и может отвечать на вопросы о своих собственных функциях и ограничениях.

​
Примеры вопросов

> может ли Claude Code создавать pull request'ы?

> как Claude Code обрабатывает разрешения?

> какие slash команды доступны?

> как использовать MCP с Claude Code?

> как настроить Claude Code для Amazon Bedrock?

> каковы ограничения Claude Code?
Claude предоставляет ответы, основанные на документации, на эти вопросы. Для исполняемых примеров и практических демонстраций обращайтесь к конкретным разделам рабочих процессов выше.
Советы:
  • Claude всегда имеет доступ к последней документации Claude Code, независимо от версии, которую вы используете
  • Задавайте конкретные вопросы для получения подробных ответов
  • Claude может объяснить сложные функции, такие как интеграция MCP, корпоративные конфигурации и продвинутые рабочие процессы

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

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

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