PL ▾
Pobierz klucz API

getdeepseekapi.comPrzewodnik

Jak używać API DeepSeek w Claude Code: Rzeczywiste opcje

Jeśli chcesz dowiedzieć się, jak używać API DeepSeek w Claude Code, pamiętaj, że Claude Code komunikuje się z endpointami w stylu Anthropic, a ta usługa używa formatu OpenAI. Małe proxy do tłumaczenia zamyka tę lukę, a ta strona pokazuje, jak je skonfigurować.

Zaktualizowano

Kluczowe punkty

  • Claude Code oczekuje API Messages Anthropic; ta usługa oferuje /v1/chat/completions kompatybilne z OpenAI.
  • Lokalne proxy, takie jak LiteLLM, może tłumaczyć między tymi dwoma formatami.
  • Aider, Continue i Cline akceptują bazowy URL kompatybilny z OpenAI bezpośrednio, bez proxy.
  • To nie jest oficjalne API DeepSeek: to jeden niezależny model o otwartych wagach z identyfikatorem uncensored.
Dwa niedopasowane złącza połączone świecącym adapterem, pokazujące proxy tłumaczące między formatami API

Zacznij od tego, co zadziała, a co nie

Dwie uwagi oszczędzą godzinę nieporozumień. Po pierwsze, usługa nie jest oficjalnym API DeepSeek i nie jest routerem dla DeepSeek ani żadnego innego dostawcy. Udostępnia jeden model o otwartych wagach, uruchamiany przez niezależnego dostawcę, pod identyfikatorem modelu uncensored. Jeśli potrzebujesz własnych modeli DeepSeek, przejdź bezpośrednio do DeepSeek. Po drugie, Claude Code jest zbudowany wokół Messages API Anthropic. Możesz zmienić miejsce wysyłania zapytań, ale to, co wysyłasz, to nadal JSON w formacie Anthropic.

Usługa udostępnia POST /v1/chat/completions oraz GET /v1/models w formacie OpenAI. Bezpośrednie wskazanie Claude Code na nią nie zadziała, ponieważ ścieżki i payloady się różnią. Rozwiązaniem jest warstwa translacji. Uruchamiasz małe proxy na swoim komputerze, które przyjmuje wywołania w formacie Anthropic od Claude Code i przekazuje je jako wywołania w formacie OpenAI do https://api.getdeepseekapi.com/v1. Istnieją narzędzia właśnie do tego celu, a w kolejnym rozdziale skonfigurujemy jedno z nich.

Przed rozpoczęciem sprawdź jedno oczekiwanie. Claude Code mocno polega na wywoływaniu funkcji do odczytu plików, ich edycji i uruchamiania poleceń. To API obsługuje wywoływanie funkcji, w tym strumieniowanie tool_calls, ale to, jak dobrze dany model prowadzi długą pętlę agenta, to coś, co należy przetestować na swoim własnym repozytorium, a nie coś, co należy zakładać.

Pobierz klucz i potwierdź endpoint

Załóż konto za pomocą Google lub e-maila i hasła, a następnie otwórz stronę klucza API. Nowi użytkownicy mogą odebrać $0,50 kredytu próbnego jednym kliknięciem. Ważny przez 7 dni, nie wymaga podania danych płatniczych i wystarczy do przetestowania wszystkiego poniżej. Pamiętaj, że klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę, co ma znaczenie dla narzędzi agentowych, które wysyłają kilka wywołań naraz.

export UNCENSORED_API_KEY="paste-your-key-here"

curl https://api.getdeepseekapi.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

Jeśli zwróci to completion, strona upstream jest gotowa. Wszystko, co pozostało, to podłączenie proxy.

Opcja 1: proxy LiteLLM przed Claude Code

LiteLLM to projekt open-source, którego serwer proxy może udostępniać endpoint kompatybilny z Anthropic i kierować ruch do backendów kompatybilnych z OpenAI. Sprawdź jego dokumentację, aby poznać aktualny zestaw funkcji, ponieważ ta część ekosystemu rozwija się szybko.

