# Konfiguracja klucza API Claude Code

Claude Code odczytuje dwie zmienne środowiskowe, aby kierować żądania w dowolne miejsce: ANTHROPIC_BASE_URL i ANTHROPIC_API_KEY. Skieruj je na RunAPI i uruchamiaj każdy model Claude za połowę oficjalnej stawki. Ten przewodnik pokazuje dokładne polecenia dla Mac, Linux i Windows.

*Updated June 18, 2026 · RunAPI Editorial*

## Jak ustawić własny klucz API w Claude Code?

Claude Code używa dwóch zmiennych środowiskowych, aby zdecydować, dokąd trafiają żądania i jak są uwierzytelniane. Ustaw ANTHROPIC_BASE_URL i ANTHROPIC_API_KEY na wartości RunAPI, a każde żądanie będzie kierowane przez RunAPI z rabatem 50%. Chcesz użyć zupełnie innego dostawcy? RunAPI działa też jako brama typu drop-in, dzięki czemu możesz uruchamiać modele Claude bez bezpośredniego konta Anthropic.

- **Dwie zmienne**: ANTHROPIC_BASE_URL ustawia endpoint. ANTHROPIC_API_KEY ustawia klucz. To cała konfiguracja — dwie zmienne, bez innych zmian.
- **Wartość endpointu**: Ustaw ANTHROPIC_BASE_URL na https://runapi.ai, żeby Claude Code kierował przez RunAPI.
- **Zapisz to**: Dodaj oba eksporty do profilu powłoki (.zshrc lub .bashrc), aby nie ustawiać ich ponownie w każdej sesji. Użytkownicy Windows ustawiają je w PowerShell i otwierają nowe okno.
- **50% zniżki**: Każdy model Claude jest rozliczany po połowie oficjalnej stawki Anthropic. Bez subskrypcji, bez limitu.

## Czego potrzebujesz przed konfiguracją Claude Code?

Konfiguracja zajmuje kilka minut. Potrzebujesz zainstalowanego Claude Code, konta RunAPI i terminala. Najpierw uruchom claude --version, aby potwierdzić, że Claude Code działa, zanim zmienisz jakąkolwiek konfigurację klucza API.

### Zainstalowany Claude Code

Zainstaluj Claude Code z oficjalnego źródła i potwierdź, że działa, używając claude --version w terminalu. Jeśli to polecenie zwraca błąd, napraw instalację przed ustawieniem jakichkolwiek kluczy API.

### Konto RunAPI

Zarejestruj się na runapi.ai. Bezpłatny poziom zawiera kredyty do testowania dowolnego modelu Claude przed zasileniem salda.

### Klucz API

Utwórz klucz z Dashboard → API Keys. Skopiuj go raz — w pełnej postaci jest pokazywany tylko podczas tworzenia. Nie wklejaj go do publicznych repozytoriów ani nie udostępniaj na zrzutach ekranu.

### Dostęp do terminala

Potrzebujesz powłoki, aby ustawić zmienne środowiskowe. macOS i Linux używają .zshrc lub .bashrc. Użytkownicy Windows mogą użyć PowerShell — ustaw zmienną, a następnie otwórz nowe okno terminala, aby zaczęła działać.


## Jak skonfigurować klucz API Claude Code z RunAPI

Uruchom te polecenia po kolei. Ustawiają endpoint i klucz, zapisują je w profilu powłoki oraz potwierdzają, że Claude Code je wykrywa. Zastąp placeholder swoim prawdziwym kluczem RunAPI. Użyj ANTHROPIC_API_KEY (nie CLAUDE_API_KEY) — to właśnie tę zmienną faktycznie odczytuje Claude Code.

## Jakie zmienne środowiskowe odczytuje Claude Code?

