DeepSeek V4 Flash i Pro w Claude Code: konfiguracja i przełączanie modeli

Skonfiguruj DeepSeek w Claude Code za pomocą APIMaster. Ustaw settings.json na Windows, macOS i Linux, uruchom claude, wybierz model poleceniem /model i zacznij czat.

Skonfiguruj APIMaster w settings.json, uruchom claude, a następnie wpisz /model MODEL_ID w rozmowie, aby korzystać z DeepSeek. Omawiane dostępne identyfikatory to deepseek-v4-flash, deepseek-v4-pro. Klientem jest Claude Code; DeepSeek to model, który odpowiada.

Zanim zaczniesz

Wykonaj sprawdzenie środowiska i konfigurację Claude Code. Uzyskaj klucz API APIMaster z wystarczającym saldem i dostępem do wybranych modeli.

claude --version

Bazowy adres URL bramy to https://apimaster.ai, bez /v1. Claude Code sam dodaje /v1/messages.

1. Otwórz katalog konfiguracyjny

Windows

Naciśnij Win + R, wpisz poniższą ścieżkę i naciśnij Enter:

%USERPROFILE%\.claude

W razie potrzeby utwórz folder. Otwórz lub utwórz settings.json. Upewnij się, że plik nie nazywa się settings.json.txt.

macOS / Linux

Na macOS w Finderze naciśnij Command + Shift + G i wpisz:

~/.claude

Na Linuksie otwórz ten sam katalog w menedżerze plików lub edytorze. W razie potrzeby utwórz go:

mkdir -p ~/.claude

Otwórz lub utwórz tam settings.json. Jeśli ustawiłeś niestandardowy katalog konfiguracji Claude Code, użyj tego katalogu.

2. Edytuj settings.json

Windows, macOS i Linux używają tej samej konfiguracji. Zastąp YOUR_APIMASTER_API_KEY swoim kluczem APIMaster:

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Jeśli plik już istnieje, zrób jego kopię zapasową i scal te pola z istniejącym obiektem JSON oraz obiektem env. Zachowaj inne potrzebne ustawienia. Nie dopisuj drugiego obiektu JSON ani nie duplikuj klucza env. JSON nie dopuszcza komentarzy ani przecinków na końcu.

Ogólny przewodnik po Claude Code pokazuje uwierzytelnianie tokenem. Ten przewodnik używa uwierzytelniania kluczem API, przetestowanego w naszych testach integracyjnych. Gdy używasz ANTHROPIC_API_KEY, pozostaw ANTHROPIC_AUTH_TOKEN pusty i usuń konfliktowe dane uwierzytelniające z innych ustawień lub terminala. Do tej bramy używaj klucza APIMaster.

Pole model ustawia model startowy. Po uruchomieniu możesz wybrać inny. Zachowaj ten plik ustawień użytkownika w prywatności; nie zatwierdzaj prawdziwych kluczy do współdzielonego repozytorium. Zapisz plik i uruchom ponownie Claude Code, aby wczytać nową konfigurację.

3. Uruchom Claude Code

W terminalu otwartym w katalogu projektu uruchom:

claude

Wykonaj standardowe monity pierwszego uruchomienia i zapoznaj się z monitem o zaufanie do projektu. Model startowy powinien to być deepseek-v4-flash. To normalna sesja interaktywna ze zwykłymi narzędziami i ustawieniami projektu.

4. Wybierz model i zacznij czat

W rozmowie Claude Code wpisz jedno z poniższych poleceń i naciśnij Enter:

/model deepseek-v4-flash
/model deepseek-v4-pro

Uruchamiaj jeden wiersz na raz, wybierając żądany model. Po potwierdzeniu przełączenia przez Claude Code wyślij krótką wiadomość:

Reply with exactly OK.

Zwykła odpowiedź tekstowa potwierdza podstawowe połączenie. Możesz wtedy kontynuować czat lub poprosić o pracę nad projektem. Aby przełączyć się ponownie w tej samej rozmowie, wpisz kolejne polecenie /model MODEL_ID.