Zainstaluj i skonfiguruj

pip install 'litellm[proxy]'

cat > litellm-config.yaml <<'EOF'
model_list:
  - model_name: uncensored
    litellm_params:
      model: openai/uncensored
      api_base: https://api.getdeepseekapi.com/v1
      api_key: os.environ/UNCENSORED_API_KEY
EOF

litellm --config litellm-config.yaml --port 4000

Prefiks openai/ mówi LiteLLM, aby użyło adaptera kompatybilnego z OpenAI; nazwa po nim jest wysyłana wyżej jako model. Pozostaw terminal uruchomiony.

Wskaż Claude Code na proxy

Claude Code odczytuje swój endpoint i poświadczenia ze zmiennych środowiskowych. W drugim terminalu:

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude

Token autoryzacji tutaj to tylko to, czego oczekuje Twoje lokalne proxy; prawdziwy klucz pozostaje w środowisku proxy. Ustawienie małego, szybkiego modelu również ma znaczenie, ponieważ Claude Code używa drugiego modelu do lekkich zadań w tle. Jeśli go nie ustawisz, może spróbować wywołać nazwę modelu Anthropic, której proxy nie zna. Nowe wersje mogą nazywać to ustawienie inaczej, więc uruchom claude --help lub przeczytaj aktualną dokumentację ustawień Claude Code, jeśli zmienna wydaje się ignorowana.

Opcja 2: narzędzia przyjmujące bazowy URL OpenAI bezpośrednio

Jeśli Twoim celem jest asystent AI do programowania, a nie samo Claude Code, kilka narzędzi pomija proxy, ponieważ już mówią w formacie OpenAI. Każde z nich pozwala ustawić niestandardowy bazowy URL i nazwę modelu.

  • Aider to terminalowy asystent do programowania w parze. Odczytuje OPENAI_API_BASE oraz OPENAI_API_KEY, a Ty poprzedzasz model prefiksem openai/.
  • Continue to rozszerzenie edytora, gdzie wpis modelu może zawierać apiBase i dostawcę w stylu OpenAI.
  • Cline oferuje dostawcę OpenAI Compatible w swoich ustawieniach z polami na bazowy URL, klucz i identyfikator modelu.

Z Aiderem cała konfiguracja to trzy linie:

export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored

Te narzędzia często zmieniają swoje menu, więc traktuj powyższe nazwy pól jako wskazówkę i postępuj zgodnie z aktualną dokumentacją każdego projektu. Wartości, których potrzebujesz, nie ulegną zmianie: bazowy URL https://api.getdeepseekapi.com/v1, Twój klucz i identyfikator modelu uncensored.

Napisz własną cienką pętlę agenta

Gdy pełny asystent programistyczny to przesada, krótki skrypt z wywoływaniem funkcji rozwiąże wiele problemów. Ten pozwala modelowi poprosić o odczytanie pliku, a następnie przekazuje plik z powrotem jako wiadomość role: "tool".

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getdeepseekapi.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
)

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Read a text file from the project",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "What does main.py do? Read it first."}]

for _ in range(5):
    r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = r.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"]) as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

Ograniczenie pętli do pięciu iteracji zapobiega nieskończonemu działaniu zagubionego modelu. W prawdziwym narzędziu sprawdziłbyś również ścieżki, aby model nie mógł czytać plików spoza projektu.

Limity zapytań, koszt i naprawa 429

Narzędzia agentowe są gadatliwe. Pojedyncze zadanie może wywołać dziesiątki zapytań, każde z ponownym wysyłaniem rosnącego kontekstu. Na pełnym kluczu otrzymujesz 8 równoległych zapytań i 300 na minutę. Błąd 429 z concurrency oznacza zbyt wiele nakładających się wywołań, a 429 z rate_limited oznacza zbyt wiele na minutę. Podczas krótkiego przeciążenia zobaczysz 429 z Retry-After: 5. LiteLLM może automatycznie ponawiać żądania, jeśli dodasz ustawienie ponownego wysyłania; sprawdź jego dokumentację.

