Przełączanie dostawcy w Claude Code: poradnik CC Switch w 5 minut

Ten poradnik dotyczy CC Switch v4.0.26 (listopad 2026). Etykiety przycisków mogą się zmienić w kolejnych wersjach; model konfiguracji pozostaje bez zmian.

Przełączanie Claude Code między dostawcami zwykle oznacza edycję pliku ~/.claude/settings.json: adresu URL, klucza API, a czasem także modelu. Przy jednym dostawcy da się tym zarządzać. Przy dwóch lub trzech staje się to drobnym obowiązkiem konserwacyjnym — a problem może pozostać niezauważony, bo nieaktualna zmienna ANTHROPIC_* wyeksportowana w powłoce może nadpisać właśnie edytowany plik.

CC Switch zamienia przełączanie w kartę, którą wystarczy kliknąć. Wbudowany preset AiHubMix uzupełnia punkt końcowy, a Ty wklejasz jeden klucz API. Claude Code zwykle wczytuje zmianę bez ponownego uruchamiania. W tym poradniku przeprowadzimy pełną konfigurację, a następnie wyjaśnimy, co CC Switch zapisuje, na czym polega pułapka zmiennych środowiskowych i kiedy wystarczy tryb bezpośredni.

Jeśli chcesz poznać tylko skróconą wersję: zainstaluj CC Switch, utwórz klucz AIHubMix, wybierz preset AiHubMix w sekcji Claude Code, wklej klucz, dodaj ANTHROPIC_MODEL=claude-sonnet-5-5 do dostawcy, kliknij Przełącz i uruchom claude -p "1+1, output only the answer" --model claude-sonnet-5-5. W dalszej części wpisu omówimy szczegóły tych kroków.

Czym jest CC Switch

CC Switch to otwartoźródłowa aplikacja desktopowa (MIT, Tauri + Rust + React) do zarządzania konfiguracjami dostawców w Claude Code, Codex, Gemini CLI, OpenCode i innych narzędziach programistycznych. Zawiera ponad 90 presetów dostawców i obsługuje dostawców niestandardowych.

To coś więcej niż przełącznik kluczy:

• Tryb bezpośredni zmienia pola klucza w pliku konfiguracyjnym klienta, który następnie łączy się z dostawcą.
• Tryb routingu uruchamia lokalną bramę pod adresem 127.0.0.1:15721, oferując konwersję formatów API, przełączanie awaryjne, kontrole stanu i dzienniki żądań.
• Tryb agregacji umieszcza modele od kilku dostawców na jednej liście /model.

Repozytorium i instrukcja obsługi są dostępne pod adresem github.com/farion1231/cc-switch. Oficjalnymi źródłami pobierania są wyłącznie ccswitch.io i strona GitHub Releases; każda witryna prosząca o płatność lub dane logowania do konta nie jest oficjalna.

Zanim zaczniesz

Potrzebujesz trzech rzeczy:

• Zainstalowanego Claude Code, który można uruchomić z terminala. Sprawdź to poleceniem claude --version. Jeśli go brakuje, skorzystaj z oficjalnego instalatora: curl -fsSL https://claude.ai/install.sh | bash albo npm i -g @anthropic-ai/claude-code z Node.js 22 lub nowszym.
• Konta AIHubMix i klucza API. Utwórz klucz w konsoli AIHubMix. Zwykle zaczyna się od sk-.
• Instalatora CC Switch. Pobierz go z ccswitch.io lub GitHub Releases.

Krok 1: Zainstaluj CC Switch

Przy pierwszym uruchomieniu CC Switch importuje istniejącą konfigurację Claude Code jako dostawcę o nazwie default i dodaje oficjalnego dostawcę. Twoja pierwotna konfiguracja nie zostaje utracona; w każdej chwili możesz do niej wrócić.

Jeśli Claude Code nie jest jeszcze zainstalowany, możesz go zainstalować lub zaktualizować na stronie Aplikacje w CC Switch.

Krok 2: Utwórz klucz API AIHubMix

Otwórz stronę kluczy API AIHubMix, utwórz klucz i skopiuj go.

Symbol zastępczy AIHUBMIX_API_KEY w dokumentacji nie jest prawdziwym kluczem. Jeśli wkleisz go bez zmian, żądanie zakończy się błędem 401 invalid key: AIHUBMIX_API_KEY.

Krok 3: Dodaj AIHubMix do Claude Code

