> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Расширенная настройка provider BetterToken в CC Switch

> Управляйте provider BetterToken, model mappings и proxy для Claude Code, Claude Desktop, Codex CLI, OpenCode и OpenClaw через CC Switch.

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

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

<Tabs>
  <Tab title="macOS">
    Самый простой вариант — Homebrew. Также можно скачать актуальный `.dmg` или `.zip` из [GitHub Releases](https://github.com/farion1231/cc-switch/releases).

    ```bash theme={null}
    brew tap farion1231/ccswitch
    brew install --cask cc-switch
    ```
  </Tab>

  <Tab title="Windows">
    Скачайте актуальный installer `CC-Switch-v{version}-Windows.msi` или portable `.zip` build из [GitHub Releases](https://github.com/farion1231/cc-switch/releases).
  </Tab>

  <Tab title="Linux">
    Скачайте актуальный `.deb`, `.rpm` или `.AppImage` build из [GitHub Releases](https://github.com/farion1231/cc-switch/releases).
  </Tab>
</Tabs>

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

* API Key BetterToken (<a href={"https://bettertoken.ai/register"}>зарегистрироваться</a>)
* 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. Его можно скопировать из <a href={"https://bettertoken.ai/pricing"}>BetterToken model plaza</a> или дать CC Switch получить его из `/v1/models`

<Info>
  При первом запуске CC Switch автоматически импортирует конфигурации, которые уже находит на вашей машине. Можно оставить официальный provider как fallback и добавить BetterToken рядом с ним.
</Info>

<Note>
  BetterToken использует два режима доступа: Anthropic и OpenAI-compatible. Чтобы не смешивать `https://www.bettertoken.ai` и `https://www.bettertoken.ai/v1`, лучше создавать providers отдельно для каждого приложения, а не пытаться использовать один универсальный provider для Claude Code и OpenAI-compatible инструментов.
</Note>

## Добавьте provider BetterToken

<Tabs>
  <Tab title="Claude Code" id="claude-code">
    <Steps>
      <Step title="Откройте Claude Code в CC Switch и добавьте provider">
        Откройте CC Switch, переключитесь на **Claude Code** и нажмите **Add Provider**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=517f215f5f828187647dd214eacfe19b" alt="Страница Claude Code в CC Switch, кнопка добавления provider в правом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Заполните базовые поля">
        * **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**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=514944678fb16510d03f0f2610bd8b70" alt="Страница редактирования Claude Code provider в CC Switch с полями Provider Name, API Key и API Endpoint." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Настройте model mapping по провайдеру">
        * Если вы используете провайдер **Claude**, обычно не нужно менять advanced options или model mapping
        * Если вы используете провайдер **GPT**, выполните дополнительную настройку ниже:

        1. Откройте **Advanced Options**
        2. Установите **API Format** в **OpenAI Responses API**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5605667b764f033854f78dc981592f84" alt="Advanced Options в CC Switch, API Format установлен в OpenAI Responses API." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-api-format.png" />
        </Frame>

        3. В **Model Mapping** нажмите **Fetch Model List**
        4. Явно выберите значения в dropdown для **Primary Model**, **Thinking Model**, **Haiku Default Model**, **Sonnet Default Model** и **Opus Default Model**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=d1104cc24dae2825dfed3a6be53dc6b3" alt="Раздел model mapping в CC Switch с Fetch Model List и mappings для Primary, Thinking, Haiku, Sonnet и Opus." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-model-mapping.png" />
        </Frame>

        Все эти модели должны использовать актуальные model IDs провайдера **GPT** из <a href={"https://bettertoken.ai/pricing"}>BetterToken model plaza</a>.
      </Step>

      <Step title="Сохраните, переключитесь и решите, нужен ли proxy">
        После сохранения вернитесь к списку providers:

        1. Отметьте provider BetterToken как активный
        2. Если вы используете провайдер **Claude**, включать **CC Switch proxy** в левом верхнем углу не нужно
        3. Если вы используете провайдер **GPT**, включите **CC Switch proxy**

        На скриншоте ниже BetterToken-claude уже включен в списке providers. Включайте **CC Switch proxy** в левом верхнем углу только при использовании провайдера **GPT**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=13c9adc5d76d5a2d1fae0e52e90a87ca" alt="Список providers CC Switch, где BetterToken-claude выбран и отмечен как In Use." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-enable-proxy.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Desktop" id="claude-desktop">
    <Info>
      Эта вкладка предназначена для GPT, Kimi, GLM и других провайдеров, отличных от Claude. Для провайдера Claude используйте [прямую настройку Claude Desktop](/faq/claude-desktop-bettertoken-api).
    </Info>

    <Steps>
      <Step title="Откройте Claude Desktop в CC Switch и добавьте provider">
        Откройте CC Switch, выберите значок **Claude Desktop** на верхней панели и нажмите **+** в правом верхнем углу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/cc-switch-claude-desktop-add-provider.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=8906aaf8ead247cf406a55a51f402bdf" alt="Переход к Claude Desktop в CC Switch и добавление provider кнопкой в правом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/cc-switch-claude-desktop-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Заполните основные поля">
        * **Provider Name**: понятное имя, например `BetterToken-GPT`
        * **API Key**: ваш API Key BetterToken
        * **API Endpoint**: `https://www.bettertoken.ai`

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-basic-fields.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=ba55f76085a213cde6527e86aca54798" alt="Основные поля Provider Name, API Key и API Endpoint для Claude Desktop в CC Switch." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Настройте API Format и model mapping">
        В **API Format** выберите **OpenAI Responses API (Requires routing)**, затем нажмите **Fetch Models**.

        Сопоставьте Sonnet, Opus, Fable и Haiku с нужным Model ID:

        | Model role | Requested model |
        | ---------- | --------------- |
        | Sonnet     | `YOUR_MODEL_ID` |
        | Opus       | `YOUR_MODEL_ID` |
        | Fable      | `YOUR_MODEL_ID` |
        | Haiku      | `YOUR_MODEL_ID` |

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-model-mapping.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=d93c1bd4098f1f839cd2ab6a426d1aba" alt="OpenAI Responses API и сопоставление моделей Claude Desktop в CC Switch." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-model-mapping.png" />
        </Frame>

        Скопируйте актуальный Model ID из <a href={"https://bettertoken.ai/pricing"}>model plaza</a> или окна **Setup** для API Key. Включайте **Declare 1M** только для модели, у которой в model plaza указано контекстное окно 1M.
      </Step>

      <Step title="Сохраните, переключите provider и включите proxy">
        Сохраните provider, отметьте его как **In use** и включите proxy switch в левом верхнем углу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-enable-proxy.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=99800d159627886f2e999f9eceb061bf" alt="Provider BetterToken для Claude Desktop активен, proxy CC Switch включен." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-enable-proxy.png" />
        </Frame>
      </Step>

      <Step title="Перезапустите Claude Desktop">
        Полностью закройте Claude Desktop и откройте его снова. Надпись **Gateway** в левом нижнем углу подтверждает, что настройка активна. Выберите сопоставленную модель в меню рядом с полем ввода.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/claude-desktop-gateway-ready.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=bf573497e7a842b367f6c9ca95fdc99b" alt="Claude Desktop после перезапуска показывает Gateway и модели, сопоставленные через CC Switch." style={{ borderRadius: '0.5rem' }} width="2400" height="1600" data-path="images/claude-desktop-third-party-models/claude-desktop-gateway-ready.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Codex" id="codex-cli">
    <Steps>
      <Step title="Откройте Codex в CC Switch и добавьте provider">
        Откройте CC Switch, переключитесь на **Codex** и нажмите **Add Provider**. Если CC Switch сначала просит выбрать preset, предпочитайте **OpenAI Compatible** или **Custom**.

        Нумерованные маркеры на скриншоте соответствуют этим действиям:

        1. Переключитесь на **Codex**
        2. Нажмите **Add Provider** в правом верхнем углу

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=5f892bf124c432babed54886c6051632" alt="Страница Codex в CC Switch, Codex выбран сверху, а кнопка add в правом верхнем углу используется для создания provider." style={{ borderRadius: '0.5rem' }} width="1800" height="1532" data-path="images/cc-switch/codex-cli-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Заполните базовые поля">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: ваш API Key BetterToken

        Если вы переключитесь в custom config view, убедитесь, что базовая конфигурация использует `wire_api = "responses"`.

        Нумерованные маркеры на скриншоте соответствуют этим полям:

        1. **Provider Name**
        2. **API Key**
        3. **Base URL**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/codex-cli-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=a6483a11bcf6eaf3663134f407843391" alt="Страница редактирования Codex provider в CC Switch с полями Provider Name, API Key и Base URL." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/codex-cli-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Получите и сопоставьте модель">
        Нажмите **Fetch Models** и выберите актуальный Model ID из <a href={"https://bettertoken.ai/pricing"}>model plaza</a>. Для Codex proxy CC Switch не нужен.
      </Step>

      <Step title="Сохраните и переключитесь">
        Сохраните provider и переключите Codex на BetterToken. CC Switch сам запишет соответствующие Codex auth и config files.

        После сохранения вернитесь к списку и убедитесь, что запись BetterToken отмечена как **In Use**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/cc-switch/codex-cli-activate-provider.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=52dc850977af1443b4b573a27726c4b5" alt="Список Codex providers в CC Switch, BetterToken выбран и отмечен как in use." style={{ borderRadius: '0.5rem' }} width="1800" height="1686" data-path="images/cc-switch/codex-cli-activate-provider.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode" id="opencode">
    <Steps>
      <Step title="Откройте OpenCode в CC Switch и добавьте provider">
        Откройте CC Switch, переключитесь на **OpenCode** и нажмите **Add Provider**. Если CC Switch сначала просит preset, предпочитайте **OpenAI Compatible** или **Custom**.
      </Step>

      <Step title="Заполните базовые поля">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: ваш API Key BetterToken
        * **API Format**: `OpenAI Compatible`
      </Step>

      <Step title="Выберите модель по умолчанию">
        Используйте **Fetch Models**, когда это возможно. Если модель нужно ввести вручную, используйте актуальный Model ID провайдера **GPT** из <a href={"https://bettertoken.ai/pricing"}>BetterToken model plaza</a>.

        OpenCode читает сохраненную конфигурацию provider напрямую, поэтому proxy CC Switch не требуется.
      </Step>

      <Step title="Сохраните и переключитесь">
        Сохраните provider и переключите OpenCode на BetterToken.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenClaw" id="openclaw">
    <Steps>
      <Step title="Откройте OpenClaw в CC Switch и добавьте provider">
        Откройте CC Switch, переключитесь на **OpenClaw** и нажмите **Add Provider**. Если CC Switch сначала просит preset, предпочитайте **OpenAI Compatible** или **Custom**.
      </Step>

      <Step title="Заполните базовые поля">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: ваш API Key BetterToken
        * **API Format**: `OpenAI Responses API`

        Если вы редактируете custom OpenClaw provider config, убедитесь, что `api` установлен в `openai-responses`.
      </Step>

      <Step title="Выберите модель по умолчанию">
        Используйте **Fetch Models**, когда это возможно. Если модель нужно ввести вручную, используйте актуальный Model ID провайдера **GPT**.

        OpenClaw использует сохраненную конфигурацию provider напрямую, поэтому proxy CC Switch не требуется.
      </Step>

      <Step title="Сохраните и переключитесь">
        Сохраните provider и переключите OpenClaw на BetterToken.
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

После сохранения и переключения 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 и общей истории сеансов](/faq/codex/official-login-third-party-api).

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

* Не добавляйте `/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](/ai-tools/claude-code)
* Прямая настройка провайдера Claude в Claude Desktop: [Claude Desktop](/faq/claude-desktop-bettertoken-api)
* Подробно про Codex: [Codex](/ai-tools/codex)
* Подробно про OpenCode: [OpenCode](/ai-tools/opencode)
* Подробно про OpenClaw: [OpenClaw](/ai-tools/openclaw)

## Связанные FAQ

* [Third-party модели и Codex в Claude Desktop](/faq/claude-desktop/third-party-models)
* [OpenAI-compatible API и Anthropic-compatible API](/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP и API Key / Base URL](/faq/concepts/mcp-vs-api-key-base-url)
* [Что такое model\_provider, base\_url и wire\_api?](/faq/codex/model-provider-base-url-wire-api)
* [Как настроить OpenAI-compatible API в Cline](/faq/cline/openai-compatible-api)