Один эндпоинт, и всё
Claude API — это не библиотека и не сложная система. Это один HTTP-эндпоинт: ты отправляешь POST на https://api.anthropic.com/v1/messages, в теле — JSON с твоим вопросом, в ответ приходит JSON с текстом модели. Всё остальное (стриминг, инструменты, кэш) — надстройки над этим же эндпоинтом.
Мысленная модель простая: запрос → ответ. Ты как будто вызываешь чужую функцию по сети, только эта функция — большая языковая модель.
Когда звать модель, а когда нет
Модель платная и медленнее обычного кода. Зови её там, где нужна работа с естественным языком или нечёткими данными:
- Хорошо: ответить клиенту магазина своими словами, вытащить плюсы и минусы из отзыва, классифицировать обращение по теме, переформулировать описание товара.
- Плохо: посчитать сумму заказа, отфильтровать строки по дате, проверить формат email. Это детерминированные задачи — обычный код сделает их быстрее, дешевле и без ошибок.
Правило большого пальца: если задачу можно описать чёткими правилами — пиши код. Если для неё нужно «понять смысл» текста — зови модель.
Почему это удобно разработчику
Никакого своего ML, GPU и обучения. Ты шлёшь обычный HTTP-запрос — хоть из Python, хоть curl-ом, хоть из бэкенда бота поддержки. Дальше в курсе разберём этот запрос по косточкам: заголовки, тело, ответ и выбор модели.