> ## Documentation Index > Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code > Ten przewodnik pomoże Ci w kilka minut zacząć korzystać z Claude Code z modelami Harogo. > [!NOTE] > > **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](https://docs.harogo.ai/pl/codex.md). ### 1. Zainstaluj Claude Code #### Instalacja lokalna ```shellscript macOS theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` ```shellscript Windows theme={null} irm https://claude.ai/install.ps1 | iex ``` #### Instalacja przez npm Wymaga [Node.js w wersji 18 lub nowszej](https://nodejs.org/en/download/) ```shellscript theme={null} 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. 1. Ustaw `ANTHROPIC_BASE_URL` na `https://api.harogo.ai/` 2. Ustaw `ANTHROPIC_AUTH_TOKEN` na klucz API uzyskany na [platformie Harogo](https://console.harogo.ai/keys) 3. Ustaw `ANTHROPIC_MODEL` na model Claude obsługiwany przez Harogo, na przykład `claude-sonnet-5`. > [tab] macOS > > 1. Uruchom w terminalu następujące polecenie, aby sprawdzić domyślną powłokę. > > ```shellscript theme={null} > echo $SHELL > ``` > > 2. Ustaw zmienne środowiskowe odpowiednio do typu powłoki: > > ```shellscript Zsh theme={null} > # Zastąp prawdziwym kluczem z platformy Harogo > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.zshrc > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc > ``` > > ```shellscript Bash theme={null} > # Zastąp prawdziwym kluczem z platformy Harogo > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.bash_profile > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile > ``` > > 3. Uruchom w terminalu następujące polecenie, aby zastosować zmienne środowiskowe. > > ```shellscript Zsh theme={null} > source ~/.zshrc > ``` > > ```shellscript Bash theme={null} > source ~/.bash_profile > ``` > > 4. Otwórz nowy terminal i uruchom następujące polecenia, aby sprawdzić, czy zmienne środowiskowe zostały zastosowane. > > ```shellscript theme={null} > echo $ANTHROPIC_BASE_URL > test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" > echo $ANTHROPIC_MODEL > ``` > [tab] Windows > > W systemie Windows możesz ustawić Base URL Harogo i [klucz API](https://console.harogo.ai/keys) jako zmienne środowiskowe za pomocą CMD lub PowerShell. > > > [tab] CMD > > > > 1. Uruchom w CMD następujące polecenie, aby ustawić zmienne środowiskowe. > > > > ```shellscript theme={null} > > REM Zastąp prawdziwym kluczem z platformy Harogo > > setx ANTHROPIC_AUTH_TOKEN "" > > setx ANTHROPIC_BASE_URL "https://api.harogo.ai" > > setx ANTHROPIC_MODEL "claude-sonnet-5" > > ``` > > > > 2. Otwórz nowe okno CMD i uruchom następujące polecenia, aby sprawdzić, czy zmienne środowiskowe zostały zastosowane. > > > > ```shellscript theme={null} > > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set > > echo %ANTHROPIC_BASE_URL% > > echo %ANTHROPIC_MODEL% > > ``` > > > [tab] PowerShell > > > > 1. Uruchom w PowerShell następujące polecenie, aby ustawić zmienne środowiskowe. > > > > ```shellscript theme={null} > > # Zastąp prawdziwym kluczem z platformy Harogo > > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User) > > ``` > > > > 2. Otwórz nowe okno PowerShell i uruchom następujące polecenia, aby sprawdzić, czy zmienne środowiskowe zostały zastosowane. > > > > ```shellscript theme={null} > > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" } > > echo $env:ANTHROPIC_BASE_URL > > echo $env:ANTHROPIC_MODEL > > ``` > [!NOTE] > > 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. ```bash macOS/Linux theme={null} 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"}] }' ``` ```powershell Windows theme={null} 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ąć. ```bash theme={null} $ 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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c) 1. Znajdź plik `.claude.json` w katalogu domowym: * macOS / Linux: `~/.claude.json` * Windows: `C:\Users\%USERNAME%\.claude.json` 2. Ustaw pole `hasCompletedOnboarding` na `true` ```json theme={null} { "hasCompletedOnboarding": true } ``` 3. 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. 1. **W trakcie rozmowy:** uruchom polecenie `/model `, aby przełączyć model. Dobre do jednorazowej zmiany. ```text theme={null} /model claude-sonnet-5 ``` 2. **Przy uruchamianiu Claude Code:** uruchom `claude --model `, aby wskazać model. Dobre dla pojedynczej sesji. ```text theme={null} claude --model claude-sonnet-5 ``` 3. **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. ```shellscript theme={null} 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ń. 4. **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 1. 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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce) 2. Z listy gotowych ustawień wybierz jako dostawcę „Konfiguracja niestandardowa” (Custom Configuration). ![Wybór Custom Configuration na liście predefiniowanych dostawców w CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2) 3. Uzupełnij m.in. nazwę dostawcy, klucz API i endpoint ([https://api.harogo.ai](https://api.harogo.ai)). Po wypełnieniu wszystkich pól kliknij „Dodaj” (Add). ![Wpisywanie klucza API w formularzu konfiguracji dostawcy w CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751) 4. 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](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499) > ![Sprawdzanie konfiguracji modelu poleceniami status i models w terminalu Claude Code](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9) > > ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388) > > Wskazówka: po otwarciu Claude Code w terminalu wpisz /status, aby sprawdzić identyfikator modelu, lub /models, aby wybrać inny skonfigurowany model. > [!WARNING] > > 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=`, 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.