Перейти к основному содержанию
Каждая задача в этом документе включает чёткие инструкции, примеры команд и лучшие практики, которые помогут вам максимально эффективно использовать 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

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

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

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

Claude Code автоматически делегирует подходящие задачи специализированным подагентам:
> review my recent code changes for security issues
> run all tests and fix any failures
3

Явно запросите конкретные подагенты

> use the code-reviewer subagent to check the auth module
> have the debugger subagent investigate why users can't log in
4

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

> /agents
Затем выберите “Create New subagent” и следуйте подсказкам для определения:
  • Уникального идентификатора, описывающего назначение подагента (например, code-reviewer, api-designer).
  • Когда Claude должен использовать этого агента
  • Какие инструменты он может использовать
  • Системного приглашения, описывающего роль и поведение агента
Советы:
  • Создавайте специфичные для проекта подагенты в .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 "Analyze the authentication system and suggest improvements"

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

claude --permission-mode plan
> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
Claude анализирует текущую реализацию и создаёт подробный план. Уточните с помощью дополнительных вопросов:
> What about backward compatibility?
> How should we handle database migration?

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

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

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

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

Создавайте pull requests

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

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

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

Создайте pull request с 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 (не используйте cmd+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?
Советы:
  • Используйте изображения, когда текстовые описания были бы неясными или громоздкими
  • Включайте скриншоты ошибок, дизайны пользовательского интерфейса или диаграммы для лучшего контекста
  • Вы можете работать с несколькими изображениями в разговоре
  • Анализ изображений работает с диаграммами, скриншотами, макетами и многим другим
  • Когда Claude ссылается на изображения (например, [Image #1]), Cmd+Click (Mac) или Ctrl+Click (Windows/Linux) ссылку, чтобы открыть изображение в вашей программе просмотра по умолчанию

Ссылайтесь на файлы и каталоги

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

Ссылайтесь на один файл

> Explain the logic in @src/utils/auth.js
Это включает полное содержимое файла в разговор.
2

Ссылайтесь на каталог

> What's the structure of @src/components?
Это предоставляет список каталогов с информацией о файлах.
3

Ссылайтесь на ресурсы MCP

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

Используйте расширенное мышление (режим мышления)

Расширенное мышление резервирует часть общего бюджета выходных токенов для Claude, чтобы пошагово рассуждать о сложных проблемах. Это рассуждение видно в подробном режиме, который вы можете переключить с помощью Ctrl+O. Расширенное мышление особенно ценно для сложных архитектурных решений, сложных ошибок, многошагового планирования реализации и оценки компромиссов между различными подходами. Это обеспечивает больше места для исследования нескольких решений, анализа граничных случаев и самокоррекции ошибок.
Sonnet 4.5 и Opus 4.5 имеют мышление, включённое по умолчанию. Все остальные модели имеют мышление, отключённое по умолчанию. Используйте /model для просмотра или переключения вашей текущей модели.
Вы можете настроить режим мышления для Claude Code несколькими способами:
ОбластьКак включитьПодробности
Ярлык переключенияНажмите Option+T (macOS) или Alt+T (Windows/Linux)Переключайте мышление включено/выключено. Может потребоваться конфигурация терминала для включения ярлыков клавиши Option
Глобальное значение по умолчаниюИспользуйте /config для включения режима мышленияУстанавливает ваше значение по умолчанию для всех проектов.
Сохраняется как alwaysThinkingEnabled в ~/.claude/settings.json
Переопределение переменной окруженияУстановите переменную окружения MAX_THINKING_TOKENSКогда установлена, применяет пользовательский бюджет токенов ко всем запросам, переопределяя конфигурацию режима мышления. Пример: export MAX_THINKING_TOKENS=1024

Мышление для каждого запроса с ultrathink

Вы можете включить ultrathink как ключевое слово в вашем сообщении, чтобы включить мышление для одного запроса:
> ultrathink: design a caching layer for our API
Обратите внимание, что ultrathink как выделяет бюджет мышления, так И семантически сигнализирует Claude рассуждать более тщательно, что может привести к более глубокому мышлению, чем необходимо для вашей задачи. Ключевое слово ultrathink работает только, когда MAX_THINKING_TOKENS не установлен. Когда MAX_THINKING_TOKENS настроен, он имеет приоритет и контролирует бюджет мышления для всех запросов. Другие фразы, такие как “think”, “think hard” и “think more”, интерпретируются как обычные инструкции приглашения и не выделяют токены мышления. Чтобы просмотреть процесс мышления Claude, нажмите Ctrl+O для переключения подробного режима и просмотрите внутреннее рассуждение, отображаемое как серый курсивный текст. Смотрите раздел бюджета токенов ниже для подробной информации о бюджете и последствиях стоимости.

Как работают бюджеты токенов расширенного мышления

Расширенное мышление использует бюджет токенов, который контролирует, сколько внутреннего рассуждения Claude может выполнить перед ответом. Больший бюджет токенов мышления обеспечивает:
  • Больше места для пошагового исследования нескольких подходов к решению
  • Место для анализа граничных случаев и тщательной оценки компромиссов
  • Возможность пересмотра рассуждений и самокоррекции ошибок
Бюджеты токенов для режима мышления:
  • Когда мышление включено (через /config или ultrathink), Claude может использовать до 31,999 токенов из вашего выходного бюджета для внутреннего рассуждения
  • Когда мышление отключено, Claude использует 0 токенов для мышления
Пользовательские бюджеты токенов:
  • Вы можете установить пользовательский бюджет токенов мышления, используя переменную окружения MAX_THINKING_TOKENS
  • Это имеет наивысший приоритет и переопределяет бюджет по умолчанию 31,999 токенов
  • Смотрите документацию расширенного мышления для допустимых диапазонов токенов
Вам выставляется счёт за все использованные токены мышления, даже если модели Claude 4 показывают сокращённое мышление

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

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

Назовите ваши сеансы

Дайте сеансам описательные имена, чтобы найти их позже. Это лучшая практика при работе над несколькими задачами или функциями.
1

Назовите текущий сеанс

Используйте /rename во время сеанса, чтобы дать ему запоминающееся имя:
> /rename auth-refactor
Вы также можете переименовать любой сеанс из средства выбора: запустите /resume, перейдите к сеансу и нажмите R.
2

Возобновите по имени позже

Из командной строки:
claude --resume auth-refactor
Или из активного сеанса:
> /resume auth-refactor

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

Команда /resume (или claude --resume без аргументов) открывает интерактивное средство выбора сеанса со следующими функциями: Ярлыки клавиатуры в средстве выбора:
ЯрлыкДействие
/ Навигация между сеансами
/ Развёртывание или свёртывание сгруппированных сеансов
EnterВыберите и возобновите выделенный сеанс
PПредпросмотр содержимого сеанса
RПереименуйте выделенный сеанс
/Поиск для фильтрации сеансов
AПереключение между текущим каталогом и всеми проектами
BФильтр к сеансам из вашей текущей ветки git
EscВыход из средства выбора или режима поиска
Организация сеанса: Средство выбора отображает сеансы с полезными метаданными:
  • Имя сеанса или начальное приглашение
  • Время, прошедшее с момента последней активности
  • Количество сообщений
  • Ветка Git (если применимо)
Разветвлённые сеансы (созданные с помощью /rewind или --fork-session) сгруппированы под их корневым сеансом, что облегчает поиск связанных разговоров.
Советы:
  • Назовите сеансы рано: Используйте /rename при начале работы над отдельной задачей — намного легче найти “payment-integration”, чем “explain this function” позже
  • Используйте --continue для быстрого доступа к вашему самому последнему разговору в текущем каталоге
  • Используйте --resume session-name, когда вы знаете, какой сеанс вам нужен
  • Используйте --resume (без имени), когда вам нужно просмотреть и выбрать
  • Для скриптов используйте claude --continue --print "prompt" для возобновления в неинтерактивном режиме
  • Нажмите P в средстве выбора для предпросмотра сеанса перед его возобновлением
  • Возобновленный разговор начинается с той же модели и конфигурации, что и оригинал
Как это работает:
  1. Хранилище разговоров: Все разговоры автоматически сохраняются локально с полной историей сообщений
  2. Десериализация сообщений: При возобновлении вся история сообщений восстанавливается для сохранения контекста
  3. Состояние инструмента: Использование инструмента и результаты из предыдущего разговора сохраняются
  4. Восстановление контекста: Разговор возобновляется со всем предыдущим контекстом нетронутым

Запустите параллельные сеансы 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 '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 для автоматического просмотра кода в вашем конвейере CI/CD
  • Настройте приглашение для проверки конкретных проблем, релевантных для вашего проекта
  • Рассмотрите создание нескольких скриптов для различных типов проверки

Передавайте данные, получайте данные

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

Контролируйте формат вывода

Предположим, вам нужен вывод 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

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

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

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

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

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

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

> can Claude Code create pull requests?
> how does Claude Code handle permissions?
> what slash commands are available?
> how do I use MCP with Claude Code?
> how do I configure Claude Code for Amazon Bedrock?
> what are the limitations of Claude Code?
Claude предоставляет ответы на основе документации на эти вопросы. Для исполняемых примеров и практических демонстраций обратитесь к конкретным разделам рабочего процесса выше.
Советы:
  • Claude всегда имеет доступ к последней документации Claude Code, независимо от версии, которую вы используете
  • Задавайте конкретные вопросы, чтобы получить подробные ответы
  • Claude может объяснить сложные функции, такие как интеграция MCP, конфигурации предприятия и продвинутые рабочие процессы

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

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

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