AI-гайд

Тонкости Claude

У тебя в боте — GPT-5.4-mini от OpenAI. Помощник по проекту — Claude от Anthropic. Это разные модели от разных компаний, и хотя концепции у них общие, конкретные фичи и ценники разные. Эта статья — про четыре особенности именно Claude, которые полезно знать, когда работаешь с ним в Claude Code: семейство моделей, extended thinking, prompt caching, tool use. Глубокие объяснения — в faithful-переводах документации Anthropic, ссылки в конце каждого раздела.

1. Семейство моделей: Sonnet, Opus, Haiku

У Anthropic — три линейки моделей. Названия — поэтические формы стихосложения, что симпатично, но не подсказывает, какая для чего.

• Haiku — самый быстрый и дешёвый. Слабее в сложных рассуждениях, но отвечает почти мгновенно. Подходит для классификации, простых преобразований, чат-ботов с быстрыми ответами.
• Sonnet — средний по силе и цене. Универсальная рабочая лошадка: код, длинные тексты, рассуждения. Большинству задач Sonnet хватает.
• Opus — самый мощный и самый дорогой. Лучше работает на сложных рассуждениях, длинных цепочках, тонких редактурах. Медленнее Sonnet.

Цифры в названии — поколение. Opus 4.7 новее, чем Opus 4.6, новее, чем Opus 4. Между поколениями обычно растёт качество и иногда меняется цена.

Что это значит для тебя в Claude Code:

• Дефолт в Claude Code Desktop — Opus 4.7. Это обычно правильный выбор: проект бота — небольшая, но аккуратная работа, где лучше не экономить на модели.
• Sonnet — для рутины. Если делаешь сотни мелких операций (переименования, форматирование, небольшие коммит-сообщения) — переключение на Sonnet экономит ощутимо.
• Haiku в твоей работе с Claude Code пригодится редко: проект небольшой, экономия на Haiku не оправдывает качества.

2. Extended / adaptive thinking

Подробно — в гайде «Research + расширенное мышление». Здесь — короткое напоминание в контексте «тонкостей Claude»:

• Extended thinking — модель явно строит цепочку рассуждений до ответа. Полезно для сложных задач, лишнее для простых.
• Adaptive thinking — модель сама решает, насколько долго думать. Это актуальная схема для современных Opus и Sonnet.
• Управление в Claude Code — /effort со слайдером low / medium / high / xhigh / max. Дефолт для Opus 4.7 — xhigh. Поднимай до max, если задача нетривиальная (например, разобраться с тонким багом в обработке апдейтов aiogram). Опускай до medium, если делаешь много мелких правок.

Глубже — faithful-перевод документации: Extended thinking.

3. Prompt caching — почему «второй запрос дешевле»

Каждый запрос к модели — это отправка в API всего системного промпта плюс истории. Если у тебя длинный системный промпт (или длинный CLAUDE.md), и ты отправляешь его каждый раз, одни и те же тысячи токенов проходят через модель снова и снова.

Prompt caching — это техника, при которой Anthropic запоминает префикс твоего запроса (системный промпт, CLAUDE.md, большие приложенные документы) и при следующем запросе с тем же префиксом не пересчитывает его, а берёт из кэша. Это даёт две выгоды:

• Быстрее. Кэш-хит выдаёт ответ заметно быстрее, чем расчёт «с нуля».
• Дешевле. Кэш-токены тарифицируются дешевле, чем «свежие». Во сколько раз — зависит от тарифа и поколения модели.

Что это значит для тебя:

• В Claude Code — работает само. Тебе не нужно ничего настраивать; кэширование CLAUDE.md и больших приложенных файлов происходит автоматически.
• В твоём боте на OpenAI — это другая история. У OpenAI своё кэширование, со своими правилами. Если будешь настраивать оптимизацию затрат бота — читай документацию OpenAI, не статью про Claude.
• Кэш живёт недолго. Если перерыв между запросами — несколько минут, кэш ещё горячий. Если несколько часов — пересчитается «с нуля». Это нормально.
• Меняй неизменное реже. Если на каждый запрос ты меняешь верхушку CLAUDE.md, кэш не работает. Стабильное держи в начале файла, переменное — в самом запросе.

Глубже: Prompt caching (faithful-перевод).

4. Tool use — как модель «нажимает кнопки»

Tool use — это способность модели по запросу пользователя вызвать заранее описанную функцию: «найти задачу в БД», «отправить напоминание», «сохранить заметку». Ты в коде описываешь, какие функции есть и какие у них параметры; модель решает, какую вызвать и с какими аргументами; твой код выполняет вызов и возвращает результат; модель пишет ответ пользователю с учётом результата.

В твоём боте это центральный механизм: add_task, save_goal, get_user_notes, set_reminder — всё это инструменты. Без tool use бот мог бы только разговаривать; с tool use он может делать.

Концепция у Claude и OpenAI почти одинаковая, но конкретные форматы JSON отличаются. Поэтому учить tool use стоит на той модели, на которой будешь работать (для тебя — OpenAI). Адаптация для Сониного стека: Tool use (адаптация для бота на aiogram).

Тонкости, общие для Claude и OpenAI:

• Описание функции — это часть промпта. Модель решает, вызвать или нет, по тому, как описана функция. Хорошее описание = надёжный вызов; плохое = модель то вызывает, то нет.
• Параметры лучше типизировать. Если у функции есть severity: 'low' | 'medium' | 'high', описывай это как enum, а не как «строка». Иначе получишь severity: "среднее".
• Параллельные вызовы. Современные модели могут вызвать несколько функций за один шаг. Проверь, что твой код это обрабатывает (asyncio.gather по списку tool-вызовов, а не await по одному).
• «Forced tool use». Иногда полезно заставить модель обязательно вызвать конкретный инструмент (например, при первом сообщении пользователя — обязательно get_user_notes). Это поддерживается, но используется аккуратно.

Что не нужно знать прямо сейчас

У Claude есть много специфики, которая для твоего проекта не критична: продвинутые batch-запросы, Files API, Citations API, Computer Use, тонкая настройка thinking-токенов. Если столкнёшься — обращайся к faithful-переводам в разделе «Полная версия». Не учи впрок: устаревает быстрее, чем читается.

Также не путай ценники и rate limits — они меняются по плану и тарифу, и любая статья «как сейчас» через полгода будет неточной. Цены и лимиты — всегда смотри в актуальной документации провайдера.

Памятка

• Sonnet / Opus / Haiku — три линейки. В Claude Code дефолт Opus 4.7. Sonnet — для рутины.
• Adaptive thinking + /effort — рулит «глубиной» рассуждений. Дефолт xhigh на Opus.
• Prompt caching в Claude Code работает само. Стабильное держи в верху CLAUDE.md, переменное — в запросе.
• Tool use — центральный механизм твоего бота. Учи на OpenAI (это твой стек), но концепция — общая.
• Не учи впрок продуктовые тонкости — устаревают. Открывай документацию по факту необходимости.

Что почитать дальше

• Claude vs OpenAI: сравнение семейств — отдельный гайд, помогает развести «Claude как помощник» и «GPT-5.4-mini в боте».
• Промпт-инжиниринг (адаптации для бота) — практический раздел трека: как писать промпты для GPT-5.4-mini внутри твоего бота.
• Extended thinking и Prompt caching — faithful-переводы документации Anthropic, если захочется глубже.