Как использовать Claude Sonnet 5 в Cursor IDE через Claudexia (гайд 2026)

В 2026 году Cursor остаётся самым продуктивным AI-редактором на рынке, а Claude Sonnet 5, самой сильной универсальной моделью для кода. Проблема в том, что подписка Cursor включает фиксированную квоту вызовов фронтир-моделей, а всё сверху тарифицируется отдельно, и счёт растёт быстро, если вы реально пользуетесь агентом. Самое чистое решение: направить Cursor на pay-per-token Claude-шлюз вроде Claudexia, оставить привычные Cmd+K, Cmd+L и Composer как есть, и платить только за реально использованные токены.

Этот гайд проводит вас через всю настройку: что нужно заранее, как получить API-ключ, как прописать кастомный OpenAI-совместимый base URL, какие алиасы моделей мы рекомендуем для повседневной работы, как включить Claude для tab-автодополнения и Composer, и какие ошибки вы почти наверняка поймаете с первой попытки.

Почему Cursor и Claude: правильная связка в 2026

Две причины, обе скучные и обе верные.

Во-первых, Claude Sonnet 5 и Claude Opus 5 стабильно лидируют в публичных бенчмарках по коду и, что важнее, во внутренних оценках команд, которые много отгружают. Claude особенно хорош в правках через несколько файлов, не врёт о том, что только что сделал, и аккуратно следует конвенциям проекта, если ему дать CLAUDE.md или AGENTS.md.

Во-вторых, UI Cursor построен вокруг трёх примитивов: inline-правка (Cmd+K), чат (Cmd+L) и Composer (мульти-файловый агент). Все три прямо выигрывают от более сильной базовой модели. Замена модели под этими примитивами и есть тот сценарий, для которого существует поддержка кастомных моделей.

Что нужно заранее

Перед началом убедитесь в двух вещах:

1. Нужен Cursor Pro. Бесплатный тариф и 7-дневный триал Pro не позволяют использовать кастомные OpenAI-совместимые модели. Чтобы увидеть поля "OpenAI API Key" и "Override OpenAI Base URL", нужна действующая платная подписка Cursor Pro. Это ограничение Cursor, а не Claudexia.
2. Аккаунт Claudexia с балансом. Claudexia работает по факту, так что небольшого пополнения (5–10 USD эквивалент через СБП, крипту или карту) хватит, чтобы протестировать весь сценарий.

Это вся поверхность настройки. Никаких расширений, прокси и локальных серверов.

Шаг 1. Получите API-ключ Claudexia

Войдите в дашборд Claudexia, откройте раздел API Keys и создайте ключ с меткой "Cursor" (или любой удобной для последующей ротации). Скопируйте ключ один раз: через минуту вы вставите его в Cursor. Если заподозрите, что ключ утёк, отзовите его на том же экране и выпустите новый: в Claudexia ключи изначально разделены по приложениям именно для этого.

Шаг 2. Направьте Cursor на Claudexia (OpenAI-совместимый режим)

Откройте Cursor и зайдите в Settings → Models. Прокрутите до блока OpenAI API Key. Да, вы будете использовать именно его, хотя зовёте Claude: поле "OpenAI" в Cursor на самом деле слот под любой OpenAI-совместимый endpoint, а Claudexia как раз отдаёт полностью OpenAI-совместимый API, чтобы интеграция работала без вашего кода.

Заполните ровно два поля:

• OpenAI API Key: ключ из Шага 1.
• Override OpenAI Base URL: https://api.claudexia.tech/v1

Включите тумблер override. Не включайте параллельно нативный Anthropic API в этом же профиле Cursor. Выберите один транспорт. Мы рекомендуем строго OpenAI-совместимый режим, потому что UI регистрации кастомных моделей в Cursor завязан на схему OpenAI, а Claudexia на стороне сервера переводит OpenAI-запросы в вызовы Claude.

Шаг 3. Добавьте алиасы моделей

