Получение Claude API Key: Console, пополнение и вызовы (2026)

Claude API — интерфейс моделей, который предоставляет Anthropic; его часто используют для длинных текстов, кода, агентов и сложных рассуждений. При первой настройке многие разработчики путают три вещи: веб-подписку Claude, Claude Code и Claude API.

Статья объясняет, как получить Claude API Key, как вызывать API, как подключить Claude Code и какие есть два варианта доступа из Китая.

Примечание: Claude и Anthropic — товарные знаки соответствующих правообладателей. Примеры отражают распространённую практику на октябрь 2026 года; интерфейсы и цены определяются официальными страницами и материалами сайта.

1. Сначала разделите три понятия

Название	Что это	Как использовать
Веб-версия и приложение Claude	Чат-продукт	Подписка
Claude Code	Инструмент программирования в командной строке	Вызывает модель через API
Claude API	Интерфейс модели	Вызов `/v1/messages` с ключом

Статья посвящена Claude API Key. Это не аккаунт веб-подписки, и веб-подписку нельзя напрямую использовать как API.

2. Вариант A: официальный ключ Anthropic Console

Откройте Anthropic Console.
Зарегистрируйтесь или войдите.
Перейдите на страницу API Keys.
Создайте ключ, задайте имя и сохраните.
Привяжите способ оплаты и подтвердите квоту.
Скопируйте ключ и сохраните в менеджере паролей.

Адрес официального ключа обычно:

https://api.anthropic.com

В заголовках запроса нужны x-api-key и anthropic-version. Точные требования — в официальной документации.

3. Вариант B: ключ ZSQH AI Gateway

Если доступ к официальному интерфейсу из Китая нестабилен или нужны единый счёт и несколько моделей:

Откройте ZSQH AI Gateway и зарегистрируйтесь.
Перейдите в раздел «API-ключи» и создайте ключ.
Задайте лимит и срок действия.
Пополните баланс.
Скопируйте ключ.

Шлюз предлагает два распространённых способа:

Совместимость с Anthropic: для Claude Code и других инструментов, использующих протокол Anthropic.
Совместимость с OpenAI: для OpenAI SDK, Cursor, Chatbox, Dify и других; Base URL — https://ai.zhongshangqihang.com/v1.

4. Вызов нативного интерфейса Anthropic через curl

export ANTHROPIC_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Объясни в трёх предложениях, что такое API-шлюз"}
    ]
  }'

Имя модели — на странице цены на модели. Если путь входа, совместимого с Anthropic, на шлюзе отличается, ориентируйтесь на внутреннюю инструкцию по подключению.

5. Вызов Claude через OpenAI SDK

Многие инструменты поддерживают только протокол OpenAI. В таком случае используйте вход шлюза, совместимый с OpenAI:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Ответь только OK"}],
)
print(resp.choices[0].message.content)

Обратите внимание: нативный интерфейс Anthropic и интерфейс, совместимый с OpenAI, имеют разные форматы запросов; не смешивайте их.

6. Подключение к Claude Code

Claude Code работает по протоколу Anthropic. Типичная конфигурация:

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-ваш-ключ"
claude

Если клиент требует ANTHROPIC_AUTH_TOKEN, замените переменную согласно документации клиента. Подробные шаги — в статье Подключение Claude Code: ключ и первый запрос.

7. Типичные ошибки

Ошибка	Причина	Что делать
`401`	Неверный или просроченный ключ, неправильный заголовок	Проверить `x-api-key` или Bearer
`404`	Неверный Base URL или путь	Для нативного интерфейса `/v1/messages`; для OpenAI-совместимого `/v1`
`model not found`	Неверное имя модели	Скопировать со страницы цен
`429`	Ограничение скорости или квота	Снизить параллельность, повторить, повысить квоту
`insufficient quota`	Недостаточно средств	Пополнить баланс
Ошибка `anthropic-version`	Отсутствует заголовок версии	Добавить `anthropic-version: 2023-06-01`

8. Рекомендации по безопасности

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

9. Прямое подключение и шлюз

Критерий	Прямое официальное подключение	ZSQH AI Gateway
Доступ	Зависит от сети	Оптимизирован для Китая
Оплата	Официальные способы	Пополнение в кабинете
Модели	Только Claude	Одновременно GPT/Gemini/DeepSeek
Счёт	Официальная панель	Единая консоль
Переключение	Смена поставщика требует правок кода	Достаточно изменить имя модели

Если вы используете только Claude и официальный доступ стабилен, можно подключаться напрямую; если нужны стабильный доступ из Китая и единое управление несколькими моделями, шлюз удобнее.

Частые вопросы

Это тот же ключ, что у Claude Code?

Claude Code использует Claude API Key (или ключ совместимого шлюза). Веб-подписка — не API-ключ.

Можно ли одним ключом вызывать несколько моделей Claude?

Да, модель указывается в параметрах запроса. Доступные модели смотрите на странице цен.

Почему код из официальной документации не работает?

Частые причины — несоответствие Base URL, заголовков и имени модели. Нативный интерфейс и интерфейс, совместимый с OpenAI, настраиваются отдельно.

Что дальше

Если нужен стабильный доступ из Китая или единая точка входа для нескольких моделей, зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ и выполните первый запрос по этой статье. Модели и цены — на странице цены на модели.