Подключение CC Switch
Сложность 🧩 Средняя | Формат API Claude | base_url
https://byesu.com
https://byesu.comclaude-opus-4-8CC Switch — это открытый кроссплатформенный инструмент для единого управления AI CLI. Он позволяет в один клик переключаться между разными поставщиками API в Claude Code, Codex и Gemini CLI без необходимости вручную менять переменные окружения или файлы конфигурации. Подключив Byesu API, вы сможете в любой момент переключаться на канал byesu прямо из этого инструмента.
Перед началом
Сначала зайдите в Консоль → Токены и создайте новый токен (вида sk-xxxx), а также выберите для токена правильную группу — группа определяет, какие модели вы сможете вызывать и по какому маршруту пойдёт запрос. Если не знаете, как выбрать, смотрите Выбор группы.
CC Switch управляет CLI вроде Claude Code, поэтому Claude Code использует формат API Anthropic, а в качестве base_url применяется https://byesu.com (без /v1).
Шаг 1: Установка CC Switch
Официальная загрузка: GitHub Releases (установщики для Windows / macOS / Linux) · сайт ccswitch.io
Выберите способ установки в зависимости от вашей системы:
brew tap farion1231/ccswitch
brew install --cask cc-switchСкачайте MSI-установщик из GitHub Releases или возьмите portable ZIP — распакуйте и пользуйтесь.# Скачайте из GitHub Releases пакет DEB / AppImage / RPM
# На ArchLinux установите из AUR:
paru -S cc-switch-binПосле установки откройте CC Switch и в левом верхнем углу переключитесь на категорию Claude (Claude Code).
Шаг 2: Добавление поставщика byesu
Способ 1: Импорт в один клик (самый быстрый)
Если вы работаете в консоли Byesu, можно сразу импортировать через глубокую ссылку ccswitch://, чтобы не заполнять всё вручную:
- Зайдите в Консоль → Токены и в выпадающем меню нужного токена выберите CC Switch.
- В появившемся окне конфигурации:
- Тип приложения: выберите Claude
- Название конфигурации: любое, например
byesu - Основная модель (обязательно): выберите
claude-opus-4-8 - Модель Opus:
claude-opus-4-8 - Модель Sonnet / Модель Haiku: по желанию, выберите другие доступные модели по необходимости
- Нажмите Открыть CC Switch — конфигурация импортируется автоматически.
Проверьте base_url и токен
Импорт в один клик автоматически подставит адрес API byesu и ключ вашего токена. После импорта зайдите в детали поставщика и убедитесь, что base_url равен https://byesu.com (формат Anthropic, без /v1).
Способ 2: Добавление вручную
В категории Claude в CC Switch нажмите «Добавить поставщика» и заполните поля по таблице ниже:
| Поле | Что вписать |
|---|---|
| Название (Name) | byesu (произвольное) |
Адрес API / Base URL (соответствует ANTHROPIC_BASE_URL) | https://byesu.com |
API Key / Auth Token (соответствует ANTHROPIC_AUTH_TOKEN) | sk-xxxx (ваш токен byesu) |
| Основная модель / Opus | claude-opus-4-8 |
| Sonnet | claude-opus-4-8 (или другая доступная модель) |
| Haiku | можно оставить по умолчанию или выбрать лёгкую модель |
Имя модели должно быть реально доступным в byesu
Например, claude-opus-4-8. Все три уровня Claude Code — Opus/Sonnet/Haiku — могут указывать на одну и ту же или на разные модели в byesu; главное, чтобы группа, к которой относится ваш токен, поддерживала выбранную модель.
После сохранения нажмите на эту запись byesu в списке поставщиков — CC Switch запишет её в конфигурацию Claude Code (переменные окружения ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN).
Шаг 3: Проверка работоспособности
- В CC Switch переключите текущего поставщика на
byesu. - Откройте новый терминал и запустите Claude Code:
claude- Задайте любой вопрос, например «Привет, назови модель, которую ты используешь». Если приходит нормальный ответ и нет ошибки аутентификации — значит, соединение с byesu установлено.
Если Claude Code был открыт ранее, после переключения поставщика перезапустите терминал и запустите снова, чтобы новые переменные окружения вступили в силу.
Застряли?
- Ошибка 401 / сбой аутентификации: токен введён неправильно или содержит лишние пробелы; убедитесь, что ключ имеет вид
sk-xxxx. Смотрите Частые ошибки #auth. - Сообщение об отсутствии доступного канала / no channel: в группе текущего токена нет этой модели. Смените группу на ту, что поддерживает данную модель, либо используйте модель из текущей группы. Смотрите Выбор группы и Частые ошибки #no-channel.
- Недостаточно средств / balance: не хватает квоты токена или баланса аккаунта. Смотрите Частые ошибки #balance.
- Переключили поставщика, но эффекта нет: переменные окружения не обновляются автоматически в уже открытом терминале; перезапустите терминал и попробуйте снова.
Больше способов диагностики смотрите в разделе Частые ошибки.
