В большой рамке один выделенный файл, от него стрелки к трём кругам, справа ряды бледных файловпапкаAGENTS.md

107

Как работает агент на компьютере

Без файла правил каждая новая сессия начинается с нуля: вы снова объясняете агенту, кто вы, где какие файлы и как с вами говорить. Агент на компьютере открыт в папке и сам работает с её файлами, поэтому правила кладут туда же, и агент читает их при каждом запуске. Записали один раз, и агент знает это в каждой сессии.

Откройте агента в папке

Агент работает в той папке, в которой вы его открыли. В приложении Claude, вкладка Code, папку сохраняют как окружение, чтобы потом открывать её одним выбором.

Окружение создаёте один раз: новая сессия (⌘N), под полем ввода выбор окружения, затем New environment (⌥⌘0), вкладка Local, ваша папка, Create environment. В русской версии приложения эти пункты называются «Выбрать среду», «Новая среда», «Добавить папку». Дальше окружение выбираете кликом или сочетанием ⌥⌘1–9.

Как открыть агента в папке KB: tools/claude Четыре кадра: открыть выбор окружения под полем ввода; выбрать New environment; во вкладке Local выбрать свою папку и нажать Create environment; папка появилась в списке окружений и выбрано. 1 Открой выбор окружения Спроси Claude… notes Auto нажми на окружение под полем ввода 2 New environment This computer ⌥⌘1 notes ✓ ⌥⌘2 Cloud · SSH + New environment ⌥⌘0 Спроси Claude… notes Auto 3 Local → папка → Create New environment Local SSH Cloud Папка ~/Documents/agent Create environment 4 Готово: agent в списке This computer ⌥⌘1 notes ⌥⌘2 agent ✓ ⌥⌘3 + New environment ⌥⌘0 Спроси Claude… agent Auto
Папка становится окружением за четыре шага.

AGENTS.md: правила, которые агент читает сам

AGENTS.md это файл правил, и имя здесь важно. Харнес, программа вокруг модели, ищет в папке файл именно с этим именем и читает его сам, без вашей просьбы. Остальные рабочие файлы называйте как угодно: агент найдёт их по ссылке из AGENTS.md.

У Claude Code одна оговорка. Если в папке лежит CLAUDE.md, он читает этот файл вместо AGENTS.md. В стартовом шаблоне штаба CLAUDE.md уже ведёт ссылкой на AGENTS.md, так что файл правил там один. Если в папке появился отдельный CLAUDE.md, правила из AGENTS.md Claude Code видеть перестанет.

В AGENTS.md ставят ссылку на файл о вас, me.md, чтобы агент в каждой сессии знал ваш контекст. Там же пишут стиль общения: например, писать без эмодзи или начинать ответ с шутки.

Как контекст о вас попадает в каждую новую сессию: me.md по ссылке из AGENTS.md Агент записывает с ваших слов файл me.md, вы читаете и правите его руками. В AGENTS.md стоит ссылка на me.md. Когда вы открываете в папке новую сессию, харнес сам читает AGENTS.md и по ссылке доходит до me.md. Новое правило включается с новой сессии. Агент записывает за вами Вы правите руками me.md контекст о вас AGENTS.md ссылка на me.md Новая сессия в папке харнес читает AGENTS.md сам пишет правите по ссылке при старте Новое правило включается с новой сессии
Харнес сам читает AGENTS.md при старте и по ссылке доходит до файла о вас.

Правило, которое вы дописали, заработает со следующей сессии: текущая его не увидит.

Проверьте, что правила работают

Откройте новую сессию в папке и спросите агента о себе. Он отвечает по me.md и держит правило общения, которое вы добавили. Если агент вас не знает, проверьте по порядку: сессия новая; файл называется ровно AGENTS.md; рядом нет отдельного CLAUDE.md; в AGENTS.md есть ссылка на me.md.

AGENTS.md агент читает целиком на каждый запрос, поэтому в нём держат только то, что нужно всегда. Ориентир на старте 40–60 строк. Частая ошибка: сложить в файл правил прошлогодние регламенты и переписку со встреч. Такой файл дорастает до полутора тысяч строк, контекст основной сессии до 120 тысяч токенов, и агент хуже держит суть. Процедуру из нескольких шагов, которая нужна время от времени, сохраняют отдельным файлом, скиллом: о нём следующая глава.