1. Wybierz Claude Code na pasku bocznym po lewej stronie.
2. Kliknij przycisk + w prawym górnym rogu.
3. Wyszukaj AiHubMix lub znajdź go w kategorii platform zewnętrznych.
4. Nazwa i punkt końcowy zostaną uzupełnione automatycznie: https://aihubmix.com. Wklej klucz w polu Klucz API.
5. Kliknij Dodaj.

Preset zapisuje dwie zmienne środowiskowe:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

Preset nie ustawia modelu. W przewodniku AIHubMix zmienna ANTHROPIC_MODEL jest uznawana za podstawową, więc przed przełączeniem dodaj ją do tego samego bloku env:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Bez ustawionego modelu Claude Code wysyła własny domyślny identyfikator modelu, który może nie być obsługiwany przez AIHubMix.

Warto pamiętać o dwóch szczegółach.

Nie dodawaj /v1 do bazowego adresu URL. Claude Code korzysta z protokołu Anthropic Messages i sam tworzy ścieżkę żądania. Prawidłowy adres to https://aihubmix.com; https://aihubmix.com/v1 to bazowy adres zgodny z OpenAI, przeznaczony dla innych klientów, a Claude Code dopisałby do niego własne /v1/messages.

Preset używa ANTHROPIC_API_KEY, natomiast przewodnik AIHubMix dotyczący Claude Code korzysta z ANTHROPIC_AUTH_TOKEN. AIHubMix akceptuje oba warianty: ANTHROPIC_AUTH_TOKEN wysyła nagłówek Bearer, a ANTHROPIC_API_KEY wysyła x-api-key. Wybierz jeden. Nie wpisuj różnych wartości w oba pola. Szczegóły konfiguracji AIHubMix, identyfikatory modeli i opis błędów znajdziesz w dokumentacji AIHubMix dotyczącej Claude Code.

Jeśli nie ma presetu — na przykład w starszej wersji lub po usunięciu karty — wybierz Konfiguracja niestandardowa i wklej powyższy kod JSON. Menedżer punktów końcowych na karcie dostawcy może sprawdzić opóźnienie; preset zawiera też https://api.aihubmix.com jako alternatywny punkt końcowy na wypadek, gdyby aihubmix.com nie dało się rozwiązać.

Krok 4: Przełącz dostawcę i sprawdź konfigurację

Na karcie Bezpośrednio kliknij Przełącz na karcie AiHubMix. Gdy konfiguracja zostanie zapisana, przycisk zmieni się na W użyciu.

Claude Code automatycznie wczytuje konfigurację; ponowne uruchomienie zwykle nie jest potrzebne. Jeśli bieżąca sesja nadal korzysta ze starego dostawcy, zakończ ją i uruchom ponownie.

Sprawdź działanie całego połączenia:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

Odpowiedź 2 oznacza, że żądanie dotarło do AIHubMix. W sesji interaktywnej wiersz Anthropic base URL w sekcji /status powinien pokazywać https://aihubmix.com.

Aby szybko zmienić dostawcę, skorzystaj z zasobnika systemowego: kliknij prawym przyciskiem myszy ikonę CC Switch, otwórz podmenu Claude Code i kliknij dostawcę. Tytuł podmenu pokazuje aktywnego dostawcę i podsumowanie limitu.

Aby wrócić do oficjalnego dostawcy, przełącz się na Claude Official, uruchom ponownie Claude Code i przejdź proces logowania.

Co faktycznie zmienia przełączenie

W trybie bezpośrednim CC Switch zastępuje wyłącznie pola połączenia i zgodności w pliku ~/.claude/settings.json: ANTHROPIC_*, AWS_*, selektory protokołu, takie jak CLAUDE_CODE_USE_BEDROCK, model, apiKeyHelper oraz kilka opcji zgodności przypisanych do dostawcy, takich jak CLAUDE_CODE_DISABLE_ARTIFACT i okno kontekstu.

permissions, hooks, enabledPlugins, statusLine, konfiguracja MCP, komentarze i wszystkie inne dodane przez Ciebie ustawienia pozostają bez zmian. Pełną listę znajdziesz w opisie pliku konfiguracyjnego.

Przed pierwszą zmianą konfiguracji danego narzędzia CC Switch tworzy kopię oryginału w ~/.cc-switch/backups/live-first-write/. Jeśli plik JSON jest nieprawidłowy, odmawia zapisu, podaje numer wiersza i kolumny, a plik pozostawia bez zmian.

Pułapka: nieaktualne zmienne ANTHROPIC_*

To właśnie ten problem sprawia wrażenie, jakby CC Switch nie zadziałał.

