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

Przejęcie jednym kliknięciem (Takeover) pozwala skierować popularne narzędzia CLI AI do programowania na lokalną bramę AI bez ręcznej edycji jakichkolwiek plików konfiguracyjnych. Po przejęciu żądania z tych narzędzi są kierowane przez http://127.0.0.1:11580 do skonfigurowanych w bramie kanałów dostawców i objęte jednolitymi statystykami użycia oraz kosztów.

Jak to działa

Gdy wykonujesz przejęcie jednym kliknięciem dla danego narzędzia, brama kolejno:

1. Sprawdza stan zdrowia bramy, aby potwierdzić dostępność punktu końcowego proxy.
2. Automatycznie tworzy dedykowany klucz wirtualny (brama zapisuje go w konfiguracji narzędzia; jawny tekst można w każdej chwili odzyskać na stronie kluczy).
3. Tworzy kopię zapasową oryginalnego pliku konfiguracyjnego z rozszerzeniem .bak (np. ~/.claude/settings.json.bak).
4. Precyzyjnie zapisuje / głęboko scala konfigurację wskazującą na bramę, nie zmieniając Twoich pozostałych ustawień.
5. Odświeża stan interfejsu, pokazując bieżący status przejęcia.

Zatrzymanie przejęcia również polega na „precyzyjnym usunięciu”: odpowiednie klucze są usuwane tylko wtedy, gdy konfiguracja rzeczywiście wskazuje na tę bramę, co zapobiega przypadkowemu usunięciu innych ustawień skonfigurowanych ręcznie; jednocześnie unieważniany jest klucz wirtualny utworzony automatycznie podczas przejęcia.

Stan przejęcia

Każde narzędzie na stronie Brama AI → Zarządzanie integracjami → Klienci wyświetla jeden z czterech stanów:

Stan	Znaczenie
Przejęte (ta brama)	Narzędzie wskazuje na lokalną bramę AI
Połączone (inny adres)	Narzędzie ma skonfigurowany inny adres (skonfigurowany ręcznie lub wskazujący na inną bramę); brama nie nadpisze go samowolnie
Nieprzejęte	Wykryto narzędzie, ale nie wskazuje jeszcze na bramę
Nie wykryto	Nie znaleziono na tym komputerze katalogu konfiguracyjnego tego narzędzia

Wymagania wstępne

• Zalogowano się do konta ServBay i skonfigurowano co najmniej jeden dostępny kanał na stronie Kanały.
• Docelowe narzędzie AI jest zainstalowane na tym komputerze (brama określa jego obecność na podstawie katalogu konfiguracyjnego).

Przejęcie jednym kliknięciem

Przejdź do strony Brama AI → Zarządzanie integracjami → Klienci, znajdź docelowe narzędzie na liście narzędzi i kliknij Przejmij jednym kliknięciem. Po pomyślnym przejęciu stan zmieni się na „Przejęte (ta brama)”. Aby wycofać zmiany, kliknij Zatrzymaj przejęcie.

Szczegóły przejęcia dla poszczególnych narzędzi

Poniższa tabela przedstawia pliki konfiguracyjne i zawartość faktycznie modyfikowaną podczas przejmowania każdego narzędzia, co ułatwia zrozumienie i diagnozowanie:

Narzędzie	Plik konfiguracyjny	Zapisywana zawartość	Adres bramy
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] + najwyższego poziomu model_provider = "servbay"	http://127.0.0.1:11580/v1
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (kompatybilny z OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	sekcja [model_providers.servbay] + definicje modeli	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	głębokie scalenie węzła modelu servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	głębokie scalenie węzła provider.servbay (agregującego modele z poszczególnych kanałów)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	głębokie scalenie węzła providers.servbay	http://127.0.0.1:11580/v1

Dlaczego adres Claude Code nie zawiera /v1

Claude Code używa protokołu Anthropic, a brama samodzielnie składa ścieżki takie jak /v1/messages, dlatego ANTHROPIC_BASE_URL musi być adresem głównym bramy (bez /v1). Większość pozostałych narzędzi korzysta z protokołu zgodnego z OpenAI i wymaga sufiksu /v1. Przejęcie jednym kliknięciem automatycznie wypełnia konfigurację zgodnie z konwencjami poszczególnych narzędzi, więc nie musisz tego rozróżniać ręcznie.

Przywracanie i diagnozowanie

• Przywrócenie oryginalnej konfiguracji — kliknij Usuń, a brama precyzyjnie wycofa konfigurację wskazującą na tę bramę. Możesz też ręcznie przywrócić plik z kopii zapasowej .bak znajdującej się w tym samym katalogu.
• Stan „Połączone (inny adres)” — oznacza, że narzędzie wskazuje obecnie inny adres (skonfigurowany ręcznie lub wskazujący na inną bramę). Aby uniknąć nadpisania Twoich ustawień, brama nie przejmie go automatycznie; najpierw ręcznie wyczyść tę konfigurację, a następnie wykonaj przejęcie.
• Narzędzie nadal zgłasza błędy po przejęciu — upewnij się, że usługa proxy bramy działa, odpowiedni kanał jest sprawny, a klucz wirtualny nie został unieważniony; na stronie Statystyki i monitorowanie możesz sprawdzić, czy żądania docierają do bramy.

Często zadawane pytania (FAQ)

• P: Czy przejęcie jednym kliknięciem zepsuje moją dotychczasową konfigurację narzędzia?
  • O: Nie. Brama tylko precyzyjnie zapisuje / scala klucze związane z bramą i przed zapisem tworzy kopię zapasową oryginalnego pliku jako .bak. Pozostałe ustawienia pozostają bez zmian.
• P: Czy po przejęciu mogę ręcznie przywrócić poprzednie ustawienia?
  • O: Tak. Kliknij „Usuń”, aby brama wycofała zmiany, albo ręcznie przywróć plik z kopii .bak.
• P: Gdzie znajduje się klucz wirtualny użyty do przejęcia?
  • O: Brama automatycznie tworzy dedykowany klucz wirtualny dla każdego przejętego narzędzia; można go wyświetlić i zarządzać nim na stronie Klucze.
• P: Narzędzie na liście pokazuje „Nie wykryto”?
  • O: Oznacza to, że na tym komputerze nie znaleziono katalogu konfiguracyjnego tego narzędzia. Najpierw zainstaluj i uruchom narzędzie przynajmniej raz, aby utworzyło katalog konfiguracyjny, a następnie wykonaj przejęcie.

Podsumowanie

Przejęcie jednym kliknięciem zamienia żmudne i podatne na błędy „ręczne edytowanie plików konfiguracyjnych poszczególnych narzędzi” w jedno kliknięcie: automatyczne tworzenie klucza, automatyczna kopia zapasowa, precyzyjny zapis i możliwość przywrócenia w dowolnym momencie. W połączeniu z jednolitymi kanałami i statystykami użycia pozwala wszystkim Twoim narzędziom AI do programowania korzystać z tego samego zestawu konfiguracji dostawców i widoku kosztów. Jeśli chcesz wywoływać bramę z własnego kodu, zapoznaj się z Punkty końcowe i zmienne środowiskowe.