Przejęcie narzędzi do programowania AI jednym kliknięciem

Funkcja przejęcia jednym kliknięciem (Takeover) umożliwia przekierowanie popularnych narzędzi AI CLI do lokalnej bramki AI bez konieczności ręcznej edycji plików konfiguracyjnych. Po przejęciu zapytania tych narzędzi kierowane są przez http://127.0.0.1:11580 i dalej przekazywane do skonfigurowanych dostawców w bramce, z możliwością centralnej kontroli zużycia i kosztów.

Jak to działa

Podczas przejmowania wybranego narzędzia bramka wykonuje kolejno następujące kroki:

1. Weryfikacja stanu bramki, aby upewnić się, że punkt proxy działa prawidłowo.
2. Automatyczne utworzenie dedykowanego wirtualnego klucza (wyświetlanego tylko podczas tworzenia; klucz jest zapisywany w konfiguracji narzędzia).
3. Utworzenie kopii zapasowej oryginalnego pliku konfiguracyjnego z rozszerzeniem .bak (np. ~/.claude/settings.json.bak).
4. Precyzyjne zapisanie/połączenie konfiguracji przekierowującej na bramkę, z zachowaniem innych Twoich ustawień.
5. Odświeżenie statusu w interfejsie, prezentacja bieżącego stanu przejęcia.

Przy usuwaniu przejęcia stosowane jest "precyzyjne usuwanie": tylko wtedy, gdy konfiguracja rzeczywiście wskazuje na tę bramkę, ustawienia są cofane, nie ingerując w pozostałe ręcznie ustawione opcje.

Status przejęcia

Każde narzędzie na stronie AI Gateway → Endpoints posiada jeden z czterech statusów:

Status	Znaczenie
Przejęte (ta bramka)	Narzędzie wskazuje na lokalną bramkę AI
Połączono (inny adres)	Narzędzie skonfigurowane z innym adresem (ręcznie lub inną bramką), bramka nie nadpisuje takich ustawień
Nieprzejęte	Narzędzie wykryto, ale nie zostało przekierowane na bramkę
Nie wykryto	Nie znaleziono katalogu konfiguracyjnego tego narzędzia lokalnie

Wymagania

• Musisz być zalogowany na konto ServBay oraz mieć przynajmniej jeden aktywny kanał na stronie Kanały.
• Narzędzia AI muszą być zainstalowane lokalnie (bramka sprawdza je po katalogu konfiguracyjnym).

Operacja przejęcia jednym kliknięciem

Wejdź w AI Gateway → Endpoints, znajdź wybrane narzędzie na liście i kliknij Przejęcie jednym kliknięciem. Po sukcesie status zmieni się na "Przejęte (ta bramka)". Jeśli chcesz wycofać zmiany, kliknij Usuń / Przywróć.

Szczegóły przejęcia — pliki konfiguracyjne

Tabela poniżej pokazuje, jakie dokładnie pliki i ustawienia są modyfikowane podczas przejmowania każdego narzędzia:

Narzędzie	Plik konfiguracyjny	Zmiana w pliku	Adres bramki
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (bez /v1)
Codex	~/.codex/config.toml	sekcja [model_providers.servbay] + topowe model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	dwie linie: GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (zgodność z OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	sekcja [model_providers.servbay] + definicja modelu	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	połączenie głębokie z węzłem modelu servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	połączenie głębokie z provider.servbay (agregacja modeli z kanałów)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	połączenie głębokie z providers.servbay	http://127.0.0.1:11580/v1

Dlaczego adres Claude Code nie zawiera /v1

Claude Code korzysta z protokołu Anthropic, gdzie bramka sama dokleja ścieżki takie jak /v1/messages, więc ANTHROPIC_BASE_URL powinien wskazywać na główny adres bramki (bez /v1). Większość pozostałych narzędzi korzysta z protokołu zgodnego z OpenAI, wymagającego sufiksu /v1. Przejęcie jednym kliknięciem automatycznie dba o odpowiednie ustawienie — nie musisz tego rozróżniać ręcznie.

Przywracanie i rozwiązywanie problemów

• Przywrócenie oryginalnej konfiguracji — Kliknij Usuń, a bramka precyzyjnie usunie tylko te wpisy, które dotyczą jej konfiguracji. Możesz też ręcznie przywrócić plik z kopii .bak.
• Status „Połączono (inny adres)” — To oznacza, że narzędzie wskazuje aktualnie na inny adres (np. skonfigurowałeś ręcznie lub na inną bramkę). Aby bramka mogła przejąć narzędzie, najpierw sam usuń tę konfigurację.
• Po przejęciu narzędzie nadal wyświetla błąd — Upewnij się, że usługa proxy bramki jest uruchomiona, wybrany kanał jest zdrowy, a wirtualny klucz jest aktywny. Sprawdź także na stronie Statystyki i monitorowanie, czy żądanie dotarło do bramki.

Najczęstsze pytania (FAQ)

• Q: Czy przejęcie jednym kliknięciem zniszczy moją pierwotną konfigurację narzędzi?
  • A: Nie. Bramka zmienia i łączy tylko te ustawienia, które są jej potrzebne, a przed każdą zmianą tworzy kopię .bak. Pozostałe opcje zostają bez zmian.
• Q: Czy po przejęciu mogę ręcznie przywrócić poprzednią konfigurację?
  • A: Tak. Możesz to zrobić klikając „Usuń” w bramce lub ręcznie przywracając plik .bak.
• Q: Gdzie znajdę wirtualny klucz używany do przejęcia?
  • A: Dla każdego narzędzia przejętego przez bramkę automatycznie generowany jest indywidualny wirtualny klucz, który możesz zarządzać na stronie Klucze.
• Q: Dlaczego w liście narzędzi widnieje status „Nie wykryto”?
  • A: Bramka nie znalazła katalogu konfiguracyjnego narzędzia. Zainstaluj narzędzie i uruchom je choć raz, aby utworzyć folder konfiguracyjny, wtedy możliwe będzie przejęcie.

Podsumowanie

Przejęcie narzędzi do programowania AI jednym kliknięciem eliminuje ręczną, podatną na błędy edycję plików konfiguracyjnych. W parę sekund automatycznie tworzysz klucz, tworzysz kopię zapasową, aktualizujesz wpisy i możesz łatwo przywrócić poprzedni stan. Dzięki centralnej konfiguracji kanałów i statystykom zużycia możesz spiąć wszystkie narzędzia AI pod jednego dostawcę i prosty podgląd kosztów. Jeśli chcesz korzystać z bramki bezpośrednio ze swojego kodu, zapoznaj się z endpointami i zmiennymi środowiskowymi.