Claude Code

Ten przewodnik korzysta wyłącznie z modeli Claude. Claude Code może uruchamiać modele Claude (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) oraz modele bez ograniczeń klienta (GLM, Qwen, Kimi, MiniMax, DeepSeek). Modele GPT nie są dostępne w Claude Code — zobacz Codex.

1. Zainstaluj Claude Code

Instalacja lokalna

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Instalacja przez npm

Wymaga Node.js w wersji 18 lub nowszej

npm install -g @anthropic-ai/claude-code

2. Skonfiguruj API Harogo

Aby połączyć się z usługą modeli Harogo przez API zgodne z Anthropic, ustaw następujące zmienne środowiskowe.

Ustaw ANTHROPIC_BASE_URL na https://api.harogo.ai/
Ustaw ANTHROPIC_AUTH_TOKEN na klucz API uzyskany na platformie Harogo
Ustaw ANTHROPIC_MODEL na model Claude obsługiwany przez Harogo, na przykład claude-sonnet-5.

macOS
Windows

Uruchom w terminalu następujące polecenie, aby sprawdzić domyślną powłokę.

echo $SHELL

Ustaw zmienne środowiskowe odpowiednio do typu powłoki:

# Zastąp <HAROGO_API_KEY> prawdziwym kluczem z platformy Harogo
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc

# Zastąp <HAROGO_API_KEY> prawdziwym kluczem z platformy Harogo
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile

Uruchom w terminalu następujące polecenie, aby zastosować zmienne środowiskowe.

source ~/.zshrc

source ~/.bash_profile

Otwórz nowy terminal i uruchom następujące polecenia, aby sprawdzić, czy zmienne środowiskowe zostały zastosowane.

echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

W systemie Windows możesz ustawić Base URL Harogo i klucz API jako zmienne środowiskowe za pomocą CMD lub PowerShell.

CMD
PowerShell

Uruchom w CMD następujące polecenie, aby ustawić zmienne środowiskowe.

REM Zastąp <HAROGO_API_KEY> prawdziwym kluczem z platformy Harogo
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

Otwórz nowe okno CMD i uruchom następujące polecenia, aby sprawdzić, czy zmienne środowiskowe zostały zastosowane.

if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

Uruchom w PowerShell następujące polecenie, aby ustawić zmienne środowiskowe.

# Zastąp <HAROGO_API_KEY> prawdziwym kluczem z platformy Harogo
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User)

Otwórz nowe okno PowerShell i uruchom następujące polecenia, aby sprawdzić, czy zmienne środowiskowe zostały zastosowane.

if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

Jeśli zamierzasz zarządzać Claude Code przez CC Switch, zalecamy, aby nie ustawiać dodatkowo globalnych wartości ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL ani ANTHROPIC_MODEL. Zmienne środowiskowe na poziomie systemu lub użytkownika mogą nadpisać konfigurację dostawcy zapisaną przez CC Switch. W efekcie interfejs pokazuje wybranego właściwego dostawcę, a Claude Code w rzeczywistości nadal używa starego klucza lub modelu.

3. Sprawdź konfigurację

Po skonfigurowaniu zmiennych środowiskowych lub CC Switch, zanim rozpoczniesz dłuższą sesję, wyślij najpierw jedno minimalne zapytanie, aby potwierdzić, że klucz, model i endpoint zgodny z Anthropic działają poprawnie.

curl https://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"

4. Zacznij korzystać z Claude Code

Po zakończeniu konfiguracji przejdź do katalogu roboczego i uruchom w terminalu polecenie claude, aby zacząć.

$ cd /path/your-project
> claude

Jeśli przy uruchomieniu widzisz komunikat Not logged in · Please run /login lub trafiasz do procesu logowania Anthropic, zwykle oznacza to, że Claude Code nie wczytał działającej konfiguracji Harogo albo nie ukończono wstępnej konfiguracji przy pierwszym uruchomieniu. Najpierw upewnij się, że minimalne zapytanie z poprzedniego kroku zwraca 2, i sprawdź, czy ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL lub ANTHROPIC_MODEL nie są nadpisywane przez stare globalne zmienne środowiskowe. Jeśli klucz działa, a nadal trafiasz do procesu logowania, możesz pominąć wstępną konfigurację, wykonując poniższe kroki:

Terminal z monitem o zalogowanie się lub kontynuację przy pierwszym uruchomieniu Claude Code

Znajdź plik .claude.json w katalogu domowym:
- macOS / Linux: ~/.claude.json
- Windows: C:\Users\%USERNAME%\.claude.json
Ustaw pole hasCompletedOnboarding na true

