Claude Code: чек-лист лучших практик для ежедневной работы

Большинство советов по Claude Code вытекает из одного ограничения: окно контекста быстро заполняется, а с ростом контекста модель делает больше ошибок и работа дорожает. Поэтому хорошие привычки сводятся к тому, чтобы давать агенту ровно нужное, проверять результат и не пускать задачу в долгий дрейф. Ниже чек-лист Claude Code best practices для ежедневной работы. У каждого пункта объяснено, зачем он нужен. Опираемся на официальную документацию Anthropic (разделы Best practices, Common workflows, Costs); названия команд сверяйте с вашей версией, они меняются.

1. Сначала настройте подключение и слоты моделей

Если вы работаете через шлюз, один раз пропишите в ~/.claude/settings.json адрес и ключ, а также соответствие слотов моделей. По документации Zukko по Claude Code↗: ANTHROPIC_BASE_URL=https://api.zukko.pro (без /v1), ANTHROPIC_AUTH_TOKEN=fetch_..., а слоты Opus, Sonnet и Haiku переназначаются переменными ANTHROPIC_DEFAULT_*_MODEL.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5-5"
  }
}

Зачем: псевдонимы в меню /model указывают на модели по умолчанию, и без переназначения часть слотов (например, Haiku) может указать на модель, которой нет в каталоге шлюза. Если файл уже существует, вмержите блок env, а не затирайте конфиг.

2. Заведите короткий CLAUDE.md

Файл CLAUDE.md в корне проекта подгружается в начале каждой сессии. Команда /init создаёт черновик по содержимому репозитория. Что туда писать: команды сборки и тестов, структура каталогов, соглашения, которые нельзя угадать из кода. Чего не писать: пересказ очевидного, длинные руководства, секреты.

Пример:

## Проект
- Сборка: `npm run build`; тесты: `npm test -- --run`
- Код на TypeScript, строгий режим; импорты только через алиас `@/`
- Миграции БД не править руками, только через `npm run migrate:new`
- Перед завершением задачи запускай линтер и тесты

Зачем: файл оплачивается в каждой сессии, поэтому каждая лишняя строка стоит денег и разбавляет важное. Подробнее — в статье Как написать CLAUDE.md↗.

3. Дайте агенту способ проверить свою работу

Самая сильная привычка из документации Anthropic: указывайте проверку, которую агент может запустить сам. Не «реализуй валидацию email», а «реализуй validateEmail, вот примеры: user@example.com верно, user@.com неверно, запусти тесты после реализации».

Зачем: без проверки у агента один сигнал «выглядит готовым», и проверяющим становитесь вы. С тестами, сборкой или линтером он замыкает цикл сам: запускает, читает результат, чинит.

4. Исследуйте, потом планируйте, потом пишите

Режим планирования включается сочетанием Shift+Tab (повторите, пока в статусной строке не появится plan mode) или запуском claude --permission-mode plan. В нём агент читает файлы и предлагает план, но не вносит правок, пока вы не одобрите. Типовой порядок: изучить, составить план, реализовать, закоммитить.

Зачем: так вы ловите неверное понимание задачи до того, как оно превратилось в десять изменённых файлов. Правило из документации: если дифф можно описать одним предложением (опечатка, лог, переименование), план не нужен.

5. Делите работу на небольшие задачи

Одна сессия — одна задача. «Перепиши модуль авторизации» лучше разбить на «опиши текущий поток», «добавь проверку токена», «обнови тесты». Между несвязанными задачами выполняйте /clear.

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

6. Пишите точные запросы

Указывайте файл, симптом и критерий готовности. Сравните: «добавь тесты для foo.py» и «напиши тест для foo.py на случай, когда пользователь не авторизован, без моков». Ссылайтесь на образцы в коде: «сделай по аналогии с HomeWidget».

Зачем: меньше блужданий по репозиторию и меньше токенов на чтение лишнего.

7. Управляйте контекстом вручную

Автоматическое сжатие истории срабатывает при приближении к лимиту, но вручную лучше. Команда /compact принимает пояснение: /compact Сохрани список изменённых файлов и команды тестов. Также можно через /rewind выбрать сообщение и сжать историю до или после него. Инструкции по сжатию можно записать в CLAUDE.md.

