Подключение Cursor / Claude Code / Cherry Studio к собственному AI-шлюзу

Руководство · 2026-11-20 · 7 мин чтения

Основные AI-инструменты поддерживают кастомные API — то есть вы можете направить их на собственный шлюз (например 4-4 AI) и унифицировать ключи и биллинг. В этой статье — настройка трёх самых популярных инструментов и общий подход к диагностике ошибок.

Предварительное условие: у вас уже есть ключ API. Если нет, сначала завершите регистрацию и создание ключа с помощью «Подключение к единому AI API за 5 минут». В статье используется Base URL 4-4 AI (https://www.4-4.vip/v1) — другие шлюзы, совместимые с OpenAI, работают так же.

Cursor

Диалоговая модель Cursor может работать через кастомный интерфейс, совместимый с OpenAI:

  1. Откройте Settings → Models (или страницу настроек Models);
  2. Разверните область OpenAI API Key: введите ключ шлюза (sk-...);
  3. Отметьте/заполните Override OpenAI Base URL: https://www.4-4.vip/v1;
  4. Добавьте в список моделей имена, доступные в вашем шлюзе (полностью совпадающие с именами каналов шлюза, важен регистр);
  5. После успешной проверки 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"
Два нюанса: ① ANTHROPIC_BASE_URL без суффикса /v1 (путь протокола Anthropic инструмент собирает сам); ② если хотите, чтобы Claude Code использовал модели не семейства Claude, проверьте, что в канале шлюза настроено соответствующее сопоставление моделей, и используйте имена со стороны шлюза.

Cherry Studio

Cherry Studio наиболее прямолинеен для кастомных провайдеров, совместимых с OpenAI:

  1. Настройки → Сервисы моделей: добавить/выбрать провайдера, совместимого с OpenAI;
  2. Адрес API: https://www.4-4.vip/v1 (в некоторых версиях /v1 дополняется автоматически — не дублируйте);
  3. Ключ API: ключ шлюза;
  4. В управлении моделями вручную добавьте доступные имена моделей и выберите их в диалоге после сохранения.

Общее правило: любой инструмент, совместимый с OpenAI

Множество инструментов (LobeChat, Open WebUI, Immersive Translate, разные IDE-плагины) настраиваются по одной схеме — запомните тройку:

ПараметрЗначениеТипичные ловушки
Base URLhttps://www.4-4.vip/v1Одним инструментам нужен /v1, другим нет — при 404 сначала попробуйте с /v1 и без
API KeyКлюч шлюза (sk-...)Пробелы по краям, истёкший ключ, исчерпанный баланс
Имя моделиИмя, как оно задано в канале шлюзаДолжно полностью совпадать со стороной шлюза; имена, которых нет в пресетах инструмента, не сработают

Шпаргалка по ошибкам

401 Unauthorized

404 Not Found

400 Model Not Found / нет доступного канала

Потоковый вывод прерывается / нет ответа

Частые вопросы (FAQ)

Безопасны ли мои данные при прохождении через шлюз?

Ваши запросы идут через шлюз к каналу апстрим-модели. При выборе шлюза проверьте его политики логирования и конфиденциальности; для чувствительных данных отключите на стороне шлюза сохранение логов диалогов или используйте каналы, не сохраняющие данные.

Можно ли настроить несколько шлюзов в одном инструменте?

Большинство инструментов поддерживают несколько провайдеров с мгновенным переключением (например Cherry Studio, Cursor). С разными токенами для разных инструментов статистика использования и лимиты тоже разделяются.

Почему рекомендуется единый шлюз вместо прямого подключения каждого инструмента к своему провайдеру?

Три причины: централизованное управление ключами (меньше поверхность утечки), биллинг и использование видны в одном месте (не нужно сверяться между платформами), модели заменяемы в любой момент (развязка с поставщиком — смена затрагивает только конфигурацию шлюза).

Похожие статьи

Быстрый старт 4-4 AI: подключение к единому AI API за 5 минут Интерфейс, совместимый с OpenAI: один ключ для GLM, DeepSeek, Qwen и других. Рабочие примеры на трёх языках. 7 инженерных практик снижения расходов на токены в AI-приложениях Маршрутизация по уровням моделей, обрезка контекста, кэширование префиксов, бюджетные ограничители — семь долг
Готовы подключиться?

Один ключ для GLM, DeepSeek, Qwen и других ведущих моделей: единый биллинг и наглядная статистика использования.

Модели и тарифы Попробовать бесплатно