К содержимому
Claude Code с 0:полный курс
APIАвтор: Михаил Кузьмицкий

Первый запрос к Claude по API: что такое curl

Коротко

Слово «API» пугает новичков, но за ним простая идея — программы умеют разговаривать. Разбираем её на пальцах и пробуем curl.

Вы наверняка слышали слово «API» и тихо проматывали его дальше — звучит как что-то для программистов с десятилетним стажем. На деле идея проще, чем кажется, и понять её можно за пять минут, без единой строчки настоящего кода.

Давайте разберёмся, что такое API, при чём тут команда curl и как из обычного терминала можно «поговорить» с Claude напрямую — не через сайт и не через приложение.

Запрос к Claude через терминал командой curl

API — это способ программам общаться

Представьте окошко в кафе: вы говорите «капучино», вам через минуту отдают капучино. Вы не лезете на кухню и не варите кофе сами — вы делаете запрос и получаете ответ. API работает так же, только разговаривают не люди, а программы.

  • Вы (или ваша программа) отправляете запрос: «вот текст, ответь на него».
  • Сервис обрабатывает его и присылает ответ обратно.
  • Никто не заходит «внутрь» чужой программы — общение идёт через заранее оговорённое окошко.

Так приложения подключают карты, погоду, оплату — и так же можно подключить Claude к своей программе. Если хочется разобрать незнакомое слово прямо сейчас, у нас есть разбор терминов простыми словами.

curl — это «отправить запрос» из терминала

curl — обычная команда терминала. Её задача — взять адрес в интернете, сходить туда и принести ответ. Это и есть тот самый запрос, только вручную, без сайта-посредника.

Самый безобидный пример — просто получить страницу:

curl https://example.com

В терминал вернётся то, что лежит по этому адресу. Запрос к Claude API устроен по той же логике: вы отправляете свой текст на адрес сервиса и получаете назад ответ модели. Деталей там чуть больше — нужен ключ доступа и текст вопроса в правильном формате, — но суть ровно та же: запрос ушёл, ответ пришёл.

Совет

Ключ доступа к API — это как пароль: он привязан к вашему аккаунту, и за запросы по нему списывается оплата. Никогда не вставляйте ключ в чужие скрипты и не выкладывайте его в открытый доступ.

Чем это отличается от Claude Code

Важно не путать две вещи. Claude Code — это готовый помощник в терминале: он сам читает и правит ваши файлы, запускает команды, и ставить запросы вручную не нужно. А API — это «провод» для ваших собственных программ, когда вы хотите встроить Claude внутрь своего приложения.

Новичку API нужен не сразу. Сначала стоит освоиться в терминале и научиться ставить задачи словами — это фундамент, на котором всё остальное ложится легко.

Не пугайтесь незнакомых слов: за каждым из них почти всегда стоит простая идея. Мы разбираем их по шагам — от первой команды до первого настоящего запроса.

Начать с нуля бесплатно

Читайте также

Попробуй на практике

Бесплатные интерактивные курсы по теме — прямо в браузере, с нуля.