Зачем: вы решаете, что именно должно пережить сжатие, вместо того чтобы доверить это автоматике в неудобный момент.

8. Всегда смотрите дифф

Перед коммитом выполните git diff и прочитайте изменения. Просите агента объяснять неочевидные места, а не принимайте по умолчанию. Коммитьте мелкими шагами, чтобы откат был дешёвым.

Зачем: агент иногда решает задачу «в обход», например правит тест вместо кода или добавляет заглушку. Эти вещи видны только в диффе. Отдельная ветка под задачу делает откат безопасным; кроме того, в Claude Code есть откат состояния через /rewind или двойное нажатие Esc.

9. Настройте разрешения под свою работу

Не нажимайте «разрешить» вслепую и не отключайте подтверждения целиком. Лучше добавить в permissions.allow узкие команды, которые повторяются (линтер, тесты), а в permissions.deny закрыть файлы с секретами, например Read(./.env). Про опасные режимы и секреты смотрите раздел Permissions документации Anthropic.

Зачем: если подтверждения появляются только на редких и рискованных действиях, вы читаете их внимательно. Когда их слишком много, их начинают нажимать не глядя.

10. Делегируйте исследования субагентам

Когда нужно «изучить, как устроен модуль», поручите это субагенту: он прочитает десятки файлов в отдельном контексте и вернёт короткий вывод. Основная сессия остаётся чистой. Подробнее — в статье Субагенты в Claude Code↗.

Зачем: чтение файлов — основной потребитель контекста, и лучше платить за него в одноразовом окне.

11. Выбирайте модель под задачу

Не всё требует самой сильной модели. По таблице на 18 октября 2026 (Zukko, $ за 1M токенов, вход / выход, индекс силы): claude-opus-5-5 0.8 / 4, индекс 58; claude-sonnet-5-5 0.4 / 2, индекс 48. Меняйте модель командой /model на границе задач, а не посреди длинной сессии: кэш привязан к префиксу и, как правило, к модели, и после смены накопленный контекст оплачивается заново. Какая модель справляется с вашими задачами, показывает только проверка на ваших примерах.

12. Следите за расходом и ставьте лимит на ключ

Команда /usage показывает расход сессии. Учтите: Claude Code считает сумму локально по списочным ценам Anthropic, и это оценка, а не счёт; при работе через шлюз она не совпадёт с реальными списаниями. Реальные списания смотрите в разделе «Использование» кабинета Zukko. В Anthropic-формате (/v1/messages, куда ходит Claude Code) шлюз видит чтение и запись кэша и оплачивает их по своим ценам: у claude-sonnet-5-5 это $0.05 за чтение и $0.5 за запись против $0.4 за обычный вход.

Заведите для Claude Code отдельный ключ в кабинете↗ с дневным лимитом и списком allowed_models. Если агент зациклится, вы получите 429 key_daily_limit_reached вместо сюрприза на балансе. Лимиты мягкие: запрос, начатый до потолка, завершится, поэтому закладывайте запас. Как устроены мягкие лимиты и коды ошибок, описано в документации по лимитам ключа↗.

Короткая версия на каждый день

1. Новая задача: /clear.
2. Задача неочевидна: Shift+Tab, план.
3. В запросе: файл, симптом, как проверить.
4. Агент запускает тесты сам.
5. Читаю git diff, коммичу.
6. Раз в день смотрю расход в кабинете.

Частые вопросы

Нужно ли всегда использовать режим планирования?

Нет. Для небольших правок, которые можно описать одним предложением, он только добавляет шаги. Включайте план для задач на несколько файлов или в незнакомом коде.

Насколько длинным должен быть CLAUDE.md?

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

Можно ли оставить Claude Code работать без присмотра?

Только в изолированной среде и с лимитом на ключе. Для автономной работы дайте агенту проверку (тесты) и потолок расхода.

Какую модель поставить по умолчанию?

Выбор зависит от задач. Для начала возьмите claude-sonnet-5-5 и поднимайтесь к claude-opus-5-5 там, где результат вас не устроил. Решение принимайте по своим примерам.