{
  "hasCompletedOnboarding": true
}

Zapisz plik, a następnie ponownie uruchom claude w terminalu.

(Opcjonalnie) Inne sposoby konfiguracji modelu

Claude Code obsługuje następujące sposoby konfiguracji modelu, uporządkowane od najwyższego do najniższego priorytetu — ustawienie o wyższym priorytecie nadpisuje ustawienie o niższym priorytecie.

W trakcie rozmowy: uruchom polecenie /model <model-name>, aby przełączyć model. Dobre do jednorazowej zmiany.

/model claude-sonnet-5

Przy uruchamianiu Claude Code: uruchom claude --model <model-name>, aby wskazać model. Dobre dla pojedynczej sesji.

claude --model claude-sonnet-5

Ustaw zmienne środowiskowe: skonfiguruj modele różnych poziomów w zależności od złożoności zadań, a Claude Code automatycznie dobierze odpowiedni model do zadania. Działa globalnie.

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"

Gdzie:

ANTHROPIC_DEFAULT_OPUS_MODEL: do złożonego rozumowania, projektowania architektury i innych trudnych zadań.
ANTHROPIC_DEFAULT_SONNET_MODEL: do pisania kodu, implementowania funkcji i innych codziennych zadań.
ANTHROPIC_DEFAULT_HAIKU_MODEL: do sprawdzania składni, wyszukiwania plików i innych prostych zadań.

Ustaw na stałe w settings.json: zapisz konfigurację modelu w pliku konfiguracyjnym użytkownika Claude Code (np. ~/.claude/settings.json lub C:\Users\%USERNAME%\.claude\settings.json w systemie Windows) albo w konfiguracji na poziomie projektu, aby ustawić ją na stałe dla użytkownika lub projektu.

Konfiguracja przez CC Switch

Uruchom CC Switch, wybierz po lewej stronie Claude Code, a następnie kliknij „Dodaj dostawcę” (Add Provider).

Przycisk dodawania dostawcy na ekranie głównym CC Switch

Z listy gotowych ustawień wybierz jako dostawcę „Konfiguracja niestandardowa” (Custom Configuration).

Wybór Custom Configuration na liście predefiniowanych dostawców w CC Switch

Uzupełnij m.in. nazwę dostawcy, klucz API i endpoint (https://api.harogo.ai). Po wypełnieniu wszystkich pól kliknij „Dodaj” (Add).

Wpisywanie klucza API w formularzu konfiguracji dostawcy w CC Switch

Po powrocie na ekran główny wybierz z listy dostawców „harogo” i kliknij „Użyj” (Use).

Wybór harogo i kliknięcie Use na ekranie głównym CC Switch

Wskazówka: po otwarciu Claude Code w terminalu wpisz /status, aby sprawdzić identyfikator modelu, lub /models, aby wybrać inny skonfigurowany model.

Jeśli CC Switch wyświetla komunikat „Wykryto konflikt systemowych zmiennych środowiskowych” (System environment variable conflict detected), najpierw zajmij się zmiennymi ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL i ANTHROPIC_MODEL. Te zmienne globalne nadpisują bieżącą konfigurację dostawcy — wartość zastępcza, taka jak ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY>, od razu spowoduje błąd uwierzytelniania. Gdy masz pewność, że zmienne globalne nie są już potrzebne, usuń konfliktujące wpisy w CC Switch albo ręcznie usuń zmienne środowiskowe systemu lub użytkownika i uruchom ponownie terminal.

Pierwsze kroki

Szybki start

Cennik

1. Zainstaluj Claude Code

Instalacja lokalna

Instalacja przez npm

2. Skonfiguruj API Harogo

3. Sprawdź konfigurację

4. Zacznij korzystać z Claude Code

(Opcjonalnie) Inne sposoby konfiguracji modelu

Konfiguracja przez CC Switch

​1. Zainstaluj Claude Code

​Instalacja lokalna

​Instalacja przez npm

​2. Skonfiguruj API Harogo

​3. Sprawdź konfigurację

​4. Zacznij korzystać z Claude Code

​(Opcjonalnie) Inne sposoby konfiguracji modelu

​Konfiguracja przez CC Switch

1. Zainstaluj Claude Code

Instalacja lokalna

Instalacja przez npm

2. Skonfiguruj API Harogo

3. Sprawdź konfigurację

4. Zacznij korzystać z Claude Code

(Opcjonalnie) Inne sposoby konfiguracji modelu

Konfiguracja przez CC Switch