Настройка CC Switch

CC Switch управляет локальными конфигурациями AI CLI. Добавьте NexusAPI вручную, выберите этот provider, затем откройте соответствующий CLI в новом терминале.

Подготовка

Нужны активный ключ, точный ID модели из его группы и endpoints:

Назначение	Endpoint
Claude Code	`https://nexusapi.link`
Codex	`https://nexusapi.link/v1`

Соответствие модели и протокола проверьте в матрице возможностей.

Консоль NexusAPI
→ Управление токенами
→ Создать или скопировать API-ключ

Установка CC Switch

macOS

brew install --cask cc-switch

После установки откройте CC Switch из Applications.

Windows

Скачайте .msi или portable .zip с официальных releases.

https://github.com/farion1231/cc-switch/releases

Linux

Скачайте .deb или .AppImage с официальных releases. В Arch Linux доступен поддерживаемый сообществом AUR-пакет:

https://github.com/farion1231/cc-switch/releases

paru -S cc-switch-bin

Используйте только официальный репозиторий CC Switch и его releases. Не используйте сторонние страницы, которые просят оплату или учётные данные NexusAPI.

Добавление provider

В Управлении provider → Добавить выберите приложение, введите endpoint, ключ и модель, сохраните и активируйте provider.

Открыть CC Switch
→ Добавить provider
→ Выбрать настраиваемое приложение
→ Указать NexusAPI endpoint, API-ключ и ID модели
→ Сохранить provider
→ Переключиться на него
→ Запустить соответствующий CLI в новом терминале

Официальный экран CC Switch для добавления provider; для NexusAPI выберите custom configuration

Официальный пример формы Provider CC Switch с замаскированным ключом

Изображения из официального репозитория CC Switch. URL, модель и имя gateway во втором примере не являются значениями NexusAPI.

Claude Code

Поле	Значение
App	`Claude Code`
Name	`NexusAPI Claude`
Endpoint	`https://nexusapi.link`
API Key	Ваш NexusAPI ключ
Primary model	Совместимый Claude ID из группы ключа

Необязательные поля Haiku, Sonnet и Opus можно оставить пустыми или заполнить доступными моделями. Минимальная конфигурация:

App: Claude Code
Name: NexusAPI Claude
Endpoint: https://nexusapi.link
API Key: YOUR_NEXUSAPI_KEY
Primary Model: YOUR_CLAUDE_MODEL_ID
Sonnet Model: YOUR_CLAUDE_MODEL_ID

В новых версиях выбирайте Claude Code; в старом UI он может называться Claude. Выбирайте Provider Claude Code, а не Claude Desktop, и не добавляйте /v1. После переключения откройте новый терминал:

claude

Проверьте /status и короткий запрос.

Представься одним предложением.

Codex

Поле	Значение
App	`Codex`
Name	`NexusAPI Codex`
Endpoint	`https://nexusapi.link/v1`
API Key	Ваш NexusAPI ключ
Primary model	ID модели Responses из группы

Минимальная конфигурация:

App: Codex
Name: NexusAPI Codex
Endpoint: https://nexusapi.link/v1
API Key: YOUR_NEXUSAPI_KEY
Primary Model: YOUR_CODEX_MODEL_ID

Codex использует протокол Responses, поэтому endpoint должен содержать /v1. После переключения выполните:

codex

Сначала сделайте read-only тест.

Проверка моделей текущего ключа

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

curl 'https://nexusapi.link/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Значения data[].id — это ID моделей, доступных именно этому ключу. Не угадывайте их по имени Provider или старому скриншоту.

Правила endpoint для инструментов

Инструмент	Endpoint
Claude Code	`https://nexusapi.link`
Codex	`https://nexusapi.link/v1`

Устранение проблем

После переключения всё ещё вызывается официальный адрес

Проверьте, что в CC Switch активен NexusAPI provider, откройте терминал заново и убедитесь, что локальная конфигурация целевого CLI не переопределяет настройки CC Switch.

API-ключ недействителен

Проверьте, что ключ создан в NexusAPI Token Management, включён, не истёк, имеет достаточный кредит и не заблокирован ограничением моделей. Копируйте ключ полностью, не добавляя и не угадывая префикс.

Модель недоступна

Проверьте группу, модельные ограничения и /v1/models для того же ключа. Если модели нет в ответе, не редактируйте CC Switch снова и снова: используйте видимую модель или обратитесь в поддержку с именем модели и Request ID. Для NexusAPI provider не входите в официальный аккаунт Claude. Вернитесь к NexusAPI provider в CC Switch и перезапустите терминал.

Начало работы

Модели и оплата

Клиентские инструменты

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

API для разработчиков

Настройка CC Switch

Подготовка

Установка CC Switch

macOS

Windows

Linux

Добавление provider

Claude Code

Codex

Проверка моделей текущего ключа

Правила endpoint для инструментов

Устранение проблем

После переключения всё ещё вызывается официальный адрес

API-ключ недействителен

Модель недоступна

Рекомендуемый порядок

​Подготовка

​Установка CC Switch

​macOS

​Windows

​Linux

​Добавление provider

​Claude Code

​Codex

​Проверка моделей текущего ключа

​Правила endpoint для инструментов

​Устранение проблем

​После переключения всё ещё вызывается официальный адрес

​API-ключ недействителен

​Модель недоступна

​Claude Code предлагает выполнить /login

​Рекомендуемый порядок

Подготовка

Установка CC Switch

macOS

Windows

Linux

Добавление provider

Claude Code

Codex

Проверка моделей текущего ключа

Правила endpoint для инструментов

Устранение проблем

После переключения всё ещё вызывается официальный адрес

API-ключ недействителен

Модель недоступна

Claude Code предлагает выполнить `/login`

Рекомендуемый порядок