Strona główna → Pomoc

Claude Code i Codex potrzebują różnych base URL w tej samej bramce

Co widzisz

• 404 on /v1/v1/messages
• Claude Code works but Codex returns 404, or the reverse
• Unexpected token '<' — HTML where JSON was expected
• The key is valid and the model exists, yet nothing connects
• No trace of the failed request in the provider's usage log

Dlaczego tak się dzieje

Dwie linie SDK, dwie konwencje, jedna nazwa hosta bramki. Żaden klient nie jest w błędzie; po prostu nie zgadzają się, kto odpowiada za segment /v1. Pomylenie ich daje albo /v1/v1/…, albo ścieżkę bez wersji.

Powstały 404 jest wyjątkowo trudny do debugowania, bo często w ogóle nie dociera do API. Bramka, która serwuje stronę WWW z tej samej domeny, odpowiada na nieznane ścieżki stroną marketingową – HTTP 200, Content-Type: text/html. Klient próbuje wtedy sparsować HTML jako JSON i zgłasza błąd składni, który nie wskazuje nawet w pobliżu prawdziwej przyczyny.

Oznacza to też, że błąd nie zostawia śladu po stronie dostawcy. Wsparcie powie, że nie widzi żadnych żądań z twojego klucza, i będzie mówić prawdę: na żądanie odpowiedział serwer WWW, zanim w ogóle stało się wywołaniem API.

Sprawdź, czy to ta przyczyna

Zamiast czytać treść, zapytaj o typ treści – jedno polecenie to rozstrzyga:

curl -s -o /dev/null -w '%{http_code} %{content_type}\n' \
  -X POST 'YOUR_BASE_URL/chat/completions' \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"hi"}]}'

application/json oznacza, że URL jest poprawny – nawet zły klucz odpowiada w JSON. text/html oznacza, że rozmawiasz ze stroną WWW, a problemem jest base URL.

Jak to naprawić

1. Decyduj według linii SDK, nie nazwy produktuWszystko zbudowane na Anthropic SDK chce samego hosta; wszystko zgodne z OpenAI chce /v1. Nowe narzędzia pasują do jednej z tych dwóch grup bez osobnych instrukcji.
2. Usuń końcowy ukośnikNiektóre klienty łączą ścieżki naiwnie, a base URL zakończony na / może dać podwójny ukośnik, który trafia do strony WWW zamiast do API.
3. Sprawdź typ treści, zanim sprawdzisz kluczOdpowiedź w HTML oznacza, że żądanie nigdy nie dotarło do API. Zmiana kluczy w tym momencie niczego nie zmienia i kosztuje całe popołudnie.
4. Najpierw użyj przykładów dostawcy dosłownieUruchom jedną znaną, działającą konfigurację, a potem zmieniaj po jednej rzeczy naraz. Większość błędów konfiguracji to dwie pomyłki jednocześnie.

Powiązane

Ostatnio sprawdzono 2026-10-01. Napisane na podstawie problemów zdiagnozowanych na działającej bramce zgodnej z OpenAI, a nie zebrane z innych stron.