Понимание новых кодовых баз
Получение быстрого обзора кодовой базы
Предположим, вы только что присоединились к новому проекту и вам нужно быстро понять его структуру.Поиск релевантного кода
Предположим, вам нужно найти код, связанный с конкретной функцией или функциональностью.Эффективное исправление ошибок
Предположим, вы столкнулись с сообщением об ошибке и вам нужно найти и исправить его источник.Рефакторинг кода
Предположим, вам нужно обновить старый код для использования современных паттернов и практик.Использование специализированных subagents
Предположим, вы хотите использовать специализированные AI subagents для более эффективного выполнения конкретных задач.Используйте subagents автоматически
Claude Code автоматически делегирует соответствующие задачи специализированным subagents:
Создайте пользовательские subagents для вашего рабочего процесса
- Уникального идентификатора, описывающего назначение subagent (например,
code-reviewer,api-designer). - Когда Claude должен использовать этого агента
- Какие инструменты он может использовать
- Системной подсказки, описывающей роль и поведение агента
Использование Plan Mode для безопасного анализа кода
Plan Mode инструктирует Claude создать план путём анализа кодовой базы с операциями только для чтения, идеально подходит для изучения кодовых баз, планирования сложных изменений или безопасного просмотра кода. В Plan Mode Claude используетAskUserQuestion для сбора требований и уточнения ваших целей перед предложением плана.
Когда использовать Plan Mode
- Многошаговая реализация: Когда ваша функция требует редактирования множества файлов
- Изучение кода: Когда вы хотите тщательно исследовать кодовую базу перед внесением каких-либо изменений
- Интерактивная разработка: Когда вы хотите итерировать направление с Claude
Как использовать Plan Mode
Включите Plan Mode во время сеанса Вы можете переключиться в Plan Mode во время сеанса, используя Shift+Tab для циклического переключения между режимами разрешений. Если вы находитесь в Normal Mode, Shift+Tab сначала переключается в Auto-Accept Mode, обозначенный⏵⏵ accept edits on в нижней части терминала. Последующий Shift+Tab переключится в Plan Mode, обозначенный ⏸ plan mode on.
Запустите новый сеанс в Plan Mode
Чтобы запустить новый сеанс в Plan Mode, используйте флаг --permission-mode plan:
-p (то есть в “headless режиме”):
Пример: Планирование сложного рефакторинга
Настройка Plan Mode по умолчанию
Работа с тестами
Предположим, вам нужно добавить тесты для непокрытого кода.
Claude может создавать тесты, которые следуют существующим паттернам и соглашениям вашего проекта. При запросе тестов будьте конкретны в отношении поведения, которое вы хотите проверить. Claude изучает ваши существующие файлы тестов, чтобы соответствовать стилю, фреймворкам и паттернам утверждений, уже используемым в проекте.
Для полного покрытия попросите Claude определить граничные случаи, которые вы могли пропустить. Claude может анализировать пути вашего кода и предлагать тесты для условий ошибок, граничных значений и неожиданных входных данных, которые легко упустить.
Создание pull requests
Вы можете создавать pull requests, попросив Claude напрямую (“create a pr for my changes”), или направить Claude пошагово: Когда вы создаёте PR с помощьюgh pr create, сеанс автоматически связывается с этим PR. Вы можете возобновить его позже с помощью claude --from-pr <number>.
Работа с документацией
Предположим, вам нужно добавить или обновить документацию для вашего кода.Работа с изображениями
Предположим, вам нужно работать с изображениями в вашей кодовой базе, и вы хотите помощь Claude в анализе содержимого изображения.Добавьте изображение в разговор
Вы можете использовать любой из этих методов:
- Перетащите изображение в окно Claude Code
- Скопируйте изображение и вставьте его в CLI с помощью ctrl+v (не используйте cmd+v)
- Предоставьте Claude путь к изображению. Например, “Analyze this image: /path/to/your/image.png”
Ссылка на файлы и каталоги
Используйте @ для быстрого включения файлов или каталогов без ожидания, пока Claude их прочитает.Ссылка на MCP ресурсы
Использование расширенного мышления (режим мышления)
Расширенное мышление включено по умолчанию, предоставляя Claude пространство для пошагового рассуждения о сложных проблемах перед ответом. Это рассуждение видно в режиме подробности, который вы можете переключить с помощьюCtrl+O.
Кроме того, Opus 4.6 и Sonnet 4.6 поддерживают адаптивное рассуждение: вместо фиксированного бюджета токенов мышления модель динамически распределяет мышление на основе вашего параметра уровня усилий. Расширенное мышление и адаптивное рассуждение работают вместе, чтобы дать вам контроль над тем, насколько глубоко Claude рассуждает перед ответом.
Расширенное мышление особенно ценно для сложных архитектурных решений, сложных ошибок, многошагового планирования реализации и оценки компромиссов между различными подходами.
Фразы вроде “think”, “think hard” и “think more” интерпретируются как обычные инструкции подсказки и не выделяют токены мышления.
Настройка режима мышления
Мышление включено по умолчанию, но вы можете его отрегулировать или отключить.| Область | Как настроить | Подробности |
|---|---|---|
| Уровень усилий | Запустите /effort, отрегулируйте в /model или установите CLAUDE_CODE_EFFORT_LEVEL | Контролируйте глубину мышления для Opus 4.6 и Sonnet 4.6. См. Отрегулируйте уровень усилий |
Ключевое слово ultrathink | Включите “ultrathink” в любом месте вашей подсказки | Устанавливает усилие на high для этого хода на Opus 4.6 и Sonnet 4.6. Полезно для одноразовых задач, требующих глубокого рассуждения, без постоянного изменения вашего параметра усилий |
| Сочетание клавиш переключения | Нажмите Option+T (macOS) или Alt+T (Windows/Linux) | Переключите мышление включено/выключено для текущего сеанса (все модели). Может потребоваться конфигурация терминала для включения сочетаний клавиш Option |
| Глобальное значение по умолчанию | Используйте /config для переключения режима мышления | Устанавливает ваше значение по умолчанию для всех проектов (все модели). Сохраняется как alwaysThinkingEnabled в ~/.claude/settings.json |
| Ограничить бюджет токенов | Установите переменную окружения MAX_THINKING_TOKENS | Ограничьте бюджет мышления определённым количеством токенов (игнорируется на Opus 4.6 и Sonnet 4.6, если не установлено на 0). Пример: export MAX_THINKING_TOKENS=10000 |
Ctrl+O для переключения режима подробности и просмотрите внутреннее рассуждение, отображаемое как серый курсивный текст.
Как работает расширенное мышление
Расширенное мышление контролирует, сколько внутреннего рассуждения Claude выполняет перед ответом. Больше мышления предоставляет больше пространства для изучения решений, анализа граничных случаев и самокоррекции ошибок. С Opus 4.6 и Sonnet 4.6, мышление использует адаптивное рассуждение: модель динамически распределяет токены мышления на основе уровня усилий, который вы выбираете. Это рекомендуемый способ настройки компромисса между скоростью и глубиной рассуждения. С более старыми моделями, мышление использует фиксированный бюджет до 31 999 токенов из вашего бюджета вывода. Вы можете ограничить это с помощью переменной окруженияMAX_THINKING_TOKENS, или отключить мышление полностью через /config или переключение Option+T/Alt+T.
MAX_THINKING_TOKENS игнорируется на Opus 4.6 и Sonnet 4.6, так как адаптивное рассуждение контролирует глубину мышления. Одно исключение: установка MAX_THINKING_TOKENS=0 всё ещё полностью отключает мышление на любой модели. Чтобы отключить адаптивное мышление и вернуться к фиксированному бюджету мышления, установите CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1. См. переменные окружения.
Возобновление предыдущих разговоров
При запуске Claude Code вы можете возобновить предыдущий сеанс:claude --continueпродолжает самый последний разговор в текущем каталогеclaude --resumeоткрывает средство выбора разговора или возобновляет по имениclaude --from-pr 123возобновляет сеансы, связанные с конкретным pull request
/resume для переключения на другой разговор.
Сеансы хранятся в каталоге проекта. Средство выбора /resume показывает сеансы из того же репозитория git, включая worktrees.
Назовите ваши сеансы
Дайте сеансам описательные имена, чтобы найти их позже. Это лучшая практика при работе над несколькими задачами или функциями.Назовите сеанс
Назовите сеанс при запуске с Или используйте Вы также можете переименовать любой сеанс из средства выбора: запустите
-n:/rename во время сеанса, что также показывает имя на строке подсказки:/resume, перейдите к сеансу и нажмите R.Используйте средство выбора сеанса
Команда/resume (или claude --resume без аргументов) открывает интерактивное средство выбора сеанса со следующими функциями:
Сочетания клавиш в средстве выбора:
| Сочетание клавиш | Действие |
|---|---|
↑ / ↓ | Навигация между сеансами |
→ / ← | Развернуть или свернуть сгруппированные сеансы |
Enter | Выберите и возобновите выделенный сеанс |
P | Предпросмотр содержимого сеанса |
R | Переименуйте выделенный сеанс |
/ | Поиск для фильтрации сеансов |
A | Переключение между текущим каталогом и всеми проектами |
B | Фильтр к сеансам из вашей текущей ветки git |
Esc | Выход из средства выбора или режима поиска |
- Имя сеанса или начальная подсказка
- Время, прошедшее с момента последней активности
- Количество сообщений
- Ветка Git (если применимо)
/rewind или --fork-session) сгруппированы под их корневым сеансом, что облегчает поиск связанных разговоров.
Запуск параллельных сеансов Claude Code с Git worktrees
При работе над несколькими задачами одновременно вам нужно, чтобы каждый сеанс Claude имел свою копию кодовой базы, чтобы изменения не конфликтовали. Git worktrees решают эту проблему, создавая отдельные рабочие каталоги, которые имеют свои собственные файлы и ветку, при этом совместно используя одну и ту же историю репозитория и удалённые соединения. Это означает, что вы можете иметь Claude, работающего над функцией в одном worktree, пока исправляете ошибку в другом, без того чтобы один сеанс мешал другому. Используйте флаг--worktree (-w) для создания изолированного worktree и запуска Claude в нём. Значение, которое вы передаёте, становится именем каталога worktree и именем ветки:
<repo>/.claude/worktrees/<name> и ветвятся из ветки удалённого репозитория по умолчанию. Ветка worktree названа worktree-<name>.
Вы также можете попросить Claude “work in a worktree” или “start a worktree” во время сеанса, и он автоматически создаст один.
Worktrees subagents
Subagents также могут использовать изоляцию worktree для параллельной работы без конфликтов. Попросите Claude “use worktrees for your agents” или настройте это в пользовательском subagent, добавивisolation: worktree в frontmatter агента. Каждый subagent получает свой собственный worktree, который автоматически очищается, когда subagent завершает работу без изменений.
Очистка worktrees
Когда вы выходите из сеанса worktree, Claude обрабатывает очистку на основе того, внесли ли вы изменения:- Нет изменений: worktree и его ветка удаляются автоматически
- Существуют изменения или коммиты: Claude предлагает вам сохранить или удалить worktree. Сохранение сохраняет каталог и ветку, чтобы вы могли вернуться позже. Удаление удаляет каталог worktree и его ветку, отбрасывая все незафиксированные изменения и коммиты
Ручное управление worktrees
Для большего контроля над расположением worktree и конфигурацией ветки создавайте worktrees непосредственно с Git. Это полезно, когда вам нужно проверить конкретную существующую ветку или разместить worktree вне репозитория.Контроль версий, не основанный на git
Изоляция worktree работает с git по умолчанию. Для других систем контроля версий, таких как SVN, Perforce или Mercurial, настройте hooks WorktreeCreate и WorktreeRemove для предоставления пользовательской логики создания и очистки worktree. При настройке эти hooks заменяют поведение git по умолчанию при использовании--worktree.
Для автоматизированной координации параллельных сеансов с общими задачами и обменом сообщениями см. команды агентов.
Получайте уведомления, когда Claude нуждается в вашем внимании
Когда вы запускаете долгоживущую задачу и переключаетесь на другое окно, вы можете настроить уведомления рабочего стола, чтобы узнать, когда Claude завершит работу или нуждается в вашем вводе. Это использует событиеNotification hook, которое срабатывает всякий раз, когда Claude ожидает разрешения, неактивен и готов к новой подсказке, или завершает аутентификацию.
Добавьте hook в ваши параметры
Откройте Если ваш файл параметров уже имеет ключ
~/.claude/settings.json и добавьте hook Notification, который вызывает команду уведомления вашей платформы:- macOS
- Linux
- Windows
hooks, объедините запись Notification в него, а не перезаписывайте. Вы также можете попросить Claude написать hook для вас, описав то, что вы хотите в CLI.Опционально сузьте matcher
По умолчанию hook срабатывает на всех типах уведомлений. Чтобы срабатывать только для конкретных событий, установите поле
matcher на одно из этих значений:| Matcher | Срабатывает когда |
|---|---|
permission_prompt | Claude нуждается в вашем одобрении для использования инструмента |
idle_prompt | Claude завершил и ожидает вашей следующей подсказки |
auth_success | Аутентификация завершена |
elicitation_dialog | Claude задаёт вам вопрос |
Проверьте hook
Введите
/hooks и выберите Notification для подтверждения появления hook. Выбор его показывает команду, которая будет запущена. Чтобы протестировать её от начала до конца, попросите Claude запустить команду, требующую разрешения, и переключитесь от терминала, или попросите Claude напрямую запустить уведомление.Используйте Claude как утилиту в стиле unix
Добавьте Claude в ваш процесс проверки
Предположим, вы хотите использовать Claude Code как линтер или рецензент кода. Добавьте Claude в ваш скрипт сборки:Pipe in, pipe out
Предположим, вы хотите передать данные в Claude и получить данные в структурированном формате. Передайте данные через Claude:Контролируйте формат вывода
Предположим, вам нужен вывод Claude в конкретном формате, особенно при интеграции Claude Code в скрипты или другие инструменты.Используйте текстовый формат (по умолчанию)
Используйте JSON формат
Спросите Claude о его возможностях
Claude имеет встроенный доступ к своей документации и может ответить на вопросы о своих собственных функциях и ограничениях.Примеры вопросов
Claude предоставляет ответы на основе документации на эти вопросы. Для исполняемых примеров и практических демонстраций обратитесь к конкретным разделам рабочих процессов выше.
Следующие шаги
Лучшие практики
Паттерны для получения максимума от Claude Code
Как работает Claude Code
Поймите агентский цикл и управление контекстом
Расширьте Claude Code
Добавьте skills, hooks, MCP, subagents и plugins
Справочная реализация
Клонируйте нашу справочную реализацию контейнера разработки