API-ключ Claude: как получить, подключить и проверить

Чтобы подключить Claude к своему приложению, нужны три вещи: API-ключ, адрес сервера и название модели. Одного ключа недостаточно: ключ Клодыча работает с адресом Клодыча, а ключ Anthropic — с API Anthropic. Если перепутать адрес, даже действующий ключ вернёт ошибку авторизации.

Здесь пройдём путь от выбора доступа до первого ответа. Если нужен обычный разговор с Claude без программирования, начните с чата в Telegram.

Что именно вы получаете

Доступ	Где используется	За что платите
Claude Pro	Аккаунт Claude и доступные функции подписки	Подписка с лимитами использования
Прямой Claude API	Ваш код → сервер Anthropic	Использованные токены и инструменты
API Клодыча	Ваш код → шлюз Клодыча → поставщик модели	Запросы по тарифу Клодыча с рублёвого баланса

Pro не выдаёт бесплатный API-баланс: Anthropic прямо разделяет подписку и использование API. Это объясняется в справке о Pro. Подробный выбор сценария — в статье «Claude Pro или API».

Где получить ключ

Прямой доступ. Создайте аккаунт Claude Console, настройте биллинг и выпустите ключ. Сначала проверьте поддерживаемые регионы Anthropic: наличие иностранной карты само по себе не означает, что сервис доступен для вашего аккаунта.

Через Клодыча. Откройте @claudichbot, нажмите «Запустить» и перейдите в раздел API. Создайте отдельный ключ для нужного приложения, задайте доступный лимит расходов и пополните баланс перед тестовым запросом. Действующие цены находятся на странице тарифов.

Не используйте один ключ во всех проектах. Отдельный ключ для редактора кода и отдельный для серверного бота позволят понять, какое приложение расходует баланс, и отключить только проблемное подключение.

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

Установите SDK в окружение своего проекта:

pip install anthropic

Сохраните ключ в переменную окружения CLAUDICH_API_KEY, а затем выполните:

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["CLAUDICH_API_KEY"],
    base_url="https://app.claudich.dev",
)

response = client.messages.create(
    model="claude-haiku-4.5",
    max_tokens=256,
    messages=[{
        "role": "user",
        "content": "Объясни в двух предложениях, что такое API.",
    }],
)

for block in response.content:
    if block.type == "text":
        print(block.text)

print(response.usage)

Здесь Haiku выбран для короткой проверки подключения. Значение max_tokens=256 ограничивает только этот тест: для отчёта, кода или большого перевода такой предел может оборвать ответ. В рабочем приложении выбирайте его под задачу и проверяйте stop_reason.

Названия моделей берите из каталога сервиса. Вызов GET https://app.claudich.dev/v1/models с вашим ключом позволяет проверить доступные идентификаторы перед интеграцией. Официальное имя модели и её идентификатор у шлюза могут различаться.

Какой адрес вставлять в настройки

Клиент	Адрес Клодыча
Anthropic SDK, параметр base_url / baseURL	https://app.claudich.dev
OpenAI-совместимый SDK, параметр base_url / baseURL	https://app.claudich.dev/v1
Claude Code, ANTHROPIC_BASE_URL	https://app.claudich.dev
Прямой HTTP-запрос Messages	https://app.claudich.dev/v1/messages

Anthropic SDK сам добавляет /v1/messages, поэтому ему нужен корень адреса. OpenAI-совместимому клиенту нужен адрес с /v1. Для Claude Code используйте отдельную инструкцию. Не копируйте настройки одного редактора в другой: провайдер, формат авторизации и поддержка пользовательского адреса зависят от клиента.

Запрос не работает: что проверить

Что произошло	Что сделать
401 — ключ не принят	Проверьте адрес, лишние пробелы, активность ключа и выбранный способ авторизации
402 — недостаточно средств	Посмотрите баланс и ограничения ключа в кабинете
404 — модель или маршрут не найдены	Сверьте модель с каталогом, исключите двойной /v1/v1 в адресе
429 — превышен лимит	Уменьшите параллельность и соблюдайте время ожидания из ответа сервера
Ответ оборвался	Проверьте stop_reason, ограничение вывода и состояние соединения
SDK получает HTML вместо JSON	Проверьте полный адрес и прокси: запрос мог попасть на веб-страницу

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

Как не потерять контроль над ключом и деньгами

Храните секрет на сервере или в локальном окружении. Ключ в JavaScript страницы, мобильном приложении или публичном репозитории смогут извлечь другие люди. Для пользовательского интерфейса нужен собственный сервер, который авторизует пользователя и вызывает модель.

После первого запроса проверьте не только текст ответа, но и запись расхода в кабинете. Затем выполните несколько типовых задач: короткий вопрос плохо предсказывает стоимость большого документа или агентной сессии. Для расчёта используйте сравнение цен API, а для снижения расхода — разбор контекста и кеширования.

Готовы подключить свой проект? Откройте бота и нажмите «Запустить». В разделе API будут ключ, параметры подключения и история запросов — всё для проверки первого вызова в одном месте.