Эта книга написана не как каталог возможностей, а как рабочая инструкция, и потому каждый механизм разбирается в одном и том же порядке. Сначала - какую проблему он решает, потом где лежит его конфигурация и когда она загружается, затем какой у неё scope и приоритет, как проверить фактическое состояние, что может пойти не так и как безопасно вернуть систему к понятной конфигурации. Этот порядок важнее красивых обобщений: он превращает набор фактов в воспроизводимое понимание.

В тексте строго различаются два типа утверждений, и это различие - основа доверия к книге. Первое помечается как официальное: факт, имя команды, ключ, путь, ограничение или порядок приоритета, прямо описанные Anthropic, сопровождаются ссылкой на первоисточник. Второе - инженерный вывод: практическая рекомендация, которая следует из документированного поведения, но не является требованием продукта. Держать общий settings.json минимальным - разумный приём, но не правило Claude Code, и книга это честно разделяет.

Разделение на официальное и выводимое важнее удобной уверенности. Настройка становится полезной только тогда, когда вы понимаете три вещи: откуда она берётся, какое значение допустимо и чем грозит ошибка. Приём, поданный как незыблемое правило, рано или поздно упрётся в контекст, где он вреден; тот же приём, поданный как инженерный вывод из поведения, вы примените осознанно и там, где он к месту, а не по привычке.

Полнота в этой книге означает четыре вещи. Все основные поверхности Claude Code и их различия. Весь путь - от установки до CI/CD и корпоративной политики. Все встроенные команды, флаги, ключи settings.json и hook-события в справочниках. И полный индекс переменных окружения, где отдельно выделены рабочее ядро и редкие диагностические и облачные переключатели.

При этом полнота - не призыв включить каждый флаг. Многие переменные окружения существуют ради поддержки, миграций, облачных провайдеров или аварийной диагностики, и в обычной работе к ним не прикасаются. Настройка полезна не количеством включённого, а точностью: один осознанно выставленный ключ, источник и цена которого понятны, ценнее десяти скопированных из чужого конфига без разбора.

Главный практический принцип книги - проверять фактическое состояние командой, а не памятью. Claude Code быстро меняется между версиями, и заученное однажды поведение может разойтись с текущим. Поэтому каждая глава заземлена на проверку: claude --version отвечает, что именно запускается, /status - какая модель, provider и каталог, /permissions и /context - что реально загружено и разрешено. Живая команда всегда важнее уверенности по памяти.