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