Koszt jest skromny, ponieważ cena wynosi $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Załóżmy, że sesja agenta wykonuje 40 wywołań, które wysyłają po 30 000 tokenów kontekstu i otrzymują z powrotem 600 tokenów. Wejście to 1 200 000 tokenów, co kosztuje 1,2 x $0,15 = $0,18. Wyjście to 24 000 tokenów, co kosztuje 0,024 x $0,50 = $0,012. Cała sesja kosztuje $0,192. Okno kontekstu ma 100 000 tokenów, więc trzymaj ładowane pliki skupione na temacie.

Kiedy kredyt próbny się skończy, doładuj dowolną kwotę całkowitą od $20 do $500 kryptowalutami (USDT na TRC20, USDC na Base). Bonusy to +5% od $50, +10% od $100 i +15% od $200. Zobacz stronę cenową i dokumentację po szczegóły.

Rozwiązywanie problemów z konfiguracją proxy

ObjawPrzyczynaCo spróbować
Claude Code zgłasza nieznany modelNazwa modelu w tle nie jest zmapowanaUstaw zmienną małego szybkiego modelu również na uncensored
Połączenie odrzuconeProxy nie działa lub port się różniUruchom LiteLLM i dopasuj port w ANTHROPIC_BASE_URL
401 z upstreamZły klucz w środowisku proxyPonownie wyeksportuj UNCENSORED_API_KEY i zrestartuj proxy
Wywołania narzędzi kończą się błędem lub zapętlają sięModel ma trudności z formatem agentaObniż temperaturę, skróć prompt lub użyj Aidera
Częste 429Limit równoległych zapytań dla klucza próbnego: 2Doładuj konto, aby uzyskać pełny klucz z 8 równoległymi slotami

Dwa nawyki zapewniają bezpieczeństwo konfiguracji. Uruchom proxy tylko na localhost, aby nikt inny w Twojej sieci nie mógł wydać Twojego kredytu, i przechowuj prawdziwy klucz w środowisku proxy, a nie w pliku projektu, który trafi do systemu kontroli wersji. Obserwuj również nagłówek odpowiedzi X-Balance-USD podczas pierwszej długiej sesji, ponieważ pętle agentów mogą zużyć więcej tokenów, niż się spodziewasz. Jeśli saldo spada szybciej niż szacuje się powyżej, skróć pliki, które podajesz, lub ogranicz liczbę kroków.

Nieudane zapytania nie są rozliczane, więc eksperymentowanie jest tanie. Prompty nie są używane do trenowania modeli. Aby porównać się z innymi bramkami, przeczytaj nasze omówienie kluczy API.

Pytania i odpowiedzi

Czy Claude Code może łączyć się bezpośrednio z tym API?

Nie. Claude Code używa formatu Messages od Anthropic, a to API używa formatu chat completions od OpenAI. Ustaw między nimi proxy tłumaczące, takie jak LiteLLM.

Czy to oficjalne API DeepSeek?

Nie. Hostuje jeden niezależny model o otwartych wagach pod identyfikatorem uncensored i nie jest powiązany z DeepSeek ani żadnym innym dostawcą.

Które narzędzia działają bez proxy?

Narzędzia z ustawieniem dostawcy kompatybilnego z OpenAI, takie jak Aider, Continue i Cline. Ustaw bazowy URL, klucz i identyfikator modelu uncensored.

Czy wywoływanie funkcji działa?

Tak, w tym strumieniowanie tool_calls i zwracanie wyników jako wiadomości z rolą tool. Przetestuj własny przepływ pracy agenta, aby zobaczyć, jak model sobie z tym radzi.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.

Pobierz klucz API