Claude API, токены и ключ доступа

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

🎯 После урока сможешь: получить ключ Claude API и отправить первый запрос.

Токен — и почему это про деньги

За API платят по токенам. Токен — это маленький кусочек текста (примерно часть слова). Чем длиннее твой запрос и ответ модели — тем больше токенов и тем дороже. Считают отдельно за вход (что ты отправил) и за выход (что ответила модель).

Где взять ключ: два пути

Путь 1 — прямой (Anthropic Console). Заходишь на console.anthropic.com, создаёшь ключ, там же ставишь лимит расходов. Это «из первых рук»: все возможности и обычная цена. Минус — из России доступ и оплата бывают затруднены (нужна зарубежная карта, иногда VPN).

Путь 2 — через посредника (OpenRouter). openrouter.ai — сервис-посредник: один ключ даёт доступ сразу ко многим моделям, включая Claude. Не путай с бесплатной дорожкой (Qwen/Ollama): там другой «мозг» вместо Claude, а здесь — тот же Claude, просто другой вход.

• Один ключ — много моделей, пробуешь без отдельных аккаунтов.
• Знакомый формат: в коде меняешь только адрес (https://openrouter.ai/api/v1) и ключ.
• Оплата по факту, способы пополнения часто доступнее из России.
• Экономия сохраняется: prompt caching для Claude через OpenRouter работает.

У OpenRouter есть небольшая наценка сверху, и данные идут через посредника — не отправляй туда лишний раз персональные данные клиентов. Правило одно для обоих путей: ключ — секрет, только в .env, никогда в коде и в Git.

Первый запрос

Сначала поставь две библиотеки: саму библиотеку Anthropic и помощника, который умеет читать файл .env. На Windows пиши py вместо python — так команда точно попадёт в настоящий Python, а не в заглушку магазина приложений.

py -m pip install anthropic python-dotenv

Successfully installed anthropic python-dotenv

Теперь сам запрос. Ключ лежит в .env и в коде не появляется:

from dotenv import load_dotenv
from anthropic import Anthropic

load_dotenv()   # прочитать .env и передать ключ программе

client = Anthropic()   # ключ подхватится сам из ANTHROPIC_API_KEY

msg = client.messages.create(
    model="claude-haiku-4-5",   # дешёвая модель для теста; актуальный id сверь в доке
    max_tokens=200,
    messages=[{"role": "user", "content": "Привет! Ответь одним предложением."}],
)
print(msg.content[0].text)

Привет! Рад помочь — с чего начнём?

Строчка load_dotenv() — не украшение, без неё программа ключ не найдёт. Файл .env сам по себе программе не виден: это просто текстовый файл, лежащий рядом. load_dotenv() открывает его и передаёт содержимое программе. Уберёшь строчку — получишь ошибку «ключ не найден» при том, что ключ на месте и верный.

Ошибка authentication_error или «could not resolve authentication method» означает одно из двух: программа не нашла ключ (нет load_dotenv(), или .env лежит в другой папке) либо ключ скопирован не целиком. Сам ключ в код не вставляй даже «на минутку проверить» — забудешь убрать, и он уедет в Git.

Считаем стоимость

Стоимость — это просто арифметика по токенам. Например, модель берёт 3 ₽ за 1000 токенов входа. Твой запрос — 2000 токенов входа. Значит вход стоит 2000 ÷ 1000 × 3 = 6 ₽. Прибавь выход по его цене — вот и вся математика.

Чтобы точно не потратить лишнего, в Anthropic Console → Spending Limits ставят лимит расходов (например, на месяц). Бюджет первого месяца на тесты обычно копеечный.

Контрольный вопрос. Тебе нужен быстрый и дешёвый тест API. Какую модель разумно взять?

АЛюбую, разницы в цене нет

БOpus — самую мощную и дорогую

ВHaiku — самую дешёвую и быструю

Подсказка: Для теста мощная модель не нужна, а цена у моделей разная.

Онлайн-проверка ответа появится позже

Контрольный вопрос. Модель берёт 3 ₽ за 1000 токенов входа. Твой запрос — 2000 токенов входа. Сколько рублей стоит вход одного запроса? Впиши число.

Подсказка: Цена дана не за штуку, а за тысячу токенов: переведи объём запроса в тысячи и умножь на цену.

Онлайн-проверка ответа появится позже

Контрольный вопрос. Где выставляют лимит расходов на Claude API, чтобы не потратить лишнего?

АВ файле .gitignore рядом с ключом

БВ настройках Telegram-бота у @BotFather

ВВ Anthropic Console → Spending Limits

Подсказка: Лимит расходов ставят там же, где создают ключ.

Онлайн-проверка ответа появится позже

Контрольный вопрос. Модель берёт 3 ₽ за 1000 токенов входа и 15 ₽ за 1000 токенов выхода. Твой запрос — 1500 токенов входа и 300 токенов выхода. Сколько рублей стоит весь запрос целиком, вход и выход вместе? Впиши число.

Подсказка: Посчитай вход и выход по отдельности, каждый по своей цене за тысячу токенов, а потом сложи.

Онлайн-проверка ответа появится позже

Что дальше

Ты умеешь получить ключ (напрямую или через OpenRouter), отправить запрос и посчитать цену. Остался последний кирпич фундамента — MCP, через который Claude подключается к внешним сервисам.

← Назад  ·  ↑ В начало урока  ·  ⌂ В начало курса  ·  Вперёд →