Strona główna → Poradniki → Base URL Anthropic dla Claude Code: poprawne ustawienie ANTHROPIC_BASE_URL

Base URL Anthropic dla Claude Code: poprawne ustawienie ANTHROPIC_BASE_URL

Claude Code łączy się z adresem, na który wskazuje ANTHROPIC_BASE_URL. Jedyna reguła, na której wielu się potyka: chce samego hosta, bez /v1 — odwrotnie niż prawie wszystkie narzędzia w stylu OpenAI.

Krótka odpowiedź

Przed uruchomieniem Claude Code ustaw dwie zmienne środowiskowe:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

Oficjalny adres Anthropic to https://api.anthropic.com; przy pośredniku wystarczy go podmienić. Claude Code sam dopisuje /v1/messages, więc base URL kończy się na hoście. Na tej bramce 88% całego ruchu Claude z ostatnich 30 dni pochodziło z Claude Code ustawionego dokładnie w ten sposób.

Gdzie to ustawić

macOS / Linux — w powłoce, z której go uruchamiasz:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — dla bieżącego okna:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — aby każda sesja to przejęła, niezależnie od powłoki:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Wartość jest odczytywana przy starcie Claude Code. Po zmianie wyjdź i otwórz nową sesję; otwarta sesja zachowuje stary adres. ANTHROPIC_AUTH_TOKEN wysyłany jest jako Authorization: Bearer, a ANTHROPIC_API_KEY jako x-api-key. Ta bramka przyjmuje oba — używaj jednego, nie obu.

Test jednym poleceniem

Zanim zaczniesz podejrzewać Claude Code, sprawdź adres i klucz bezpośrednio:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Odpowiedź w JSON oznacza, że oba są poprawne. text/html lub 404 oznacza zły adres; 401 w JSON oznacza poprawny adres i zły klucz.

Kiedy dodać /v1, a kiedy nie

Dwie rodziny SDK dzielą adres w różnych miejscach. Klienci w stylu Anthropic sami dopisują /v1/messages; klienci w stylu OpenAI oczekują /v1 w base URL i dopisują tylko /chat/completions:

Klient	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Z /v1 w Claude Code żądania idą na /v1/v1/messages i zwracają 404. Bez /v1 w Cursorze idą na /chat/completions — też 404. Żadne nie dociera do API.

Błąd adresu czy błąd klucza?

• Błąd, a w logu użycia nic → ścieżka jest zła. 404 jest zwracane na brzegu sieci i nigdy nie dociera do rozliczeń. Najpierw sprawdź /v1.
• 401 z wpisem w logu → klucz jest zły, unieważniony albo saldo jest puste.
• Jeden model daje 404, a inne działają na tym samym kluczu → ten model należy do innej grupy. Każdy klucz jest przypisany do jednej grupy; utwórz drugi dla tamtej.
• Zmiana jakby nie działa → zmienną ustawiono w innej powłoce albo sesja wystartowała wcześniej.

Wybór modelu

Nazwy modeli to dokładne ciągi z łącznikami, nigdy kropkami — claude-fable-5-1, nie claude-fable-5.1. Wybierz przy starcie lub poleceniem /model w sesji:

claude --model claude-opus-5-5

Aktualne nazwy i ceny są w cenniku. Konfiguracja innych klientów jest w szybkim starcie, a aplikacja Claude Desktop w przewodniku po aplikacjach desktopowych.

Zacznij korzystać

Bez abonamentu, bez minimum miesięcznego, bez rozmowy z handlowcem. Doładuj w USDT i płać za to, czego używasz — 1 USDT to 2 kredyty salda API.

Przeczytaj 30-sekundowy szybki start

Język: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Ceny na tej stronie są uzupełniane automatycznie z rzeczywistych danych rozliczeniowych. Warunki stron trzecich cytujemy z ich dokumentacji.