Claude Code odczytuje niewielki zestaw zmiennych do kontrolowania endpointu, uwierzytelniania, modelu i długości wyjścia. Tabela zawiera te, które mają znaczenie przy konfiguracji niestandardowego endpointu, oraz opis ich działania. Uwaga: użyj ANTHROPIC_API_KEY (nie CLAUDE_API_KEY) — to właśnie tę zmienną faktycznie odczytuje Claude Code.

| Zmienna | Przeznaczenie | Przykładowa wartość |
|---|---|---|
| ANTHROPIC_BASE_URL | Własny endpoint, do którego Claude Code wysyła żądania | https://runapi.ai |
| ANTHROPIC_API_KEY | Klucz używany do uwierzytelniania żądań | sk-your-runapi-key |
| ANTHROPIC_MODEL | Domyślny model dla nowych sesji | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | Limit tokenów zwracanych na odpowiedź | 8192 |

## Który model Claude powinieneś uruchomić w Claude Code?

Claude Code akceptuje każdy ID modelu Claude przez RunAPI. Wybierz według zadania: szybki i tani model do rutynowych edycji, zrównoważony do codziennego kodowania albo najmocniejszy do trudnych problemów. Ustaw ANTHROPIC_MODEL, aby zmienić domyślny model, albo przełączaj modele w Claude Code — rozliczenie zależy od modelu, który faktycznie wywołujesz.

### claude-haiku-4-5

Najszybszy i najtańszy po $1/M wejście i $5/M wyjście przez RunAPI. Najlepszy do rutynowych edycji i szybkich wyszukiwań.

### claude-sonnet-4-6

Zrównoważony domyślny do codziennego kodowania po $3/M wejście i $15/M wyjście przez RunAPI. Większość programistów używa tego.

### claude-opus-4-7

Najmocniejszy do trudnych problemów po $5/M wejście i $25/M wyjście przez RunAPI. Używaj do złożonych refaktoryzacji i przeglądów.

### Przełącz w dowolnym momencie

Ustaw ANTHROPIC_MODEL albo zmień model w Claude Code w dowolnym momencie. Rozliczenie zależy od modelu, który faktycznie wywołujesz, wszystko z rabatem 50%.


## Dlaczego mój klucz API Claude Code nie działa?

Większość problemów z konfiguracją wynika z jednej z trzech rzeczy: niewłaściwej nazwy zmiennej środowiskowej (użyj ANTHROPIC_API_KEY, nie CLAUDE_API_KEY), nieaktualnej sesji powłoki, która nie wczytała zmian profilu, albo literówki w kluczu. Tabela zawiera typowe błędy i poprawkę dla każdego z nich.

| Błąd lub objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| 401 Unauthorized | Nieprawidłowy lub wygasły klucz API | Sprawdź ANTHROPIC_API_KEY ponownie i utwórz nowy klucz w dashboardzie RunAPI, jeśli potrzeba |
| Żądania nadal trafiają do Anthropic | ANTHROPIC_BASE_URL nie jest ustawiony w tej powłoce | Uruchom echo $ANTHROPIC_BASE_URL; jeśli jest pusty, przeładuj profil lub otwórz nowy terminal |
| 404 Not Found | Ukośnik na końcu lub zła ścieżka w bazowym URL | Ustaw bazowy URL dokładnie na https://runapi.ai bez końcowej ścieżki |
| Model nie znaleziony | Nieprawidłowy lub błędnie napisany identyfikator modelu | Użyj prawidłowego identyfikatora jak claude-sonnet-4-6 lub claude-opus-4-7 |
| Zmienne utracone po restarcie | Eksporty nie zostały zapisane w profilu powłoki | Dołącz oba eksporty do ~/.zshrc lub ~/.bashrc i przeładuj |

## Jak skonfigurować klucz API Claude Code z RunAPI

