Главная / 🌱 Начинающий / Ключевые понятия

🧩 Ключевые понятия

7 концепций, которые нужно понять прежде чем начать. Объяснено простым языком с аналогиями.

📋
CLAUDE.md
Инструкции для Claude о вашем проекте
Важно

CLAUDE.md — текстовый файл в корне вашего проекта, который Claude читает автоматически в начале каждой сессии. Здесь вы пишете всё, что Claude должен знать о вашем проекте.

Аналогия: Представьте что вы наняли нового программиста. В первый день вы даёте ему «памятку» — какой стек используется, как запускать тесты, какие есть правила. Вот это и есть CLAUDE.md.

Что писать: название проекта, стек технологий, команды для запуска/тестов, правила именования, что нельзя трогать.

Где лежит: в корне проекта — рядом с package.json, composer.json и т.д. Может быть несколько файлов в разных папках — Claude читает все.

🪙
Токены и контекст
«Память» Claude в рамках сессии
Встроенное

Токен — единица текста (примерно ¾ слова). Claude читает и пишет токены, и за них вы платите.

Аналогия: Контекст — как оперативная память компьютера. Чем больше файлов и истории в сессии, тем больше токенов занято. Когда «память» заканчивается — Claude начинает «забывать» начало разговора.

Контекстное окно — максимальный объём текста, который Claude может держать в «голове» одновременно. У claude-sonnet это ~200 000 токенов (примерно 150 000 слов — целая книга).

Sonnet
~200K токенов
Opus
~200K токенов (умнее)

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

📐
Plan Mode
«Сначала покажи план — потом делай»
Использовать всегда

Plan Mode — режим, когда Claude сначала показывает план действий и ждёт вашего одобрения, прежде чем что-то менять в файлах.

Аналогия: Как хирург, который сначала объясняет операцию пациенту, а потом берёт скальпель. Не наоборот.

Как включить: нажмите Shift+Tab два раза в начале сессии. В строке ввода появится индикатор.

Когда особенно нужен:

  • Задача затрагивает много файлов
  • Вы не уверены как именно Claude будет решать задачу
  • Любые изменения в базе данных или конфигах
🔌
MCP (Model Context Protocol)
«Плагины» для расширения возможностей Claude
Опционально на старте

MCP — стандарт для подключения внешних инструментов к Claude. По умолчанию Claude умеет читать/писать файлы. С MCP он может работать с базами данных, браузером, GitHub и т.д.

Аналогия: MCP — как расширения для браузера. Chrome сам по себе умеет немногое, но с расширениями можно блокировать рекламу, переводить страницы, скачивать видео. MCP делает то же самое для Claude.

Популярные MCP:

  • mcp-docker — управление Docker контейнерами
  • mcp-postgres или mcp-mysql — прямые SQL запросы
  • mcp-github — работа с GitHub issues, PR
  • mcp-playwright — управление браузером

Для старта: MCP настраивать не обязательно. Сначала освойте базовую работу с файлами — это уже огромная польза. MCP подробно разобрано на продвинутом уровне.

🪝
Hooks
Скрипты, которые запускаются автоматически
Опционально на старте

Hooks — shell-скрипты, которые CC запускает автоматически в определённые моменты: перед редактированием файла, после выполнения команды, и т.д.

Аналогия: Как git-хуки (pre-commit, post-merge) — только для Claude. Можно настроить: «перед изменением файла — создать резервную копию» или «после редактирования — запустить linter».

Распространённые применения:

  • Запрет опасных команд (rm -rf, DROP TABLE)
  • Автоматический запуск линтера после изменений
  • Уведомления в Telegram когда задача завершена

Для старта: hooks настраивать не нужно. Это продвинутая тема — разбор на продвинутом уровне.

⚙️
settings.json
Глобальная конфигурация Claude Code
Важно

Файл настроек Claude Code. Лежит в домашней директории: ~/.claude/settings.json (или C:\Users\ВашеИмя\.claude\settings.json на Windows). Применяется ко всем проектам.

Аналогия: Как настройки операционной системы — задаёте один раз, работают везде.

Минимальный рабочий конфиг:

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

Подробный разбор — на следующей странице Минимальная настройка.

🧠
Sonnet / Opus / Haiku
Три уровня моделей Claude
Встроенное

Claude Code использует разные модели под капотом. Модель влияет на качество ответов, скорость и расход токенов.

Аналогия: Как автомобили в такси: Haiku — эконом (быстро, дёшево), Sonnet — комфорт (баланс), Opus — бизнес-класс (лучшее качество, дороже).
МодельКачествоСкоростьКогда использовать
haikuБазовоеОчень быстроПростые правки, объяснения
sonnetОтличноеБыстроБольшинство задач — рекомендуется
opusНаивысшееМедленнееСложные архитектурные задачи

Совет: начните с sonnet. Переключитесь на opus только для сложных задач — например, спроектировать архитектуру большой системы. Подробно о моделях и тарифах — в FAQ.

Отлично! Теперь вы знаете ключевые понятия. Следующий шаг — минимальная настройка: установим CC и создадим рабочий конфиг за 20 минут.