Samo wpisanie /model otwiera wybór modelu. Niestandardowe identyfikatory bramy mogą nie pojawić się na jego domyślnej liście. W takim przypadku wpisz pełny identyfikator, jak pokazano powyżej. Polecenie ukośne należy do wnętrza Claude Code, a nie PowerShell czy Basha. Nazwy modeli opisują modele DeepSeek, a nie Claude Sonnet czy Opus.

Możesz też wybrać model podczas uruchamiania z terminala. Uruchamiaj jedno polecenie na raz:

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

Aby jawnie ustawić domyślny model na przyszłe sesje, edytuj model w settings.json. Flaga uruchamiania, zmienna środowiskowa ANTHROPIC_MODEL lub ustawienie projektu/zarządzane mogą wpływać na wybrany model; sprawdź je, jeśli model startowy różni się od zapisanej wartości.

Rozwiązywanie problemów

Objaw	Co sprawdzić
401 / nieoczekiwany monit logowania	Sprawdź klucz APIMaster, bazowy adres URL i konfliktowe zmienne uwierzytelniania; po edycji ustawień uruchom CLI ponownie.
404	Używaj `https://apimaster.ai`, bez `/v1` ani `/v1/messages`.
Ustawienia nie działają	Sprawdź lokalizację pliku, poprawność JSON i nadpisania z terminala, projektu lub ustawień zarządzanych.
Brak modelu w selektorze	Wpisz `/model MODEL_ID` z dokładnym identyfikatorem albo uruchom z `claude --model MODEL_ID`.
Model niedostępny / 403	Sprawdź pisownię, modele dozwolone dla klucza, saldo konta i bieżącą dostępność trasy.
`unrecognized_model`	Zaobserwowano z niestandardowymi identyfikatorami w naszych testach. Sprawdź rzeczywistą odpowiedź i wynik narzędzia; wbudowane domyślne możliwości Claude nie są zweryfikowane dla DeepSeek.
Odmowa uprawnień do pliku lub polecenia	Przejrzyj i zatwierdź zamierzoną operację przez zwykłe monity o uprawnienia.
429 / 5xx / przerwana odpowiedź	Zachowaj błąd, identyfikator modelu, wersję CLI, czas UTC i identyfikator żądania, jeśli dostępny, dla wsparcia technicznego.

Walidacja i opcjonalna diagnostyka

Zarejestrowane testy integracyjne: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Wszystkie wymienione tutaj modele zwróciły oczekiwany tekst i odczytały lokalny plik za pomocą narzędzia. Złożone zadania programistyczne były poza zakresem tamtych testów. Windows i macOS nie były częścią tych zarejestrowanych uruchomień.

Wcześniejsze automatyczne testy używały trybu bare, aby wyizolować konfigurację. Normalne codzienne użytkowanie przebiega zgodnie z settings.json i krokami interaktywnymi powyżej. Tryb bare oraz --setting-sources "" pomijają normalne integracje lub zapisane ustawienia, więc nie należy ich dodawać do codziennego polecenia startowego z tego przewodnika.

Aby wykonać szybkie sprawdzenie nieinteraktywne z użyciem zapisanej konfiguracji:

claude --model deepseek-v4-flash -p "Reply with exactly OK."

Aby przetestować narzędzie, utwórz plik probe.txt zawierający FILE_PROBE_739182, uruchom Claude Code w tym katalogu i poproś go o odczytanie pliku za pomocą narzędzia i zwrócenie jego dokładnej zawartości. Potwierdź, że narzędzie faktycznie się uruchomiło.

To ograniczone testy integracyjne, a nie gwarancja każdej funkcji Claude Code, zachowania długich sesji czy maksymalnego kontekstu. Oficjalna dokumentacja bramy Anthropic nie wspiera oficjalnie kierowania Claude Code do modeli innych niż Claude; ten przewodnik opisuje integrację APIMaster.

FAQ

Czy moja subskrypcja Claude opłaca te żądania?

Nie. Z tą konfiguracją APIMaster żądania korzystają z Twojego klucza i salda APIMaster.

Czy mogę kontynuować czat po przełączeniu modelu?

Tak, użyj polecenia przełączenia modelu w otwartej rozmowie i poczekaj na potwierdzenie przed wysłaniem kolejnej wiadomości. Aby uzyskać czyste porównanie między modelami, uruchom osobną sesję z claude --model MODEL_ID.