> ## Content Index
> Fetch the complete content index at: https://matveev.tech/llms.txt
> Use this file to discover other available public pages before exploring further.

# Что такое agent harness: обвязка, которая делает AI полезным
- URL: https://matveev.tech/agent-harness-chto-takoe/
- Published: 2026-03-21T09:25:21.000Z
- Updated: 2026-03-21T09:25:21.000Z
- Description: Agent harness — всё, что окружает AI-модель и превращает её в рабочего агента. Разбираем компоненты, примеры и отличие от framework.
- Author: Pavel Matveev
- Tags: Глоссарий, AI, Агенты

> TL;DR: Agent harness — это вся инфраструктура вокруг AI-модели, которая превращает её в рабочего агента. Промпты, инструменты, память, песочница, оркестрация. Если убрать harness, останется модель, которая умеет только принимать текст и выдавать текст.

Термин harness мелькает в документации Claude Code, в блогах OpenAI про Codex, в описании [MiniMax M2.7](https://matveev.tech/minimax-m27-self-evolution/). При этом нормального русскоязычного определения я так и не нашёл. Попробую закрыть этот пробел.

Формула простая: **Agent = Model + Harness**. Эту формулировку [используют в LangChain](https://blog.langchain.com/the-anatomy-of-an-agent-harness?ref=matveev.tech): если ты не модель, ты harness. Всё, что не является весами нейросети (код, конфигурация, логика выполнения), это и есть harness. На русском ближайший перевод «обвязка» или «оснастка», но в индустрии используют английский термин.

## Из чего состоит agent harness

Компоненты варьируются от продукта к продукту, но набор примерно такой:

| Компонент        | Что делает                                | Пример                                 |
| ---------------- | ----------------------------------------- | -------------------------------------- |
| Системный промпт | Задаёт роль, правила, ограничения         | CLAUDE.md, AGENTS.md                   |
| Инструменты      | Позволяют взаимодействовать с миром       | Bash, Read, Edit, MCP-серверы          |
| Файловая система | Даёт рабочее пространство и хранение      | Чтение кода, запись результатов, git   |
| Песочница        | Безопасное выполнение кода                | Docker-контейнер, sandboxed shell      |
| Память           | Сохраняет знания между сессиями           | Memory-файлы, persistent context       |
| Оркестрация      | Управляет субагентами и потоками          | Agent Teams, параллельные воркеры      |
| Хуки             | Детерминированные проверки на каждом шаге | Lint после коммита, тесты после правки |

Модель сама по себе умеет принимать токены и генерировать токены. Она не может выполнить код, прочитать файл, запомнить что-то между разговорами или открыть браузер. Всё это делает harness.

## Пример: Claude Code как harness

Claude Code — типичный harness вокруг модели Claude. Модель через него получает доступ к файловой системе проекта, может выполнять bash-команды, запускать тесты, ставить зависимости. При старте в контекст загружаются CLAUDE.md и memory-файлы (это память). Есть набор инструментов (Read, Edit, Grep, MCP-серверы), хуки для автоматических проверок и субагенты для параллельных задач.

Без всего этого Claude — чат-бот. С harness он может сам разобраться в проекте, написать код, прогнать тесты и создать пулл-реквест. Разница огромная, хотя модель та же самая.

## Agent harness vs framework vs scaffold

Эти три термина часто путают. Harrison Chase из LangChain предложил автомобильную аналогию: framework как шасси, runtime как двигатель, harness как навигация и электроника.

|              | Framework                    | Harness                                  |
| ------------ | ---------------------------- | ---------------------------------------- |
| Что это      | Библиотека, набор абстракций | Готовая система вокруг конкретной модели |
| Аналогия     | Набор инструментов в гараже  | Собранный автомобиль                     |
| Примеры      | LangChain, CrewAI, AutoGen   | Claude Code, Codex CLI, OpenClaw         |
| Кто собирает | Разработчик                  | Поставщик (или разработчик из framework) |

Scaffold — по сути синоним harness. Некоторые компании (Anthropic, OpenAI) используют scaffold, другие (LangChain, MiniMax) говорят harness. Смысл один: инфраструктура вокруг модели.

## Где применяется

- Кодинг-агенты (Claude Code, Codex, Cursor): harness определяет, какие файлы агент видит, как редактирует код, как запускает тесты
- Офисные агенты (OpenClaw, Cowork): harness подключает календарь, почту, документы и задаёт правила взаимодействия
- Исследовательские агенты, как в [MiniMax M2.7](https://matveev.tech/minimax-m27-self-evolution/): harness включает data-пайплайны, тренировочные окружения и мониторинг экспериментов
- Self-evolving агенты: harness, который модель может сама модифицировать и улучшать

## FAQ

**Можно ли сделать harness без фреймворка?** Да. Harness можно собрать из обычного кода: while-loop, вызовы API модели, инструменты, файловая система. Framework ускоряет сборку, но не обязателен.

**Влияет ли harness на качество работы агента?** Сильно. На [Terminal Bench 2.0](https://blog.langchain.com/the-anatomy-of-an-agent-harness?ref=matveev.tech) одна и та же модель Opus 4.6 показывает разные результаты в разных harness. Оптимизация harness может быть важнее выбора модели.

**Что такое harness engineering?** Новая дисциплина, которая занимается проектированием harness: какие инструменты дать модели, как управлять контекстом, как настроить петли обратной связи. [OpenAI](https://openai.com/ru-RU/index/harness-engineering?ref=matveev.tech) выпустили отдельный гайд по теме.

**Чем harness отличается от промпт-инжиниринга?** Промпт-инжиниринг фокусируется на тексте, который получает модель. Harness engineering охватывает всё остальное: инструменты, окружение, память, оркестрацию, верификацию. Промпт — часть harness, но далеко не весь harness.

## Что ещё почитать

- [3 паттерна воркфлоу AI-агентов](https://matveev.tech/patterny-workflow-ai-agentov/) — архитектурные паттерны, которые реализуются внутри harness
- [Субагенты в Codex: настраиваем AI-команду](https://matveev.tech/codex-subagents-tutorial/) — пример оркестрации как компонента harness
- [Память AI-агентов: контекст, RAG, графы и mem0](https://matveev.tech/pamyat-ai-agentov-rag-grafy-mem0/) — глубокое погружение в один из компонентов harness
- [MiniMax M2.7: модель, которая сама себя обучала](https://matveev.tech/minimax-m27-self-evolution/) — пример self-evolving harness на практике