Краткое руководство
Хотите просто пообщаться с 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) и введите:
python --version
Если вы видите номер версии, например “Python 3.12.2”, то все в порядке. Если нет, посетите официальный сайт Python и загрузите последнюю версию.
(Необязательно) Создайте виртуальное окружение
Хотя это не обязательно, рекомендуется создать виртуальное окружение для ваших проектов с Claude. Это поможет организовать ваши зависимости и предотвратить конфликты с другими проектами. Чтобы создать виртуальное окружение, выполните:
python -m venv claude-env
Затем активируйте его:
- На macOS или Linux:
source claude-env/bin/activate
- На Windows:
claude-env\Scripts\activate
Шаг 2: Установка Anthropic Python SDK
После настройки окружения пришло время установить библиотеку Claude Python. Просто выполните:
pip install anthropic
Эта команда установит последнюю версию библиотеки вместе со всеми необходимыми зависимостями.
Шаг 3: (Необязательно) Настройка вашего API-ключа
Чтобы использовать Claude, вам нужно предоставить свой API-ключ. Вы можете сделать свой API-ключ доступным для всех ваших проектов Claude, установив переменную окружения. Вот как это сделать:
- На macOS или Linux:
- Откройте терминал и введите:
nano ~/.bash_profile
(илиnano ~/.zshrc
, если вы используете более новую версию macOS) - Добавьте эту строку в файл, заменив
your-api-key-here
на ваш фактический API-ключ:export ANTHROPIC_API_KEY='your-api-key-here'
- Сохраните файл и выйдите из редактора (нажмите
Ctrl+O
, затемEnter
, затемCtrl+X
) - Загрузите обновленный профиль, выполнив:
source ~/.bash_profile
(илиsource ~/.zshrc
)
- Откройте терминал и введите:
- На Windows:
- Откройте командную строку и введите:
setx ANTHROPIC_API_KEY "your-api-key-here"
, заменивyour-api-key-here
на ваш фактический API-ключ - Чтобы сделать это изменение постоянным, выполните следующие шаги:
- Щелкните правой кнопкой мыши на ‘Этот компьютер’ или ‘Мой компьютер’ и выберите ‘Свойства’
- Нажмите на ‘Дополнительные параметры системы’
- Нажмите кнопку ‘Переменные среды’
- В разделе ‘Системные переменные’ нажмите ‘Создать…’ и введите
ANTHROPIC_API_KEY
в качестве имени переменной и ваш API-ключ в качестве значения переменной
- Откройте командную строку и введите:
Шаг 4: Отправьте свой первый API-запрос
Вы почти у цели! Давайте отправим ваш первый API-запрос к Claude. Создайте новый файл Python (например, claude_test.py
) и добавьте следующий код:
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.
- Изучите глоссарий терминов, чтобы ознакомиться с терминологией, используемой в AI, LLM и экосистеме Claude.
- Присоединяйтесь к нашему серверу Discord для разработчиков, чтобы общаться с другими разработчиками, задавать вопросы и делиться своими проектами.
- Посетите библиотеку промптов для вдохновения и готовых к использованию промптов для различных задач или окунитесь в инженерию промптов, ознакомившись с введением в промптинг.
Мы с нетерпением ждем, что вы создадите с помощью Claude. Счастливого кодинга!