Начальная настройка

В этом примере мы попросим Claude написать функцию на Python, которая проверяет, является ли строка палиндромом.

​

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

Вам понадобится:

• Учетная запись Console от Anthropic
• API ключ
• Python 3.7+ или TypeScript 4.5+

Anthropic предоставляет SDK для Python и TypeScript, хотя вы можете делать прямые HTTP-запросы к API.

​

Начните с Workbench

Любой API-вызов, который вы делаете — независимо от конкретной задачи — отправляет правильно настроенный промпт в API Anthropic. Пока вы учитесь максимально эффективно использовать Claude, мы рекомендуем начать процесс разработки в Workbench — веб-интерфейсе для работы с Claude.

Войдите в Anthropic Console и нажмите Write a prompt from scratch.

В средней секции под User давайте зададим Claude вопрос.

Why is the ocean salty?

Нажмите Run. Справа вы увидите вывод, подобный этому:

Океан солёный по нескольким причинам:

1. Выветривание горных пород: На протяжении миллионов лет дождь, реки и ручьи разрушали породы, содержащие минеральные соли. Эти соли переносятся в океан водными потоками.
2. Вулканическая активность: Подводные вулканы и гидротермальные источники выделяют минералы, включая соли, в океанскую воду.
3. Атмосферное осаждение: Частицы соли из океанских брызг могут переноситься ветром и осаждаться обратно в океан.
4. Испарение: Когда вода испаряется с поверхности океана, она оставляет растворенные соли, увеличивая концентрацию соли в оставшейся воде.
5. Биологические процессы: Некоторые морские организмы способствуют солености океана, выделяя солевые соединения как побочные продукты своего метаболизма.

Со временем эти процессы постоянно добавляли соли в океан, в то время как испарение удаляет чистую воду, что приводит к текущему уровню солености океана. Важно отметить, что общее количество соли в океане остается относительно стабильным, поскольку поступление солей уравновешивается их удалением через такие процессы, как образование эвапоритовых отложений.

Это хороший ответ, но давайте представим, что мы хотим контролировать точный тип ответа, который дает Claude. Например, позволить Claude отвечать на вопросы только стихами. Мы можем контролировать формат, тон и характер ответа, добавив системный промпт.

You are a world-class poet. Respond only with short poems.

Нажмите Run снова.

Соленый океан морской,
История времен и сил земной.
Скалы и дождь, медленная эрозия,
Минералы в растворе, как поэзия.
Века проходят, соль остается,
В бескрайних водах вечно льется.

Видите, как изменился ответ Claude? LLM хорошо реагируют на четкие и прямые инструкции. Вы можете поместить инструкции о роли либо в системный промпт, либо в сообщение пользователя. Мы рекомендуем протестировать, какой способ дает лучшие результаты для вашего случая.

Когда вы настроите входные данные так, что будете довольны результатом – и хорошо поймете, как использовать Claude – преобразуйте ваш Workbench в интеграцию.

​

Установка SDK

Anthropic предоставляет SDK для Python (3.7+), TypeScript (4.5+) и Java (8+). У нас также есть Go SDK в бета-версии.

• Python
• TypeScript
• Java

python -m venv claude-env

pip install anthropic

​

Установите ваш API ключ

Каждый API-вызов требует действительный API ключ. SDK разработаны так, чтобы получать API ключ из переменной окружения ANTHROPIC_API_KEY. Вы также можете предоставить ключ клиенту Anthropic при его инициализации.

export ANTHROPIC_API_KEY='your-api-key-here'

​

Вызов API

Вызовите API, передав соответствующие параметры в конечную точку /messages.

Обратите внимание, что код, предоставленный Workbench, устанавливает API ключ в конструкторе. Если вы установили API ключ как переменную окружения, вы можете опустить эту строку, как показано ниже.

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1000,
    temperature=1,
    system="You are a world-class poet. Respond only with short poems.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Why is the ocean salty?"
                }
            ]
        }
    ]
)
print(message.content)

Запустите код используя python3 claude_quickstart.py или node claude_quickstart.js.

[TextBlock(text="Соленый океан морской,\nИстория времен и дней.\nСкалы и реки, минералы текут,\nНа дне морском покой найдут.\nИспарение соль оставляет,\nВ бескрайних водах навек пребывает.", type='text')]

Это руководство по быстрому старту показывает, как разработать базовое, но функциональное приложение на основе Claude с использованием Console, Workbench и API. Вы можете использовать этот же рабочий процесс как основу для гораздо более мощных случаев использования.

​

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

Теперь, когда вы сделали свой первый запрос к API Anthropic, пора изучить, что еще возможно: