Смотреть урок
Когда вы запускаете новую сессию в Claude Code, агент первым делом читает файл claude.md в корне проекта. В этом файле хранятся системные инструкции: кто он, как должен себя вести, что ему можно делать, а чего нельзя. Если файла нет, агент каждый раз начинает с нуля и сам решает, как действовать. Если файл составлен грамотно, агент с первого сообщения понимает контекст и работает по нему. В других инструментах этот файл называется иначе — agent.md в Codex, codex.md в Codex CLI — но логика везде одна.
В claude.md нужно описать три вещи.
Первая и самая важная — роль. Нужно написать, кем агент выступает в вашем проекте и как он себя ведёт. Роль задаёт рамку, в которой агент будет принимать решения. Вот пример:
Ты — опытный Python-разработчик. Предпочитаешь чистый типизированный код. Не извиняешься, а исправляешь ошибки.
Вторая — ограничения и запреты. Роман советует задавать их жёстко. Например, запретить агенту удалять файлы без вашего подтверждения, работать в основной ветке репозитория или принимать сложные архитектурные решения самостоятельно. Если агенту нужно создать принципиально новое решение, он должен создать отдельную ветку разработки (work tree) и работать в ней — чтобы можно было откатить изменения, если что-то пойдёт не так. Без таких ограничений агент может натворить дел: удалить базу данных, сломать структуру проекта или переписать код, который трогать не стоило. Роман прописывает у себя такое правило:
При любых сложных архитектурных или инфраструктурных действиях агент обязан задать вопрос и вынести решение на обсуждение.
Третья — паттерны поведения. Стоит указать, на каком языке отвечать, в каком формате выдавать результат, нужны ли подробные пояснения или только конкретные ответы без воды. Если работаете с Gemini через Antigravity CLI и не пропишете «отвечай по-русски», агент будет писать на английском.
Рядом с ролью и правилами полезно сразу указать контекст проекта — технологический стек, архитектуру, ключевые ограничения:
Стек: FastAPI + React. БД: PostgreSQL. Auth: JWT. Структура src/. Без class-компонентов.
Оптимальный объём claude.md, по опыту Романа, — 100 строк, максимум 200. Если файл разрастётся больше, он начнёт съедать слишком много контекстного окна при каждом запуске сессии.
Всё, что не относится к базовым инструкциям, лучше вынести в отдельные файлы: описание архитектуры проекта отдельно, правила обработки ошибок отдельно, инструкции по конкретным фичам отдельно. В claude.md при этом нужно оставить ссылки на эти файлы. Когда агент встретит такую ссылку, он обратится к нужному файлу…