Перейти к основному содержанию
Claude Code — это агентивный помощник, который работает в вашем терминале. Хотя он отлично справляется с кодированием, он может помочь с чем угодно, что вы можете делать из командной строки: писать документацию, запускать сборки, искать файлы, исследовать темы и многое другое. Это руководство охватывает основную архитектуру, встроенные возможности и советы по эффективной работе с Claude Code. Пошаговые инструкции см. в разделе Типичные рабочие процессы. Информацию о функциях расширяемости, таких как skills, MCP и hooks, см. в разделе Расширение Claude Code.

​
Агентивный цикл

Когда вы даёте Claude задачу, он работает через три фазы: сбор контекста, выполнение действия и проверка результатов. Эти фазы переплетаются. Claude использует инструменты на протяжении всего процесса, будь то поиск файлов для понимания вашего кода, редактирование для внесения изменений или запуск тестов для проверки своей работы. Агентивный цикл: ваш запрос приводит к тому, что Claude собирает контекст, выполняет действия, проверяет результаты и повторяет процесс до завершения задачи. Вы можете прервать процесс в любой момент. Цикл адаптируется к тому, что вы просите. Вопрос о вашей кодовой базе может потребовать только сбора контекста. Исправление ошибки проходит через все три фазы повторно. Рефакторинг может включать обширную проверку. Claude решает, что требуется на каждом этапе, на основе того, что он узнал на предыдущем этапе, объединяя десятки действий вместе и корректируя курс по ходу дела. Вы также являетесь частью этого цикла. Вы можете прервать процесс в любой момент, чтобы направить Claude в другом направлении, предоставить дополнительный контекст или попросить его попробовать другой подход. Claude работает автономно, но остаётся отзывчивым к вашему вводу. Агентивный цикл питается двумя компонентами: моделями, которые рассуждают, и инструментами, которые действуют. Claude Code служит агентивной оболочкой вокруг Claude: он предоставляет инструменты, управление контекстом и среду выполнения, которые превращают языковую модель в способного агента кодирования.

​
Модели

Claude Code использует модели Claude для понимания вашего кода и рассуждения о задачах. Claude может читать код на любом языке, понимать, как компоненты связаны, и выяснять, что нужно изменить для достижения вашей цели. Для сложных задач он разбивает работу на этапы, выполняет их и корректирует на основе того, что узнаёт. Доступны несколько моделей с различными компромиссами. Sonnet хорошо справляется с большинством задач кодирования. Opus обеспечивает более сильное рассуждение для сложных архитектурных решений. Переключайтесь с помощью /model во время сеанса или начните с claude --model <name>. Когда в этом руководстве говорится «Claude выбирает» или «Claude решает», это модель, которая выполняет рассуждение.

​
Инструменты

Инструменты — это то, что делает Claude Code агентивным. Без инструментов Claude может только отвечать текстом. С инструментами Claude может действовать: читать ваш код, редактировать файлы, запускать команды, искать в Интернете и взаимодействовать с внешними сервисами. Каждое использование инструмента возвращает информацию, которая поступает обратно в цикл, информируя следующее решение Claude. Встроенные инструменты обычно делятся на пять категорий, каждая из которых представляет различный вид агентивности.
КатегорияЧто может делать Claude
Операции с файламиЧитать файлы, редактировать код, создавать новые файлы, переименовывать и реорганизовывать
ПоискНаходить файлы по шаблону, искать содержимое с помощью regex, исследовать кодовые базы
ВыполнениеЗапускать команды shell, запускать серверы, запускать тесты, использовать git
ВебИскать в Интернете, получать документацию, искать сообщения об ошибках
Интеллект кодаВидеть ошибки типов и предупреждения после редактирования, переходить к определениям, находить ссылки (требует плагины интеллекта кода)
Это основные возможности. Claude также имеет инструменты для создания subagents, задания вам вопросов и других задач оркестрации. Полный список см. в разделе Инструменты, доступные Claude. Claude выбирает, какие инструменты использовать, на основе вашего запроса и того, что он узнаёт по ходу дела. Когда вы говорите «исправьте неудачные тесты», Claude может:
  1. Запустить набор тестов, чтобы увидеть, что не работает
  2. Прочитать вывод ошибки
  3. Найти соответствующие исходные файлы
  4. Прочитать эти файлы, чтобы понять код
  5. Отредактировать файлы, чтобы исправить проблему
  6. Снова запустить тесты для проверки
