Простыми словами
Агент для кода - это модель, которой дали инструменты и право пользоваться ими в твоём проекте. Документация Claude Code так и объясняет устройство: модель рассуждает, инструменты действуют, а сам Claude Code - обвязка вокруг модели, которая даёт ей инструменты и следит за тем, что она видит. Без инструментов модель может только ответить текстом. С инструментами она может прочитать файл, поправить код, запустить команду, поискать в интернете.
Работа агента идёт циклом из трёх фаз: собрать контекст, сделать, проверить результат. Фазы перетекают друг в друга, и агент повторяет их, пока задача не закрыта. Вопрос про код может закончиться на первой фазе. Исправление ошибки пройдёт все три несколько раз.
Чем агент отличается от чата
| Чат с моделью | Агент для кода | |
|---|---|---|
| Что делает | отвечает текстом | меняет файлы и запускает команды |
| Откуда знает проект | из того, что ты вставил | читает папку сам |
| Перенос результата в проект | ты | агент |
| Кто проверяет | ты | агент по тестам и сборке, потом ты |
| Сколько шагов на задачу | один ответ | десятки действий подряд |
| Где работает | окно в браузере | терминал, редактор кода, облачная среда |
Главная разница - в последней строке цикла. Чат не узнаёт, сработал ли его совет. Агент запускает тест, видит, что тот упал, читает ошибку и правит снова. Поэтому одна и та же модель в чате и в агенте даёт разный результат на одной задаче.
Как агент решает задачу: пример
Ты пишешь: «почини упавшие тесты». Документация Claude Code разбирает ровно такой случай. Агент:
- запускает набор тестов, чтобы увидеть, что упало;
- читает вывод с ошибкой;
- ищет файлы, к которым она относится;
- читает их, чтобы понять код;
- правит;
- запускает тесты снова и проверяет, что теперь проходят.
Каждый шаг даёт ему новую информацию для следующего. Ты можешь вмешаться в любой момент: остановить, подсказать, повернуть в другую сторону.
Из чего состоит агент
- Модель. Думает и решает, какой шаг следующий. В Claude Code это модели Claude, в Codex - модели OpenAI. Модель меняется командой, например
/modelв Claude Code. - Инструменты. Работа с файлами, поиск по проекту, запуск команд, поиск в интернете. Плюс внешние источники через MCP-серверы: база знаний, трекер задач, браузер.
- Контекст. Всё, что агент видит в текущей сессии: переписка, прочитанные файлы, правила проекта.
- Правила и скиллы. Файлы, которые агент читает сам: CLAUDE.md или AGENTS.md с правилами проекта и скиллы с инструкциями под отдельные задачи. Благодаря им промпт в сессии может быть коротким.
- Разрешения. Что агент делает без спроса, а на что просит подтверждение: правка файлов, запуск команд, выход в сеть.
Где работают агенты для кода
Агенты работают в нескольких местах, и одна программа часто есть сразу в нескольких видах.
- Терминал. Claude Code и Codex CLI запускаются командой в папке проекта. Это основной режим, в нём видно каждый шаг.
- Редактор кода. Расширения для VS Code и похожих редакторов показывают правки агента прямо в файлах. Как это устроено у Claude Code - в статье Claude Code в VS Code.
- Облако. Агент работает в отдельной среде на серверах разработчика и присылает готовые изменения. Так умеют Codex и Claude Code в веб-версии.
Чего агент не делает за тебя
Агент не знает, чего ты хочешь, если ты этого не написал. Документация Claude Code прямо говорит: модель может догадаться о намерении, но мысли не читает. Ещё агент останавливается, когда работа выглядит готовой, - и если у него нет теста или сборки для проверки, «выглядит готовой» остаётся единственным сигналом. Тогда проверкой становишься ты.
Отсюда простое правило работы: задача с понятным результатом, границы, что трогать нельзя, и способ проверки. С этими тремя вещами агент закрывает задачу без тебя. Без них - делает что-то похожее.
Как поставить агенту первую задачу
Начни с маленькой задачи, результат которой видно глазами: поправить текст на странице, добавить поле в форму, переименовать раздел в меню. Перед запуском убедись, что папка проекта под git - так любую правку можно откатить одной командой.
Задание пиши так, как написал бы новому подрядчику: что должно получиться, в каком файле, чего не трогать, как проверить. Агент покажет, какие файлы открыл и что изменил. Прочитай изменения, открой страницу и проверь сам. Если что-то не так, не поправляй агента пятью сообщениями подряд: очисти сессию и напиши задачу заново, с тем, что понял.
Через несколько таких задач станет видно, что ты повторяешь одно и то же в каждом задании. Это повод вынести повторяющееся в правила проекта и скиллы - дальше агент будет читать их сам.
Частые ошибки
Путать агента с чат-ботом. Задавать агенту вопросы, как в чате, и копировать ответы руками. Агенту ставят задачу - советы удобнее спрашивать в чате.
Давать непроверяемую задачу. «Сделай лучше» агент выполнит, но ты не сможешь сказать, выполнил ли. Назови признак готовности.
Открыть всё без git. Работать с агентом в папке без системы контроля версий - значит не иметь кнопки «отменить». Сначала git, потом агент.
Одна бесконечная сессия. Контекст растёт, агент путается и тратит больше лимита. Между разными задачами - /clear.
Не смотреть результат. Тесты прошли - ещё не значит, что страница выглядит как надо. Последнюю проверку делаешь ты.
Агент, субагент и мультиагентная работа
На этой странице агент - это вся программа, с которой ты работаешь. Внутри неё бывают субагенты: главный агент запускает помощника под отдельную подзадачу, у помощника свой контекст, а наверх возвращается короткий итог. Так шумная работа - прогон тестов, чтение логов - не забивает основную сессию. Как создавать субагентов в Claude Code и раздавать им задачи, разобрано в статье Claude Code агенты. Про агента, который работает на твоём компьютере без облака, - в статье локальный агент.
Что почитать дальше
- Claude Code: что это и как пользоваться - агент от Anthropic с нуля.
- Codex - что это за программа - агент от OpenAI.
- Codex или Claude Code - что выбрать под свою задачу.
- Claude Code агенты - субагенты и раздача задач.