Одноклікове перехоплення 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-інструментам програмування спільний набір конфігурацій провайдерів і спільний огляд витрат. Якщо ви хочете викликати шлюз зі свого коду, див. Кінцеві точки та змінні середовища.