1. **Ustaw bazowy URL** — Wyeksportuj ANTHROPIC_BASE_URL=https://runapi.ai, aby kierować żądania przez RunAPI.
2. **Ustaw klucz API** — Wyeksportuj ANTHROPIC_API_KEY z kluczem RunAPI z Dashboard → Klucze API.
3. **Zapisz obie zmienne** — Dodaj oba eksporty do ~/.zshrc lub ~/.bashrc i przeładuj za pomocą source ~/.zshrc, aby przetrwały nowe sesje. W Windows ustaw je w PowerShell i otwórz nowe okno terminala.
4. **Uruchom Claude Code** — Uruchom claude --version, aby potwierdzić instalację, a następnie uruchom claude w swoim projekcie. Żądania są teraz kierowane przez RunAPI z rabatem 50% od oficjalnej stawki.

## FAQ dotyczące klucza API Claude Code

### Jak dodać klucz API do Claude Code?

Ustaw dwie zmienne środowiskowe. Wyeksportuj ANTHROPIC_BASE_URL do https://runapi.ai oraz ANTHROPIC_API_KEY do swojego klucza RunAPI. Dodaj obie do profilu powłoki (.zshrc lub .bashrc), aby utrzymywały się między sesjami. Claude Code odczytuje je przy uruchomieniu i kieruje każde żądanie przez RunAPI.

### Skąd wziąć klucz API do Claude Code?

Utwórz je na runapi.ai. Zarejestruj się, otwórz Dashboard → API Keys i wygeneruj klucz. Skopiuj go od razu — pełny klucz jest pokazywany tylko podczas tworzenia. Darmowa warstwa obejmuje kredyty do przetestowania dowolnego modelu Claude przed zasileniem salda.

### Do czego służy ANTHROPIC_BASE_URL?

Informuje Claude Code, do jakiego endpointu wysyłać żądania. Domyślnie Claude Code wywołuje Anthropic bezpośrednio. Ustawienie na https://runapi.ai kieruje każde żądanie przez RunAPI, które rozlicza te same modele po 50% oficjalnej stawki.

### Czy mogę używać Claude Code z innymi dostawcami API, takimi jak OpenAI?

Czy da się używać Claude Code z innymi dostawcami API, takimi jak OpenAI? Tak — Claude Code obsługuje każdy endpoint zgodny z OpenAI przez ANTHROPIC_BASE_URL. RunAPI udostępnia zgodną bramę, dzięki czemu możesz zmieniać dostawców bez zmiany kodu, używając jednego klucza dla Claude, GPT i innych modeli.

### Dlaczego Claude Code nadal rozlicza według pełnej stawki?

Uruchom echo $ANTHROPIC_BASE_URL w terminalu. Jeśli nic nie wypisze, eksport nie został utrwalony. Dodaj oba eksporty do ~/.zshrc lub ~/.bashrc, uruchom source ~/.zshrc, a następnie otwórz nowy terminal i sprawdź ponownie. Użytkownicy Windows muszą otworzyć nowe okno PowerShell po ustawieniu zmiennych środowiskowych.

### Czy mogę przechowywać klucz w pliku konfiguracyjnym?

Tak. Umieść wartości w pliku .claude.json w katalogu domowym lub katalogu projektu zamiast eksportować je w każdej sesji. Oba podejścia działają — plik jest wygodny dla kluczy per projekt, a eksporty są prostsze przy jednej globalnej konfiguracji.

### Jak monitorować koszt po konfiguracji?

Otwórz panel RunAPI. Pokazuje wydatki według klucza i według żądania w czasie rzeczywistym. Aby ograniczyć koszt wyjścia, ustaw CLAUDE_CODE_MAX_OUTPUT_TOKENS, aby każda odpowiedź była limitowana, i używaj claude-haiku-4-5 do rutynowych edycji.

### Czy to zmienia zachowanie Claude Code?

Nie. RunAPI przekazuje żądania bezpośrednio do bazowych modeli Claude. Wyjście, użycie narzędzi i zachowanie są identyczne jak przy bezpośrednim wywołaniu Anthropic. Zmieniasz tylko miejsce, do którego trafiają żądania, i sposób ich rozliczania — doświadczenie kodowania pozostaje takie samo.