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

# Настройка кастомной модели Claude Desktop через BetterToken

> Включите developer mode в Claude Desktop и настройте BetterToken API как third-party inference gateway.

Claude Desktop может использовать third-party inference gateway, если включен developer mode. Выберите путь настройки по группе API Key BetterToken: введите Anthropic-compatible endpoint напрямую или перенаправляйте запросы через локальный route CC Switch.

<Info>
  Если в поле **Группа ключа** выбрано **Claude**, можно указать `https://www.bettertoken.ai` напрямую в Claude Desktop. Если выбрано **GPT**, сначала настройте local route через CC Switch, затем введите local service address в Claude Desktop. Не вводите Codex / OpenAI-compatible endpoint `https://www.bettertoken.ai/v1` напрямую в Claude Desktop Gateway.
</Info>

## Шаги настройки

<Steps>
  <Step title="Скачайте Claude Desktop">
    Скачайте актуальное приложение Claude Desktop по официальной ссылке:

    [Download Claude for Mac](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect)

    После установки не входите в Claude account. Перейдите к следующему шагу и включите developer mode.
  </Step>

  <Step title="Включите developer mode">
    Откройте Claude Desktop, затем в macOS menu bar выберите **Help** → **Troubleshooting** → **Enable Developer Mode**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=88d5591c4fc6690a13b846df03f84991" alt="Выбор Enable Developer Mode в меню Help приложения Claude Desktop." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png" />
    </Frame>

    В окне подтверждения нажмите **Enable**, затем перезапустите Claude Desktop.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/developer-mode-confirm.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=ec60755e271216c1383bd7ec466c58db" alt="Подтверждение developer mode в Claude Desktop." style={{ borderRadius: '0.5rem' }} width="520" height="480" data-path="images/claude-desktop-llmeasy-api/developer-mode-confirm.png" />
    </Frame>
  </Step>

  <Step title="Откройте настройки third-party inference">
    После перезапуска в macOS menu bar появится меню **Developer**.

    Выберите **Developer** → **Configure Third-Party Inference...**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/configure-third-party-inference.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=f4412369928fe11c78433578e0efa60a" alt="Выбор Configure Third-Party Inference в меню Developer." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/configure-third-party-inference.png" />
    </Frame>
  </Step>
</Steps>

После первых 3 шагов выберите путь, который соответствует группе вашего API Key BetterToken.

