Первые шаги: установка и первый запрос
Как установить anthropic SDK, безопасно хранить API-ключ через dotenv и отправить первый запрос к Claude — от установки до печати ответа.
Установка SDK
Для работы с Claude API нужен Python 3.7.1 или новее. Установите пакет:
pip install anthropic python-dotenv
Хранение API-ключа
Никогда не хардкодьте ключ. Используйте .env файл:
from dotenv import load_dotenv
import os
load_dotenv()
my_api_key = os.getenv("ANTHROPIC_API_KEY")
Инициализация клиента
from anthropic import Anthropic
client = Anthropic(api_key=my_api_key)
# или просто — SDK автоматически читает ANTHROPIC_API_KEY из окружения:
client = Anthropic()
Первый запрос к Claude
our_first_message = client.messages.create(
model="claude-3-haiku-20240307",
max_tokens=1000,
messages=[
{"role": "user", "content": "Hi there! Please write me a haiku about a pet chicken"}
]
)
print(our_first_message.content[0].text)
Три обязательных параметра
Каждый запрос к Claude требует трёх полей:
- model — идентификатор модели (например,
claude-3-haiku-20240307) - max_tokens — максимальное количество токенов в ответе
- messages — список сообщений в формате диалога
Что такое токены?
Токен — фрагмент текста, примерно 3.5 символа для английского. Claude генерирует ответ токен за токеном. max_tokens задаёт верхний предел — модель остановится раньше, если закончит мысль.
Установите anthropic и python-dotenv, создайте .env с ключом, напишите скрипт который спрашивает Claude написать хайку о вашем городе и выводит текст ответа.
Скопируйте и адаптируйте под свой контекст. Текст в треугольных скобках — то, что нужно заменить.
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=1024,
messages=[
{"role": "user", "content": "Напиши хайку о программировании на Python"}
]
)
print(message.content[0].text)- Хардкодят API-ключ прямо в коде — риск утечки при коммите в git.
- Забывают вызвать load_dotenv() до os.getenv() — переменная не загружается.
- Не проверяют версию Python — SDK требует 3.7.1+.
- Если ANTHROPIC_API_KEY экспортирован в окружение — load_dotenv() не нужен, Anthropic() найдёт его сам.
- pip install anthropic уже включает httpx и другие зависимости — дополнительно ничего не нужно.
- Для ноутбуков используйте %pip install anthropic вместо !pip.
Любой новый проект на Claude API — начинайте с этого шаблона как минимального рабочего примера.
Если вы уже используете LangChain или другой фреймворк поверх Anthropic — прямой SDK может быть избыточен.