Каждое использование инструмента даёт Claude новую информацию, которая информирует следующий шаг. Это агентивный цикл в действии. Расширение базовых возможностей: Встроенные инструменты — это основа. Вы можете расширить то, что знает Claude, с помощью skills, подключиться к внешним сервисам с помощью MCP, автоматизировать рабочие процессы с помощью hooks и делегировать задачи subagents. Эти расширения образуют слой поверх основного агентивного цикла. Руководство по выбору правильного расширения для ваших потребностей см. в разделе Расширение Claude Code.

​
Что Claude может получить доступ

Это руководство сосредоточено на терминале. Claude Code также работает в VS Code, JetBrains IDEs и других средах. Когда вы запускаете claude в каталоге, Claude Code получает доступ к:
  • Вашему проекту. Файлы в вашем каталоге и подкаталогах, а также файлы в других местах с вашего разрешения.
  • Вашему терминалу. Любой команде, которую вы можете запустить: инструменты сборки, git, менеджеры пакетов, системные утилиты, скрипты. Если вы можете это сделать из командной строки, Claude тоже может.
  • Вашему состоянию git. Текущей ветке, незафиксированным изменениям и истории недавних коммитов.
  • Вашему CLAUDE.md. Файл markdown, где вы храните инструкции, специфичные для проекта, соглашения и контекст, который Claude должен знать в каждом сеансе.
  • Автоматической памяти. Обучение, которое Claude сохраняет автоматически по мере работы, например шаблоны проекта и ваши предпочтения. Первые 200 строк MEMORY.md загружаются в начале каждого сеанса.
  • Расширениям, которые вы настраиваете. MCP servers для внешних сервисов, skills для рабочих процессов, subagents для делегированной работы и Claude в Chrome для взаимодействия с браузером.
Поскольку Claude видит весь ваш проект, он может работать по всему проекту. Когда вы просите Claude «исправить ошибку аутентификации», он ищет соответствующие файлы, читает несколько файлов для понимания контекста, вносит скоординированные изменения в них, запускает тесты для проверки исправления и фиксирует изменения, если вы попросите. Это отличается от встроенных помощников кода, которые видят только текущий файл.

​
Среды и интерфейсы

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

​
Среды выполнения

Claude Code работает в трёх средах, каждая с различными компромиссами для того, где выполняется ваш код.
СредаГде выполняется кодВариант использования
ЛокальнаяВаша машинаПо умолчанию. Полный доступ к вашим файлам, инструментам и среде
ОблакоУправляемые Anthropic виртуальные машиныДелегировать задачи, работать с репозиториями, которые у вас нет локально
Удалённое управлениеВаша машина, управляемая из браузераИспользовать веб-интерфейс, сохраняя всё локально

​
Интерфейсы

Вы можете получить доступ к Claude Code через терминал, настольное приложение, расширения IDE, claude.ai/code, Remote Control, Slack и CI/CD pipelines. Интерфейс определяет, как вы видите и взаимодействуете с Claude, но основной агентивный цикл идентичен. Полный список см. в разделе Используйте Claude Code везде.

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

Claude Code сохраняет вашу беседу локально по мере работы. Каждое сообщение, использование инструмента и результат сохраняются, что позволяет откатывать, возобновлять и разветвлять сеансы. Перед тем как Claude вносит изменения в код, он также создаёт снимок затронутых файлов, чтобы вы могли откатить, если потребуется. Сеансы независимы. Каждый новый сеанс начинается со свежего context window, без истории беседы из предыдущих сеансов. Claude может сохранять обучение между сеансами, используя автоматическую память, и вы можете добавить свои собственные постоянные инструкции в CLAUDE.md.

​
Работа между ветвями

