Введение
Хорошая структура проекта в Claude Code помогает ИИ лучше понимать код, автоматизировать задачи и избегать ошибок. Вы получите организованный репозиторий, где агент эффективно редактирует файлы, запускает команды и интегрируется с инструментами. Идеально для разработчиков и новичков.
Что понадобится
- Установленный Claude Code (доступен в терминале, IDE или браузере через code.claude.com).
- Пустой репозиторий на GitHub или локальная папка.
- Базовые знания Markdown и JSON (не обязательно глубоко).
- Доступ к Anthropic (claude.ai/login).
Пошаговая инструкция
- Создайте файл CLAUDE.md в корне проекта. Это основной файл с правилами проекта и контекстом. Запишите стандарты кодирования, цели проекта и инструкции для ИИ. Почему? Claude Code читает его первым, чтобы понять, как работать с вашим кодом. Пример: ``` # Правила проекта
- Используй Python 3.12.
-
Всегда тестируй изменения. ``` Ссылка на детали: CLAUDE.md: пошаговый гайд к 10x продуктивности с ИИ.
-
Добавьте CLAUDE.local.md. Здесь храните персональные переопределения — настройки, специфичные для вашего окружения (например, локальные пути). Почему? Это не коммитится в Git, чтобы не раскрывать секреты. Предупреждение: если забудете, ИИ может использовать общие правила вместо ваших.
-
Создайте mcp.json в корне. Укажите подключение инструментов вроде GitHub, Slack или БД. Почему? Это позволяет Claude Code интегрироваться и выполнять реальные действия (push в репозиторий, отправка уведомлений). Пример:
json { "tools": ["github", "slack"] }Проверьте документацию на code.claude.com/docs для точного формата. -
Создайте папку claude/ и файл settings.json внутри. В settings.json пропишите права доступа и модели ИИ. Почему? Это управляет безопасностью и производительностью агента. Пример:
json { "permissions": ["read", "write"], "model": "claude-3.5-sonnet" }Проблема: без этого ИИ может отказываться от команд. -
В папке claude/ создайте подпапки: rules/, commands/, skills/, agents/, hooks/.
- rules/: стандарты кодирования и тесты (файлы .md с правилами). Почему? Обеспечивает consistency.
- commands/: workflow вроде /review или /fix (скрипты или промпты). Почему? Переиспользование ускоряет рутину.
- skills/: экспертиза по темам (подгружается автоматически). Почему? ИИ становится специалистом "на лету".
- agents/: под-агенты для задач. Почему? Разделяет сложные проекты.
- hooks/: guardrails и автоматизация (хуки на события). Почему? Предотвращает ошибки, как автотесты. Добавьте пустые README.md в каждую для старта.
Результат
У вас готов скелет проекта: корневые файлы задают контекст и интеграции, папка claude/ — логику агента. Claude Code теперь понимает codebase, редактирует файлы, запускает команды и масштабирует рефакторинг. Результат — быстрее шитите фичи, экономя дни работы.
Советы
- Лайфхак: Начните с копирования шаблона из code.claude.com/docs/en/overview — сэкономит время.
- Частая ошибка: Игнор CLAUDE.md — ИИ будет "слепым" к вашим правилам. Всегда обновляйте его.
- Тестируйте: запустите /review на малом файле, чтобы проверить.
- Для не-кодеров: фокусируйтесь на CLAUDE.md — ИИ сделает остальное (см. разбор на Habr).
- Масштабируйте: добавляйте skills/ по мере роста проекта.