ClaudeStore/Документация
⚠ Документация в разработке. Часть материалов может быть неточной или временно сгенерирована ИИ.

Аутентификация Claude API — настройка ключа Клод нейросеть

Как аутентифицировать запросы к нейросети Клауд (Claude API). Настройка API-ключа Клод ИИ, заголовков и безопасности.

🇬🇧 Read in English

Префикс ключа: sk-cs2-*. Anthropic заголовок: x-api-key: sk-cs2-.... OpenAI заголовок: Authorization: Bearer sk-cs2-.... Base URL: https://api3.claudestore.store. Ротация: В любой момент из дашборда без даунтайма.

Формат API-ключа

ClaudeStore выдаёт два семейства ключей:

  • sk-cs2-… — v1-ключи для https://api3.claudestore.store (Cursor, OpenAI SDK, Anthropic SDK).
  • sk-cs2-… — v2-ключи для https://api3.claudestore.store (Claude Code CLI/расширение, отдельный пул кредитов).

Храните оба в секрете — не публикуйте в клиентском коде и открытых репозиториях.

Методы аутентификации

Шлюз поддерживает два варианта в зависимости от формата API:

Формат Anthropic

Передайте API-ключ в заголовке x-api-key вместе с обязательным anthropic-version:

curl https://api3.claudestore.store/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4.6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Привет"}]}'

Формат OpenAI

Передайте API-ключ как Bearer токен в заголовке Authorization:

curl https://api3.claudestore.store/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4.6", "messages": [{"role": "user", "content": "Привет"}]}'

Claude Code CLI / расширение

Claude Code CLI и VS Code-расширение читают переменную ANTHROPIC_API_KEY. Используйте только ANTHROPIC_API_KEY — ANTHROPIC_AUTH_TOKEN зарезервирован под OAuth-логин Anthropic Pro/Max и с этим шлюзом не работает.

Переменные для Claude Codebash
export ANTHROPIC_BASE_URL="https://api3.claudestore.store"
export ANTHROPIC_API_KEY="YOUR_SK_CS2_KEY"

Настройки ключа

Каждый API-ключ конфигурируется в личном кабинете. Сейчас на стороне шлюза применяются следующие ограничения:

ПараметрОписание
Rate limitМаксимум запросов в минуту для этого ключа
Allowed modelsОграничить ключ конкретными моделями (например, только claude-sonnet-4)
Monthly credit capЖёсткий лимит на расход кредитов этим ключом в течение календарного месяца (UTC)
RevocationМгновенный отзыв скомпрометированного ключа без влияния на остальные
Настройки задаются в API Keys → Редактировать ключ. Все параметры опциональны — по умолчанию ключ имеет полный доступ и ограничен только остатком кредитов.

Настройка SDK

Оба SDK (Anthropic и OpenAI) принимают API-ключ напрямую. Подробности — в руководствах по SDK.

Проверьте конфигурацию

Проверка доступа к gateway

Перед боевыми запросами выполните две дешёвые проверки: liveness-пробу и список моделей. Они подтверждают base URL, сеть и (для /v1/models) ваш API-ключ — без расхода кредитов.

1. Проверка живости — /healthz

Публичный, без авторизации. Возвращает 200 и JSON со статусом, если шлюз поднят. Используйте в CI, мониторинге или просто в терминале.

curl -sS -o /dev/null -w "HTTP %{http_code}\n" \
  https://api3.claudestore.store/healthz

2. Авторизация + каталог — /v1/models

Возвращает список ID моделей, доступных через /v1/messages. Требует валидный x-api-key. Если работает — ключ, base URL и заголовки верны.

curl -sS https://api3.claudestore.store/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" | jq '.data[].id'

Как выглядит корректный ответ

  • /healthz → HTTP 200, тело {"status":"ok", ...}. Всё остальное (таймаут, 5xx, HTML) означает неверный хост или проблему с сетью/прокси.
  • /v1/models → HTTP 200, тело {"object":"list","data":[...]}. В data перечислены ровно те ID моделей, которые принимает /v1/messages.

Частые ошибки

  • Неверный base URL. Единственный правильный хост — https://api3.claudestore.store. Не используйте api.anthropic.com, api.claudestore.store (старый) или другие варианты.
  • Забыли префикс /v1. Все боевые ручки живут под /v1/* (например, /v1/messages, /v1/models). /healthz — единственное исключение, он на корне.
  • Неверный заголовок авторизации. Используйте x-api-key: sk-cs2-... (как у Anthropic). Не отправляйте Authorization: Bearer ..., если этого не делает SDK сам.
  • Неверный ID модели. Работают только ID из /v1/models. На сегодня: claude-sonnet-4.6, claude-haiku-4.5, claude-opus-4.7.

Совет: используйте /v1/models как источник правды для ID моделей в скриптах и CI — не хардкодьте список.

Готовы начать?

Получите доступ к API всех моделей Claude за 2 минуты.

Смотреть тарифы