CC-Switch Полное руководство по добавлению провайдера: 4-шаговая инструкция по настройке на примере APIYI

После установки CC-Switch следующим шагом станет добавление вашего поставщика API. Многие новички спотыкаются на этом моменте: не знают, что именно заполнять, куда вписывать и как сделать так, чтобы всё заработало. В этой статье на примере APIYI (apiyi.com) мы подробно разберем процесс добавления, переключения, проверки скорости и возврата к стандартному входу.

Что вы узнаете: Прочитав этот материал, вы полностью освоите управление поставщиками в CC-Switch и сможете настроить всё за 3 минуты.

Подготовка перед добавлением провайдера в CC-Switch

Прежде чем приступать к настройке, убедитесь, что у вас всё под рукой:

Список необходимого

Регистрация аккаунта APIYI

Если у вас еще нет аккаунта APIYI, выполните следующие действия:

1. Перейдите на официальный сайт APIYI: apiyi.com.
2. Нажмите «Регистрация» и создайте аккаунт.
3. Зайдите в консоль управления и получите свой API-ключ.
4. Сохраните эти данные:
   • API Key: строка ключа, начинающаяся с sk-.
   • Base URL: https://api.apiyi.com.

🚀 Бонус для новичков: При регистрации на APIYI (apiyi.com) вы получаете бесплатный тестовый баланс. Сервис поддерживает Claude, GPT, Gemini и другие популярные Большие языковые модели, так что можно всё протестировать перед пополнением.

Проверка конфликтов переменных окружения

Важно: Если вы ранее настраивали API-ключи напрямую в системных переменных окружения, они могут перекрывать настройки CC-Switch.

Проверьте и очистите конфликтующие переменные:

macOS/Linux:

# Проверьте наличие конфликтующих переменных
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# Если они выводят значения, их нужно удалить из ~/.zshrc или ~/.bashrc

Windows:

• Откройте «Свойства системы → Дополнительно → Переменные среды».
• Найдите и удалите переменные вроде ANTHROPIC_API_KEY, OPENAI_API_KEY и т.д.

Инструкция по добавлению провайдера в CC-Switch

Шаг 1: Открываем интерфейс добавления провайдера

1. Запустите приложение CC-Switch.
2. На главном экране найдите кнопку «Add Provider» (обычно она расположена над списком провайдеров).
3. Нажмите на нее, чтобы открыть окно конфигурации.

Шаг 2: Выбираем способ настройки

CC-Switch предлагает два варианта добавления:

Так как APIYI является сторонним провайдером, мы выбираем «Custom».

Шаг 3: Заполняем данные провайдера

Это самый ответственный этап. Нужно точно заполнить следующие поля:

Основная информация

Настройка Claude Code (если используете)

CC-Switch позволяет настроить следующие поля специально для Claude Code:

Маппинг моделей (опционально)

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

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

Вот как выглядит заполненный профиль для провайдера APIYI:

# Основная информация
Name: APIYI
Base URL: https://api.apiyi.com

# Настройка Claude Code
ANTHROPIC_AUTH_TOKEN: sk-your-apiyi-key
ANTHROPIC_BASE_URL: https://api.apiyi.com

