PL ▾

Alternatywa dla Claude Code: Konfiguracja agenta kodującego

Claude Code komunikuje się z własnym API Anthropic, więc nie można go po prostu przekierować na endpoint w stylu OpenAI. Oto co działa zamiast tego: agenci kodujący, którzy akceptują niestandardowy bazowy URL OpenAI, oraz sposób ich podłączenia do tego API.

Zaktualizowano

Okno terminala połączone świecącym kablem z sześcianem serwera API, ilustrujące agenta kodującego używającego niestandardowego endpointu

Kluczowe punkty

  • Claude Code jest zbudowane wokół formatu API Anthropic, podczas gdy ta usługa mówi w formacie chat completions OpenAI.
  • Narzędzia w stylu Aider, Continue, Cline i Cursor akceptują niestandardowy bazowy URL kompatybilny z OpenAI oraz nazwę modelu.
  • Użyj bazowego URL https://api.minimaxapikey.com/v1 z identyfikatorem modelu uncensored i kluczem Bearer.
  • Przetestuj najpierw za pomocą curla, a następnie utrzymaj liczbę równoległych zapytań na poziomie 8 lub mniej, ponieważ agenci wysyłają wiele wywołań jednocześnie.

Krótka odpowiedź

Jeśli szukałeś alternatywy OpenAI dla Claude Code, pierwszą rzeczą do ustalenia jest to, co chcesz zastąpić. Claude Code to terminalowy agent kodujący od Anthropic. Jest zaprojektowany do komunikacji z własnym API Anthropic, które używa innego formatu zapytań niż OpenAI. Ta usługa implementuje format chat completions OpenAI, więc te dwa rozwiązania nie są ze sobą kompatybilne poprzez zmianę tylko adresu URL.

Działają natomiast duże rodziny agentów kodujących i wtyczek do edytorów, które akceptują dowolny endpoint kompatybilny z OpenAI. Podajesz im bazowy adres URL, klucz i nazwę modelu, a one wysyłają zwykłe zapytania POST /v1/chat/completions. Aider, Continue i Cline należą do tej grupy, a kilka edytorów ma możliwość nadpisania bazowego adresu URL dla modeli OpenAI. Dla tego API trzy wartości to bazowy adres URL https://api.minimaxapikey.com/v1, identyfikator modelu uncensored oraz Twój klucz jako token Bearer.

Utrzymuj realistyczne oczekiwania. Modelem za endpointem jest jeden model o otwartych wagach uruchamiany przez niezależnego dostawcę, dostrojony do odpowiadania bez odmów treści do zgodnego z prawem użytku przez dorosłych. To nie jest Claude i nie jest to oficjalne API żadnego dostawcy modeli. To, czy pasuje do Twojego repozytorium, sprawdzisz na własnych zadaniach, a ten artykuł pokazuje, jak przeprowadzić ten test tanio.

Dlaczego nie można po prostu zmienić URL w Claude Code

Format API to więcej niż adres. API Anthropic ma własną strukturę wiadomości, własny sposób wyrażania promptów systemowych, własne bloki używania narzędzi i własne zdarzenia strumieniowania. Serwer w stylu OpenAI oczekuje messages z rolami, tablicy tools definicji funkcji oraz zdarzeń wysyłanych przez serwer zawierających choices[0].delta. Klient zbudowany dla jednego formatu zawiedzie lub zachowa się niepoprawnie wobec serwera dla innego, nawet jeśli URL jest osiągalny.

Niektórzy umieszczają warstwę translacji między dwoma, mały proxy, które przepisuje zapytania i odpowiedzi. Może to zadziałać, ale jest to osobny program, który uruchomisz i debugujesz samodzielnie, a zachowanie wokół wywołań narzędzi i strumieniowania często jest miejscem, gdzie takie warstwy się psują. Czy Claude Code oferuje oficjalne ustawienie dla endpointów stron trzecich, to coś, co należy sprawdzić w aktualnej dokumentacji Anthropic, ponieważ te opcje się zmieniają.

Prostszą ścieżką jest wybór agenta, który już mówi formatem OpenAI. Nie tracisz niczego w zakresie podstawowej pętli: agent czyta Twoje pliki, buduje prompt, pyta model o edycję i stosuje ją. Modelem jest część, którą wymieniasz, a ta część potrzebuje tylko kompatybilnego endpointu.

