Из чего собран мой агент в Claude Code
(или некликбейтно 👉 Как настроил свой Claude Code)

Вся настройка Claude Code – это несколько текстовых файлов. Часть – глобальные, лежат в ~/.claude/, часть проектные – your-project/ и your-project/.claude/. Почти все – мдшки, то есть файлы в формате markdown. Агент читает их и применяет на разных этапах как инструкции. Это часть того, что принято называть контекстом


ГЛАВНОЕ

Глобальный клод мд (~/.claude/CLAUDE.md) – правила для всех проектов. Агент видит его всегда, с первой секунды любой сессии. У меня там описана общая схема работы. Если упрощать, она выглядит так – в каждом проекте есть клод мд с целью проекта и план с конкретными задачками, все

Проектный клод мд (your-project/CLAUDE.md) – цель проекта, схема папок и как работаем. Тоже всегда в контексте, но только внутри своего проекта

План (your-project/PLAN.md) – где мы сейчас и что осталось. Подробно расписан только текущий шаг. Это не про режим Plan, это просто мдшка: сам в контекст он не попадает, агент читает его, потому что так написано в проектном клод мд

Скиллы (глобальные ~/.claude/skills/ и проектные your-project/.claude/skills/) – инструкции под конкретную задачу. Название и короткое описание агент видит всегда, сам скилл – только когда вызывает его. Глобальные доступны везде, проектные – только внутри проекта

Например, у меня есть глобальный скилл brainstorm для мозгового штурма – его я использую в разных проектах. А ещё есть скилл docs-translation, он лежит в проекте Learn Claude – им я переводил и сжимал статьи из документации клода, в других проектах он мне незачем


ОСТАЛЬНОЕ

Стиль общения (~/.claude/output-styles/) – как агент со мной разговаривает: на «ты», простыми словами, коротко. Встраивается в системный промпт – это стартовые инструкции, с которыми начинается любая сессия, их не видно, пишет их сам Anthropic. Стиль действует всегда, во всех проектах

Хуки (~/.claude/hooks/) – скрипты, которые сами срабатывают на событие, например перед каждым действием агента. Подключаются в настройках. В контекст не попадают: агент о хуке не знает, пока тот его не остановит или не подскажет

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

Настройки (~/.claude/settings.json) – модель по умолчанию, разрешения, подключённые хуки, выбранный стиль общения и ещё несколько настроек. Трогаю редко


НЕ ПОЛЬЗУЮСЬ

Правила (your-project/.claude/rules/) – мне хватает клод мд. Но у правил есть прикольная фича: им можно задать пути, и тогда правило подтянется, только когда агент работает с подходящими файлами – например, только с мдшками

Автопамять (~/.claude/projects/your-project/memory/) – у себя выключил: всё нужное мне лежит в файлах проекта, где я это вижу и правлю

Агенты (your-project/.claude/agents/) – это инструкции для субагентов, они вызываются по описанию, как и скиллы. У меня их нет, скиллы всё закрывают


По-любому что-то забыл (из того, чем сам не пользуюсь). Полный набор на интерактивной карте в документации: Explore the .claude directory

И литтл тип: все эти файлы пишет сам агент, и они разрастаются. Перечитывайте их после правок и держите короткими