Отправляем первый запрос

О чём урок

Добро пожаловать в Anthropic Academy! Этот урок является вашим первым шагом к разработке с использованием Claude API. Мы покажем, как отправить ваш первый запрос к Claude и получить от него ответ, используя Python. Понимание этих основ критически важно для создания более сложных интерактивных приложений и систем на базе больших языковых моделей (LLM). В этом руководстве мы рассмотрим все необходимые шаги: от настройки вашей среды разработки до отправки запроса и извлечения полезной информации из ответа Claude. Прежде чем мы сможем отправить наш первый запрос к Claude, необходимо подготовить рабочую среду. Это включает установку необходимых библиотек и безопасную настройку вашего API-ключа. Для начала установим библиотеки anthropic (официальный Python SDK для Claude API) и python-dotenv (для безопасного управления переменными окружения). Если вы работаете в Jupyter Notebook или IPython, используйте префикс %pip: Если вы используете обычный Python скрипт, достаточно команды pip install в вашей командной строке или терминале. Ваш API-ключ — это конфиденциальная информация, которую никогда не следует напрямую встраивать в код или коммитить в систему контроля версий (например, Git). Лучший и наиболее безопасный способ — использовать файл .env для хранения ключа. Создайте файл с именем .env в той же директории, что и ваш скрипт или Jupyter-ноутбук, и добавьте в него следующую строку, заменив "your-api-key-here" на ваш реальный API-ключ, который вы получили от Anthropic: Всегда добавляйте .env в ваш файл .gitignore, чтобы случайно не опубликовать ключ в публичном репозитории. Теперь, когда ключ настроен, мы можем загрузить его из файла .env и инициализировать клиент Anthropic. Этот клиент будет служить основным интерфейсом для всех ваших запросов к API Claude. Здесь мы сначала загружаем переменные окружения с помощью load_dotenv(). Затем мы импортируем класс Anthropic и создаем его экземпляр, который сохраняем в переменной client. Также мы определяем, какую конкретную модель Claude будем использовать для наших запросов; в данном случае это claude-sonnet-4-0.

План урока

1. Введение: Ваш первый запрос к Claude API
2. Подготовка к работе с API Claude
3. Установка зависимостей
4. Безопасное хранение API-ключа
5. Инициализация клиента API
6. Отправка запросов с помощью client.messages.create()
7. Понимание max_tokens
8. Структура параметра messages