⚙️ Минимальная настройка

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

💡

Принцип «минимальной настройки»: начните с самого необходимого. Потом, когда поймёте как работает CC, добавляйте остальное постепенно. Лучше 5 строк которые понимаешь, чем 100 строк скопированных вслепую.

Установка Claude Code

Требования: Node.js 18+, аккаунт Anthropic

Claude Code устанавливается как обычный npm-пакет. После установки команда claude становится доступна в терминале.

# Установка (один раз)
npm install -g @anthropic-ai/claude-code

# Проверить что установилось
claude --version

# Запустить (из папки вашего проекта!)
cd E:\Clients\my-project
claude

⚠️

Важно: всегда запускайте claude из папки вашего проекта, не из корня диска. Claude ищет CLAUDE.md и настройки начиная от текущей папки — если запустить не там, он ничего не найдёт.

⏱ ~5 минут

Минимальный settings.json

Глобальный конфиг — работает во всех проектах сразу

Этот файл создаётся один раз в папке C:\Users\ВашеИмя\.claude\settings.json (на Windows) или ~/.claude/settings.json (на Mac/Linux). Настройки применяются глобально — во всех ваших проектах.

{
  "model": "sonnet",
  "env": {
    "MCP_TOOL_SEARCH": "1",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "400000"
  }
}

Разбор каждой строки:

💰

"model": "sonnet" — использовать Claude Sonnet по умолчанию. Это самый разумный выбор: дешевле Opus в 5 раз, но справляется с 90%+ задач. Работает сразу

🔍

"MCP_TOOL_SEARCH": "1" — главная экономия токенов. Без этой настройки Claude загружает схемы всех MCP-инструментов в начале каждого разговора. С ней — только когда реально нужен конкретный инструмент. Экономия 47–95%. Работает сразу

🧠

"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "400000" — когда контекст (память разговора) заполнится на 400K токенов, CC автоматически его сжимает. По умолчанию 200K — слишком маленько для больших задач. 400K даёт больше пространства. Работает сразу

✅

Эти три настройки работают прямо сейчас без каких-либо дополнительных файлов или скриптов. Это встроенные параметры Claude Code.

Что НЕ нужно добавлять сразу:

✗ Пока не нужно

❌ hooks (dangerous-command-guard, auto-format)

❌ permissions с длинными списками

❌ mcpServers в settings.json

❌ COST_ALERT_THRESHOLD (требует hook)

✓ Достаточно на старте

✅ model: sonnet

✅ MCP_TOOL_SEARCH: 1

✅ AUTO_COMPACT_WINDOW: 400000

✅ Когда освоитесь — добавите остальное

⏱ ~5 минут

Первый CLAUDE.md

Инструкция для Claude — создаётся в папке проекта

CLAUDE.md — это текстовый файл, который Claude читает при каждом запуске. Создаётся в корне вашего проекта. Начните с минимума — 10–20 строк с самым важным.

Что писать? Три категории: стек (какие технологии), запреты (что нельзя), правила кода (форматирование, тесты).

# Правила проекта

## Стек
- [Ваш язык/фреймворк] + [версия]
- [База данных]
- [Другие ключевые зависимости]

## Что запрещено
- НЕ удалять данные без явного подтверждения
- НЕ коммитить файлы .env, *.key, секреты
- НЕ добавлять функциональность сверх просьбы — только то, что явно попросили

## Правила кода
- [Форматтер: Pint / Ruff / Prettier — что используете]
- [Тестовый фреймворк: Pest / pytest / Jest]
- Коммиты: feat/fix/chore/docs (не «update» или «changes»)

## Проверка
- После изменений запускать тесты и показывать реальный вывод
- Не говорить «всё работает» без реальной проверки

Пример для Laravel-проекта:

# Laravel-проект

## Стек
- PHP 8.3 / Laravel 11 / PostgreSQL 16
- Vue 3 + TypeScript
- Docker (все команды через контейнер)

## Запрещено
- НЕ запускать php artisan migrate:fresh или db:wipe
- НЕ коммитить .env, *.pem, secrets/
- НЕ добавлять новые пакеты без согласования
- НЕ добавлять функциональность сверх просьбы (YAGNI)

## Код
- Тесты: Pest (не PHPUnit напрямую)
- Форматирование: Pint (запускать после каждого PHP файла)
- Архитектура: Service Layer — логика в Services, Controllers тонкие
- Коммиты: feat/fix/chore/docs

## Проверка
- После изменений: ./vendor/bin/pest (показать реальный вывод)
- Линтер: ./vendor/bin/pint --test (без --test ничего не изменит)

💡

Правило «коротко и конкретно»: CLAUDE.md из 500 строк хуже, чем из 20. Bloated CLAUDE.md — Claude начинает игнорировать правила или читать невнимательно. Пишите только то, что Claude не знает по умолчанию: ваш стек, ваши запреты, ваши нестандартные правила.

⏱ ~10 минут

✅ Проверяем что всё работает

# 1. Запустите Claude из папки проекта
cd E:\Clients\my-project
claude

# 2. Попросите Claude убедиться что он читает ваши правила:
# "Прочитай CLAUDE.md и перечисли правила которые ты будешь соблюдать"

# Claude должен перечислить то, что вы написали — значит всё настроено

✅

Если Claude перечислил ваши правила — настройка работает. Переходите к следующему шагу: Первая задача →

🚀 Что добавить потом (не сейчас)

Когда освоитесь с базовой настройкой — постепенно добавляйте более продвинутые вещи:

Что	Зачем	Где читать
Hooks (защита)	Блокировать опасные команды автоматически	Продвинутый: Hooks
MCP серверы	Дать Claude доступ к Docker, БД, браузеру	Продвинутый: MCP
Полный settings.json	Permissions, cost tracking, все env переменные	Продвинутый: Настройка
Иерархия конфигов	Как работают глобальный / монорепо / проектный уровни	Продвинутый: Иерархия