как настроить API в CC Switch

Рекомендуемый вариант — импорт из консоли 穷哥么: CC Switch безопасно получает поставщика, endpoint, модель и API Key. Ниже также приведена ручная настройка на случай ошибки импорта.

Краткая настройка

Рекомендуемая страница
https://qionggeme.com/console/token
В меню действий строки API Key выберите «CC Switch»
Протокол импорта
ccswitch://v1/import
Ссылка может содержать API Key: не отправляйте её в публичные чаты, заявки и снимки экрана
Codex Endpoint
https://qionggeme.com/v1
Нативный Responses, локальное преобразование маршрута не требуется
Claude / Gemini Endpoint
https://qionggeme.com
Состояние импорта
enabled=true
После импорта всё равно проверьте, что целевой поставщик включён

Перед началом:

Используйте готовый импорт из консоли и не собирайте Deep Link вручную. Параметры Deep Link могут содержать API Key открытым текстом: не делитесь ссылкой, не пересылайте её и не публикуйте снимки экрана с Key.

Порядок настройки

  1. Откройте страницу API Key 穷哥么

    Перейдите на https://qionggeme.com/console/token, найдите нужный API Key и выберите «CC Switch» в меню действий этой строки. Не копируйте из адресной строки браузера последующую ссылку с секретом.

  2. Выберите приложение, имя поставщика и основную модель

    В диалоге выберите Claude, Codex или Gemini, задайте понятное имя поставщика и основную модель. ID должен полностью совпадать с текущей моделью на странице цен.

  3. Нажмите «Open CC Switch»

    Консоль создаст Deep Link ccswitch://v1/import и предложит открыть CC Switch. Сгенерированные данные содержат apiKey, model, homepage и enabled=true. Для Codex поле endpoint равно https://qionggeme.com/v1, для Claude / Gemini — https://qionggeme.com.

  4. Подтвердите импорт в CC Switch

    CC Switch покажет предварительный просмотр. Проверьте тип приложения, имя поставщика, endpoint и модель, затем подтвердите. Официальный протокол требует показать конфигурацию и получить явное согласие; при недоверенном источнике или странных полях отмените импорт.

  5. Проверьте включение поставщика и перезапустите целевой CLI

    Вернитесь к списку поставщиков нужного приложения и убедитесь, что импортированный поставщик включён. Если Claude Code, Codex или Gemini CLI уже работал до импорта, полностью закройте и снова запустите CLI. Для Codex официальная инструкция прямо требует после переключения закрыть и заново открыть терминал.

  6. Если импорт не сработал, добавьте поставщика вручную

    Добавьте пользовательского поставщика на вкладке соответствующего приложения CC Switch:

    • Вкладка Codex: endpoint https://qionggeme.com/v1, собственный API Key и модель; нативный responses, локальное преобразование маршрута не требуется.
    • Вкладка Claude: endpoint https://qionggeme.com, собственный API Key и модель; сохраните и включите поставщика.

    Даже при ручной настройке нельзя использовать адрес сайта документации или добавлять /docs к API endpoint.

Пример конфигурации

# Безопасная памятка: настоящий API Key и полный Deep Link не показываются
Протокол: ccswitch://v1/import
resource: provider
Codex endpoint: https://qionggeme.com/v1
Claude/Gemini endpoint: https://qionggeme.com
Поля: apiKey, model, homepage, enabled=true

# Ручной резервный вариант для Codex
Base URL: https://qionggeme.com/v1
Wire API: responses
Локальное преобразование маршрута: не требуется

Устранение неполадок

После «Open CC Switch» приложение не открылось

Убедитесь, что CC Switch установлен и хотя бы раз запускался. При установке регистрируется протокол ccswitch://. Если регистрация нарушена, переустановите приложение или восстановите протокол по официальной документации, затем повторите импорт со страницы API Key.

CC Switch сообщает об ошибке импорта или отсутствующих полях

Не редактируйте ссылку с Key вручную. Вернитесь в консоль, заново выберите приложение, имя и модель. Если ошибка остаётся, используйте ручную настройку. Endpoint должен быть https://qionggeme.com/v1 или https://qionggeme.com без /docs.

Импорт успешен, но CLI использует старого поставщика

Проверьте, что новый поставщик включён в CC Switch, затем полностью завершите и перезапустите целевой CLI. Для Codex закройте текущее окно терминала и откройте новое.

Codex не работает или кажется, что нужен локальный маршрут

Проверьте endpoint https://qionggeme.com/v1 и нативный протокол responses. Для qionggeme локальное преобразование CC Switch не требуется; оно нужно только вышестоящим API без нативного Responses, например только с Chat Completions или Anthropic Messages.

Ошибка 401, недостаточный баланс или модель не существует

Проверьте API Key, разрешения токена и баланс, а также ID модели на странице цен. Не отправляйте Key или Deep Link с Key в публичный канал при обращении за помощью.

Готовы начать?

Зарегистрируйтесь в 穷哥么, получите API Key и сразу используйте все доступные модели

Зарегистрироваться

Частые вопросы

Какие поля импортируются в CC Switch?

Импорт поставщика qionggeme содержит apiKey, model, homepage, enabled=true и endpoint по приложению: https://qionggeme.com/v1 для Codex, https://qionggeme.com для Claude/Gemini.

Можно ли отправить ссылку ccswitch:// другому человеку?

Нет, если она содержит API Key. Секрет может попасть в публичный чат, заявку, снимок экрана, синхронизацию истории браузера или журнал. Для совместной работы удалите чувствительные поля и попросите другого пользователя указать собственный Key.

Почему Codex не требует локального преобразования маршрута?

Endpoint qionggeme https://qionggeme.com/v1 нативно поддерживает Responses. Достаточно Base URL, API Key и модели; локальная конвертация нужна только API без Responses.

Почему импорт не вступил в силу сразу?

Сначала убедитесь, что поставщик включён. Работающий CLI может хранить старую конфигурацию, поэтому его нужно перезапустить; для Codex официальная инструкция требует закрыть и заново открыть терминал.

Можно ли указать API endpoint с /docs?

Нет. Codex использует https://qionggeme.com/v1, Claude/Gemini — https://qionggeme.com; в API endpoint никогда не должно быть /docs.