Начало работы с Claude

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

​

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

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

• Учетная запись Anthropic Console
• 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. В правой части вы увидите вывод, подобный этому

The ocean is salty due to several factors:

1. Weathering of rocks: Over millions of years, rain, rivers, and streams have eroded rocks containing mineral salts. These salts are carried into the ocean by water runoff.
2. Volcanic activity: Underwater volcanoes and hydrothermal vents release minerals, including salts, into the ocean water.
3. Atmospheric deposition: Salt particles from ocean spray can be carried by wind and deposited back into the ocean.
4. Evaporation: As water evaporates from the surface of the ocean, it leaves behind dissolved salts, increasing the concentration of salt in the remaining water.
5. Biological processes: Some marine organisms contribute to the ocean's salinity by releasing salt compounds as byproducts of their metabolism.

Over time, these processes have continuously added salts to the ocean, while evaporation removes pure water, leading to the ocean's current salinity levels. It's important to note that the total amount of salt in the ocean remains relatively stable because the input of salts is balanced by the removal of salts through processes like the formation of evaporite deposits.

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

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

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

The ocean's salty brine,
A tale of time and elements combined.
Rocks and rain, a slow erosion,
Minerals carried in solution.
Eons pass, the salt remains,
In the vast, eternal watery domain.

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

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

​

Установите SDK

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

python -m venv claude-env

pip install anthropic

python -m venv claude-env

pip install anthropic

npm install @anthropic-ai/sdk

implementation("com.anthropic:anthropic-java:1.0.0")

<dependency>
  <groupId>com.anthropic</groupId>
  <artifactId>anthropic-java</artifactId>
  <version>1.0.0</version>
</dependency>

​

Установите ваш 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-opus-4-20250514",
    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="The ocean's salty brine,\nA tale of time and design.\nRocks and rivers, their minerals shed,\nAccumulating in the ocean's bed.\nEvaporation leaves salt behind,\nIn the vast waters, forever enshrined.", type='text')]

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

​

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

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