Claude Code

У цьому посібнику використовуються лише моделі 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.

1. Встановлення Claude Code

Локальне встановлення

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

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

Встановлення через npm

Потрібен Node.js 18 або новіший

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

2. Налаштування Harogo API

Щоб підключитися до моделей Harogo через API, сумісний з Anthropic, задайте такі змінні середовища.

Задайте для ANTHROPIC_BASE_URL значення https://api.harogo.ai/
Задайте для ANTHROPIC_AUTH_TOKEN API-ключ, отриманий на платформі Harogo
Задайте для ANTHROPIC_MODEL модель Claude, яку підтримує Harogo, наприклад claude-sonnet-5.

macOS
Windows

Виконайте в терміналі таку команду, щоб дізнатися, яка оболонка використовується за замовчуванням.

echo $SHELL

Задайте змінні середовища залежно від типу оболонки:

# Замініть <HAROGO_API_KEY> на справжній ключ із платформи 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

# Замініть <HAROGO_API_KEY> на справжній ключ із платформи 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

Виконайте в терміналі таку команду, щоб застосувати змінні середовища.

source ~/.zshrc

source ~/.bash_profile

Відкрийте новий термінал і виконайте такі команди, щоб переконатися, що змінні середовища застосовано.

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

У Windows базовий URL Harogo та API-ключ можна задати як змінні середовища через CMD або PowerShell.

CMD
PowerShell

Виконайте в CMD таку команду, щоб задати змінні середовища.

REM Замініть <HAROGO_API_KEY> на справжній ключ із платформи Harogo
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

Відкрийте нове вікно CMD і виконайте такі команди, щоб переконатися, що змінні середовища застосовано.

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

Виконайте в PowerShell таку команду, щоб задати змінні середовища.

# Замініть <HAROGO_API_KEY> на справжній ключ із платформи 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)

Відкрийте нове вікно PowerShell і виконайте такі команди, щоб переконатися, що змінні середовища застосовано.

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

Якщо ви плануєте керувати Claude Code через CC Switch, радимо не задавати додатково глобальні ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL і ANTHROPIC_MODEL. Системні або користувацькі змінні середовища можуть перевизначати конфігурацію постачальника, яку записує CC Switch. У результаті в інтерфейсі вибрано правильного постачальника, а Claude Code насправді й далі працює зі старим ключем або старою моделлю.

3. Перевірка конфігурації

Після налаштування змінних середовища або CC Switch спершу надішліть один мінімальний запит, щоб переконатися, що ключ, модель і Anthropic-сумісний ендпоінт працюють, і лише потім починайте тривалу сесію.

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. Початок роботи з Claude Code

Після налаштування перейдіть до робочого каталогу та виконайте в терміналі команду claude.

$ 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

Знайдіть файл .claude.json у домашньому каталозі:
- macOS / Linux: ~/.claude.json
- Windows: C:\Users\%USERNAME%\.claude.json
Встановіть для поля hasCompletedOnboarding значення true

{
  "hasCompletedOnboarding": true
}

Збережіть файл і знову виконайте claude у терміналі.

(Необов’язково) Інші способи налаштування моделі

Claude Code підтримує такі способи налаштування моделі, перелічені від найвищого пріоритету до найнижчого: налаштування з вищим пріоритетом перевизначає налаштування з нижчим.

Під час діалогу: виконайте команду /model <model-name>, щоб змінити модель. Підходить для разового перемикання.

/model claude-sonnet-5

Під час запуску Claude Code: виконайте claude --model <model-name>, щоб вказати модель. Підходить для однієї сесії.

claude --model claude-sonnet-5

Через змінні середовища: налаштуйте моделі різних рівнів залежно від складності завдання, і Claude Code автоматично вибиратиме відповідну. Діє глобально.

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: для перевірки синтаксису, пошуку файлів та інших простих завдань.

Постійно в settings.json: запишіть конфігурацію моделі в користувацький файл конфігурації Claude Code (наприклад, ~/.claude/settings.json або C:\Users\%USERNAME%\.claude\settings.json у Windows) чи в конфігурацію проєкту, щоб закріпити налаштування на рівні користувача або проєкту.

Налаштування через CC Switch

Запустіть CC Switch, виберіть ліворуч Claude Code і натисніть «Додати постачальника» (Add Provider).

Кнопка додавання постачальника на головному екрані CC Switch

У списку пресетів виберіть як постачальника «Власна конфігурація» (Custom Configuration).

Вибір Custom Configuration у списку пресетів постачальників CC Switch

Вкажіть назву постачальника, API-ключ, ендпоінт (https://api.harogo.ai) та інші дані. Заповнивши всі поля, натисніть «Додати» (Add).

Введення API-ключа у формі налаштування постачальника в CC Switch

Поверніться на головний екран, виберіть «harogo» у списку постачальників і натисніть «Використати» (Use).

Вибір harogo і натискання Use на головному екрані CC Switch

Порада: відкривши Claude Code у терміналі, введіть /status, щоб переглянути ID моделі, або /models, щоб вибрати іншу налаштовану модель.

Якщо CC Switch показує «Виявлено конфлікт системних змінних середовища» (System environment variable conflict detected), спершу розберіться з ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL і ANTHROPIC_MODEL. Ці глобальні змінні перевизначають поточну конфігурацію постачальника, а значення-заглушка на кшталт ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY> одразу призведе до помилки автентифікації. Переконавшись, що глобальні змінні більше не потрібні, видаліть конфліктні записи в CC Switch або вручну видаліть системні/користувацькі змінні середовища та перезапустіть термінал.

Початок роботи

Швидкий старт

Ціни

1. Встановлення Claude Code

Локальне встановлення

Встановлення через npm

2. Налаштування Harogo API

3. Перевірка конфігурації

4. Початок роботи з Claude Code

(Необов’язково) Інші способи налаштування моделі

Налаштування через CC Switch

​1. Встановлення Claude Code

​Локальне встановлення

​Встановлення через npm

​2. Налаштування Harogo API

​3. Перевірка конфігурації

​4. Початок роботи з Claude Code

​(Необов’язково) Інші способи налаштування моделі

​Налаштування через CC Switch

1. Встановлення Claude Code

Локальне встановлення

Встановлення через npm

2. Налаштування Harogo API

3. Перевірка конфігурації

4. Початок роботи з Claude Code

(Необов’язково) Інші способи налаштування моделі

Налаштування через CC Switch