Jeśli wcześniej skorzystałeś z poradnika ręcznej konfiguracji i dodałeś export ANTHROPIC_BASE_URL=... lub export ANTHROPIC_AUTH_TOKEN=... do pliku ~/.zshrc albo ~/.bash_profile, te zmienne mogą nadpisać wartości zapisane przez CC Switch. Przełączasz kartę na AIHubMix, ale żądania nadal trafiają do starego punktu końcowego.

CC Switch wykrywa konflikt. Żółty baner u góry okna informuje, że zmienne środowiskowe mogą nadpisywać konfigurację; szczegóły pokazują nazwę zmiennej, jej wartość i źródło. Opcja Usuń zaznaczone usuwa te zmienne, uprzednio zapisując kopię zapasową w pliku ~/.cc-switch/backups/env-backup-<timestamp>.json.

Aby sprawdzić to ręcznie:

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Zakomentuj stare polecenia export, a następnie uruchom source ~/.zshrc lub otwórz nowy terminal. Dokumentacja AIHubMix zaleca usunięcie globalnych zmiennych ANTHROPIC_*, gdy konfiguracją zarządza CC Switch. Pełny opis obsługi konfliktów znajdziesz w opisie zmiennych środowiskowych.

Aliasy modeli i przełączanie

Gdy ustawisz ANTHROPIC_MODEL, domyślnym modelem Claude Code będzie Sonnet 5.5. Jeśli chcesz, aby aliasy /model (opus, sonnet, haiku, fable) wskazywały identyfikatory modeli AIHubMix, musisz je jeszcze skonfigurować. Dodaj te klucze w sekcji env:

Pełna konfiguracja dostawcy wygląda wtedy tak:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

Priorytet wyboru modelu — od najwyższego: /model <name> → claude --model <name> → ANTHROPIC_MODEL → pole model w settings.json. Skopiuj identyfikatory modeli z listy modeli AIHubMix; rozróżniają wielkość liter.

Kiedy używać routingu lub agregacji

W przypadku AIHubMix domyślnie najlepiej wybrać tryb bezpośredni. Punkt końcowy obsługuje już protokół Anthropic Messages, więc konwersja protokołu nie jest potrzebna.

Użyj trybu routingu, gdy potrzebujesz kolejki przełączeń awaryjnych lub chcesz udostępnić Claude Code dostawcę korzystającego z formatu OpenAI. Routing kieruje Claude Code na adres http://127.0.0.1:15721, zastępuje klucz w konfiguracji wartością PROXY_MANAGED i wstrzykuje prawdziwy klucz z CC Switch. Aplikacja musi działać w tle; po zamknięciu CC Switch przywraca konfigurację bezpośrednią. Oficjalne subskrypcje Claude nie przechodzą przez routing — w ich przypadku użyj trybu bezpośredniego.

Użyj agregacji, jeśli chcesz mieć modele od kilku dostawców na jednej liście /model. Domyślny dostawca obsługuje żądania bez prefiksu; modele pozostałych dostawców mają prefiks ccs-. Agregacja nie zapewnia przełączania awaryjnego. Jest dostępna tylko w Claude Code i Codex, a oficjalne subskrypcje Claude nie są obsługiwane w trybie agregacji. Lista modeli ccs- wymaga Claude Code w wersji 2.1.243 lub nowszej. Claude Code od razu wykrywa zmiany na liście modeli; Codex wymaga pełnego ponownego uruchomienia.

Co jeszcze obsługuje CC Switch

• Użycie: panel łączy dzienniki przekierowanych żądań z lokalnymi dziennikami sesji. Skanowanie sesji działa bez przekierowywania, a ceny są ustalane na podstawie modelu zapisanego w dzienniku; przekierowane żądania są rejestrowane osobno.
• MCP: ujednolicony panel serwerów MCP, synchronizowany z wybranymi aplikacjami.
• Umiejętności: wyszukuj, instaluj i usuwaj umiejętności z jednego miejsca.
• Sesje: wyszukuj, przeglądaj, eksportuj i wznawiaj sesje lokalne.
• Projekty: zapisuj dostawcę projektu, serwery MCP, umiejętności i pliki pamięci w postaci migawki, a następnie przełączaj cały zestaw dla poszczególnych projektów.

Dane są przechowywane w ~/.cc-switch/, a ich podstawą jest baza danych SQLite. Automatyczne kopie zapasowe domyślnie zachowują 10 najnowszych, dostępna jest też synchronizacja przez WebDAV lub zgodna z S3. Baza danych i wyeksportowane kopie zapasowe zawierają konfiguracje dostawców, w tym klucze, dlatego należy traktować je jako dane poufne.

Rozwiązywanie problemów

