ДокументацияНачало работыДля новичков: CC Switch

Для новичков: CC Switch

Подключите Claude Code / Codex к SoleAPI через GUI — без конфигов и переменных окружения.

Если вам не хочется править конфигурационные файлы, используйте открытое настольное приложение CC Switch: это визуальный менеджер «провайдеров» для Claude Code, Codex, Gemini CLI и других AI-инструментов. Введите base URL и ключ один раз — и переключайтесь между официальным API и SoleAPI в один клик, без ручной настройки.

Подготовка: получите API-ключ

Зарегистрируйтесь в SoleAPI и создайте ключ (вида sk-sole-…) на странице «API Key» в консоли — см. Быстрый старт.

Полный ключ показывается только один раз при создании — скопируйте и сохраните его, прежде чем идти дальше.

Шаг 1: установите CC Switch

macOS: выполните команду ниже или скачайте .dmg со страницы Releases.

bash

brew install --cask cc-switch

Windows: скачайте MSI-установщик (или портативный ZIP) со страницы Releases.
Linux: в Releases есть пакеты .deb / .rpm / AppImage.
Официальная страница загрузки: ccswitch.io/download (свежие сборки для всех платформ)

Шаг 2: импортируйте SoleAPI одним кликом

На странице API Key в консоли есть кнопка Импорт в CC Switch — в диалоге сразу после создания ключа и в строке каждого существующего ключа. По клику откроется локальный CC Switch с предпросмотром конфигурации; подтвердите — и провайдер добавлен, Base URL и ключ заполнены автоматически.

Для импорта в один клик нужен CC Switch v3.16 или новее (с поддержкой deeplink ccswitch://). Если по клику ничего не происходит, убедитесь, что CC Switch установлен и запускался хотя бы один раз.

У импортированных провайдеров отображение расхода в CC Switch включается автоматически: в списке видны баланс и суммарные траты, данные берутся из GET https://api.soleapi.com/v1/usage (авторизация вашим API-ключом; возвращает remaining / used / total / unit, единица — Credits). При ручном добавлении включите его, указав этот URL в настройках расхода провайдера.

Добавить вручную (запасной вариант)

Если импорт в один клик недоступен, заполните вручную:

Откройте CC Switch и выберите вкладку нужного инструмента (например, Claude Code).
Нажмите «Add Provider», выберите пользовательскую конфигурацию и заполните поля:

Инструмент	Base URL	API-ключ
Claude Code	`https://api.soleapi.com`	`sk-sole-…`
Codex	`https://api.soleapi.com/v1`	`sk-sole-…`

Назовите запись как угодно (например, SoleAPI) и сохраните.

Без завершающего слеша в base URL: вариант https://api.soleapi.com/ приведёт к двойному слешу при сборке путей и ошибкам.

Шаг 3: включите и проверьте

Выберите запись SoleAPI в списке и нажмите «Enable» — CC Switch сам запишет настройки в конфигурационный файл инструмента.
Перезапустите терминал (или CLI-инструмент), чтобы изменения вступили в силу; Claude Code поддерживает горячее переключение и обычно перезапуска не требует.
Отправьте любое сообщение в Claude Code — нормальный ответ означает, что подключение работает. Ключ можно проверить и напрямую:

bash

curl https://api.soleapi.com/v1/models \
  -H "Authorization: Bearer sk-sole-your-key"

Чтобы позже вернуться на официальный API (или другого провайдера), просто кликните нужную запись в списке CC Switch или в меню системного трея — переключаться можно сколько угодно.

Частые проблемы

Ошибка 401: ключ скопирован не полностью или отключён — проверьте его в консоли; подробности в разделе Ошибки.
Двойной слеш (//v1) в тексте ошибки: удалите / в конце base URL и включите провайдера заново.
Переключение не сработало: перезапустите терминал и убедитесь, что провайдер помечен в CC Switch как включённый.
Ничего не происходит при клике «Импорт в CC Switch»: CC Switch не установлен, старее v3.16 или ни разу не запускался (протокол не зарегистрирован); установите/запустите и попробуйте снова.

CC Switch — сторонний open-source-инструмент, не связанный с SoleAPI. Не хотите ставить настольное приложение? Ручная настройка так же проста — см. Быстрый старт.