Содержание
Claude Code harness: что это и как работает
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 16 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Claude Code harness: что это и как работает — это слой, который превращает модель Claude в агента командной строки. Модель отвечает за рассуждение, harness — за цикл задачи, доступ к файлам, запуск команд и запрос подтверждений. В документации Anthropic Claude Code описан как агент командной строки, который работает в терминале, читает репозиторий, редактирует файлы, выполняет команды и запрашивает подтверждение перед потенциально опасными действиями. Мы скачали подборку результатов веб-поиска по запросу «Claude Code harness: что это и как работает»: текст отдали 10 из 10.
Что такое harness в первичной документации Anthropic
Слово harness в материалах Anthropic прямо не расшифровывается как отдельный термин. В справке Claude Code описан как инструмент кодирования, дающий прямой доступ к моделям Claude в терминале или поддерживаемой IDE, чтобы делегировать сложные задачи кодирования с сохранением прозрачности и контроля. Это описание и есть определение harness по смыслу: обвязка, которая соединяет модель с вашей рабочей средой.
Разбор дизайна harness в Claude Code на сайте Learn Harness Engineering выделяет подсистему инструкций как многоуровневую систему памяти, подсистему контекста как конвейер compaction, подсистему инструментов как набор механизмов расширения, а также обратную связь и верификацию с разделением ролей человека и машины. Обзор на Lucid Train разбирает вопрос, является ли Claude Code harness или агентом, и описывает, что делает harness Claude Code, а где начинается ваш собственный harness.
Практический смысл термина: harness — это всё, что стоит между текстовым запросом и реальным изменением в репозитории. Модель генерирует следующий шаг, harness решает, какие инструменты доступны, что попадает в контекст, какие действия требуют подтверждения и как результат возвращается обратно в цикл.
| Слой | За что отвечает | Где виден пользователю |
|---|---|---|
| Модель Claude | Рассуждение, генерация кода и плана | Ответы в сеансе |
| Harness | Цикл задачи, инструменты, память, разрешения | Терминал, IDE, веб-версия |
| Репозиторий | Файлы, тесты, история изменений | Ваша рабочая копия |
Цикл задачи и использование инструментов
Цикл строится вокруг повторяющихся шагов. Пользователь ставит задачу, harness передаёт её модели, модель выбирает инструмент, harness выполняет вызов и возвращает результат. В документации Anthropic описан ожидаемый результат для типового случая с падающим тестом: Claude Code читает файл теста, отслеживает путь кода через тестируемые модули, определяет несоответствие и предлагает редактирование, а после одобрения повторно запускает набор тестов для подтверждения исправления.
Инструменты в этом цикле делятся по назначению. Чтение файлов и поиск по репозиторию дают модели контекст. Редактирование файлов и запуск команд меняют состояние проекта. Тесты и линтеры возвращают детерминированную обратную связь, на которую модель опирается при следующей итерации. В справке Anthropic перечислены типичные случаи использования: исправление неудачного теста, понимание незнакомого кода, поиск места в коде, анализ ошибки или трассировки стека, рефакторинг с планом, написание тестов, проверка pull request, адаптация к новому репозиторию, решение задачи от начала до конца и превращение повторяющейся задачи в Skill.
Пример запроса из документации для случая с тестами выглядит так: «the tests in tests/auth.test.ts are failing, can you figure out why and fix them». Запрос задаёт цель и указывает файл, а поиск причины harness берёт на себя.
Отдельный режим — веб-версия. В справке Anthropic сказано, что Claude Code в веб-версии запускает задачи удалённо, работая с кодом из репозиториев GitHub. Вы выбираете репозиторий, описываете задачу, и Claude работает в удалённой среде; после запуска страницу можно закрыть, а по завершении Claude автоматически создаст pull request с изменениями для рассмотрения. Каждая задача выполняется в изолированной виртуальной машине, репозиторий клонируется в эту среду, а учётные данные GitHub управляются через защищённый прокси.
| Режим | Как ставится задача | Кто следит за ходом |
|---|---|---|
| Терминал или IDE | Запрос и уточнения в сеансе | Вы, синхронно |
| Веб-версия | Описание задачи для репозитория GitHub | Claude, асинхронно |
Контекст и разрешения
Управление контекстом — часть harness. Разбор на Learn Harness Engineering описывает подсистему контекста как конвейер compaction, который удерживает сеанс в рабочем состоянии по мере роста истории. Подсистема инструкций там же описана как многоуровневая система памяти: часть указаний живёт в проекте, часть задаётся на уровне пользователя.
Практический элемент этой памяти — файл CLAUDE.md. В наборе коммуникационных материалов Anthropic команда /init описана так: Claude читает проект и пишет CLAUDE.md с командами сборки и соглашениями, чтобы не переобъяснять основы при каждом сеансе. Так harness получает постоянный слой инструкций, который подставляется в контекст автоматически.
Разрешения — вторая половина управления. В описании Claude Code указано, что агент запрашивает подтверждение перед потенциально опасными действиями. В веб-версии к этому добавляются элементы управления безопасностью: ограниченный доступ в сеть и защищённая обработка учётных данных. Если задача требует доступа в интернет, например для установки пакетов, уровень доступа настраивается отдельно.
Отдельный слой — переменные окружения. В справке Anthropic отмечено, что при установленной переменной ANTHROPIC_API_KEY Claude Code использует этот ключ для аутентификации вместо подписки, что приводит к платежам за использование API. Проверка окружения перед началом работы относится к базовой гигиене.
Модель Claude и клиент Claude Code
Эти две сущности стоит развести. Модель Claude — это то, что генерирует рассуждение и код. Claude Code — клиент, который даёт доступ к моделям Claude в терминале или поддерживаемой IDE. Harness живёт в клиенте: он решает, какие инструменты вызвать, что положить в контекст и когда спросить разрешение.
В справке Anthropic для планов Pro и Max сказано, что подписка даёт доступ и к Claude в веб-версии, приложениях для рабочего стола и мобильных устройствах, и к Claude Code в терминале. Для планов Team и Enterprise Claude Code включён в места, а вход выполняется рабочей учётной записью с автоматической обработкой SSO. Ошибка 403 после входа обычно означает, что администратор ещё не включил доступ для рабочего пространства.
Расширения доступны для VS Code и JetBrains IDE: те же функции встроены в редактор. Подключение в IDE разобрано в статье Claude Code в Visual Studio: как подключить и работать. Если вы сравниваете клиентов, полезен материал Cline и Claude: как подключить модель.
Разница с автодополнением описана в справке Anthropic прямо: автодополнение предлагает следующие несколько строк, а Claude Code — это агент, которому дают задачу, и он читает файлы, запускает команды и делает многофайловые правки до завершения.
Что проверяет человек после работы агента
Проверка остаётся за человеком. В веб-версии по завершении задачи Claude отправляет изменения в новую ветку репозитория, вы получаете уведомление и можете проверить изменения, затем создать pull request из интерфейса. Pull request включает всю работу Claude, готовую к рассмотрению и дополнительным правкам.
В терминале точка проверки — момент подтверждения. Агент запрашивает разрешение перед потенциально опасными действиями, и это подтверждение и есть ваша проверка на раннем этапе. После выполнения задачи стоит посмотреть diff, убедиться, что тесты проходят, и оценить, соответствует ли решение задаче.
В наборе коммуникационных материалов Anthropic есть отдельная мысль про первую задачу: общие примеры не конвертируют, а конкретная формулировка вроде «исправить нестабильный тест в auth_test.go» — конвертирует. Тот же принцип работает и при проверке: чем конкретнее была постановка, тем понятнее, что именно проверять в результате.
Промпт, чтобы поручить агенту разбор падающего теста и получить готовый к проверке результат:
Разберись, почему падает тест в [файл с тестом]. Найди корневую причину, объясни её коротко, предложи исправление и внеси правку. После правки запусти этот тест и покажи результат. Если причина в коде приложения, а не в тесте, скажи об этом прямо. Изменения держи в пределах [модуль или директория].
В квадратных скобках подставьте свой файл и границы правки. Вариации той же задачи: попросить написать тесты для существующего модуля; попросить объяснить незнакомый участок кода перед изменением; попросить проверить pull request и перечислить риски; попросить отрефакторить участок с чётким объёмом; попросить превратить повторяющуюся задачу в Skill.
Частые вопросы
Что такое harness в Claude Code простыми словами?
Это обвязка вокруг модели: цикл задачи, доступ к инструментам, память проекта и правила подтверждений. Модель рассуждает, harness выполняет действия в вашей среде. В документации Anthropic Claude Code описан как агент командной строки, который читает репозиторий, редактирует файлы, выполняет команды и запрашивает подтверждение перед потенциально опасными действиями.
Claude Code — это модель или клиент?
Клиент. В справке Anthropic сказано, что Claude Code даёт прямой доступ к моделям Claude в терминале или поддерживаемой IDE. Модель отвечает за рассуждение и генерацию кода, клиент с harness — за инструменты, контекст и разрешения.
Как Claude Code управляет контекстом?
Через память проекта и сжатие истории. Разбор на Learn Harness Engineering описывает подсистему контекста как конвейер compaction, а подсистему инструкций — как многоуровневую систему памяти. Команда /init из набора Anthropic создаёт CLAUDE.md с командами сборки и соглашениями проекта.
Что проверяет человек после работы агента?
Diff, результат тестов и соответствие задаче. В веб-версии Claude отправляет изменения в новую ветку, вы получаете уведомление и можете создать pull request из интерфейса. В терминале проверка начинается с подтверждения потенциально опасных действий.
Чем Claude Code отличается от автодополнения?
Масштабом задачи. В справке Anthropic сказано, что автодополнение предлагает следующие несколько строк, а Claude Code читает файлы, запускает команды и делает многофайловые правки до завершения. Запрос формулируется как задача.