Skip to main content
CC Switch — кроссплатформенное desktop-приложение для управления providers в Claude Code, Claude Desktop, Codex, OpenCode и OpenClaw. На этой странице собраны расширенные настройки. Сначала используйте прямую настройку нужного инструмента, а CC Switch подключайте для смены provider или работы с неродной моделью.

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

Самый простой вариант — Homebrew. Также можно скачать актуальный .dmg или .zip из GitHub Releases.

​
Что подготовить

  • API Key BetterToken (зарегистрироваться)
  • Claude Code использует Anthropic-протокол, поэтому его Base URL — https://www.bettertoken.ai
  • Для Claude Desktop с провайдером, отличным от Claude, нужны последние версии Claude Desktop и CC Switch v3.16.5 или новее
  • Codex, OpenCode и OpenClaw используют OpenAI-compatible protocol, поэтому их Base URL — https://www.bettertoken.ai/v1
  • Подготовьте актуальный Model ID провайдера GPT для Codex, OpenCode и OpenClaw. Его можно скопировать из BetterToken model plaza или дать CC Switch получить его из /v1/models
При первом запуске CC Switch автоматически импортирует конфигурации, которые уже находит на вашей машине. Можно оставить официальный provider как fallback и добавить BetterToken рядом с ним.
BetterToken использует два режима доступа: Anthropic и OpenAI-compatible. Чтобы не смешивать https://www.bettertoken.ai и https://www.bettertoken.ai/v1, лучше создавать providers отдельно для каждого приложения, а не пытаться использовать один универсальный provider для Claude Code и OpenAI-compatible инструментов.

​
Добавьте provider BetterToken

1

Откройте Claude Code в CC Switch и добавьте provider

Откройте CC Switch, переключитесь на Claude Code и нажмите Add Provider.
Страница Claude Code в CC Switch, кнопка добавления provider в правом верхнем углу.
2

Заполните базовые поля

  • Provider Name: BetterToken-claude (или другое понятное имя для различения provider)
  • Base URL: https://www.bettertoken.ai
  • API Key: ваш API Key BetterToken
  • API Format: OpenAI Responses API
Нумерованные маркеры на скриншоте соответствуют этим полям:
  1. Provider Name
  2. API Key
  3. Base URL
Страница редактирования Claude Code provider в CC Switch с полями Provider Name, API Key и API Endpoint.
3

Настройте model mapping по провайдеру

  • Если вы используете провайдер Claude, обычно не нужно менять advanced options или model mapping
  • Если вы используете провайдер GPT, выполните дополнительную настройку ниже:
  1. Откройте Advanced Options
  2. Установите API Format в OpenAI Responses API
Advanced Options в CC Switch, API Format установлен в OpenAI Responses API.
  1. В Model Mapping нажмите Fetch Model List
  2. Явно выберите значения в dropdown для Primary Model, Thinking Model, Haiku Default Model, Sonnet Default Model и Opus Default Model
Раздел model mapping в CC Switch с Fetch Model List и mappings для Primary, Thinking, Haiku, Sonnet и Opus.
Все эти модели должны использовать актуальные model IDs провайдера GPT из BetterToken model plaza.
4

Сохраните, переключитесь и решите, нужен ли proxy

После сохранения вернитесь к списку providers:
  1. Отметьте provider BetterToken как активный
  2. Если вы используете провайдер Claude, включать CC Switch proxy в левом верхнем углу не нужно
  3. Если вы используете провайдер GPT, включите CC Switch proxy
На скриншоте ниже BetterToken-claude уже включен в списке providers. Включайте CC Switch proxy в левом верхнем углу только при использовании провайдера GPT.
Список providers CC Switch, где BetterToken-claude выбран и отмечен как In Use.

​
Как применить сохраненные изменения

После сохранения и переключения providers перезапустите затронутый client или gateway перед проверкой настройки.
  • Claude Code: полностью завершите текущую сессию Claude Code, затем запустите ее заново.
  • Claude Desktop: полностью закройте приложение, откройте его снова и убедитесь, что в левом нижнем углу отображается Gateway.
  • Codex: перезапустите текущий процесс Codex или откройте новую terminal session.
  • OpenCode: завершите текущую сессию OpenCode и запустите ее снова.
  • OpenClaw: выполните openclaw gateway restart, затем используйте /new, /status и /model в Discord.

​
Расширенные функции CC Switch

CC Switch может сохранять официальный вход Codex при переключении на сторонний provider и объединять официальные и сторонние сеансы в одной истории. После включения этих параметров перезапустите Codex. См. сохранение официального входа Codex и общей истории сеансов.

​
Частые проблемы

  • Не добавляйте /v1 к Claude Code Base URL
  • Когда Claude Code использует провайдера GPT, установите API Format в OpenAI Responses API в Advanced Options
  • Когда Claude Code использует провайдера Claude, включать CC Switch proxy не нужно
  • Для Claude Desktop с провайдером, отличным от Claude, включите CC Switch proxy и полностью перезапустите приложение
  • Codex, OpenCode и OpenClaw должны использовать https://www.bettertoken.ai/v1
  • Когда Codex, OpenCode или OpenClaw запрашивает модель, используйте Model ID провайдера GPT
  • Если Fetch Models не работает, проверьте API key и Base URL, затем вставьте model ID вручную
  • Если переключение не вступило в силу, убедитесь, что BetterToken активный provider в CC Switch, и перезапустите затронутый client или gateway, как описано выше

​
Смежные страницы

  • Подробно про Claude Code: Claude Code
  • Прямая настройка провайдера Claude в Claude Desktop: Claude Desktop
  • Подробно про Codex: Codex
  • Подробно про OpenCode: OpenCode
  • Подробно про OpenClaw: OpenClaw

​
Связанные FAQ