Однокликовая передача управления AI-инструментами программирования

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

Как это работает

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

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

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

Статусы передачи управления

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

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

Предварительные условия

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

Выполнение однокликовой передачи управления

Перейдите на страницу AI-шлюз → Управление подключениями → Клиенты, найдите нужный инструмент в списке и нажмите Однокликовая передача управления. После успешной передачи управления статус изменится на «Управление передано (данный шлюз)». Чтобы отменить, нажмите Остановить передачу управления.

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

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

Инструмент	Файл конфигурации	Записываемое содержимое	Адрес шлюза
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
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-инструментам программирования использовать общую конфигурацию провайдеров и единое представление затрат. Если вы хотите обращаться к шлюзу из собственного кода, см. раздел Эндпоинты и переменные окружения.