Это шаг, на котором ошибается большинство. Cursor не определит автоматически, какие модели Claude доступны за вашим шлюзом: нужно явно перечислить идентификаторы, которые он будет отправлять. В той же панели Models нажмите + Add model и добавьте следующие алиасы. Каждый алиас указывает на реальный, маршрутизируемый идентификатор на стороне Claudexia, поэтому что вы напишете, то и спишется.

У нас нет тира Haiku. Самая дешёвая модель это gpt-5.6-luna, но учтите: это другое семейство. Формат запросов совместимый, а поведение и промпты могут отличаться, так что проверьте на своей задаче.

После добавления алиасов выключите стоковые модели Cursor, которые вы не планируете использовать через дефолтную квоту редактора. Точный список таких моделей меняется с каждым релизом Cursor, поэтому сверяйтесь с Settings → Models, а не с этим текстом. Это гарантирует, что ваши хоткеи всегда пойдут через Claudexia, а не молча свалятся в платный пул Cursor.

Шаг 4. Проверьте чатом

Откройте чат через Cmd+L, выберите cursor-sonnet5 в селекторе модели и спросите что-то тривиальное, например "ответь словом ok". Ответ должен прийти меньше чем за секунду. Если пришёл, проводка верна: можно идти дальше.

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

Шаг 5. Включите Claude для автодополнения и Composer

Два финальных тумблера:

1. Модель tab-автодополнения. В Settings → Features → Cursor Tab установите модель completion в cursor-luna. gpt-5.6-luna достаточно быстрая, чтобы вы не чувствовали сетевой хоп, а стоимость одного принятого автодополнения пренебрежимо мала.
2. Модель Composer / агента. В Settings → Features → Composer поставьте дефолтом cursor-sonnet5 для повседневных запусков агента и cursor-opus5 для сессий с тяжёлым планированием. Composer уважает выбор модели на уровне треда, так что вы можете переопределить её под конкретный рефакторинг, не трогая глобальную настройку.

Это вся настройка. Inline-правка (Cmd+K), чат (Cmd+L), Composer и tab-автодополнение теперь работают на Claude через Claudexia, с оплатой по токенам по ставкам Anthropic.

Траблшутинг

Две ошибки, которые вы почти наверняка увидите хотя бы раз:

• HTTP 401 / "invalid API key". Ключ Claudexia неверный, отозван или содержит лишний пробел в конце. Перекопируйте из дашборда и вставьте снова. Cursor не обрезает хвостовые пробелы.
• HTTP 404 / "model not found". Алиас, который вы вписали в Cursor, не совпадает с моделью, зарегистрированной на стороне Claudexia. Перепроверьте написание: cursor-sonnet5, не Cursor-Sonnet5 и не cursorsonnet5. Алиасы регистрозависимы.
• Большая задержка на первом запросе. Холодный кэш. Сделайте один прогревочный запрос: следующий улетит быстро. Это не баг.
• Tab-автодополнение тормозит. Скорее всего, вы выставили модель Composer (Sonnet 5 / Opus 5) как модель автодополнения. Поставьте cursor-luna (gpt-5.6-luna): снова станет мгновенно.

Сколько это реально стоит

Для одного разработчика, который пользуется Cursor плотно (чат, Composer и автодополнение целый день), ожидайте примерно 5–20 USD в месяц на Claudexia по ставкам 2026 года, при условии что gpt-5.6-luna работает на автодополнении, Sonnet на дефолтном чате, а Opus только когда он реально нужен. Тяжёлые пользователи агента с длинными ежедневными сессиями Composer ближе к верхней границе диапазона; те, кто в основном правит inline, к нижней.

Это ощутимо дешевле, чем докупать квоту фронтир-моделей внутри Cursor Pro, плюс вы получаете точную постатейную видимость, на что ушли деньги.

Куда идти дальше

За полным референсом (включая переменные окружения для headless-сетапов, управление ключами на уровне команды и актуальный список маршрутизируемых идентификаторов) загляните в каноничный документ: /docs/guides/cursor. Он синхронизируется с каждым релизом моделей Claude, так что в закладки лучше класть его, а не этот пост.