Минимальная настройка
Только то, что работает прямо сейчас. Три шага — и можно начинать работу.
$ node --version
v22.4.0 # ✓ 18+ — отлично
$ npm install -g @anthropic-ai/claude-code
… установка пакета…
added 312 packages
$ claude --version
claude-code 1.x.x # ✓ установлено
$ cd C:\projects\my-shop && claude
╭───────────────────────────────╮
│ ✻ Claude Code v1.x │
│ Model: claude-sonnet-5 │
│ Cwd: C:\projects\my-shop │
╰───────────────────────────────╯
›
20 минут — и вы готовы к работе. Три шага: установка, минимальный конфиг, первый CLAUDE.md. Никакой сложной настройки. Начните с этим — докручивать будете позже.
💡
Принцип «минимальной настройки»: начните с самого необходимого. Потом, когда поймёте как работает CC, добавляйте остальное постепенно. Лучше 5 строк которые понимаешь, чем 100 строк скопированных вслепую.
1
Установка Claude Code
Требования: Node.js 18+, аккаунт Anthropic
Claude Code устанавливается как обычный npm-пакет. После установки команда
claude становится доступна в терминале.
⚠️
Частая ошибка новичков: Claude Code требует Node.js версии 18 или выше. Проверьте перед установкой:
node --version. Если версия ниже 18 — установите актуальную с nodejs.org. На старых версиях CC просто не запустится или будет давать странные ошибки.
# Установка (один раз)
npm install -g @anthropic-ai/claude-code
# Проверить что установилось
claude --version
# Запустить (из папки вашего проекта!)
cd E:\Clients\my-project
claude
⚠️
Важно: всегда запускайте
claude из папки вашего проекта, не из корня диска. Claude ищет CLAUDE.md и настройки начиная от текущей папки — если запустить не там, он ничего не найдёт.
⏱ ~5 минут
2
Минимальный settings.json
Глобальный конфиг — работает во всех проектах сразу
Этот файл создаётся один раз в папке
C:\Users\ВашеИмя\.claude\settings.json (на Windows) или ~/.claude/settings.json (на Mac/Linux). Настройки применяются глобально — во всех ваших проектах.
{
"model": "sonnet",
"env": {
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "400000"
}
}
⚠️
Частая ошибка новичков: файл
settings.json — это JSON, и он очень требователен к синтаксису. Одна лишняя запятая в конце (trailing comma) или пропущенная кавычка — и CC не запустится. Проверяйте файл через jsonlint.com при возникновении ошибок. Правило: после последнего значения в объекте — запятая не ставится.
Разбор каждой строки:
"model": "sonnet" — использовать Claude Sonnet по умолчанию. Это самый разумный выбор: дешевле Opus в 5 раз, но справляется с 90%+ задач. Работает сразу
Tool Search — автоматичен с CC 1.0+, никаких переменных не нужно. Схемы MCP-инструментов загружаются лениво по умолчанию: ~5 700 токенов при старте вместо ~82 000. Claude загружает схему только когда реально нужен конкретный инструмент. Работает сразу
"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
✅ Tool Search: автоматически (CC 1.0+)
✅ AUTO_COMPACT_WINDOW: 400000
✅ Когда освоитесь — добавите остальное
⏱ ~5 минут
3
Первый 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 не знает по умолчанию: ваш стек, ваши запреты, ваши нестандартные правила.
💡
Тонкий момент: CLAUDE.md читается иерархически. Если в корне проекта есть CLAUDE.md и в подпапке тоже — 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 переменные | Продвинутый: Настройка |
| Иерархия конфигов | Как работают глобальный / монорепо / проектный уровни | Продвинутый: Иерархия |
Хотите настроить всё правильно?
Продвинутый: Иерархия конфигов
Глобальный + монорепо + проект. Полная система конфигурации
Продвинутый: Hooks
Автоматизация: линтер, защита от опасных команд, уведомления
Продвинутый: MCP серверы
Расширяем возможности CC: БД, Docker, GitHub
Эксперт: Оптимизация токенов
Tool Search и другие техники экономии токенов