SpyBara
Go Premium

how-claude-code-works.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

This page contains 38 additions and 76 deletions.

2026
Thu 10 23:00 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Как работает Claude Code

Поймите агентивный цикл, встроенные инструменты и то, как Claude Code взаимодействует с вашим проектом.

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

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

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

Когда вы даёте Claude задачу, он работает через три фазы: сбор контекста, выполнение действия и проверка результатов. Эти фазы переплетаются. 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 в каталоге, Claude Code получает доступ к:

  • Вашему проекту. Файлы в вашем каталоге и подкаталогах, а также файлы в других местах с вашего разрешения.
  • Вашему терминалу. Любой команде, которую вы можете запустить: инструменты сборки, git, менеджеры пакетов, системные утилиты, скрипты. Если вы можете это сделать из командной строки, Claude тоже может.
  • Вашему состоянию git. Текущей ветке, незафиксированным изменениям и истории недавних коммитов.
  • Вашему CLAUDE.md. Файл markdown, где вы храните инструкции, специфичные для проекта, соглашения и контекст, который Claude должен знать в каждом сеансе.
  • Автоматической памяти. Обучение, которое Claude сохраняет автоматически по мере работы, например ваши предпочтения. Первые 200 строк или 25 КБ 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 сохраняет вашу беседу локально по мере работы. Каждое сообщение, использование инструмента и результат записываются в простой текстовый файл JSONL в ~/.claude/projects/, что позволяет откатывать, возобновлять и разветвлять сеансы. Перед тем как Claude вносит изменения в код, он также создаёт снимок затронутых файлов, чтобы вы могли откатить, если потребуется. Информацию о путях, сохранении и способах очистки этих данных см. в разделе данные приложения в ~/.claude.

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

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

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

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

Поскольку сеансы привязаны к каталогам, вы можете запускать параллельные сеансы Claude Code, используя git worktrees, которые создают отдельные каталоги для отдельных ветвей.

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

Возобновление сеанса с помощью claude --continue или claude --resume открывает его повторно с тем же ID сеанса и добавляет новые сообщения к существующей беседе. Разветвление с помощью --fork-session или /branch копирует историю в новый ID сеанса, оставляя исходный неизменным.

Диаграмма непрерывности сеанса: возобновление продолжает тот же сеанс, разветвление создаёт новую ветвь с новым ID. Диаграмма непрерывности сеанса: возобновление продолжает тот же сеанс, разветвление создаёт новую ветвь с новым ID.

Информацию о флагах возобновления, средстве выбора /resume, именовании и том, что происходит, когда один и тот же сеанс открыт в двух терминалах, см. в разделе Управление сеансами.

Context window

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

Для интерактивного пошагового руководства по тому, что загружается и когда, см. Исследуйте context window.

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

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

Чтобы контролировать, что сохраняется во время компактирования, добавьте раздел «Compact Instructions» в CLAUDE.md или запустите /compact с фокусом (например, /compact focus on the API changes).

Если один файл или выход инструмента настолько велик, что контекст заполняется снова после каждого резюме, Claude Code прекращает auto-compact после нескольких попыток и вместо этого показывает ошибку. Информацию о шагах восстановления см. в разделе Auto-compaction stops with a thrashing error.

Запустите /context, чтобы увидеть, что использует место. Определения инструментов MCP отложены по умолчанию и загружаются по требованию через поиск инструментов, поэтому только имена инструментов и инструкции сервера потребляют контекст, пока Claude не использует конкретный инструмент.

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

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

Skills загружаются по требованию. Claude видит описания skills в начале сеанса, но полное содержимое загружается только при использовании skill. Для skills, которые вы вызываете вручную, установите disable-model-invocation: true, чтобы описания не попадали в контекст, пока они вам не понадобятся. Для skills, которые вы не писали, используйте skillOverrides, чтобы сделать то же самое из параметров.

Subagents работают в своём собственном context window. Subagent начинает с нуля, если это не fork, который начинается с копии вашей беседы на данный момент. В любом случае, вызовы инструментов subagent остаются вне вашего контекста, и Claude получает резюме, когда subagent завершает работу.

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

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

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

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

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

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

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

Выберите режим разрешений, чтобы установить, что Claude может делать без запроса. Нажмите Shift+Tab, чтобы циклически переключаться между режимами разрешений:

  • Auto: классификатор проверяет большинство действий в фоновом режиме и блокирует рискованные вместо того, чтобы спрашивать вас. На планах Pro, Max и Team это встроенный начальный режим разрешений для интерактивных сеансов терминала и VS Code
  • Manual: Claude спрашивает перед редактированием файлов и командами shell
  • Accept edits: Claude редактирует файлы и запускает общие команды файловой системы, такие как mkdir и mv, без запроса, всё ещё спрашивает для других команд
  • Plan: Claude исследует и предлагает план без редактирования ваших исходных файлов

Вы также можете разрешить определённые команды в .claude/settings.json, чтобы Claude не спрашивал каждый раз. Это полезно для доверенных команд, таких как npm test или git status. Параметры могут быть ограничены от политик на уровне организации до личных предпочтений. Подробности см. в разделе Разрешения.

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

Эти советы помогут вам получить лучшие результаты от Claude Code. Для получения дополнительной информации о конкретных запросах, проверке и планировании см. Лучшие практики.

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

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

Встроенные команды также помогут вам в настройке:

  • /init проведёт вас через создание CLAUDE.md для вашего проекта
  • /doctor запускает проверку настройки, которая диагностирует проблемы с установкой и конфигурацией и может их исправить

Это беседа

Claude Code — это беседа. Вам не нужны идеальные запросы. Начните с того, что вы хотите, затем уточните:

Исправьте ошибку входа

[Claude исследует, пробует что-то]

Это не совсем правильно. Проблема в обработке сеанса.

[Claude корректирует подход]

Когда первая попытка не удалась, вы не начинаете заново. Вы итерируете.

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

Вы можете перенаправить Claude в любой момент без ожидания завершения хода или начала заново:

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

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

Думайте о делегировании способному коллеге. Дайте контекст и направление, затем доверьте Claude разобраться с деталями:

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

Вам не нужно указывать, какие файлы читать или какие команды запускать. Claude это выясняет.

Что дальше

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

Добавьте skills и подключения MCP
graduation-cap Типичные рабочие процессы

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