Konfiguracja Claude Code

CLI Anthropic na endpoincie OneProvider. Konfiguracja to dwie zmienne środowiskowe i jedno wywołanie sprawdzające.

Instalacja

curl -fsSL https://claude.ai/install.sh | bash
# or:
brew install --cask claude-code

Opcja 1: zmienne środowiskowe (bieżąca sesja)

Najszybciej jest ustawić zmienne tylko w bieżącym terminalu. Nie zostaną zachowane między sesjami — jeśli mają przetrwać restart, zobacz „Zapisz na stałe” na dole.

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

Opcja 2: trwałe ustawienia

Claude Code odczytuje ustawienia użytkownika z settings.json. Model domyślny i aliasy rodzin poniżej pochodzą z aktualnych aktywnych modeli katalogu.

Ścieżka pliku: ~/.claude/settings.json

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

Sprawdzenie

claude -p "say hi in one sentence"

Po sekundzie lub dwóch powinna pojawić się odpowiedź w jednym zdaniu. Jeśli widzisz 401, klucz jest błędny; 400 invalid_request_error oznacza, że nazwa modelu nie pasuje do kanonicznej listy (odpowiedź zawiera obsługiwane ID).

Częste problemy

# validate the file
jq . ~/.claude/settings.json
# auto-replace smart quotes with ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Pełna lista objawów, przyczyn i rozwiązań dla 400 / 401 / 403 / 404 / 429 / 503 / 504 jest na stronie Rozwiązywanie problemów .

Użycie narzędzi

Claude Code używa natywnego schematu narzędzi Anthropic. API przyjmuje każdą nazwę narzędzia (Read, Write, Edit, Bash, Grep, Glob, TodoWrite itd.) z tool_choice: auto — tak domyślnie wysyła CLI. Nagłówek anthropic-beta nie jest wymagany.

Jeśli twój własny orkiestrator ustawia tool_choice: {"type": "any"} lub tool_choice: {"type": "tool", "name": "X"}, API zamienia je na auto + wskazówkę w prompcie systemowym. Pełna tabela: Użycie narzędzi .

Zapisz na stałe

Gdy wszystko działa i chcesz, żeby zmienne przetrwały między sesjami terminala, dodaj je do pliku rc powłoki (macOS / Linux) lub do rejestru środowiska użytkownika (Windows). Nowe terminale odczytają je automatycznie.

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

Jaki model wybrać

Claude Code mówi protokołem Anthropic, więc najlepiej działa z rodziną Claude. Użyj claude-sonnet-5-5 jako codziennego wyboru: zrównoważona cena i jakość przy edycjach, testach i wyjaśnieniach. Przełącz na claude-opus-5-5 przy decyzjach architektonicznych, dużych refaktoryzacjach i błędach, których nie umiesz zawęzić; kosztuje więcej za token. Użyj claude-haiku-5-5 do szybkich pytań, komunikatów commitów i pracy w tle, gdzie liczy się szybkość, a nie głębia. W trakcie sesji przełączysz model poleceniem /model albo zaczniesz od claude --model claude-opus-5-5. Ustawienia powyżej przypisują aliasy sonnet, opus i haiku do tych ID. Aktualne ID są na stronie modeli , a stawki na stronie cennika . Ceny podano za milion tokenów, więc ustaw limit wydatków na kluczu i obserwuj zużycie w Panelu.

Częste błędy i rozwiązania

claude: command not found po instalacji

Najpierw otwórz nowy terminal: instalator umieszcza plik wykonywalny w ~/.local/bin. Jeśli nadal go brakuje, dodaj go poleceniem export PATH="$HOME/.local/bin:$PATH" w pliku rc powłoki. Przy Homebrew sprawdź, czy brew install --cask claude-code zakończyło się bez błędów.

400 invalid_request_error dotyczący modelu

ID modelu nie ma w katalogu, często to stary alias, np. claude-3-5-sonnet. Ustaw ANTHROPIC_MODEL i trzy zmienne ANTHROPIC_DEFAULT_*_MODEL jak w settings.json powyżej albo wyświetl poprawne ID poleceniem curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY".

404 lub „The requested API endpoint does not exist”

ANTHROPIC_BASE_URL musi być dokładnie https://api.oneprovider.dev: bez /v1 i bez /v1/messages na końcu. Ścieżkę dopisuje sam Claude Code.

429 „Insufficient balance on this API key”

Saldo w Panelu lub limit wydatków klucza został wyczerpany. Ponawianie nie pomoże: doładuj saldo lub podnieś limit w Panelu, a potem wyślij zapytanie ponownie.

Odpowiedź urywa się w połowie lub połączenie jest resetowane

Wyłącz każdy VPN lub proxy VLESS: buforują strumienie i psują HTTP/2. OneProvider nie blokuje ruchu geograficznie i nie buforuje strumieni. Odpowiedź musi zacząć napływać w ciągu 6 minut, a całe zapytanie trwa najwyżej 10 minut, zobacz kody błędów .

Zmieniłem settings.json, ale nic się nie zmieniło

Claude Code odczytuje blok env przy starcie, więc zamknij go i uruchom claude ponownie. Trzymaj zmienne w ~/.claude/settings.json lub w powłoce: projektowy .claude/settings.json jest wczytywany po konfiguracji pierwszego uruchomienia i może być za późno.

FAQ

Czy potrzebuję konta lub subskrypcji Claude?

Nie. Wystarczy klucz OneProvider. Claude Code nigdy nie musi logować się do claude.ai; jeśli pokaże ekran logowania, wykonaj kroki dla Auth conflict powyżej.

Czy w Claude Code mogę używać GPT lub innych modeli?

Claude Code wysyła żądania Anthropic Messages, więc używaj tam ID Claude. Do modeli GPT użyj Codex , Cursor lub Cline .

Jak wrócić do mojego logowania Anthropic?

Usuń ustawione wyżej zmienne ANTHROPIC_* z bloku env w settings.json i z pliku rc powłoki, otwórz nowy terminal i wykonaj /login.

Gdzie zobaczę, ile kosztowała sesja?

Na stronie Zużycie klucza w Panelu: każde zapytanie z modelem i liczbą tokenów. Limit wydatków na kluczu zatrzyma agenta, który wpadł w pętlę.

Czy działa w Windows?

Tak. Wybierz Windows w przełączniku systemu operacyjnego u góry: te same dwie zmienne ustawia się w PowerShell, a settings.json leży w twoim profilu użytkownika, w katalogu .claude.

Czy rozszerzenie Claude Code dla VS Code to to samo?

Używa tego samego pliku ustawień. Zobacz Claude Code w VS Code .

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .