🔥 CLAUDE.md: как сделать из AI-ассистента настоящего партнёра по проекту?

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

## Трюки и рекомендации от практиков

1️⃣ Начните с команды `/init`
- Запустите claude в терминале и введите /init.
- Claude сам проанализирует проект и создаст базовый CLAUDE.md, где будут основные команды, структура и рекомендации[1][2].
- Пример:

  # Bash commands
  - npm run build: Build the project
  - npm run typecheck: Run the typechecker

  # Code style
  - Use ES modules (import/export) syntax, not CommonJS (require)
  - Destructure imports when possible (eg. import { foo } from 'bar')

  # Workflow
  - Typecheck after making changes
  - Prefer running single tests for performance
  

- Этот шаблон — отличная отправная точка, чтобы не писать файл с нуля.

2️⃣ Держите CLAUDE.md коротким и полезным
- Пишите для Claude, а не для человека. Короткие, чёткие инструкции работают лучше[3][4].
- Удаляйте лишнее. Если папка называется tests, не объясняйте, что там тесты.
- Пример:

  # Project Conventions
  - API endpoints: /api/v1/...
  - Python: snake_case for variables and functions
  - Default branch: main
  - Feature branches: feature/your-feature-name
  

- Чем лаконичнее — тем точнее будет ответ Claude.

3️⃣ Добавляйте только важное
- Команды, стиль кода, тесты, окружение, репозиторные правила — вот главное[4][5].
- Пример структуры:

  ## Project Overview
  Краткое описание проекта и целей.

  ## Tech Stack
  - Languages: TypeScript, Python
  - Frameworks: Next.js, FastAPI
  - Tools: Docker, GitHub Actions

  ## Code Style & Conventions
  - ES modules
  - camelCase для переменных
  - Комментируйте сложную логику

  ## Development Workflow
  - Feature-ветки
  - Коммит-месседжи: [тип]: описание
  - PR обязателен

  ## Testing Strategy
  - Jest и pytest
  - 80% coverage для новой логики

  ## Environment Setup
  - npm install, pip install -r requirements.txt
  - npm run dev, uvicorn app:app
  

- Добавляйте только то, что действительно нужно Claude для работы.

4️⃣ Используйте `/memory` и `/clear`
- `/memory` — открывает CLAUDE.md для редактирования прямо из чата.
- `/clear` — очищает контекст, чтобы Claude не запутался в старых данных[4][6].
- Регулярно чистите контекст — это повышает качество ответов.

5️⃣ Создавайте кастомные команды
- Храните часто используемые промпты в `.claude/commands/` (для проекта) или ~/.claude/commands/ (для себя)[2].
- Пример:

  # .claude/commands/review_pr.md
  Please review the staged changes for a pull request. Focus on:
  1. Clarity and conciseness of code.
  2. Potential bugs or edge cases.
  3. Adherence to our project's coding standards (see CLAUDE.md).
  4. Suggest improvements for documentation and comments.
  

- Эти команды экономят время и делают работу с Claude предсказуемой.

6️⃣ Используйте чеклисты и скретчпады
- Для сложных задач (миграции, исправление ошибок) попросите Claude создать чеклист и отмечать выполненные шаги[4].
- Пример:

  Fix lint errors:
  1. [x] Fix line 42, file src/utils/auth.js
  2. [ ] Fix line 15, file src/components/Button.tsx
  

- Это помогает не потеряться в больших задачах.

7️⃣ Добавляйте специфичные правила
- Если в проекте есть неочевидные моменты — обязательно их пропишите.
- Пример:

  # Before working with new packages, always check the docs.
  

- Так Claude не будет повторять ошибки и будет учитывать особенности проекта[6].

8️⃣ Импортируйте другие файлы
- В CLAUDE.md можно ссылаться на другие файлы через `@path/to/file`.
- Пример:

  See @README for project overview.
  See @docs/git-instructions.md for git workflow.
  

- Это помогает не дублировать информацию.

## Примеры хороших CLAUDE.md

- ArthurClune/claude-md-examples — реальные примеры из разных проектов (Python, JS и др.) на GitHub[7].
- Шаблон от Maxitect — структурированный и лаконичный файл для быстрого старта[5].

## Итог

- CLAUDE.md — это живой документ.