Швидке перехоплення 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)

• Q: Чи може швидке перехоплення зіпсувати мої налаштування інструментів?
  • A: Ні. Шлюз точно записує тільки свої параметри і завжди створює резервну копію (.bak) початкового файлу. Усі інші налаштування залишаються недоторканими.
• Q: Чи можу я вручну повернути старі налаштування після перехоплення?
  • A: Так. Натисніть «Видалити» для автоматичного скасування змін шлюзом чи відновіть вручну з .bak.
• Q: Де зберігається віртуальний ключ для перехоплення?
  • A: Для кожного перехопленого інструменту шлюз створює окремий віртуальний ключ. Всі ключі та їх керування — у розділі Ключі.
• Q: Чому в списку інструмент показується як «Не знайдено»?
  • A: На комп’ютері не виявлено папки конфігурації цього інструменту. Встановіть його і запустіть принаймні раз, щоби створилася необхідна директорія.

Висновок

Швидке перехоплення перетворює рутинне та схильне до помилок редагування конфігурацій файлів інструментів на один клік: автоматичне створення ключа, резервне копіювання, точне внесення змін і можливість миттєвого відновлення. Через об'єднання налаштувань каналів та централізований облік витрат ви отримуєте єдину систему керування для всіх AI-інструментів. Для інтеграції шлюзу у власний код — звертайтеся до розділу Кінцеві точки та змінні середовища.