Перейти к тексту

Claude Code: работа с coding-агентом1. Перед стартом

Карта: что такое coding-агент и где в ней Claude Code

Засчитывается, когда отвечены все вопросы квиза

Вы спрашиваете в чате, почему падает тест. Модель отвечает разумно, но гадает: файлов она не видела, тест не запускала. Вы копируете ей код, она предлагает правку, вы вставляете её руками, запускаете тесты, несёте ошибку обратно. Половину работы делаете вы — служите модели руками и глазами.

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

Зачем это нужно

Этот курс — не про одну программу. Он про то, как отдавать агенту реальные задачи в своём репозитории: держать контекст под контролем, направлять агента и резать большую работу на куски. Эти приёмы переносятся между агентами, поэтому сначала стоит понять, из чего агент состоит и чем один отличается от другого. Тогда вы не будете путать особенности инструмента с устройством подхода.

Как это устроено

Документация Claude Code описывает работу агента как agentic loop из трёх фаз: gather context (собрать контекст), take action (действовать) и verify results (проверить результат). Фазы перетекают одна в другую. Вопрос о коде может закончиться на сборе контекста, а исправление бага проходит все три фазы много раз подряд: прочитать тест, поправить код, запустить тест снова.

Цикл держится на двух частях:

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

Без tools модель умеет только отвечать текстом. С ними она получает результат каждого действия обратно в цикл и решает, каким будет следующий шаг.

Слой вокруг модели, который даёт ей tools и решает, что попадает в её контекст, документация называет agentic harness. Claude Code — это harness вокруг моделей Claude. Модель можно сменить командой, а harness остаётся тем же: те же tools, те же файлы настройки, тот же цикл.

Поверх цикла harness даёт механизмы расширения. В Claude Code это skills (знания и процедуры, которые агент подгружает по необходимости), MCP-серверы (подключение внешних сервисов), hooks (автоматизация на события) и subagents (отдельные агенты для подзадач). Их разберём в следующих разделах.

Рядом с Claude Code

Claude Code — не единственный harness. Рядом стоят Codex CLI от OpenAI, Cursor, GitHub Copilot в agent mode и другие. Устроены они похоже: модель, tools, цикл. Различаются моделями, интерфейсом и тем, как их настраивают.

Важнее то, что у них появляется общий слой — открытые форматы:

  • AGENTS.md — «README для агентов»: один файл в корне репозитория с командами сборки, тестов и соглашениями проекта. Формат вырос из совместной работы OpenAI Codex, Amp, Jules от Google, Cursor и Factory. Claude Code читает AGENTS.md вместо своего CLAUDE.md, если в репозитории лежит именно он.
  • Agent Skills — папка с файлом SKILL.md (имя, описание, инструкции) и, по желанию, скриптами и справочниками. Агент сначала видит только имя и описание skill-а и подгружает остальное, когда задача того требует. Один skill работает в любом агенте, который понимает формат.

Поэтому курс учит через эти форматы: то, что вы напишете в AGENTS.md или в skill, переживёт смену агента.

Практика

Если Claude Code уже установлен, откройте терминал в любом своём репозитории, запустите claude и дайте задачу, где без tools не обойтись:

Which test command does this project use? Run it and tell me how many tests pass.

Посмотрите, что агент делает до ответа: какие файлы читает, какую команду предлагает запустить и как разбирает её вывод. Это и есть agentic loop — сбор контекста, действие, проверка. Если Claude Code ещё не установлен, вернитесь к этому упражнению после Lab-а в конце раздела.

Подводные камни

  • Агент — не модель. «Claude Code плохо справился» и «модель плохо справилась» — разные диагнозы. Часто проблема в контексте, который harness собрал, а не в модели.
  • Чужие привычки не переносятся один в один. Общие форматы (AGENTS.md, skills) работают везде, а настройки разрешений, горячие клавиши и слэш-команды у каждого агента свои.

Вывод: coding-агент — это модель плюс harness, который даёт ей tools и управляет контекстом. Учите подход, а не кнопки: он одинаков у Claude Code и его соседей.

Проверь себя

Источники

Текст подготовлен с помощью LLM и может содержать неточности.