Перейти к содержанию

Настройка CC Switch

Когда использовать

CC Switch удобен, если вы переключаетесь между несколькими профилями для Claude Code и Codex.

Для Nexus удобно создать два отдельных профиля:

  • профиль для Claude Code;
  • профиль для Codex.

Установка CC Switch

CC Switch устанавливается как отдельное desktop-приложение. Перед настройкой профилей убедитесь, что у вас уже установлен нужный CLI-инструмент: Claude Code, Codex или другой поддерживаемый инструмент.

Официальный репозиторий: https://github.com/farion1231/cc-switch

Создание custom записи

  1. Нажмите + в основном окне.
  2. Выберите App-specific Provider, затем Claude Code или Codex.
  3. Введите API Key и Endpoint URL; не импортируйте готовую ссылку с key.
  4. Сохраните и активируйте запись. После переключения перезапустите CLI, если он не подхватил изменения.

Запись для Claude Code

Используйте Endpoint URL https://api.nexus-hub.ru. Официальное руководство CC Switch использует такой custom JSON:

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_NEXUS_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.nexus-hub.ru"
  }
}

Nexus также принимает ключ, заданный для Claude Code через ANTHROPIC_AUTH_TOKEN. Модель выбирайте только из GET /v1/models.

Запись для Codex

Используйте Endpoint URL https://api.nexus-hub.ru/v1 и модель из GET /v1/models. В CC Switch можно выбрать Fetch Models; согласно официальному руководству оно обращается к OpenAI-compatible /v1/models. Если запись создаётся вручную, Codex-конфигурация должна использовать Responses:

model = "MODEL_FROM_V1_MODELS"
model_provider = "nexus"

[model_providers.nexus]
name = "Nexus"
base_url = "https://api.nexus-hub.ru/v1"
env_key = "NEXUS_API_KEY"
wire_api = "responses"

Если CC Switch записывает ключ только в собственное хранилище, а не через переменную окружения, используйте прямую настройку Codex для более строгого контроля ключа.

После настройки

  1. Сохраните запись.
  2. Активируйте её в CC Switch.
  3. Выберите модель, которая есть в GET /v1/models для вашего ключа.
  4. Перезапустите CLI-инструмент, если он не подхватил изменения автоматически.

Диагностика и безопасность

  • Для Claude Code используйте базу https://api.nexus-hub.ru, для Codex — https://api.nexus-hub.ru/v1.
  • В каждом профиле выбирайте модель из GET /v1/models.
  • Если переключение не сработало, перезапустите CLI и проверьте активный профиль.
  • Не экспортируйте конфигурацию с key, не вставляйте его в screenshot и не прикладывайте к обращению в поддержку. Передавайте только x-request-id и код ошибки.

Официальные источники: CC Switch user manual и releases.