# Что такое Claude API и зачем он вам

Курс: Claude API для разработчиков — https://zero2claude.ru/learn/api
Канонический URL: https://zero2claude.ru/learn/api/0-1-chto-takoe-api

Claude API — это один HTTP-эндпоинт: шлёшь текст, получаешь ответ модели. Когда звать модель, а когда хватит обычного кода.

## Один эндпоинт, и всё

Claude API — это не библиотека и не сложная система. Это **один HTTP-эндпоинт**: ты отправляешь `POST` на `https://api.anthropic.com/v1/messages`, в теле — JSON с твоим вопросом, в ответ приходит JSON с текстом модели. Всё остальное (стриминг, инструменты, кэш) — надстройки над этим же эндпоинтом.

Мысленная модель простая: **запрос → ответ**. Ты как будто вызываешь чужую функцию по сети, только эта функция — большая языковая модель.

## Когда звать модель, а когда нет

Модель платная и медленнее обычного кода. Зови её там, где нужна работа с естественным языком или нечёткими данными:

- **Хорошо:** ответить клиенту магазина своими словами, вытащить плюсы и минусы из отзыва, классифицировать обращение по теме, переформулировать описание товара.
- **Плохо:** посчитать сумму заказа, отфильтровать строки по дате, проверить формат email. Это детерминированные задачи — обычный код сделает их быстрее, дешевле и без ошибок.

Правило большого пальца: если задачу можно описать чёткими правилами — пиши код. Если для неё нужно «понять смысл» текста — зови модель.

## Почему это удобно разработчику

Никакого своего ML, GPU и обучения. Ты шлёшь обычный HTTP-запрос — хоть из Python, хоть `curl`-ом, хоть из бэкенда бота поддержки. Дальше в курсе разберём этот запрос по косточкам: заголовки, тело, ответ и выбор модели.