# Настройка моделей (опционально)
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key",
    "ANTHROPIC_API_KEY": "sk-your-apiyi-key",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  },
  "codex": {
    "OPENAI_API_KEY": "sk-your-apiyi-key",
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  },
  "gemini": {
    "GEMINI_API_KEY": "sk-your-apiyi-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

Шаг 4: Сохраняем настройки

1. Убедитесь, что все обязательные поля заполнены.
2. Нажмите кнопку «Save» или «Подтвердить».
3. CC-Switch проверит корректность формата данных.
4. После сохранения новый провайдер появится в вашем списке.

💡 Совет по настройке: API-интерфейс APIYI (apiyi.com) полностью совместим с форматами OpenAI и Anthropic. Поэтому в поле Base URL достаточно указать https://api.apiyi.com — добавлять в конце /v1 не нужно (CC-Switch подставит его автоматически там, где это необходимо).

3 способа смены провайдера в CC-Switch

После добавления нужно переключиться на нового провайдера, чтобы изменения вступили в силу. CC-Switch предлагает 3 способа переключения:

Способ 1: Переключение в главном интерфейсе (для новичков)

Это самый наглядный вариант:

1. Откройте список провайдеров в главном окне CC-Switch.
2. Найдите только что добавленный «APIYI».
3. Нажмите кнопку «Enable» или «Включить» справа от названия провайдера.
4. Когда статус сменится на Active, переключение завершено.

┌─────────────────────────────────────────────────┐
│            Список провайдеров CC-Switch          │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● APIYI (Active)          [Disable] [Test]    │  ← Сейчас активен
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

Способ 2: Переключение через системный трей (для продвинутых)

Более быстрый способ, не требующий открытия основного окна:

1. Найдите иконку CC-Switch в системном трее (в нижнем правом углу на Windows или в строке меню на macOS).
2. Кликните по иконке, чтобы развернуть меню.
3. Просто выберите в списке название провайдера «APIYI».
4. Изменения вступят в силу мгновенно, дополнительных подтверждений не требуется.

Плюс: Это самый быстрый способ, если вам нужно часто переключаться между разными провайдерами.

Способ 3: Настройка под конкретное приложение

Если вы используете несколько CLI-инструментов одновременно, можно назначить каждому свой провайдер:

В CC-Switch можно задать индивидуальные настройки провайдера для каждого приложения в отдельности.

Способы активации поставщика в CC-Switch

Важно: После смены поставщика настройки не вступят в силу в CLI-инструментах мгновенно. Вам потребуется перезапустить соответствующее приложение.

Инструкция по активации

Проверка активации настроек

После перезапуска вы можете проверить работу настроек следующими способами:

Способ 1: Прямая проверка в чате

claude
# Введите простой вопрос. Если придет ответ, значит, всё настроено верно.
> Hello, пожалуйста, ответь на русском языке.

Способ 2: Функция проверки скорости в CC-Switch

1. Нажмите кнопку «Test» рядом с именем поставщика.
2. Проверьте задержку (latency) и статус.
3. Зеленая галочка ✓ означает, что соединение установлено успешно.

Способ 3: Проверка конфигурационного файла

# Конфигурационный файл Claude Code
cat ~/.claude/settings.json

# Вы должны увидеть нечто подобное:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 Совет: В личном кабинете APIYI (apiyi.com) можно просмотреть логи вызовов API. Если вы видите там новые запросы, значит, конфигурация успешно вступила в силу.

Возврат к официальному входу через CC-Switch

Если вам нужно переключиться обратно на официальные сервисы, CC-Switch позволяет сделать это в один клик.

Возврат к официальному входу Claude Code

1. Найдите пресет «Official Login» в списке поставщиков CC-Switch.
2. Нажмите «Enable», чтобы переключиться в официальный режим.
3. Перезапустите терминал и выполните команду claude.
4. Следуйте официальной процедуре входа Claude Code (авторизация через OAuth).

Возврат к официальному входу Codex

1. Выберите пресет «Official Login» (версия для Codex).
2. Нажмите «Enable» (Включить).
3. После перезапуска выполните codex.
4. Завершите официальную аутентификацию OpenAI согласно подсказкам.

Возврат к официальному входу Gemini CLI

1. Выберите пресет «Google Official».
2. Нажмите «Enable» (Включить).
3. После перезапуска выполните gemini.
4. Пройдите стандартный процесс Google OAuth.

Резюме процесса восстановления

Примечание: При возврате к официальному входу CC-Switch автоматически сохранит резервную копию ваших кастомных настроек. Когда вы решите снова переключиться на стороннего поставщика, все ваши старые конфигурации будут на месте.

Продвинутые приемы управления провайдерами в CC-Switch

Прием 1: Сравнение скорости провайдеров

После добавления нескольких провайдеров можно провести массовый замер скорости, чтобы выбрать самый быстрый вариант:

1. Поочередно нажмите кнопку «Test» у каждого провайдера.
2. Запишите показатели задержки (latency) для каждого.
3. Выберите провайдера с минимальной задержкой в качестве основного.

Эталонные значения:

Прием 2: Дублирование провайдера

Если вам нужно создать провайдера с похожими настройками:

1. Выберите существующего провайдера.
2. Нажмите «Duplicate» или выберите «Копировать» в контекстном меню (правой кнопкой мыши).
3. Измените название и необходимые параметры.
4. Сохраните как нового провайдера.

Прием 3: Резервное копирование и синхронизация настроек

CC-Switch поддерживает облачную синхронизацию конфигураций:

1. Откройте Settings → Storage.
2. Выберите папку в облачном хранилище (например, Dropbox или OneDrive).
3. Все настройки провайдеров будут синхронизироваться автоматически.

Это позволит вам использовать идентичные конфигурации провайдеров на нескольких устройствах.

Прием 4: Общие настройки провайдера

Начиная с версии v3.9.0+, доступна функция «Общий провайдер» (Shared Provider):

• Одну конфигурацию провайдера можно применить одновременно к Claude, Codex и Gemini.
• Это удобно при использовании шлюзов вроде APIYI, которые поддерживают сразу несколько протоколов.
• При добавлении провайдера просто отметьте галочку «Sync to all apps».

Часто задаваемые вопросы по добавлению провайдеров в CC-Switch

Шпаргалка по настройке провайдера APIYI

Для быстрой настройки мы собрали все параметры APIYI в одной таблице:

Итоги

Из этого руководства вы узнали, как полностью управлять провайдерами в CC-Switch:

1. Добавление провайдера: Нажмите Add Provider → выберите Custom → заполните настройки → сохраните.
2. Переключение провайдера: Нажмите Enable в главном интерфейсе или выберите имя провайдера прямо в системном трее.
3. Как применить изменения: Перезапустите терминал или используемый CLI-клиент.
4. Возврат к официальным настройкам: Выберите пресет Official Login → перезагрузите → пройдите процесс OAuth-авторизации.

Связка CC-Switch + APIYI делает управление API максимально простым:

• CC-Switch: визуальное управление и переключение в один клик.
• APIYI apiyi.com: единый интерфейс, выгодные цены и поддержка множества моделей.

Заходите на APIYI apiyi.com прямо сейчас, чтобы получить API-ключ. Добавьте провайдера в CC-Switch и начните программировать с помощью ИИ на полную мощность!

📝 Автор: Техническая команда APIYI | APIYI apiyi.com — делаем работу с AI API проще.