Подключение Cursor / Claude Code / Cherry Studio к собственному AI-шлюзу
Основные AI-инструменты поддерживают кастомные API — то есть вы можете направить их на собственный шлюз (например 4-4 AI) и унифицировать ключи и биллинг. В этой статье — настройка трёх самых популярных инструментов и общий подход к диагностике ошибок.
https://www.4-4.vip/v1) — другие шлюзы, совместимые с OpenAI, работают так же.Cursor
Диалоговая модель Cursor может работать через кастомный интерфейс, совместимый с OpenAI:
- Откройте
Settings → Models(или страницу настроекModels); - Разверните область
OpenAI API Key: введите ключ шлюза (sk-...); - Отметьте/заполните
Override OpenAI Base URL:https://www.4-4.vip/v1; - Добавьте в список моделей имена, доступные в вашем шлюзе (полностью совпадающие с именами каналов шлюза, важен регистр);
- После успешной проверки Verify просто переключитесь на кастомную модель внизу диалога.
Примечание: встроенное автодополнение Tab в Cursor и часть Composer идут через собственный сервис Cursor и от этой настройки не зависят; кастомные модели используются в основном в чате.
Claude Code
Claude Code использует протокол Anthropic. Предпосылка подключения через шлюз — поддержка шлюзом эндпоинта протокола Anthropic (/v1/messages) — шлюзы на базе new-api (включая 4-4 AI) выполняют это преобразование; запросы протокола Claude конвертируются и маршрутизируются к реальному каналу модели.
Настройка через переменные окружения (в терминале, откуда запускается claude):
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"
# start
claude
В Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Cherry Studio
Cherry Studio наиболее прямолинеен для кастомных провайдеров, совместимых с OpenAI:
Настройки → Сервисы моделей: добавить/выбрать провайдера, совместимого с OpenAI;- Адрес API:
https://www.4-4.vip/v1(в некоторых версиях /v1 дополняется автоматически — не дублируйте); - Ключ API: ключ шлюза;
- В управлении моделями вручную добавьте доступные имена моделей и выберите их в диалоге после сохранения.
Общее правило: любой инструмент, совместимый с OpenAI
Множество инструментов (LobeChat, Open WebUI, Immersive Translate, разные IDE-плагины) настраиваются по одной схеме — запомните тройку:
| Параметр | Значение | Типичные ловушки |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | Одним инструментам нужен /v1, другим нет — при 404 сначала попробуйте с /v1 и без |
| API Key | Ключ шлюза (sk-...) | Пробелы по краям, истёкший ключ, исчерпанный баланс |
| Имя модели | Имя, как оно задано в канале шлюза | Должно полностью совпадать со стороной шлюза; имена, которых нет в пресетах инструмента, не сработают |
Шпаргалка по ошибкам
401 Unauthorized
- При копировании ключа попали пробелы/переносы → скопируйте заново;
- Ключ отключён или баланс исчерпан → проверьте на странице токенов консоли шлюза;
- Неверный формат заголовка Authorization → должен быть
Bearer sk-....
404 Not Found
- Неверный путь Base URL → попробуйте поочерёдно «с /v1» и «без /v1»;
- Запрашиваемый эндпоинт протокола не поддерживается шлюзом → проверьте, поддерживает ли шлюз этот протокол (OpenAI /v1/chat/completions или Anthropic /v1/messages).
400 Model Not Found / нет доступного канала
- Имя модели не совпадает с каналом шлюза → сверьте имена на странице моделей/каналов консоли;
- Канал отключён или у группы нет прав → проверьте диапазон моделей и настройки группы токена.
Потоковый вывод прерывается / нет ответа
- Корпоративный прокси буферизует SSE → проверьте на прямом соединении;
- Таймаут инструмента слишком короткий → увеличьте; для длинных текстов сначала проверьте, нет ли принудительного таймаута на стороне шлюза.
Частые вопросы (FAQ)
Безопасны ли мои данные при прохождении через шлюз?
Ваши запросы идут через шлюз к каналу апстрим-модели. При выборе шлюза проверьте его политики логирования и конфиденциальности; для чувствительных данных отключите на стороне шлюза сохранение логов диалогов или используйте каналы, не сохраняющие данные.
Можно ли настроить несколько шлюзов в одном инструменте?
Большинство инструментов поддерживают несколько провайдеров с мгновенным переключением (например Cherry Studio, Cursor). С разными токенами для разных инструментов статистика использования и лимиты тоже разделяются.
Почему рекомендуется единый шлюз вместо прямого подключения каждого инструмента к своему провайдеру?
Три причины: централизованное управление ключами (меньше поверхность утечки), биллинг и использование видны в одном месте (не нужно сверяться между платформами), модели заменяемы в любой момент (развязка с поставщиком — смена затрагивает только конфигурацию шлюза).
Похожие статьи
Один ключ для GLM, DeepSeek, Qwen и других ведущих моделей: единый биллинг и наглядная статистика использования.
Модели и тарифы Попробовать бесплатно