Каждая беседа Claude Code — это сеанс, привязанный к вашему текущему каталогу. Когда вы возобновляете, вы видите только сеансы из этого каталога. Claude видит файлы вашей текущей ветви. Когда вы переключаетесь между ветвями, Claude видит файлы новой ветви, но история вашей беседы остаётся той же. Claude помнит, что вы обсуждали, даже после переключения. Поскольку сеансы привязаны к каталогам, вы можете запускать параллельные сеансы Claude Code, используя git worktrees, которые создают отдельные каталоги для отдельных ветвей.

​
Возобновление или разветвление сеансов

Когда вы возобновляете сеанс с помощью claude --continue или claude --resume, вы продолжаете с того же места, используя тот же ID сеанса. Новые сообщения добавляются к существующей беседе. Полная история вашей беседы восстанавливается, но разрешения, ограниченные сеансом, нет. Вам нужно будет повторно одобрить их. Непрерывность сеанса: возобновление продолжает тот же сеанс, разветвление создаёт новую ветвь с новым ID. Чтобы разветвиться и попробовать другой подход без влияния на исходный сеанс, используйте флаг --fork-session: 
claude --continue --fork-session
Это создаёт новый ID сеанса, сохраняя историю беседы до этого момента. Исходный сеанс остаётся неизменным. Как и при возобновлении, разветвлённые сеансы не наследуют разрешения, ограниченные сеансом. Один и тот же сеанс в нескольких терминалах: Если вы возобновляете один и тот же сеанс в нескольких терминалах, оба терминала записывают в один и тот же файл сеанса. Сообщения из обоих чередуются, как если бы два человека писали в одном блокноте. Ничего не повреждается, но беседа становится запутанной. Каждый терминал видит только свои собственные сообщения во время сеанса, но если вы возобновите этот сеанс позже, вы увидите всё чередующимся. Для параллельной работы с одной и той же начальной точки используйте --fork-session, чтобы дать каждому терминалу свой чистый сеанс.

​
Context window

Context window Claude содержит историю вашей беседы, содержимое файлов, выходы команд, CLAUDE.md, автоматическую память, загруженные skills и системные инструкции. По мере работы контекст заполняется. Claude автоматически компактирует, но инструкции с начала беседы могут быть потеряны. Поместите постоянные правила в CLAUDE.md и запустите /context, чтобы увидеть, что использует место.

​
Когда контекст заполняется

Claude Code управляет контекстом автоматически по мере приближения к лимиту. Он сначала очищает старые выходы инструментов, затем суммирует беседу, если потребуется. Ваши запросы и ключевые фрагменты кода сохраняются; подробные инструкции с начала беседы могут быть потеряны. Поместите постоянные правила в CLAUDE.md, а не полагайтесь на историю беседы. Чтобы контролировать, что сохраняется во время компактирования, добавьте раздел «Compact Instructions» в CLAUDE.md или запустите /compact с фокусом (например, /compact focus on the API changes). Запустите /context, чтобы увидеть, что использует место. MCP servers добавляют определения инструментов к каждому запросу, поэтому несколько серверов могут потребить значительный контекст, прежде чем вы начнёте работать. Запустите /mcp, чтобы проверить затраты на каждый сервер.

​
Управление контекстом с помощью skills и subagents

Помимо компактирования, вы можете использовать другие функции для контроля того, что загружается в контекст. Skills загружаются по требованию. Claude видит описания skills в начале сеанса, но полное содержимое загружается только при использовании skill. Для skills, которые вы вызываете вручную, установите disable-model-invocation: true, чтобы описания не попадали в контекст, пока они вам не понадобятся. Subagents получают свой собственный свежий контекст, полностью отделённый от вашей основной беседы. Их работа не раздувает ваш контекст. По завершении они возвращают резюме. Эта изоляция — причина, по которой subagents помогают при длительных сеансах. Информацию о том, что стоит каждая функция, см. в разделе затраты контекста, а советы по управлению контекстом см. в разделе снижение использования токенов.

​
Оставайтесь в безопасности с контрольными точками и разрешениями

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

​
Откат изменений с контрольными точками

Каждое редактирование файла обратимо. Перед редактированием любого файла Claude создаёт снимок текущего содержимого. Если что-то пойдёт не так, нажмите Esc дважды, чтобы откатиться к предыдущему состоянию, или попросите Claude отменить. Контрольные точки локальны для вашего сеанса, отделены от git. Они охватывают только изменения файлов. Действия, которые влияют на удалённые системы (базы данных, API, развёртывания), не могут быть контрольными точками, поэтому Claude спрашивает перед запуском команд с внешними побочными эффектами.

