Claude Code

Настройка Claude Code для работы через ToyGate с помощью Anthropic base URL.

Интеграции

По умолчанию Claude Code обращается к Anthropic Messages API. Укажите корневой URL шлюза вместо стандартного адреса — и запросы будут прозрачно проходить через шлюз. Для моделей с provider_format: anthropic шлюз принимает запросы Anthropic-формата на /v1/messages.

Настройка

bash
export ANTHROPIC_BASE_URL="https://api.toygate.store/anthropic"export ANTHROPIC_API_KEY="gw_..."

Обратите внимание: суффикс /v1 здесь не нужен. Claude Code сам добавляет /v1/messages.

Проверка

claude --model claude-opus-4-8 'Hello'

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

Совместимость моделей

Claude Code ожидает ответы Anthropic-формата (message_start, content_block_delta, message_stop). Используйте только слаги моделей, у которых provider_format равен anthropic. Формат провайдера указан на странице каждой модели в каталоге. При несовпадении шлюз вернёт upstream_invalid_response (502): это означает, что upstream прислал стандартный формат chat completion, хотя Claude Code ожидал Anthropic-формат.

Решение проблем

  • Не работают вызовы инструментов — убедитесь, что в каталоге у модели capabilities.tools равен true. Некоторые upstream-провайдеры отключают инструменты для отдельных снимков моделей.
  • HTTP 401 с error.type: "authentication_error" — нужен ключ шлюза с префиксом gw_…, а не ключ Anthropic. В Anthropic-оболочке нет отдельного публичного поля code; соответствующая OpenAI-compatible ошибка аутентификации использует code: null.
  • upstream_invalid_response — обычно Claude Code направлен на модель с provider_format: openai, а не anthropic. Выберите другую модель или вариант Claude.

URL шлюза: https://api.toygate.store