Przetestuj endpoint za pomocą curl przed użyciem dowolnego narzędzia

Każdy problem z integracją łatwiej zdiagnozować, jeśli wiesz, że surowe API działa. Utwórz klucz na stronie klucza API, wyeksportuj go i wykonaj jedno zapytanie. Jeśli się powiedzie, każda kolejna awaria wynika z ustawień narzędzia, a nie z klucza lub sieci.

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

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that parses an ISO date string."}
    ]
  }'

Możesz też wyświetlić listę modeli za pomocą GET /v1/models. Wiele narzędzi wywołuje ten endpoint przy zapisywaniu dostawcy, aby potwierdzić ważność klucza, więc warto zobaczyć, że zwraca on poprawny wynik przed konfiguracją czegokolwiek. Pełną dokumentację zapytania znajdziesz na stronie dokumentacji.

Gdzie każde narzędzie przyjmuje bazowy URL

Nazwy ustawień różnią się, ale idea jest taka sama wszędzie. Tabela wymienia wspólne narzędzia kodujące i pole, które wypełniasz. Menu przemieszczają się między wersjami, więc traktuj to jako mapę i sprawdź dokumentację każdego narzędzia pod kątem aktualnego układu.

NarzędzieGdzie wprowadzić endpointNazwa modelu do użycia
AiderZmienne środowiskowe lub flagi wiersza poleceń dla bazowego URL i klucza OpenAIopenai/uncensored
KontynuujWpis modelu w pliku konfiguracyjnym z dostawcą openai oraz apiBaseuncensored
ClineLista dostawców, wybierz opcję kompatybilną z OpenAIuncensored
KursorUstawienia modeli, sekcja klucza API OpenAI z nadpisaniem bazowego URLuncensored jako niestandardowy model
Twój własny skryptArgument base_url dowolnego SDK OpenAIuncensored

Ponieważ ta usługa udostępnia dokładnie jeden model, nie ma selektora modeli do skonfigurowania. Gdziekolwiek narzędzie chce nazwy modelu, wpisz uncensored. Jeśli narzędzie upiera się przy liście znanych modeli i odrzuca nieznane nazwy, szukaj opcji "niestandardowy model" lub "dodaj model".

Przykład Aider

Aider działa w Twoim terminalu, edytuje pliki w repozytorium git i dokonuje commitu wyniku, co sprawia, że jest duchowo najbliższy Claude Code. Używa LiteLLM pod spodem, więc nazwa modelu zawiera prefiks dostawcy. Dla serwera kompatybilnego z OpenAI tym prefiksem jest openai/.

pip install aider-chat

export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"

cd your-repo
aider --model openai/uncensored

Po uruchomieniu poproś o małą zmianę w jednym pliku i obserwuj diff. Zacznij od czegoś, co możesz zweryfikować w kilka sekund, takiego jak dodanie docstringa lub zmiana nazwy funkcji, zanim powierzysz mu zadanie wieloplikowe. Aider wysyła mapę repozytorium i dodane pliki na czat w każdej turze, więc prompt szybko rośnie. Okno 100 000 tokenów (prompt plus completion) jest hojne, ale duże repozytorium nadal wymaga, abyś dodawał tylko istotne pliki.

Jeśli Aider ostrzega, że nie zna wielkości kontekstu ani ceny modelu, jest to oczekiwane: nie ma wpisu dla niestandardowej nazwy modelu. Ostrzeżenie nie blokuje działania.

Przykład Continue

Continue to rozszerzenie edytora, które dodaje funkcje czatu, edycji i autouzupełniania w VS Code i JetBrains. Jego konfiguracja wymienia modele, każdy z dostawcą i opcjonalnymi nadpisaniami. Wpis modelu dla tego API wygląda następująco. Dokładna nazwa pliku i schemat zależą od zainstalowanej wersji Continue, więc porównaj go z aktualną dokumentacją.

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.minimaxapikey.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Zapytania czatu i edycji dobrze działają z endpointem takim jak ten. Autouzupełnianie klawiszem Tab to inny rodzaj obciążenia: jest wywoływane przy niemal każdej pauzie w pisaniu i wymaga bardzo niskiej latencji, co lepiej obsługują małe modele lokalne. Używanie hostowanego modelu czatu do uzupełnień inline zużyje zapytania wobec Twojego limitu 300 na minutę z niewielką korzyścią.

