Мгновенный перехват AI-инструментов для программирования

Мгновенный перехват (Takeover) позволяет вам без ручного редактирования конфигурационных файлов переправить работу популярных AI CLI инструментов на локальный AI-шлюз. После перехвата все запросы с этих инструментов будут единообразно маршрутизироваться через http://127.0.0.1:11580 на выбранных вами поставщиков в настройках шлюза, а использование и расходы будут учитываться централизованно.

Принцип работы

При активации мгновенного перехвата для каждого инструмента шлюз выполняет:

1. Проверку состояния шлюза, чтобы убедиться, что прокси доступен.
2. Автоматически создаёт отдельный виртуальный ключ (его значение возвращается только при создании; ключ записывается в конфиг инструмента).
3. Резервное копирование оригинального конфигурационного файла с добавлением суффикса .bak (например, ~/.claude/settings.json.bak).
4. Точное внесение или глубокое объединение конфигурации для направления на шлюз, с сохранением других ваших настроек без изменений.
5. Обновление статуса в интерфейсе, чтобы отразить текущий перехват.

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

Статус перехвата

Для каждого инструмента на странице AI-шлюз → Эндпоинты (Endpoints) отображается один из четырёх статусов:

Статус	Описание
Перехвачен (локальный шлюз)	Инструмент перенаправлён на локальный AI-шлюз
Подключен (другой адрес)	Инструмент настроен на другой адрес (вы настроили вручную или используете другой шлюз); настройки не будут перезаписаны
Не перехвачен	Инструмент найден, но еще не подключён к шлюзу
Не обнаружен	Конфигурация инструмента не найдена на локальном компьютере

Требования

• Вы авторизовались в аккаунте ServBay и на странице Каналы настроен хотя бы один доступный канал.
• Целевой AI-инструмент установлен на вашем устройстве (наличие определяется по каталогу настроек).

Как работает мгновенный перехват

Зайдите в раздел AI-шлюз → Эндпоинты (Endpoints), найдите нужный инструмент в списке и нажмите Мгновенный перехват. После успешного перехвата статус поменяется на "Перехвачен (локальный шлюз)". Чтобы отменить – нажмите Удалить / Восстановить.

Детали перехвата по каждому инструменту

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

Инструмент	Файл конфигурации	Записываемое содержимое	Адрес шлюза
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (без /v1)
Codex	~/.codex/config.toml	секция [model_providers.servbay] + верхний параметр model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	строки GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (OpenAI-совместимый)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	секция [model_providers.servbay] + определение модели	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	глубокое слияние узла модели servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	глубокое слияние узла provider.servbay (агрегация моделей каналов)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	глубокое слияние узла providers.servbay	http://127.0.0.1:11580/v1

Почему адрес Claude Code без /v1

Claude Code использует протокол Anthropic, и шлюз самостоятельно добавляет путь /v1/messages и т.п. Поэтому ANTHROPIC_BASE_URL должен быть корневым адресом шлюза (без /v1). Большинство остальных инструментов используют OpenAI-совместимый протокол и требуют суффикс /v1. Мгновенный перехват автоматически укажет правильный адрес для каждого инструмента – вручную различать не нужно.

Восстановление и диагностика

• Восстановить оригинальную конфигурацию — Нажмите Удалить, чтобы шлюз снял только свои настройки. Также можно вручную вернуть .bak файл из того же каталога.
• Статус показывает «Подключен (другой адрес)» — Инструмент использует другой адрес (вы настроили сами или через другой шлюз). Чтобы ваши настройки не были перезаписаны, автоматический перехват не выполняется, но вы можете вручную очистить конфиг и повторить попытку.
• Ошибки после перехвата — Убедитесь, что шлюз работает, канал доступен, виртуальный ключ не отозван, а также посмотрите на странице Статистика и мониторинг, доходят ли запросы до шлюза.

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

• Вопрос: Мгновенный перехват может повредить мои оригинальные настройки?
  • Нет. Шлюз вносит только изменения, связанные с собой, а исходный файл предварительно резервируется с расширением .bak. Все остальные параметры сохраняются.
• Вопрос: Если я хочу отменить перехват и вернуть свои настройки?
  • Можно. Нажмите "Удалить" для отмены или восстановите .bak-файл вручную.
• Вопрос: Где находятся виртуальные ключи для перехвата?
  • Шлюз автоматически создаёт отдельный виртуальный ключ для каждого перехваченного инструмента — посмотреть и управлять ими можно на странице Ключи.
• Вопрос: В списке инструментов написано "Не обнаружен"?
  • Значит, не найден конфиг инструмент для этого сервиса на вашем устройстве. Пожалуйста, установите и запустите инструмент хотя бы один раз, чтобы он создал каталог конфигурации, затем повторите перехват.

Итоги

С помощью мгновенного перехвата утомительное и рискованное "ручное редактирование конфигов" превращается в один клик: автоматическое создание ключа, резервное копирование, точное внесение параметров и моментальное восстановление. Благодаря единой статистике использования каналов, все ваши AI-инструменты программирования могут работать через один конфиг и общую систему учёта издержек. Если вы хотите интегрировать шлюз в собственный код — смотрите раздел Эндпоинты и переменные окружения.