> ## 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 > Цей посібник допоможе вам за кілька хвилин почати працювати з Claude Code на базі Harogo. > [!NOTE] > > **У цьому посібнику використовуються лише моделі Claude.** Claude Code може запускати моделі Claude (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) та моделі без обмежень за клієнтом (GLM, Qwen, Kimi, MiniMax, DeepSeek). Моделі GPT у Claude Code недоступні — див. [Codex](https://docs.harogo.ai/uk/codex.md). ### 1. Встановлення Claude Code #### Локальне встановлення ```shellscript macOS theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` ```shellscript Windows theme={null} irm https://claude.ai/install.ps1 | iex ``` #### Встановлення через npm Потрібен [Node.js 18 або новіший](https://nodejs.org/en/download/) ```shellscript theme={null} npm install -g @anthropic-ai/claude-code ``` ### 2. Налаштування Harogo API Щоб підключитися до моделей Harogo через API, сумісний з Anthropic, задайте такі змінні середовища. 1. Задайте для `ANTHROPIC_BASE_URL` значення `https://api.harogo.ai/` 2. Задайте для `ANTHROPIC_AUTH_TOKEN` API-ключ, отриманий на [платформі Harogo](https://console.harogo.ai/keys) 3. Задайте для `ANTHROPIC_MODEL` модель Claude, яку підтримує Harogo, наприклад `claude-sonnet-5`. > [tab] macOS > > 1. Виконайте в терміналі таку команду, щоб дізнатися, яка оболонка використовується за замовчуванням. > > ```shellscript theme={null} > echo $SHELL > ``` > > 2. Задайте змінні середовища залежно від типу оболонки: > > ```shellscript Zsh theme={null} > # Замініть на справжній ключ із платформи 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} > # Замініть на справжній ключ із платформи 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. Виконайте в терміналі таку команду, щоб застосувати змінні середовища. > > ```shellscript Zsh theme={null} > source ~/.zshrc > ``` > > ```shellscript Bash theme={null} > source ~/.bash_profile > ``` > > 4. Відкрийте новий термінал і виконайте такі команди, щоб переконатися, що змінні середовища застосовано. > > ```shellscript theme={null} > echo $ANTHROPIC_BASE_URL > test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" > echo $ANTHROPIC_MODEL > ``` > [tab] Windows > > У Windows базовий URL Harogo та [API-ключ](https://console.harogo.ai/keys) можна задати як змінні середовища через CMD або PowerShell. > > > [tab] CMD > > > > 1. Виконайте в CMD таку команду, щоб задати змінні середовища. > > > > ```shellscript theme={null} > > REM Замініть на справжній ключ із платформи Harogo > > setx ANTHROPIC_AUTH_TOKEN "" > > setx ANTHROPIC_BASE_URL "https://api.harogo.ai" > > setx ANTHROPIC_MODEL "claude-sonnet-5" > > ``` > > > > 2. Відкрийте нове вікно CMD і виконайте такі команди, щоб переконатися, що змінні середовища застосовано. > > > > ```shellscript theme={null} > > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set > > echo %ANTHROPIC_BASE_URL% > > echo %ANTHROPIC_MODEL% > > ``` > > > [tab] PowerShell > > > > 1. Виконайте в PowerShell таку команду, щоб задати змінні середовища. > > > > ```shellscript theme={null} > > # Замініть на справжній ключ із платформи 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. Відкрийте нове вікно PowerShell і виконайте такі команди, щоб переконатися, що змінні середовища застосовано. > > > > ```shellscript theme={null} > > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" } > > echo $env:ANTHROPIC_BASE_URL > > echo $env:ANTHROPIC_MODEL > > ``` > [!NOTE] > > Якщо ви плануєте керувати Claude Code через CC Switch, радимо не задавати додатково глобальні `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` і `ANTHROPIC_MODEL`. Системні або користувацькі змінні середовища можуть перевизначати конфігурацію постачальника, яку записує CC Switch. У результаті в інтерфейсі вибрано правильного постачальника, а Claude Code насправді й далі працює зі старим ключем або старою моделлю. ### 3. Перевірка конфігурації Після налаштування змінних середовища або CC Switch спершу надішліть один мінімальний запит, щоб переконатися, що ключ, модель і Anthropic-сумісний ендпоінт працюють, і лише потім починайте тривалу сесію. ```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. Початок роботи з Claude Code Після налаштування перейдіть до робочого каталогу та виконайте в терміналі команду `claude`. ```bash theme={null} $ cd /path/your-project > claude ``` Якщо під час запуску з'являється `Not logged in · Please run /login` або відкривається процес входу в Anthropic, зазвичай це означає, що Claude Code не підхопив робочу конфігурацію Harogo або початкове налаштування ще не пройдено. Спершу переконайтеся, що мінімальний запит із попереднього кроку повертає `2`, і перевірте, чи не перевизначаються `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` або `ANTHROPIC_MODEL` старими глобальними змінними середовища. Якщо ключ точно працює, а вас усе одно перенаправляє на вхід, пропустіть початкове налаштування, виконавши кроки нижче: ![Термінал із запитом увійти або продовжити налаштування під час першого запуску 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. Знайдіть файл `.claude.json` у домашньому каталозі: * macOS / Linux: `~/.claude.json` * Windows: `C:\Users\%USERNAME%\.claude.json` 2. Встановіть для поля `hasCompletedOnboarding` значення `true` ```json theme={null} { "hasCompletedOnboarding": true } ``` 3. Збережіть файл і знову виконайте `claude` у терміналі. #### (Необов'язково) Інші способи налаштування моделі Claude Code підтримує такі способи налаштування моделі, **перелічені від найвищого пріоритету до найнижчого**: налаштування з вищим пріоритетом перевизначає налаштування з нижчим. 1. **Під час діалогу:** виконайте команду `/model `, щоб змінити модель. Підходить для разового перемикання. ```text theme={null} /model claude-sonnet-5 ``` 2. **Під час запуску Claude Code:** виконайте `claude --model `, щоб вказати модель. Підходить для однієї сесії. ```text theme={null} claude --model claude-sonnet-5 ``` 3. **Через змінні середовища:** налаштуйте моделі різних рівнів залежно від складності завдання, і Claude Code автоматично вибиратиме відповідну. Діє глобально. ```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" ``` Де: * `ANTHROPIC_DEFAULT_OPUS_MODEL`: для складних міркувань, проєктування архітектури та інших важких завдань. * `ANTHROPIC_DEFAULT_SONNET_MODEL`: для написання коду, реалізації функцій та інших повсякденних завдань. * `ANTHROPIC_DEFAULT_HAIKU_MODEL`: для перевірки синтаксису, пошуку файлів та інших простих завдань. 4. **Постійно в settings.json:** запишіть конфігурацію моделі в користувацький файл конфігурації Claude Code (наприклад, `~/.claude/settings.json` або `C:\Users\%USERNAME%\.claude\settings.json` у Windows) чи в конфігурацію проєкту, щоб закріпити налаштування на рівні користувача або проєкту. ## Налаштування через CC Switch 1. Запустіть CC Switch, виберіть ліворуч **Claude Code** і натисніть «Додати постачальника» (Add Provider). ![Кнопка додавання постачальника на головному екрані CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce) 2. У списку пресетів виберіть як постачальника «Власна конфігурація» (Custom Configuration). ![Вибір Custom Configuration у списку пресетів постачальників 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. Вкажіть назву постачальника, API-ключ, ендпоінт ([https://api.harogo.ai](https://api.harogo.ai)) та інші дані. Заповнивши всі поля, натисніть «Додати» (Add). ![Введення API-ключа у формі налаштування постачальника в 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. Поверніться на головний екран, виберіть «harogo» у списку постачальників і натисніть «Використати» (Use). ![Вибір harogo і натискання Use на головному екрані 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) > ![Перевірка конфігурації моделі командами status і models у терміналі 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) > > Порада: відкривши Claude Code у терміналі, введіть /status, щоб переглянути ID моделі, або /models, щоб вибрати іншу налаштовану модель. > [!WARNING] > > Якщо CC Switch показує «Виявлено конфлікт системних змінних середовища» (System environment variable conflict detected), спершу розберіться з `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` і `ANTHROPIC_MODEL`. Ці глобальні змінні перевизначають поточну конфігурацію постачальника, а значення-заглушка на кшталт `ANTHROPIC_AUTH_TOKEN=` одразу призведе до помилки автентифікації. Переконавшись, що глобальні змінні більше не потрібні, видаліть конфліктні записи в CC Switch або вручну видаліть системні/користувацькі змінні середовища та перезапустіть термінал. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.