Poniższe komunikaty o błędach pochodzą z dokumentacji Claude Code serwisu AIHubMix.

W przypadku objawów innych niż błędy:

• Ekran logowania lub Not logged in: sprawdź /status; włącz opcję Skip Claude Code first-run confirmation w Ustawienia → Konfiguracja aplikacji → Claude Code; uruchom ponownie; upewnij się, że wpisano klucz.
• Przełączenie nie działa: przyczyną może być nieaktualna zmienna powłoki lub buforowana sesja; otwórz nowy terminal albo uruchom ponownie Claude Code.
• Test połączenia na karcie kończy się powodzeniem, ale żądania nie działają: test sprawdza dostępność, a nie klucz ani model; uruchom polecenie claude -p, aby przetestować cały proces.
• Chcesz wrócić do oficjalnego dostawcy: przełącz się na Claude Official, uruchom ponownie Claude Code i zaloguj się ponownie.

Jeśli polecenie claude nie jest dostępne w systemie macOS, oficjalny instalator zwykle umieszcza je w ~/.local/bin/claude. Dodaj export PATH="$HOME/.local/bin:$PATH" do profilu powłoki i otwórz nowy terminal.

Lista kontrolna

• [ ] Zainstaluj CC Switch ze strony ccswitch.io lub sekcji GitHub Releases.
• [ ] Utwórz klucz API w konsoli AIHubMix.
• [ ] W Claude Code → + → AiHubMix → wklej klucz → Add.
• [ ] Dodaj ANTHROPIC_MODEL=claude-sonnet-5-5 do JSON dostawcy.
• [ ] Kliknij Switch i upewnij się, że na karcie widnieje In use.
• [ ] Usuń nieaktualne wpisy ANTHROPIC_* z profilu powłoki.
• [ ] Uruchom claude -p "1+1, output only the answer" --model claude-sonnet-5-5 i sprawdź, czy pojawi się 2.

Jeśli ostatnie polecenie zwróci 2, przełączenie dostawcy jest zakończone. Pozostaje dodać ewentualne aliasy modeli i zdecydować, czy potrzebujesz przekierowywania lub agregacji; większości użytkowników AIHubMix wystarczy tryb bezpośredni.

FAQ

Czy CC Switch jest darmowy?
Tak. Jest dostępny na licencji open source MIT. Płacisz tylko dostawcy, którego API używasz.

Czy przełączenie usunie moje hooki, serwery MCP lub wtyczki?
Nie. Przełączenie w trybie bezpośrednim zastępuje punkt końcowy, klucz, model i kilka opcji związanych z dostawcą. Hooki, uprawnienia, serwery MCP, wtyczki i ustawienia paska stanu pozostają w pliku.

Czy CC Switch przesyła mój klucz API?
Konfiguracje dostawców są przechowywane lokalnie w ~/.cc-switch/cc-switch.db. Jeśli włączysz synchronizację WebDAV lub S3, dane będą synchronizowane z kontrolowanym przez Ciebie miejscem przechowywania. Bazy danych i kopie zapasowe zawierają klucze, dlatego należy traktować je jako dane poufne.

Czy CC Switch musi być cały czas uruchomiony?
Nie w trybie bezpośrednim. Przekierowywanie i agregacja wymagają uruchomionej aplikacji; zamknięcie CC Switch przywraca tryb bezpośredni w kliencie.

Czy mogę jednocześnie korzystać z Claude Official i AIHubMix?
W trybie bezpośrednim aktywny może być tylko jeden dostawca naraz. Agregacja pozwala umieścić modele kilku dostawców na jednej liście, ale nie obsługuje oficjalnej subskrypcji Claude; aby z niej korzystać, przełącz się z powrotem na tryb bezpośredni.

Czy działa w systemie Windows?
Tak. CC Switch obsługuje system Windows 10 i nowsze wersje, oferując instalator .msi lub wersję przenośną. Linux wymaga glibc 2.35+ i WebKitGTK 4.1.

Dlaczego karta dostawcy pokazuje prawidłowe połączenie, ale Claude Code nadal nie działa?
Test połączenia na karcie sprawdza, czy punkt końcowy jest osiągalny. Nie weryfikuje klucza API ani modelu. Użyj polecenia claude -p, aby przetestować cały proces.

Źródła

• Repozytorium CC Switch
• Instrukcja obsługi CC Switch: dodawanie dostawcy
• Instrukcja obsługi CC Switch: przełączanie dostawcy
• Instrukcja obsługi CC Switch: pliki konfiguracyjne
• Dokumentacja AIHubMix: Claude Code