Хотите просто пообщаться с Claude? Посетите claude.ai!

Хотите сразу погрузиться в изучение нашего API? Перейдите к нашей документации API reference для получения более подробной информации.

Давайте быстро настроим вас для работы с Claude! В этом руководстве мы проведем вас через процесс настройки вашего окружения, установки необходимых библиотек и отправки вашего первого API-запроса к Claude. Давайте начнем!

Обратите внимание, что хотя в этом руководстве используется наш Python SDK, мы также поддерживаем TypeScript SDK и прямую интеграцию по HTTP. Подробности смотрите в нашей документации по client SDKs и API reference.


Предварительные требования

Прежде чем начать, убедитесь, что у вас есть следующее:

  • Учетная запись с доступом к API (см. наше руководство по получению доступа к Claude)
  • API-ключ (доступен через Account Settings)
  • Python 3.7.1 или новее, установленный на вашем компьютере

Шаг 1: Настройка окружения

Сделайте копию нашего блокнота для быстрого старта в Google Colab, чтобы начать работу немедленно без настройки окружения!

Сначала убедитесь, что у вас установлен Python. Откройте терминал (на macOS) или командную строку (на Windows) и введите:

Shell
python --version

Если вы видите номер версии, например “Python 3.12.2”, то все в порядке. Если нет, посетите официальный сайт Python и загрузите последнюю версию.

(Необязательно) Создайте виртуальное окружение

Хотя это не обязательно, рекомендуется создать виртуальное окружение для ваших проектов с Claude. Это поможет организовать ваши зависимости и предотвратить конфликты с другими проектами. Чтобы создать виртуальное окружение, выполните:

Shell
python -m venv claude-env

Затем активируйте его:

  • На macOS или Linux: source claude-env/bin/activate
  • На Windows: claude-env\Scripts\activate

Шаг 2: Установка Anthropic Python SDK

После настройки окружения пришло время установить библиотеку Claude Python. Просто выполните:

Shell
pip install anthropic

Эта команда установит последнюю версию библиотеки вместе со всеми необходимыми зависимостями.

Шаг 3: (Необязательно) Настройка вашего API-ключа

Чтобы использовать Claude, вам нужно предоставить свой API-ключ. Вы можете сделать свой API-ключ доступным для всех ваших проектов Claude, установив переменную окружения. Вот как это сделать:

  • На macOS или Linux:
    1. Откройте терминал и введите: nano ~/.bash_profile (или nano ~/.zshrc, если вы используете более новую версию macOS)
    2. Добавьте эту строку в файл, заменив your-api-key-here на ваш фактический API-ключ: export ANTHROPIC_API_KEY='your-api-key-here'
    3. Сохраните файл и выйдите из редактора (нажмите Ctrl+O, затем Enter, затем Ctrl+X)
    4. Загрузите обновленный профиль, выполнив: source ~/.bash_profile (или source ~/.zshrc)
  • На Windows:
    1. Откройте командную строку и введите: setx ANTHROPIC_API_KEY "your-api-key-here", заменив your-api-key-here на ваш фактический API-ключ
    2. Чтобы сделать это изменение постоянным, выполните следующие шаги:
      • Щелкните правой кнопкой мыши на ‘Этот компьютер’ или ‘Мой компьютер’ и выберите ‘Свойства’
      • Нажмите на ‘Дополнительные параметры системы’
      • Нажмите кнопку ‘Переменные среды’
      • В разделе ‘Системные переменные’ нажмите ‘Создать…’ и введите ANTHROPIC_API_KEY в качестве имени переменной и ваш API-ключ в качестве значения переменной

Шаг 4: Отправьте свой первый API-запрос

Вы почти у цели! Давайте отправим ваш первый API-запрос к Claude. Создайте новый файл Python (например, claude_test.py) и добавьте следующий код:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="Отвечай только в стиле Йоды.",
    messages=[
        {"role": "user", "content": "Как у тебя дела сегодня?"}
    ]
)

print(message.content)

Давайте разберем, что здесь происходит:

  • Мы импортируем библиотеку anthropic, которая предоставляет удобный способ взаимодействия с API Claude.
  • Мы создаем экземпляр клиента Anthropic, передавая наш API-ключ (если вы установили переменную окружения, вы можете опустить это).
  • Мы вызываем метод messages.create() для отправки сообщения Claude. Мы указываем модель, которую хотим использовать (claude-3-opus-20240229), максимальное количество токенов в ответе (max_tokens=1000), температуру (которая контролирует случайность вывода, temperature=0.0 означает минимальную случайность) и системное сообщение (которое задает контекст для разговора).
  • Наконец, мы выводим ответ от Claude.

Чтобы запустить код, просто введите python claude_test.py в терминале или командной строке. Вы должны увидеть ответ от Claude в стиле пословицы!

Посетите Messages API examples для получения дополнительных примеров структур вызовов API. Для получения дополнительной информации о параметрах API см. справочник Messages API.


Следующие шаги

Поздравляем, вы успешно отправили свой первый API-запрос к Claude! Вот некоторые следующие шаги для продолжения вашего путешествия.

Ресурсы API

Загляните в нашу документацию по API для получения более подробной информации о доступных конечных точках и параметрах.

Ознакомьтесь с нашими клиентскими SDK для набора инструментов, которые облегчат вам создание и интеграцию Claude в ваши приложения.

Anthropic cookbook

Anthropic cookbook содержит набор рецептов в виде блокнотов Jupyter. Эти блокноты содержат копируемый код, демонстрирующий, как использовать Claude аккуратно и эффективно в более продвинутых сценариях, таких как загрузка PDF, использование инструментов и вызов функций, эмбеддинги и многое другое.

Другие ресурсы

Мы с нетерпением ждем, что вы создадите с помощью Claude. Счастливого кодинга!