Настройка Claude Code: спиннер-пасхалки, скрытые параметры settings.json и CLAUDE.md

Habr AI

Пока Claude Code думает над вашим запросом, в терминале мелькают необычные слова: Noodling, Honking, Clauding, Smooshing. Это не просто анимация — за ней скрывается целая система кастомизации, о которой почти не говорят. Внутри — 56 спиннер-глаголов, настраиваемые стили, statusline как в tmux и конфигурации, меняющие поведение ИИ.

56 слов спиннера: система Tengu

Anthropic называет систему спиннеров Tengu — в честь японского духа-трикстера. Каждый раз при обдумывании запроса Claude показывает случайное слово из списка. Вот некоторые из них:

  • Cerebrating — от cerebrum (кора мозга). Буквально «мозговая деятельность»
  • Cogitating — латынь, cogito ergo sum
  • Ruminating — жевать мысли, как корова жвачку
  • Noodling — ковыряться в идее. По-русски ближе всего «залипать»
  • Smooshing — сминать и склеивать
  • Finagling — выкручиваться, химичить
  • Schlepping — тащить (из идиша)
  • Honking — гусиный гудок
  • Clauding — клодить. Пасхалка-самоотсылка
  • Vibing — вайбить

Это можно кастомизировать. В файле ~/.claude/settings.json есть поле spinnerVerbs, куда можно добавить свои варианты. Полный список стандартных слов доступен в публичном репозитории.

Кажется мелочью, но такие детали показывают, что продукт создан с любовью, а не по чек-листу.

Файловая структура Claude Code — что где лежит

Прежде чем настраивать, важно понять структуру:

CLAUDE.md — это «что Claude должен знать». settings.json — «что Claude может делать». Если вы пишете JSON-конфиг в CLAUDE.md — он должен быть в settings.json. Если описываете правила на естественном языке в settings.json — они должны быть в CLAUDE.md.

CLAUDE.md — память между сессиями

Claude Code автоматически читает CLAUDE.md при каждом запуске. Не нужно копировать или упоминать — он просто помнит всё, что там написано.

Что стоит включить:

  • Технологический стек
  • Архитектурные решения
  • Правила форматирования
  • Инструкции по работе с конфиденциальными данными
  • Указания на важные части контекста, которые нельзя терять при автокомпакте

Последний пункт особенно важен. При сжатии истории Claude может упустить ключевую информацию. Инструкция «при компактинге сохраняй» помогает оставить нужное.

settings.json — полезные настройки

Модель и уровень усилий

Параметр effortLevel: low (быстрые ответы), medium (стандарт), high (глубокое обдумывание). Также переключается командой /effort в сессии.

Автокомпакт — когда сжимать контекст

По умолчанию сжатие происходит при заполнении контекста на ~80%. Для задач с большим контекстом — ставьте 85%. Для коротких — 60–65%, чтобы экономить токены.

Разрешения — самая важная часть

Команды в allow выполняются без подтверждения. В deny — полностью заблокированы. Остальные — требуют подтверждения. Это убирает раздражающие запросы «Allow this command? y/n».

Важно: добавьте .env в deny. Иначе Claude может прочитать API-ключи и включить их в ответ.

Хуки — автоматические действия

После редактирования файла можно запускать prettier. Код всегда остаётся отформатированным без ручного вмешательства.

Output Styles — стили вывода

Claude Code поддерживает три стиля, переключаемых через /config:

  • Default — лаконичный, только суть
  • Explanatory — с обоснованием решений
  • Learning — режим парного программирования с маркерами TODO(human) и пояснениями

Режим Learning особенно полезен для обучения: ИИ объясняет каждый шаг и указывает, где нужно ваше участие.

Можно создавать свои стили в папке ~/.claude/styles/.

Statusline — dashboard в терминале

Statusline — скрипт, показывающий информацию внизу терминала после каждого действия Claude. Настраивается через /statusline или вручную.

Можно отображать:

  • Текущую директорию
  • Git-ветку
  • Процент заполнения контекста (зелёный < 50%, жёлтый 50–80%, красный > 80%)
  • Стоимость сессии

/cost — показывает расходы (для API-ключей). /stats — для подписчиков Max/Pro.

LSP — навигация по коду

Скрытая функция, включается через переменную окружения. После этого Claude подключается к языковому серверу (tsserver, pylsp, gopls, rust-analyzer) и получает:

  • Переход к определению
  • Поиск ссылок
  • Автодополнение

Теперь ИИ лучше понимает структуру проекта и точнее редактирует код.

Требуется установленный LSP-сервер: для TypeScript — tsserver, для Python — pylsp.

Shift+Tab — переключение режимов

Три режима:

  • Default — стандартный, спрашивает подтверждение
  • acceptEdits — автоматически применяет правки, но спрашивает про команды
  • Plan Mode — только планирует, ничего не выполняет

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

Итого: минимальный конфиг для старта

Если не хотите разбираться во всём — вот базовый settings.json для ~/.claude/. Добавьте CLAUDE.md в корень проекта с описанием стека, архитектуры и правил.

Этих двух файлов достаточно, чтобы Claude перестал быть «терминальным ChatGPT» и стал настоящим инструментом, знающим ваш проект.

Читать оригинал