← Документация для разработчиков

Интеграция

Claude Code через aictrlx

Claude Code — агент Anthropic для программирования в терминале — работает с aictrlx через Anthropic Messages API: те же ключи, цены и оплата в рублях, что и у OpenAI-совместимого API.

Его уровни моделей (Opus, Sonnet, Haiku) сопоставляются с режимами маршрутизации aictrlx, поэтому Claude Code может работать и на моделях Claude, и на любой другой модели из каталога.

Настройка

Сохраните ключ в переменной окружения

Все примеры ниже читают ключ из AICTRLX_API_KEY, поэтому он не попадает в код.

Shell
export AICTRLX_API_KEY="aictrlx_live_..."

Направьте Claude Code на этот экземпляр и сопоставьте его уровни моделей с режимами маршрутизации (подойдёт и любой id модели из списка выше):

Shell
export ANTHROPIC_BASE_URL="https://aictrlx.ru"
export ANTHROPIC_AUTH_TOKEN="$AICTRLX_API_KEY"
# Claude Code's model tiers -> routing modes of this platform
export ANTHROPIC_DEFAULT_OPUS_MODEL=smart
export ANTHROPIC_DEFAULT_SONNET_MODEL=coding
export ANTHROPIC_DEFAULT_HAIKU_MODEL=fast

Через этот метод API не поддерживаются: изображения и документы на входе, серверные инструменты (веб-поиск, выполнение кода), mcp_servers и вывод расширенного мышления (extended thinking). Неизвестные имена моделей Claude отклоняются, если оператор не сопоставил их с моделями через MESSAGES_API_MODEL_ALIASES.

Какую модель указать

  • smart для уровня Opus: самая сильная модель для планирования и сложных изменений.
  • coding для уровня Sonnet: модели, отобранные по навыкам программирования, размеру контекста и работе с инструментами.
  • fast для уровня Haiku: быстрые ответы на мелких шагах.
  • Или любой id модели со страницы моделей — например, модель Claude для всех уровней.

Модели и цены →

Сколько это стоит

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

Каждый запрос с моделью, токенами и стоимостью виден в журнале запросов в кабинете.

Если что-то не работает

  • 401 с invalid_api_key или missing_api_key: инструмент не передаёт ключ или это не действующий ключ aictrlx_live_.... Создайте новый на странице «API-ключи».
  • 404 с model_not_found: имя модели — не режим маршрутизации (auto, fast, smart, coding) и не id со страницы моделей.
  • 403 с model_not_allowed: ключ ограничен частью моделей; разрешите эту модель в настройках ключа.
  • 429: слишком много запросов в минуту (rate_limit_exceeded) или закончилась квота либо бюджет (monthly_quota_exceeded и другие).

Все ошибки и лимиты →

Другие интеграции