<Tabs>
  <Tab title="Группа ключа: Claude">
    <Steps>
      <Step title="Введите настройки BetterToken API">
        В окне настроек выберите **Gateway**, затем введите:

        | Поле                    | Значение                                                         |
        | ----------------------- | ---------------------------------------------------------------- |
        | **Gateway base URL**    | `https://www.bettertoken.ai`                                     |
        | **Gateway API key**     | Скопируйте API Key из **Token management** в консоли BetterToken |
        | **Gateway auth scheme** | `x-api-key`                                                      |

        После выбора **Gateway auth scheme** Claude Desktop автоматически получит доступные модели для группы **Claude**. После ввода настроек нажмите **Apply locally**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/gateway-credentials.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=14951973725bde190ce650415e7b67f8" alt="Настройка BetterToken Gateway в Claude Desktop и кнопка Apply locally." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/gateway-credentials.png" />
        </Frame>
      </Step>

      <Step title="Подтвердите relaunch приложения">
        После записи локальной конфигурации Claude попросит сохранить изменения и перезапустить приложение. Нажмите **Save & Restart**, чтобы новая gateway-конфигурация вступила в силу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/relaunch-claude.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=9f6734947d08bab9e20a4e7e7435314c" alt="Claude Desktop просит сохранить изменения и перезапуститься, кнопка Save & Restart выделена." style={{ borderRadius: '0.5rem' }} width="1800" height="2046" data-path="images/claude-desktop-llmeasy-api/relaunch-claude.png" />
        </Frame>
      </Step>

      <Step title="Войдите через Gateway">
        После перезапуска подождите около 3 секунд, пока появится выбор способа входа.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/continue-with-gateway.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=cdd2a315ee2850d07bbaac39f0e06756" alt="Claude Desktop показывает вариант Continue with Gateway." style={{ borderRadius: '0.5rem' }} width="1200" height="1200" data-path="images/claude-desktop-llmeasy-api/continue-with-gateway.png" />
        </Frame>

        Выберите **Continue with Gateway**. Когда Claude откроется, в левом нижнем углу появится **Cowork 3P | Gateway**, и можно начинать работу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/gateway-ready.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=292b7db7ffddbcb11be3312dda097997" alt="Claude Desktop готов к работе после входа через Gateway." style={{ borderRadius: '0.5rem' }} width="3840" height="2100" data-path="images/claude-desktop-llmeasy-api/gateway-ready.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Группа ключа: GPT">
    <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/ZMo3cJhJx4ISRrsG/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=52f2f9c51f8c709da0654fff89977b59" 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="Установите API format и model mappings">
        Откройте **Advanced Options** и установите **API Format** в **OpenAI Responses API**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=78fd213694139a6457f16de0a4b1642c" 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>

        В **Model Mapping** нажмите **Fetch Model List**. Явно выберите значения в 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 из текущих моделей группы **GPT** в <a href={"https://www.bettertoken.ai/pricing"}>BetterToken model plaza</a>.
      </Step>

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

        1. Установите только что сохраненный provider BetterToken как **In use**
        2. Включите **CC Switch proxy** в левом верхнем углу

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=388cb7aa77282c5d7ae090a9f7291a56" 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>

      <Step title="Откройте настройки CC Switch">
        Вернитесь на главный экран CC Switch и нажмите **Settings** в левом верхнем углу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/cc-switch-settings-entry.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=6a1028431ba18e7981ed24062211cb1c" alt="Главный экран CC Switch с выделенной кнопкой Settings в левом верхнем углу." style={{ borderRadius: '0.5rem' }} width="2000" height="1302" data-path="images/claude-desktop-llmeasy-api/cc-switch-settings-entry.png" />
        </Frame>
      </Step>

      <Step title="Проверьте routing и скопируйте service address">
        Откройте настройки **Routing**. Убедитесь, что главный routing switch и route switch **Claude** включены. Затем скопируйте **Service address** ниже.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/cc-switch-route-service.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=cadbb3ee3defaa9f4f8d419074607026" alt="Страница routing settings в CC Switch с главным route switch, Claude route switch и кнопкой копирования service address." style={{ borderRadius: '0.5rem' }} width="2000" height="1302" data-path="images/claude-desktop-llmeasy-api/cc-switch-route-service.png" />
        </Frame>
      </Step>

      <Step title="Введите Gateway base URL в Claude Desktop">
        Вернитесь в окно third-party inference settings Claude Desktop и выберите **Gateway**. Вставьте **Service address** из CC Switch в **Gateway base URL**, затем введите API Key BetterToken.

        Установите **Gateway auth scheme** в `bearer`.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/claude-gateway-local-route.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=0fb9eb62189e501116d16dfdac54153c" alt="Страница Gateway settings в Claude Desktop с локальным service address из CC Switch." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/claude-gateway-local-route.png" />
        </Frame>
      </Step>

      <Step title="Добавьте model list и примените локально">
        Добавьте модели, которые должны отображаться в **Model list**. Для каждой модели нужны и **Model ID**, и **Display name**.

        Например:

        | Model ID        | Display name    |
        | --------------- | --------------- |
        | `claude-opus-4` | `Claude Opus 4` |

        После заполнения списка нажмите **Apply locally**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/claude-model-list-codex-group.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=754f1468abb9da6007c591d041269575" alt="Model list в Claude Desktop с заполненными Model ID и Display name, кнопка Apply locally доступна." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/claude-model-list-codex-group.png" />
        </Frame>
      </Step>

      <Step title="Подтвердите relaunch приложения">
        После записи локальной конфигурации Claude попросит сохранить изменения и перезапустить приложение. Нажмите **Save & Restart**, чтобы новая gateway-конфигурация вступила в силу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/relaunch-claude.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=9f6734947d08bab9e20a4e7e7435314c" alt="Claude Desktop просит сохранить изменения и перезапуститься, кнопка Save & Restart выделена." style={{ borderRadius: '0.5rem' }} width="1800" height="2046" data-path="images/claude-desktop-llmeasy-api/relaunch-claude.png" />
        </Frame>
      </Step>

      <Step title="Войдите через Gateway">
        После перезапуска подождите около 3 секунд, пока появится выбор способа входа.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/continue-with-gateway.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=cdd2a315ee2850d07bbaac39f0e06756" alt="Claude Desktop показывает вариант Continue with Gateway." style={{ borderRadius: '0.5rem' }} width="1200" height="1200" data-path="images/claude-desktop-llmeasy-api/continue-with-gateway.png" />
        </Frame>

        Выберите **Continue with Gateway**. Когда Claude откроется, в левом нижнем углу появится **Cowork 3P | Gateway**, и можно начинать работу.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/gateway-ready.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=292b7db7ffddbcb11be3312dda097997" alt="Claude Desktop готов к работе после входа через Gateway." style={{ borderRadius: '0.5rem' }} width="3840" height="2100" data-path="images/claude-desktop-llmeasy-api/gateway-ready.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Диагностика

Если меню **Developer** не появилось в Claude Desktop, убедитесь, что вы нажали **Enable** и полностью перезапустили приложение.

Если запросы не проходят, сначала проверьте:

1. **Gateway base URL** соответствует выбранному пути: `https://www.bettertoken.ai` для группы **Claude** или local service address из CC Switch для группы **GPT**
2. **Gateway API key** взят из **Token management** в консоли BetterToken
3. **Gateway auth scheme** соответствует группе API Key: `x-api-key` для группы **Claude** и `bearer` для группы **GPT**
4. Вы нажали **Apply locally**
5. Если используете группу **GPT**, главный routing switch и route **Claude** включены в настройках **Routing** CC Switch
6. Вы нажали **Save & Restart** и после перезапуска выбрали **Continue with Gateway**