Zbuduj własnego minimalnego agenta

Jeśli żadne istniejące narzędzie nie pasuje, wsparcie dla wywoływania narzędzi sprawia, że napisanie małego agenta jest łatwe. API akceptuje tools i tool_choice, strumieniuje tool_calls z powrotem i przyjmuje wyniki jako wiadomości z role: "tool". Poniższa pętla daje modelowi jedną funkcję czytającą plik, a następnie kontynuuje, aż model odpowie tekstem zwykłym.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Return the text of a file in the current project.",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "Summarise what main.py does."}]

while True:
    resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = resp.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"], encoding="utf-8") as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

Dodaj funkcję zapisu i potwierdzenie przed jej uruchomieniem, a będziesz miał rdzeń agenta kodującego w około pięćdziesięciu liniach kodu. Zawsze waliduj ścieżki przed odczytem lub zapisem: model może poprosić o dowolną ścieżkę.

Limity i koszty do zaplanowania

Agenci zachowują się inaczej niż osoba rozmawiająca na czacie. Wysyłają serie zapytań, często kilka jednocześnie. Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę. Klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę, co może być wąskim gardłem dla agenta. Po przekroczeniu limitu API odpowiada kodem HTTP 429 i kodem błędu rate_limited lub concurrency. Przy tymczasowym przeciążeniu zwraca też 429 z Retry-After: 5. Większość dobrych klientów ponawia zapytania przy 429, ale jeśli Twój klient tego nie robi, zmniejsz jego ustawienie równoległości. Zapytanie strumieniowe zajmuje slot równoległości do końca strumienia, więc długie edycje strumieniowe liczą się do limitu 8.

Pod względem kosztów, rozliczenie jest na zasadzie płacenia za zużycie z przedpłaconego kredytu po $0.15 za 1M tokenów wejściowych i $0.50 za 1M tokenów wyjściowych. Załóżmy, że sesja wysyła 40 zapytań zawierających 30 000 tokenów wejściowych każde i otrzymuje 1 000 tokenów wyjściowych każde. To 1 200 000 tokenów wejściowych, czyli $0.18, plus 40 000 tokenów wyjściowych, czyli $0.02, razem $0.20. Nieudane lub odrzucone zapytania nie są rozliczane, a kredyt nigdy nie wygasa. Zobacz stronę z cenami, aby poznać kwoty doładowań i bonusy.

Nowe konta mogą odebrać $0.50 kredytu próbnego jednym kliknięciem na stronie klucza, bez potrzeby podawania karty, ważny przez 7 dni. To wystarczy na uruchomienie testu curl i kilka małych edycji w Aider. Prompty nie są używane do trenowania modeli.

Pytania i odpowiedzi

Czy mogę skierować sam Claude Code na to API?

Bezpośrednio nie. Claude Code jest zaprojektowany pod format API Anthropic, podczas gdy ta usługa implementuje chat completions w stylu OpenAI. Sprawdź aktualną dokumentację Anthropic, jakie funkcje obsługuje Claude Code, i użyj agenta kompatybilnego z OpenAI, jeśli chcesz skorzystać z tego endpointu.

Które narzędzia do pisania kodu działają z niestandardowym bazowym URL OpenAI?

Aider, Continue i Cline pozwalają wprowadzić bazowy URL kompatybilny z OpenAI, klucz API oraz nazwę modelu. Cursor również oferuje możliwość nadpisania bazowego URL dla modeli w stylu OpenAI, choć warto sprawdzić jego aktualne ustawienia i limity planów.

Czy API obsługuje wywoływanie funkcji dla agentów?

Tak. Możesz wysyłać narzędzia i tool_choice, odbierać strumieniowane tool_calls oraz zwracać wyniki z role tool. To, czy dane wtyczki edytora wykorzystują te pola, zależy od samej wtyczki.

Ile kosztuje sesja programistyczna?

Cennik to $0.15 za 1M tokenów wejściowych i $0.50 za 1M tokenów wyjściowych. Agenci często ponownie wysyłają kontekst, więc tokeny wejściowe zazwyczaj dominują w rachunku.

Twój klucz jest o jeden formularz stąd

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

Pobierz klucz API