Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

На этой странице собраны короткие рецепты для повседневной разработки. Для получения более высокоуровневого руководства по подсказкам и управлению контекстом см. Лучшие практики. На этой странице рассматриваются:

​
Рецепты подсказок

Это паттерны подсказок для повседневных задач, таких как изучение незнакомого кода, отладка, рефакторинг, написание тестов и создание PR. Каждый работает на любой поверхности 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
Советы:
  • Будьте конкретны в том, что вы ищете
  • Используйте предметный язык из проекта
  • Установите плагин анализа кода для вашего языка, чтобы дать Claude точную навигацию “перейти к определению” и “найти ссылки”

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

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

​
Создание pull requests

Вы можете создавать pull requests, попросив Claude напрямую (“create a pr for my changes”), или направить Claude пошагово:
1

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

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

Создайте pull request

create a pr
3

Просмотрите и уточните

enhance the PR description with more context about the security improvements
Когда вы создаёте PR с помощью gh pr create, сеанс автоматически связывается с этим PR. Чтобы вернуться к нему позже, запустите claude --from-pr <number> или вставьте URL PR в средство выбора /resume.
Просмотрите PR, созданный Claude, перед отправкой и попросите 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 Code работает в любом каталоге. Запустите его внутри хранилища заметок, папки документации или любой коллекции файлов markdown для поиска, редактирования и переорганизации содержимого так же, как вы работаете с кодом. Каталог .claude/ и CLAUDE.md находятся рядом с каталогами конфигурации других инструментов без конфликтов. Claude читает файлы заново при каждом вызове инструмента, поэтому он видит изменения, которые вы вносите в другом приложении при следующем чтении этого файла.

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

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

Предположим, вы хотите, чтобы Claude автоматически выполнял задачу на повторяющейся основе, например просматривая открытые PR каждое утро, проверяя зависимости еженедельно или проверяя сбои CI в течение ночи. Выберите вариант планирования на основе того, где вы хотите, чтобы задача выполнялась:
ВариантГде выполняетсяЛучше всего для
RoutinesИнфраструктура, управляемая AnthropicЗадачи, которые должны выполняться даже когда ваш компьютер выключен. Также может срабатывать на вызовы API или события GitHub в дополнение к расписанию. Настройте на claude.ai/code/routines.
Запланированные задачи рабочего столаВаша машина, через настольное приложениеЗадачи, которым нужен прямой доступ к локальным файлам, инструментам или незафиксированным изменениям.
GitHub ActionsВаш конвейер CIЗадачи, связанные с событиями репозитория, такими как открытые PR, или расписания cron, которые должны находиться рядом с конфигурацией рабочего процесса.
/loopТекущий сеанс CLIБыстрый опрос во время открытого сеанса. Задачи отменяются при начале нового разговора; --resume и --continue восстанавливают неистекшие.
При написании подсказок для запланированных задач будьте явны в отношении того, что означает успех и что делать с результатами. Задача выполняется автономно, поэтому она не может задавать уточняющие вопросы. Например: “Просмотрите открытые PR с меткой needs-review, оставьте встроенные комментарии по любым проблемам и опубликуйте сводку в канале #eng-reviews Slack.”

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

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

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

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills 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 предоставляет ответы на основе документации на эти вопросы. Для исполняемых примеров запустите /powerup для интерактивных уроков с анимированными демонстрациями, или обратитесь к конкретным разделам рабочих процессов выше.
Советы:
  • Claude всегда имеет доступ к последней документации Claude Code, независимо от версии, которую вы используете
  • Задавайте конкретные вопросы для получения подробных ответов
  • Claude может объяснить сложные функции, такие как интеграция MCP, конфигурации предприятия и продвинутые рабочие процессы

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

Когда задача охватывает несколько сеансов, продолжайте с того места, где вы остановились, вместо того чтобы переобъяснять контекст. Claude Code сохраняет каждый разговор локально. 
claude --continue
Это возобновляет самый последний сеанс в текущем каталоге; если его ещё нет, выводится No conversation found to continue и программа выходит. Используйте claude --resume для выбора из списка, или /resume из активного сеанса. См. Управление сеансами для именования, ветвления и полного справочника средства выбора.

​
Запуск параллельных сеансов с worktrees

Работайте над функцией в одном терминале, пока Claude исправляет ошибку в другом, без конфликтов редактирования. Каждый worktree — это отдельный checkout на своей собственной ветке. 
claude --worktree feature-auth
Запустите ту же команду с другим именем во втором терминале для запуска изолированного параллельного сеанса. См. Worktrees для очистки, .worktreeinclude и поддержки VCS, не основанной на git. Для мониторинга параллельных сеансов с одного экрана вместо отдельных терминалов см. фоновые агенты.

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

Для изменений, которые вы хотите просмотреть перед их записью на диск, переключитесь в режим плана. Claude читает файлы и предлагает план, но не вносит изменения, пока вы не одобрите. 
claude --permission-mode plan
Вы также можете нажать Shift+Tab во время сеанса для переключения в режим плана. См. Plan Mode для потока одобрения и редактирования плана в вашем текстовом редакторе.

​
Делегирование исследований subagents

Изучение большой кодовой базы заполняет ваш контекст чтением файлов. Делегируйте исследование, чтобы только результаты вернулись. 
use a subagent to investigate how our auth system handles token refresh
Subagent читает файлы в своём собственном контекстном окне и сообщает сводку. См. Subagents для определения пользовательских агентов с их собственными инструментами и подсказками.

​
Передача Claude в скрипты

Запустите Claude неинтерактивно для CI, pre-commit hooks или пакетной обработки. Stdin и stdout работают как любой Unix инструмент. 
git log --oneline -20 | claude -p "summarize these recent commits"
См. Неинтерактивный режим для форматов вывода, флагов разрешений и паттернов fan-out.

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

Лучшие практики

Паттерны для получения максимума от Claude Code

Управление сеансами

Возобновление, именование и ветвление разговоров

Worktrees

Запуск изолированных параллельных сеансов

Расширение Claude Code

Добавление skills, hooks, MCP, subagents и plugins