раздел 04 · /init

Команда /init

Не пишите CLAUDE.md с нуля. В Claude Code есть /init - команда, которая читает ваш репозиторий и сама предлагает черновик. Дальше вы только правите детали.

Что делает /init

При запуске /init Claude:

  1. Сканирует структуру проекта (папки, ключевые файлы)
  2. Определяет стек по package.json, pyproject.toml, Cargo.toml, go.mod
  3. Читает README.md, если он есть
  4. Смотрит конфиги (tsconfig.json, vite.config.ts, Dockerfile)
  5. Генерирует CLAUDE.md с разделами: стек, структура, команды запуска, конвенции

Это занимает 30-60 секунд. На выходе - готовый файл, который чаще всего на 80% правильный.

Как запустить

В корне репо открываете Claude Code и пишете:

/init

Всё. Никаких аргументов. Claude сам поймёт где он находится и что ему делать.

Пример: запуск в Next.js проекте

Допустим, есть свежий Next.js 16 проект:

my-app/
├── app/
│   ├── layout.tsx
│   └── page.tsx
├── package.json
├── tsconfig.json
└── next.config.ts

Запускаете /init. Claude генерирует примерно такой CLAUDE.md:

# my-app

Next.js 16 приложение с App Router и TypeScript.

## Стек
- Next.js 16 (App Router)
- React 19
- TypeScript 5
- Tailwind CSS (если найдён в зависимостях)

## Структура
- `app/` - страницы и layouts (App Router)
- `public/` - статика
- `components/` - переиспользуемые React-компоненты

## Команды
- Dev: `pnpm dev` (или `npm run dev`)
- Build: `pnpm build`
- Lint: `pnpm lint`
- Start prod: `pnpm start`

## Конвенции
- Server Components по умолчанию, `"use client"` только когда нужен
- Стили через Tailwind utility classes
- TypeScript strict mode включён

Что править после /init

Claude угадывает структуру, но не угадывает ваши личные правила. После генерации обычно нужно добавить:

  • Бизнес-контекст: что вообще делает приложение
  • Локальные конвенции: как именованы папки в этой команде, какие слои разрешены
  • Адреса: где прод, где стейджинг, куда деплой
  • Тонкости тестов: какие моки используются, как настраиваются фикстуры
  • Запреты: чего не делать (например "не использовать getServerSideProps, мы на App Router")

Пример дополнения:

## Бизнес-контекст
Лендинг для курса Claude Code 101. Контент в MDX, страницы статические.

## Запреты
- Никаких client components на главных страницах - всё SSR
- Не подключай новые UI-библиотеки, только Tailwind + кастомные компоненты
- Не делай редиректы через middleware - только через next.config

Как редактировать дальше

CLAUDE.md - обычный markdown. Открывайте в редакторе, дописывайте. Claude перечитает файл при следующем запросе автоматически.

Если в проекте что-то существенно меняется (новый сервис, новая папка, изменился деплой) - не забудьте обновить. Старый CLAUDE.md хуже отсутствующего, потому что вводит в заблуждение.

Когда /init не нужен

  • Маленький скрипт на 100 строк - проще написать 5 строк правил вручную
  • Чужой репо, который вы изучаете - читайте README.md, не плодите файлы
  • Проект, где правила меняются ежедневно - используйте чаты, а не файлы

Полезные ссылки