← Документация для разработчиков
ИнтеграцияClaude Code через aictrlx
Claude Code — агент Anthropic для программирования в терминале — работает с aictrlx через Anthropic Messages API: те же ключи, цены и оплата в рублях, что и у OpenAI-совместимого API.
Его уровни моделей (Opus, Sonnet, Haiku) сопоставляются с режимами маршрутизации aictrlx, поэтому Claude Code может работать и на моделях Claude, и на любой другой модели из каталога.
Настройка
Сохраните ключ в переменной окружения
Все примеры ниже читают ключ из AICTRLX_API_KEY, поэтому он не попадает в код.
export AICTRLX_API_KEY="aictrlx_live_..."Направьте Claude Code на этот экземпляр и сопоставьте его уровни моделей с режимами маршрутизации (подойдёт и любой id модели из списка выше):
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и другие).