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

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

​

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

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

​

Модели

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

​

Инструменты

Инструменты — это то, что делает Claude Code агентивным. Без инструментов Claude может только отвечать текстом. С инструментами Claude может действовать: читать ваш код, редактировать файлы, запускать команды, искать в Интернете и взаимодействовать с внешними сервисами. Каждое использование инструмента возвращает информацию, которая поступает обратно в цикл, информируя следующее решение Claude. Встроенные инструменты обычно делятся на пять категорий, каждая из которых представляет различный вид агентивности. Это основные возможности. 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 должен знать в каждой сессии. Если ваш репозиторий содержит AGENTS.md для других агентов кодирования, Claude может прочитать его вместо CLAUDE.md.
• Автоматической памяти. Обучение, которое Claude сохраняет автоматически по мере работы, например ваши предпочтения. Первые 200 строк или 25 КБ MEMORY.md, в зависимости от того, что меньше, загружаются в начале каждого сеанса.
• Расширениям, которые вы настраиваете. MCP servers для внешних сервисов, skills для рабочих процессов, subagents для делегированной работы и Claude в Chrome для взаимодействия с браузером.

Поскольку Claude видит весь ваш проект, он может работать по всему проекту. Когда вы просите Claude «исправить ошибку аутентификации», он ищет соответствующие файлы, читает несколько файлов для понимания контекста, вносит скоординированные изменения в них, запускает тесты для проверки исправления и фиксирует изменения, если вы попросите. Это отличается от встроенных помощников кода, которые видят только текущий файл.

​

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

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

​

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

Claude Code работает в трёх средах, каждая с различными компромиссами для того, где выполняется ваш код.

​

Интерфейсы

Вы можете получить доступ к 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 сеанса, оставляя исходный неизменным. Информацию о флагах возобновления, средстве выбора /resume, именовании и том, что происходит, когда один и тот же сеанс открыт в двух терминалах, см. в разделе Управление сеансами.

​

Context window

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

​

Context Claude Code добавляет самостоятельно

Если Claude следует правилу, которое вы не писали, например добавляет трейлер Co-Authored-By к коммиту, правило могло поступить из системного напоминания. По мере работы Claude Code добавляет свой собственный контекст к беседе наряду с вашими сообщениями:

• Ваши файлы CLAUDE.md
• Инструкции вашего стиля вывода