Настройка проекта в Claude Code в 2026: структура и конфиги

Настройка проекта в Claude Code — это создание структуры файлов и конфигов (CLAUDE.md, папка .Claude/, .mcp.json), которые объясняют агенту, где он работает, что знает и что ему разрешено трогать. Без этой структуры Claude Code каждый раз стартует с нуля: не помнит стек, не знает правил и лезет в файлы, которые лучше не трогать.

Собрала конфиги для десятка своих проектов и один раз объясняла это на созвоне с сеньором так путано, что он предложил сделать методичку. Вот она, только в блог.

Коротко: главное за минуту

Проект в Claude Code держится на трёх типах файлов: CLAUDE.md — текстовая память о проекте (стек, правила, контекст), settings.json — конфиг прав и поведения агента, .mcp.json — список внешних инструментов и баз, к которым агент может подключаться. Всё это лежит в папке .Claude/ внутри репозитория (кроме CLAUDE.md — он в корне). Часть файлов коммитится в git и живёт с проектом, часть — личная и остаётся только у тебя. Разберём по порядку, что куда класть.

Claude code настройка проекта: из чего она состоит

Если открыть любой мой рабочий репозиторий, в корне будет вот такой набор:

• CLAUDE.md — файл памяти, который Claude читает при каждом запуске в этой папке.
• .Claude/settings.json — общие настройки команды: разрешённые инструменты, модель, хуки.
• .Claude/settings.local.json — твои личные настройки, не для чужих глаз.
• .mcp.json — список MCP-серверов: базы данных, Figma, Notion, что угодно, к чему агент может подключиться.
• .Claude/commands/ — свои slash-команды, которые вызываются коротким /имя.
• .Claude/agents/ — саброагенты под конкретные подзадачи (тестировщик, ревьюер, документатор).

Ничего из этого не обязательно заводить сразу всё и сразу. На маленьком скрипте хватит одного CLAUDE.md. На проекте с командой из пяти человек будет весь список, и это того стоит.

Файл	Где лежит	Что делает	Когда трогать
CLAUDE.md	корень проекта	Контекст, правила, стек — то, что агент должен помнить	В начале работы над проектом
settings.json	.Claude/settings.json	Права на инструменты, модель по умолчанию, хуки	При первой настройке для команды
settings.local.json	.Claude/settings.local.json	Личные настройки, не идёт в git	Когда конфиг команды тебе не подходит
.mcp.json	корень или .Claude/	Список MCP-серверов (базы, API, интеграции)	При подключении внешних инструментов
commands/*.md	.Claude/commands/	Кастомные slash-команды	Когда повторяешь один и тот же промпт руками
agents/*.md	.Claude/agents/	Саброагенты под отдельные задачи	Когда одному агенту скучно за всё отвечать

CLAUDE.md — файл, который агент читает первым

Это не документация для людей, это памятка для модели. Пиши так, как объяснила бы новому джуну в первый день: какой стек, какие команды запускают тесты, чего категорически нельзя делать («не трогай миграции без ревью», «не пиши в prod-конфиг»).

Разрослась у меня эта штука однажды до простыни на три экрана — с историей проекта, извинениями за легаси и лирикой про дедлайны. Толку было ноль, агент половину игнорировал. Работает короче: 20–40 строк, конкретика, без «важно понимать, что». Структура, которая реально помогает:

• одна строка про стек и версии;
• список команд (npm run test, npm run build);
• жёсткие правила («не удаляй файлы в /migrations»);
• где искать примеры кода, если нужен паттерн.

Если тема Claude Code для тебя вообще новая и непонятно, зачем весь этот огород, — у меня есть отдельная статья про то, как использовать Claude Code с нуля, почитай сначала её, потом возвращайся сюда за конфигами.

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

Claude code конфигурация: settings.json и права доступа

settings.json — это про то, что агенту разрешено делать без спроса. По умолчанию Claude Code переспрашивает перед опасными действиями (удаление файлов, запуск команд в терминале), и это правильно. Но в конфиге можно явно разрешить безопасные операции (например, чтение файлов проекта) и явно запретить рискованные (запись в конкретные папки, доступ к .env).

Здесь же настраивается модель по умолчанию для проекта и хуки — скрипты, которые запускаются до или после действия агента (например, автоматический линтер после каждой правки файла).

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

.mcp.json и Claude code workspace для нескольких проектов

MCP-серверы — это способ подключить Claude Code к внешним данным: базе данных, Figma, Notion, поисковику по документации. Список серверов проекта живёт в .mcp.json, и агент видит только то, что явно прописано в этом файле для текущего репозитория.

Если тема MCP тебе незнакома целиком — я отдельно писала, что такое MCP у Claude и зачем оно нужно, там разбор с примерами.

Про Claude code workspace: если ты работаешь с несколькими проектами одновременно (что нормально для агентства или фрилансера), у каждого своя папка .Claude/ и свой CLAUDE.md — они не пересекаются. Общие для всех проектов правила (например, твой стиль код-ревью) можно один раз вынести в глобальный конфиг в домашней директории, и он будет действовать везде, где локальный конфиг не переопределяет его явно. Удобно, когда десять клиентских репозиториев и в каждом свой стек — не приходится по десять раз объяснять одно и то же.

Однажды забыла закоммитить .mcp.json в общий репозиторий — коллега открыл проект, а у него агент вообще не видит базу данных, потому что конфиг остался только у меня локально. Полдня переписки в духе «а у тебя точно установлен Claude Code?». Мораль простая: если конфиг общий для команды — он идёт в git, если личный (токены, пути к твоим локальным папкам) — в .gitignore.

Если весь материал про Claude Code для тебя стартовый и хочется понять картину целиком, а не только конфиги — начни с обзорной статьи как пользоваться Claude Code, она разложена по полочкам для новичка.

Что кладём, а что не коммитим в git

Короткое правило, которое экономит нервы всей команде:

• Коммитим: CLAUDE.md, settings.json, .Claude/commands/, .Claude/agents/, .mcp.json (если в нём нет секретов).
• Не коммитим: settings.local.json, любые файлы с токенами и API-ключами, личные пути к папкам на твоём компьютере.

Если в .mcp.json прописаны реальные ключи доступа к базе — вынеси их в переменные окружения и подключай оттуда, а не пиши прямо в файл, который уйдёт в общий репозиторий. Это база гигиены, но именно её чаще всего пропускают в спешке.

Если после этой статьи хочется собрать себе не просто конфиг, а полноценный скилл для повторяющихся задач — у меня есть разбор что такое скиллы Claude и как их собрать, это следующий логичный шаг после настройки проекта. А про то, как оформить память проекта отдельным файлом с нуля, — в статье CLAUDE.md: как написать файл памяти.

Читайте также

• Память Claude: как включить между чатами
• MCP-сервер для Claude Code в 2026: как подключить и настроить
• Claude Code для начинающих в 2026: первый проект за час
• CLAUDE.md в 2026: как написать файл памяти для проекта
• На портале «Мастерская нейросетей»: Проекты и память в Claude: как настроить рабочее пространство под себя

Я собираю такие практические разборы и рабочие конфиги в Telegram-канале — без причёсанной теории, с реальными фейлами настройки, как вот с забытым .mcp.json выше. Залетай в канал, если хочешь видеть такое раньше, чем оно попадает в блог.