Użycie DeepSeek w Claude Code: Przewodnik konfiguracji V4 Flash / Pro
Uruchom DeepSeek V4 Flash i Pro w Claude Code przez APIMaster. Ustaw bramę i klucz API, przełączaj modele, weryfikuj narzędzia do odczytu plików i naprawiaj błędy konfiguracji.
Czy Claude Code może używać DeepSeek? Nasze testy z Claude Code 2.1.239 pomyślnie użyły deepseek-v4-flash i deepseek-v4-pro przez punkt końcowy Messages APIMaster. Ustaw ANTHROPIC_BASE_URL na https://apimaster.ai, podaj klucz APIMaster i wybierz model jawnie. Ta konfiguracja uruchamia DeepSeek, nawet jeśli klient nazywa się Claude Code.
Ostatnio testowano: 2026-09-07, Claude Code 2.1.239, Linux. Oba modele zwróciły oczekiwany tekst i ukończyły rundę narzędzia do odczytu plików. Wszystkie uruchomienia zakończyły się kodem 0. CLI wydrukowało
unrecognized_model, ale testowane żądania zakończyły się sukcesem. Te kontrole nie potwierdzają wsparcia dla każdej funkcji Claude Code, długich sesji lub przyszłych wydań. Polecenia konfiguracji dla Windows / macOS są zawarte; zarejestrowany test przeprowadzono na Linuksie.
1. Przygotuj CLI i klucz API
Postępuj zgodnie z przewodnikiem środowiska i przewodnikiem konfiguracji Claude Code w celu instalacji. Sprawdź swoją wersję:
claude --version
Uzyskaj klucz API APIMaster z dostępem do wybranego modelu DeepSeek i wystarczającym limitem. Użyj ustawień sesji poniżej w tym samouczku; nie ma potrzeby nadpisywania normalnego settings.json.
2. Ustaw bramę i klucz
Otwórz nowy terminal, aby oddzielić te ustawienia od zwykłej sesji CLI.
macOS / Linux:
export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Użyj tutaj pochodzenia witryny, bez /v1: Claude Code dodaje /v1/messages. Klucz API musi pochodzić z APIMaster. Te polecenia dotyczą tego terminala i jego procesów potomnych, a nie zapisanych plików logowania. Nie umieszczaj prawdziwego klucza w wspólnym pliku ustawień lub repozytorium.
3. Wyślij minimalne żądanie testowe
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"
Oczekiwane: is_error ma wartość false, result to DEEPSEEK_TEST_OK, a proces kończy się kodem 0. Zmień --model na deepseek-v4-pro i uruchom ponownie.
Tryb --bare w testowanej wersji używa jawnego uwierzytelniania kluczem API i pomija normalne integracje w tle. --setting-sources "" wyklucza zapisane źródła ustawień, a --tools "" wyłącza narzędzia dla tego jednego testu tekstowego. To celowe ustawienia diagnostyczne, a nie wymagania do wyłączania narzędzi podczas normalnego użytkowania. Starsze wersje CLI mogą nie akceptować wszystkich tych flag.
4. Zweryfikuj narzędzia do odczytu plików
Utwórz probe.txt w bieżącym katalogu z tą zawartością:
TOOL_PROBE_739182
Uruchom:
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
Oczekiwane: CLI odczytuje plik i zwraca TOOL_PROBE_739182. Powtórz z deepseek-v4-pro. To sprawdza, czy model może zażądać narzędzia, otrzymać jego wynik, a następnie odpowiedzieć. Tylko narzędzie Read jest włączone dla tego testu.
Do zwykłej interaktywnej pracy z tymi samymi ustawieniami terminala:
claude --bare --setting-sources "" --model deepseek-v4-flash
Aby rozpocząć z Pro:
claude --bare --setting-sources "" --model deepseek-v4-pro
Polecenia interaktywne pomijają --tools "", więc domyślne narzędzia są dostępne. Przeglądaj monity o uprawnienia jak zwykle. --bare pomija udogodnienia, takie jak haki i automatyczne instrukcje projektu; włącz swoje normalne ustawienia celowo po tym, jak minimalna konfiguracja zadziała, i sprawdź, czy nie nadpisują bramy lub modelu. Zamknij ten terminal po zakończeniu, aby pozostawić środowisko tej sesji.
Rozwiązywanie problemów
| Objaw | Co sprawdzić |
|---|---|
unrecognized_model |
Zaobserwowano dla obu identyfikatorów DeepSeek w 2.1.239. Nie zapobiegło to ukończeniu naszych żądań. Sprawdź końcowy wynik, a nie traktuj samego ostrzeżenia jako błędu. |
| 401 lub nieoczekiwany monit logowania | Potwierdź, że ANTHROPIC_API_KEY jest ustawiony, usuń konfliktowy ANTHROPIC_AUTH_TOKEN w tym terminalu i spróbuj ponownie w trybie bare. |
| 404 | ANTHROPIC_BASE_URL powinno być https://apimaster.ai, a nie pełnym punktem końcowym /v1/messages lub bazą kończącą się na /v1. |
Nieznana opcja --bare |
Sprawdź swoją wersję względem testowanej 2.1.239. Użyj ogólnego przewodnika instalacji, aby zaktualizować, jeśli to właściwe. |
Nie można odczytać probe.txt |
Uruchom z katalogu pliku. Do testu narzędzia włącz Read, a nie używaj --tools "". |
| Wybrany jest inny model | Podaj pełny identyfikator modelu z --model i sprawdź zapisane ustawienia lub nadpisania aliasów modeli przed ich włączeniem. |
| Limit szybkości, niewystarczający limit lub błąd górnego poziomu | Przeczytaj treść błędu, sprawdź limit i uprawnienia modelu oraz zanotuj znacznik czasu dla wsparcia. |
Często zadawane pytania
Czy to to samo, co użycie modelu Claude?
Nie. Claude Code jest tutaj klientem; wybranym modelem jest DeepSeek. Funkcje zależne od konkretnego modelu Claude nie są automatycznie objęte tą konfiguracją.
Dlaczego podstawowy URL różni się od przykładu SDK Python?
Pythonowy SDK OpenAI używa https://apimaster.ai/v1 i dodaje /chat/completions. Claude Code używa https://apimaster.ai i dodaje /v1/messages. Użyj udokumentowanego formatu podstawy dla każdego klienta.
Czy mogę użyć oficjalnego klucza DeepSeek z tą bramą?
Ten samouczek wymaga klucza wydanego przez APIMaster. Klucze są specyficzne dla dostawcy, który je wydaje; zmiana tylko punktu końcowego nie przenosi poświadczeń ani limitu.
Czy przetestowano rzeczywiste użycie narzędzi, czy tylko odpowiedź tekstową?
Oba zostały przetestowane dla obu modeli. Test narzędzia odczytał lokalny plik i zwrócił jego zawartość. Nie potwierdza to, że wszystkie narzędzia, agenci w tle lub długie zadania kodowania są obsługiwane.