К содержимому

Подключение CC Switch к Relay

CC Switch , приложение для компьютера с открытым исходным кодом, которое в одной панели управляет конфигурацией провайдеров для Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw и Hermes Agent.

1. Установите CC Switch

Используйте версию 3.16.5 или новее.

Пользователи macOS могут установить через Homebrew:

plaintext
brew install --cask cc-switch

Либо скачайте установщик со страницы CC Switch Releases:

  • macOS: .dmg или .zip
  • Windows: установщик .msi или портативный .zip
  • Linux: .deb, .rpm или .AppImage

Если macOS Gatekeeper блокирует первый запуск, откройте System Settings → Privacy & Security и разрешите приложение.

2. Подключите Claude Code CLI

Установка Claude Code с нуля описана в Подключение Claude Code CLI к Relay.

Если CC Switch и Claude Code уже установлены, добавьте Relay как провайдера Claude Code:

Добавьте провайдера Relay

  1. Откройте CC Switch и перейдите на вкладку Claude Code.

Вкладка Claude Code в CC Switch

  1. Нажмите оранжевую кнопку «плюс» в правом верхнем углу.
  2. Найдите Relay в Preset providers или воспользуйтесь поиском.

Выбор пресета Relay

  1. Введите ваш API-ключ Relay.

Ввод API Key Relay

  1. Нажмите Add, чтобы сохранить.

Включите провайдера Relay

Вернитесь на вкладку Claude Code, нажмите Enable на карточке провайдера Relay и откройте Claude Code.

Включение Relay

3. Подключите Claude Desktop

Установите Claude Desktop со страницы загрузки Claude:

  • macOS: скачайте .dmg или выполните brew install --cask claude
  • Windows: скачайте и запустите установщик .exe

Если CC Switch и Claude Desktop уже установлены:

Добавьте провайдера Relay

  1. Откройте CC Switch и перейдите на вкладку Claude Desktop.
  2. Нажмите оранжевую кнопку «плюс» в правом верхнем углу.
  3. Найдите Relay в Preset providers или воспользуйтесь поиском.

Выбор Relay для Claude Desktop

  1. Введите ваш API-ключ.

Ввод API Key для Claude Desktop

  1. Нажмите Add, чтобы сохранить.

Включите провайдера Relay

Вернитесь на вкладку Claude Desktop и нажмите Enable на карточке провайдера Relay. CC Switch подтвердит переключение и напомнит, что Claude Desktop нужно перезапустить.

Включение Relay для Claude Desktop

Полностью перезапустите Claude Desktop перед использованием.

4. Подключите Codex

Установка Codex с нуля описана в Подключение Codex CLI к Relay.

Если CC Switch и Codex уже установлены:

Добавьте провайдера Relay

  1. Откройте CC Switch и перейдите на вкладку Codex.
  2. Нажмите Add provider.
  3. Найдите Relay в Preset providers или воспользуйтесь поиском.

Выбор Relay для Codex

  1. Вставьте API-ключ, созданный в консоли Relay.
  2. Нажмите Add, чтобы сохранить.

Включите провайдера Relay

Вернитесь на вкладку Codex и нажмите Enable на карточке провайдера Relay. Codex не переключает провайдеров «на лету», поэтому перезапустите запущенный процесс Codex в терминале.

5. Подключите Gemini CLI

Поддержка Gemini CLI в CC Switch пока в разработке.

6. Подключите OpenCode

См. Подключение OpenCode к Relay. CC Switch пока не поддерживает подключение OpenCode.

7. Подключите OpenClaw

См. Подключение OpenClaw к Relay.

8. Подключите Hermes Agent

Если CC Switch и Hermes Agent уже установлены, добавьте Relay как провайдера Hermes:

Добавьте провайдера Relay

  1. Откройте CC Switch и перейдите на вкладку Hermes.
  2. Нажмите Add provider.
  3. Заполните:
    1. Provider ID: relay
    2. Provider name: Relay
    3. Website (необязательно): https://relay-llm.ru
    4. API mode: оставьте OpenAI Chat Completions
    5. API endpoint: https://relay-llm.ru/v1
    6. API key: вставьте ключ, созданный в консоли Relay
  4. Загрузите список моделей Relay или добавьте модели вручную. Каждой модели нужны ID и отображаемое имя. Первая модель становится верхнеуровневым model.default; поставьте claude-haiku-5-5 первой, если хотите сделать её моделью по умолчанию.
  5. Нажмите Add, чтобы сохранить.

Включите провайдера Relay

Вернитесь на вкладку Hermes и нажмите Enable на карточке провайдера Relay. По умолчанию CC Switch записывает конфигурацию в ~/.hermes/config.yaml; путь можно изменить в настройках CC Switch. Полностью перезапустите процесс Hermes.

Переключитесь на Relay в Hermes

Выполните:

plaintext
hermes setup

В мастере выбора провайдера стрелками дойдите до пользовательского провайдера в конце списка:

plaintext
relay (relay-llm.ru/v1) - model-name

Нажмите Enter или Space, чтобы выбрать. У выбранной строки появится маркер активности. Затем выполните hermes, чтобы начать сессию.

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key