# Бэкенд для Claude Code

Адрес API /claude/api для агентов Claude Code и Claude Desktop.

Адрес API `claude` предназначен для [Claude Code](https://coreinfra.ru/docs/claude-code.md) и [Claude Desktop](https://coreinfra.ru/docs/claude-desktop.md) для работы с моделями через хаб без VPN. Он отличается от [`anthropic`](https://coreinfra.ru/docs/use/anthropic.md) тем, что отдает каталог моделей в формате меню Claude.

## 1. Настройте адрес и ключ

Укажите базовый адрес `https://hub.coreinfra.ai/claude/api` и подставьте ключ хаба `sk-ci2-...` в `ANTHROPIC_API_KEY` (или в поле `Gateway API key` в Claude Desktop). Пошаговая настройка описана в инструкциях для [Claude Code](https://coreinfra.ru/docs/claude-code.md) и [Claude Desktop](https://coreinfra.ru/docs/claude-desktop.md).

Проверьте минимальный вызов через cURL:

```bash
export COREINFRA_API_KEY='sk-ci2-...'
curl https://hub.coreinfra.ai/claude/api/v1/messages \
  -H "x-api-key: $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  -d '{"model":"claude-haiku-4-5-20251001","max_tokens":64,"messages":[{"role":"user","content":"2 + 2"}]}'
```

Ожидаемый текст ответа — `4`. При пустом балансе вы получите предложение пополнить его.

## Отличия от API Anthropic

Для запросов Messages и подсчета токенов действуют те же [отличия](https://coreinfra.ru/docs/use/anthropic.md#limits) и [правила конвертации](https://coreinfra.ru/docs/use/anthropic.md#conversion), что и у [Anthropic-совместимого API](https://coreinfra.ru/docs/use/anthropic.md) (полное описание протокола — в [документации Anthropic Messages](https://platform.claude.com/docs/en/api/messages/create)).

## Что доступно

Доступны API методы `POST /v1/messages`, `POST /v1/messages/count_tokens`, `GET /v1/models` и проверка соединения `GET` или `HEAD /api/hello` относительно `https://hub.coreinfra.ai/claude/api`. Форматы запросов описаны в [справочнике Anthropic API](https://coreinfra.ru/docs/reference/anthropic.md).

Каталог `GET /v1/models` возвращает генеративные модели для меню агента с меткой `[CoreInfra]` в названии. Чтобы Claude Code показывал модели в списке выбора, в их имени должно содержаться `claude` или `anthropic`, поэтому хаб добавляет ко всем моделям других провайдеров префикс `claude-` (например, `claude-gpt-6-luna` или `claude-kimi-k3`). Полный список моделей приведен в [каталоге моделей](https://coreinfra.ru/docs/catalog.md).

![Модели из каталога хаба с префиксом \[CoreInfra\] в меню выбора модели Claude Code](https://coreinfra.ru/assets/images/any-model-any-agent-claude-99d67cdf43322a1047c576f6a9ff84d4.jpg)

Модели разных провайдеров с префиксом `[CoreInfra]` в меню выбора модели Claude Code.

## Ошибки

Формат и примеры ошибок проверки запроса приведены в [справочнике Anthropic API](https://coreinfra.ru/docs/reference/anthropic.md#errors). Общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике API](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
