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

Настройка CC Switch

CC Switch хранит отдельные записи подключения для Claude Code и Codex. Для Nexus создайте по одной записи на каждый инструмент. Переключение активной записи не создаёт второй ключ Nexus и второй баланс.

Общий порядок — на странице подключения клиентов.

Значения

Запись Endpoint URL Протокол Переменная ключа
Claude Code https://api.nexus-hub.tech Anthropic Messages ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY
Codex https://api.nexus-hub.tech/v1 OpenAI Responses NEXUS_API_KEY

CC Switch ставят отдельным настольным приложением. CLI, которым вы хотите управлять, установите до добавления записи.

Шаги

  1. Нажмите + в главном окне.
  2. Выберите App-specific Provider, затем Claude Code или Codex.
  3. Введите API-ключ и endpoint URL из таблицы. Не импортируйте ссылку, в которой уже есть ключ.
  4. Сохраните и активируйте запись. Перезапустите CLI, если он не подхватил изменение.
  5. Выберите id модели из GET /v1/models для этого ключа.

Запись Claude Code

Endpoint URL — https://api.nexus-hub.tech, без /v1. Ключ введите в поле ключа CC Switch. В своём JSON задайте одну переменную, не обе:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nexus-hub.tech",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_NEXUS_API_KEY"
  }
}

ANTHROPIC_AUTH_TOKEN уходит как Authorization: Bearer. ANTHROPIC_API_KEY уходит как x-api-key. Nexus принимает любой из двух. Этот JSON не коммитьте.

Запись Codex

Endpoint URL — https://api.nexus-hub.tech/v1. Fetch Models вызывает OpenAI-совместимый /v1/models. Ручной файл Codex должен оставаться на Responses:

model = "MODEL_FROM_V1_MODELS"
model_provider = "nexus"

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

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

Проверка

Активируйте запись, перезапустите CLI и отправьте короткий запрос. Обычный ответ значит, что запись работает.

Если не работает

  • 401 или invalid_key: в активной записи один ключ, без лишних пробелов и без второй переменной ключа.
  • model_not_found или model_not_allowed: возьмите id из GET /v1/models.
  • unsupported_model: запись Codex не на Responses, или запись Claude использует id, который Messages не разрешает.
  • 404: у Claude Code в базе нет /v1. У Codex есть /v1.
  • Переключение не применилось: перезапустите CLI и проверьте активную запись.

В поддержку отправьте маршрут, код ошибки, время и x-request-id. Не экспортируйте профиль с ключом и не отправляйте ключ или полный текст запроса.

Официальные источники: руководство CC Switch и релизы.