​
Контролируйте, что может делать Claude

Нажмите Shift+Tab, чтобы циклически переключаться между режимами разрешений:
  • По умолчанию: Claude спрашивает перед редактированием файлов и командами shell
  • Автоматическое принятие редактирования: Claude редактирует файлы без запроса, всё ещё спрашивает для команд
  • Plan Mode: Claude использует только инструменты только для чтения, создавая план, который вы можете одобрить перед выполнением
  • Auto mode: Claude оценивает все действия с проверками безопасности в фоновом режиме. В настоящее время это исследовательский предпросмотр
Вы также можете разрешить определённые команды в .claude/settings.json, чтобы Claude не спрашивал каждый раз. Это полезно для доверенных команд, таких как npm test или git status. Параметры могут быть ограничены от политик на уровне организации до личных предпочтений. Подробности см. в разделе Разрешения.

​
Эффективная работа с Claude Code

Эти советы помогут вам получить лучшие результаты от Claude Code.

​
Попросите помощь у Claude Code

Claude Code может научить вас, как его использовать. Задавайте вопросы типа «как мне настроить hooks?» или «какой лучший способ структурировать мой CLAUDE.md?» и Claude объяснит. Встроенные команды также помогут вам в настройке:
  • /init проведёт вас через создание CLAUDE.md для вашего проекта
  • /agents помогает вам настроить пользовательские subagents
  • /doctor диагностирует распространённые проблемы с вашей установкой

​
Это беседа

Claude Code — это беседа. Вам не нужны идеальные запросы. Начните с того, что вы хотите, затем уточните: 
Исправьте ошибку входа
[Claude исследует, пробует что-то] 
Это не совсем правильно. Проблема в обработке сеанса.
[Claude корректирует подход] Когда первая попытка не удалась, вы не начинаете заново. Вы итерируете.

​
Прерывание и управление

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

​
Будьте конкретны с самого начала

Чем точнее ваш начальный запрос, тем меньше коррекций вам потребуется. Ссылайтесь на конкретные файлы, упоминайте ограничения и указывайте на примеры шаблонов. 
Процесс оформления заказа сломан для пользователей с истёкшими картами.
Проверьте src/payments/ на предмет проблемы, особенно обновление токена.
Сначала напишите неудачный тест, затем исправьте его.
Расплывчатые запросы работают, но вы потратите больше времени на управление. Конкретные запросы, подобные приведённому выше, часто успешны с первой попытки.

​
Дайте Claude что-то для проверки

Claude работает лучше, когда может проверить свою собственную работу. Включите тестовые случаи, вставьте скриншоты ожидаемого пользовательского интерфейса или определите результат, который вы хотите. 
Реализуйте validateEmail. Тестовые случаи: '[email protected]' → true,
'invalid' → false, '[email protected]' → false. Запустите тесты после.
Для визуальной работы вставьте скриншот дизайна и попросите Claude сравнить его реализацию с ним.

​
Исследуйте перед реализацией

Для сложных проблем отделите исследование от кодирования. Используйте режим плана (Shift+Tab дважды) для первого анализа кодовой базы: 
Прочитайте src/auth/ и поймите, как мы обрабатываем сеансы.
Затем создайте план добавления поддержки OAuth.
Просмотрите план, уточните его через беседу, затем позвольте Claude реализовать. Этот двухфазный подход даёт лучшие результаты, чем прямой переход к коду.

​
Делегируйте, не диктуйте

Думайте о делегировании способному коллеге. Дайте контекст и направление, затем доверьте Claude разобраться с деталями: 
Процесс оформления заказа сломан для пользователей с истёкшими картами.
Соответствующий код находится в src/payments/. Можете ли вы исследовать и исправить это?
Вам не нужно указывать, какие файлы читать или какие команды запускать. Claude это выясняет.

​
Что дальше

Расширение с функциями

Добавьте Skills, подключения MCP и пользовательские команды

Типичные рабочие процессы

Пошаговые руководства для типичных задач