> ## 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.

# Настройка CC Switch с BetterToken

> Подключите BetterToken к CC Switch и управляйте Claude Code, Codex CLI, OpenCode и OpenClaw в одном месте.

CC Switch — кроссплатформенное desktop-приложение для управления providers в Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw. На этой странице показано, как подключить BetterToken к CC Switch для четырех путей BetterToken, уже описанных в этой документации: Claude Code, Codex, OpenCode и OpenClaw.

<Note>
  Gemini CLI использует протокол Google / Vertex AI. BetterToken пока не документировал этот путь здесь, поэтому в этой инструкции он не рассматривается.
</Note>

## Установка 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 (зарегистрироваться (`https://www.bettertoken.ai/register`))
* Claude Code использует Anthropic-протокол, поэтому его `Base URL` — `https://www.bettertoken.ai`
* Codex, OpenCode и OpenClaw используют OpenAI-compatible protocol, поэтому их `Base URL` — `https://www.bettertoken.ai/v1`
* Подготовьте актуальный ID модели **Codex group** для Codex, OpenCode и OpenClaw. Его можно скопировать из BetterToken model plaza (`https://www.bettertoken.ai/pricing`) или дать 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`
        * **Base URL**: `https://www.bettertoken.ai`
        * **API Key**: ваш API Key BetterToken

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

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

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

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

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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=078af460fcf75fc78f037b92f24e3c0d" alt="Advanced Options в CC Switch, API Format установлен в OpenAI Responses API." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" 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/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=6a59bc2ab875c6c262656fbcc3e811f9" alt="Раздел model mapping в CC Switch с Fetch Model List и mappings для Primary, Thinking, Haiku, Sonnet и Opus." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-model-mapping.png" />
        </Frame>

        Все эти модели должны использовать актуальные model IDs **Codex group** из BetterToken model plaza (`https://www.bettertoken.ai/pricing`).
      </Step>

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

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

        Скриншот ниже показывает случай `Codex_*`, когда proxy нужно включить.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=78cbcfb305b6d52418ac6f4a7a7eacc7" alt="После сохранения provider BetterToken выбран активным, а proxy toggle CC Switch включен в левом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-enable-proxy.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/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-basic-fields.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=b7caa17ef53aeb178b8dac0297e6bdfd" alt="Страница редактирования Codex provider в CC Switch с полями Provider Name, API Key и Base URL." style={{ borderRadius: '0.5rem' }} width="1800" height="1532" data-path="images/cc-switch/codex-cli-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Выберите модель по умолчанию">
        Сначала нажмите **Fetch Models**. CC Switch использует настроенный API key, чтобы вызвать `/v1/models`, а затем показывает доступные модели в grouped dropdowns.

        Если модели не вернулись, вставьте актуальный ID модели **Codex group** вручную.

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

        1. Нажмите **Fetch Model List**
        2. Выберите нужную модель из dropdown

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-select-model.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=e7eddd5f6cf946ec9f4c6a6d1ca85dc8" alt="Страница редактирования Codex provider в CC Switch с кнопкой Fetch Model List и dropdown выбора модели." style={{ borderRadius: '0.5rem' }} width="1800" height="1686" data-path="images/cc-switch/codex-cli-select-model.png" />
        </Frame>
      </Step>

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

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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-activate-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=da770acc8eb4cbe188369b11e9e8721e" 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>

      <Step title="Опционально: измените provider label в Codex App">
        Если хотите, чтобы provider label в правом нижнем углу chat box Codex App было проще отличать, измените поле `name` в config на нужное имя, например `bettertoken`.

        Это значение также управляет provider name внутри Codex App.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-provider-name.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=c01de212625dbb6b8b494dca2339ec5f" alt="Сгенерированный Codex config с выделенным полем name в model_providers.custom и provider label в правом нижнем углу chat box Codex App." style={{ borderRadius: '0.5rem' }} width="3836" height="2096" data-path="images/cc-switch/codex-cli-provider-name.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
      </Step>

      <Step title="Выберите модель по умолчанию">
        Используйте **Fetch Models**, когда это возможно. Если модель нужно ввести вручную, используйте актуальный ID модели **Codex group** из BetterToken model plaza (`https://www.bettertoken.ai/pricing`).
      </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

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

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

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

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

После сохранения и переключения providers перезапустите затронутый client или gateway перед проверкой настройки.

* Claude Code: полностью завершите текущую сессию Claude Code, затем запустите ее заново.
* Codex: перезапустите текущий процесс Codex или откройте новую terminal session.
* OpenCode: завершите текущую сессию OpenCode и запустите ее снова.
* OpenClaw: выполните `openclaw gateway restart`, затем используйте `/new`, `/status` и `/model` в Discord.

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

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

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

* Подробно про Claude Code: [Claude Code](/ru/ai-tools/claude-code)
* Подробно про Codex: [Codex](/ru/ai-tools/codex)
* Подробно про OpenCode: [OpenCode](/ru/ai-tools/opencode)
* Подробно про OpenClaw: [OpenClaw](/ru/ai-tools/openclaw)